HarmonyOS 电话服务开发指导

电话服务开发概述

HarmonyOS 电话服务系统提供了一系列的 API 用于拨打电话、获取无线蜂窝网络和 SIM 卡相关信息。

应用可以通过调用 API 来获取当前注册网络名称、网络服务状态、信号强度以及 SIM 卡的相关信息，具体可参考获取当前蜂窝网络信号信息开发指导。

直接拨打电话需要系统权限 ohos.permission.PLACE_CALL，建议应用使用 makeCall()，跳转到拨号界面，并显示拨号的号码，具体可参考跳转拨号界面开发指导。

约束与限制

搭载设备需要支持以下硬件：

可以进行独立蜂窝通信的 Modem 以及 SIM 卡。

跳转拨号界面

当应用需要跳转到拨号界面，并显示拨号的号码时，使用本业务。当开发者调用 makeCall 接口时，设备会自动跳转到拨号界面。和正常拨打电话一样，用户可以选择音频或视频呼叫，卡 1 或卡 2 拨出。

接口说明

call 模块为开发者提供呼叫管理功能。observer 模块为开发者提供订阅和取消订阅通话业务状态的功能。具体接口说明如下表。

开发步骤

1. import 需要的模块。

2. 调用 hasVoiceCapability()接口获取当前设备呼叫能力，如果支持继续下一步；如果不支持则无法发起呼叫。

3. 跳转到拨号界面，并显示拨号的号码。

4. （可选）订阅通话业务状态变化。

// import需要的模块
import call from '@ohos.telephony.call';
import observer from '@ohos.telephony.observer';
 
// 调用查询能力接口
let isSupport = call.hasVoiceCapability();
if (!isSupport) {
    console.log("not support voice capability, return.");
    return;
}
// 如果设备支持呼叫能力，则继续跳转到拨号界面，并显示拨号的号码
call.makeCall("13xxxx", (err)=> {
    if (!err) {
        console.log("make call success.");
    } else {
        console.log("make call fail, err is:" + JSON.stringify(err));
    }
});
// 订阅通话业务状态变化（可选）
observer.on("callStateChange", (data) => {
    console.log("call state change, data is:" + JSON.stringify(data));
});

获取当前蜂窝网络信号信息

场景介绍

应用通常需要获取用户所在蜂窝网络下信号信息，以便获取当前驻网质量。开发者可以通过本业务，获取到用户指定 SIM 卡当前所在网络下的信号信息。

接口说明

radio 模块提供了获取当前网络信号信息的方法。observer 模块为开发者提供蜂窝网络状态订阅和取消订阅功能。具体接口说明如下表。

开发步骤

1. import 需要的模块。

2. 调用 getSignalInformation()方法，返回所有 SignalInformation 列表。

3. 遍历 SignalInformation 数组，并分别根据不同的 signalType 得到不同制式的信号强度。

4. 订阅蜂窝网络信号变化（可选）。

   import radio from '@ohos.telephony.radio'
   import observer from '@ohos.telephony.observer';
    
   // 以获取卡1的信号强度为例
   let slotId = 0;
   radio.getSignalInformation(slotId, (err, data) => {
       if (!err) {
           console.log("get signal information success.");
           // 遍历数组，输出不同网络制式下的信号强度
           for (let j = 0; j < data.length; j++) {
               console.log("type:" + data[j].signalType + ", level:" + data[j].signalLevel);
           }
       } else {
           console.log("get signal information fail, err is:" + JSON.stringify(err));
       }
   });
   // 订阅蜂窝网络信号变化（可选）
   observer.on("signalInfoChange", (data) => {
       console.log("signal info change, data is:" + JSON.stringify(data));
   });