簡介

電話服務子系統，提供了一系列的API用于獲取無線蜂窩網絡和SIM卡相關的一些信息。應用可以通過調用API來獲取當前注冊網絡名稱、網絡服務狀態、信號強度以及SIM卡的相關信息。

各個模塊主要作用如下：

• 核心服務模塊：主要功能是初始化RIL管理、SIM卡和搜網模塊。
• 通話管理模塊：主要功能是管理CS（Circuit Switch，電路交換）、IMS（IP Multimedia Subsystem，IP多媒體子系統）和OTT（over the top，OTT解決方案）三種類型的通話，申請通話所需要的音視頻資源，處理多路通話時產生的各種沖突。
• 蜂窩通話模塊：主要功能是實現基于運營商網絡的基礎通話。
• 蜂窩數據模塊：主要功能是實現基于運營商網絡的蜂窩數據上網。
• 短彩信模塊：主要功能是短信收發和彩信編解碼。
• 狀態訂閱模塊：主要功能是提供電話服務子系統各種消息事件的訂閱以及取消訂閱的API。
• 數據存儲模塊：主要功能是持久化數據存儲，提供DataAbility訪問接口。
• RIL Adapter模塊： 主要功能是與modem通信接口的適配。

圖 1 子系統架構圖

目錄

base/telephony/
├── core_service            # 核心服務
├── call_manager            # 通話管理
├── cellular_call           # 蜂窩通話
├── cellular_data           # 蜂窩數據
├── sms_mms                 # 短彩信
├── state_registry          # 狀態訂閱
├── data_storage            # 數據存儲
└── ril_adapter             # RIL Adapter

約束

1. 目前開源的范圍包括蜂窩通話（僅支持CS通話）、短信、數據上網，支持雙SIM卡框架。
2. 南向HDI依賴芯片廠商適配。

使用說明

具體請參考子模塊README，下面以獲取當前蜂窩網絡信號信息和觀察蜂窩網絡狀態變化為例，說明電話服務子系統接口調用請求和狀態訂閱的使用方法。

獲取當前蜂窩網絡信號信息

1. 從@ohos.telephony.radio.d.ts中導入radio命名空間。
2. 可以通過callback或者Promise的方式調用getSignalInformation(slotId: number)方法。
3. 該接口為異步接口，結果會從callback中返回SignalInformation數組。
4. 遍歷SignalInformation數組，獲取不同制式（signalType）的信號強度（signalLevel）。

   // 引入包名
   import radio from "@ohos.telephony.radio";
   
   // 參數賦值
   let slotId = 0;
   
   // 調用接口【callback方式】
   radio.getSignalInformation(slotId, (err, value) = > {
     if (err) {
       // 接口調用失敗，err非空
       console.error(`failed to getSignalInformation because ${err.message}`);
       return;
     }
     // 接口調用成功，err為空
     for (let i = 0; i < value.length; i++) {
       console.log(`success to getSignalInformation: type is ${value[i].signalType}, level is ${value[i].signalLevel}`);
     }
   });
   
   // 調用接口【Promise方式】
   let promise = radio.getSignalInformation(slotId);
   promise.then((value) = > {
     // 接口調用成功，此處可以實現成功場景分支代碼。
     for (let i = 0; i < value.length; i++) {
       console.log(`success to getSignalInformation: type is ${value[i].signalType}, level is ${value[i].signalLevel}`);
     }
   }).catch((err) = > {
     // 接口調用失敗，此處可以實現失敗場景分支代碼。
     console.error(`failed to getSignalInformation because ${err.message}`);
   });
   

觀察蜂窩網絡狀態變化

添加觀察事件

1. 從@ohos.telephony.observer.d.ts中導入observer命名空間。
2. 調用on(type: 'networkStateChange')方法，傳入卡槽id（slotId）和收到事件的回調處理函數（callback），其中slotId為可選參數。
3. 當網絡狀態發生變更時，調用者會收到回調。

   // 引入包名
   import observer from '@ohos.telephony.observer';
   
   // 開啟訂閱
   observer.on('networkStateChange', {slotId: 0}, (value) = > {
     console.log(`network state is ` + value);
   });
   

停止觀察

1. 從@ohos.telephony.observer.d.ts中導入observer命名空間。

2. 調用off(type: 'networkStateChange')方法，傳入添加觀察事件時的callback對象（可選）。

   // 引入包名
   import observer from '@ohos.telephony.observer';
   
   // 關閉訂閱
   observer.off('networkStateChange');
   

   審核編輯 黃宇