HarmonyOS电话服务开发指导

电话服务开发概述

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

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

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

约束与限制

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

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

跳转拨号界面

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

接口说明

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

功能分类	接口名	描述	所需权限
能力获取	call.hasVoiceCapability()	是否具有语音功能	无
跳转拨号界面	call.makeCall()	跳转到拨号界面，并显示拨号的号码	无
订阅通话业务状态变化	observer.on('callStateChange')	订阅通话业务状态变化	ohos.permission.READ_CALL_LOG （获取通话号码需要该权限）
取消订阅通话业务状态变化	observer.off('callStateChange')	取消订阅通话业务状态变化	无

开发步骤

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模块为开发者提供蜂窝网络状态订阅和取消订阅功能。具体接口说明如下表。

功能分类	接口名	描述	所需权限
信号强度信息	radio.getSignalInformation  ()	获取当前注册蜂窝网络信号强度信息	无
订阅蜂窝网络信号变化	observer.on('signalInfoChange')	订阅蜂窝网络信号变化	无
取消订阅蜂窝网络信号变化	observer.off('signalInfoChange')	取消订阅蜂窝网络信号变化	无

开发步骤

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));
});