电话服务开发概述
HarmonyOS 电话服务系统提供了一系列的 API 用于拨打电话、获取无线蜂窝网络和 SIM 卡相关信息。
应用可以通过调用 API 来获取当前注册网络名称、网络服务状态、信号强度以及 SIM 卡的相关信息,具体可参考获取当前蜂窝网络信号信息开发指导。
直接拨打电话需要系统权限 ohos.permission.PLACE_CALL,建议应用使用 makeCall(),跳转到拨号界面,并显示拨号的号码,具体可参考跳转拨号界面开发指导。
约束与限制
搭载设备需要支持以下硬件:
可以进行独立蜂窝通信的 Modem 以及 SIM 卡。
跳转拨号界面
当应用需要跳转到拨号界面,并显示拨号的号码时,使用本业务。当开发者调用 makeCall 接口时,设备会自动跳转到拨号界面。和正常拨打电话一样,用户可以选择音频或视频呼叫,卡 1 或卡 2 拨出。
接口说明
call 模块为开发者提供呼叫管理功能。observer 模块为开发者提供订阅和取消订阅通话业务状态的功能。具体接口说明如下表。
开发步骤
import 需要的模块。
调用 hasVoiceCapability()接口获取当前设备呼叫能力,如果支持继续下一步;如果不支持则无法发起呼叫。
跳转到拨号界面,并显示拨号的号码。
(可选)订阅通话业务状态变化。
// 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 模块为开发者提供蜂窝网络状态订阅和取消订阅功能。具体接口说明如下表。
开发步骤
import 需要的模块。
调用 getSignalInformation()方法,返回所有 SignalInformation 列表。
遍历 SignalInformation 数组,并分别根据不同的 signalType 得到不同制式的信号强度。
订阅蜂窝网络信号变化(可选)。
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));
});
复制代码
评论