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. (可选)订阅通话业务状态变化。

javascript 复制代码
// 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. 订阅蜂窝网络信号变化(可选)。

javascript 复制代码
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));
});
相关推荐
安卓开发者6 小时前
鸿蒙NEXT应用接入快捷栏:一键直达,提升用户体验
java·harmonyos·ux
HMS Core6 小时前
消息推送策略:如何在营销与用户体验间找到最佳平衡点
华为·harmonyos·ux
Brianna Home6 小时前
【案例实战】鸿蒙分布式调度:跨设备协同实战
华为·wpf·harmonyos
Bert丶seven6 小时前
鸿蒙Harmony实战开发教学(No.4)-RichText组件基础到高阶介绍篇
华为·harmonyos·arkts·鸿蒙·鸿蒙系统·arkui·开发教程
鸿蒙小白龙7 小时前
openharmony之分布式蓝牙实现多功能场景设备协同实战
分布式·harmonyos·鸿蒙·鸿蒙系统·open harmony
爱吃水蜜桃的奥特曼8 小时前
玩Android Harmony next版,通过项目了解harmony项目快速搭建开发
android·harmonyos
鸿蒙小白龙9 小时前
openharmony之分布式购物车开发实战
分布式·harmonyos·鸿蒙·鸿蒙系统·open harmony
鸿蒙小白龙9 小时前
openharmony之分布式相机开发:预览\拍照\编辑\同步\删除\分享教程
分布式·harmonyos·鸿蒙·鸿蒙系统·open harmony
安卓开发者11 小时前
鸿蒙NEXT鼠标光标开发完全指南
华为·计算机外设·harmonyos
●VON17 小时前
重生之我在大学自学鸿蒙开发第九天-《分布式流转》
学习·华为·云原生·harmonyos·鸿蒙