一、简介
日常生活中,打电话是最常见的交流方式之一,那么如何在 OpenAtom OpenHarmony(简称“OpenHarmony”)中进行电话服务相关的开发呢?今天我们可以一起来了解一下如何通过电话服务系统支持的 API 实现拨打电话的功能。
二、效果展示
应用可以通过调用 call 和 observer 模块的 API 来获取当前注册网络名称、网络服务状态、信号强度以及 SIM 卡的相关信息,具体可参考获取当前蜂窝网络信号信息开发指导。
直接拨打电话需要提供系统权限 ohos.permission.PLACE_CALL,在这里建议应用使用 makeCall(),跳转到拨号界面,并显示拨号的号码,当开发者调用 makeCall 接口时,设备会自动跳转到拨号界面。
三、接口说明
call 模块为开发者提供呼叫管理功能。observer 模块为开发者提供通话业务状态订阅和取消订阅功能。
call.hasVoiceCapability():能力获取,表示是否具有语音功能。
call.makeCall()跳转拨号界面,跳转到拨号界面,并显示拨号的号码。
observer.on(‘callStateChange’):订阅通话业务状态变化,
ohos.permission.READ_CALL_LOG (获取通话号码需要该权限)。
observer.off(‘callStateChange’):取消订阅通话业务状态变化。
四、开发步骤
1.import 需要的模块。
// import需要的模块
import call from '@ohos.telephony.call';
import observer from '@ohos.telephony.observer';
复制代码
2.调用 hasVoiceCapability()接口获取当前设备呼叫能力,如果支持继续下一步;如果不支持则无法发起呼叫。
// 调用查询能力接口
let isSupport = call.hasVoiceCapability();
if (!isSupport) {
console.log("not support voice capability, return.");
return;
}
复制代码
3.跳转到拨号界面,并显示拨号的号码。
// 如果设备支持呼叫能力,则继续跳转到拨号界面,并显示拨号的号码
call.makeCall("13xxxx", (err)=> {
if (!err) {
console.log("make call success.");
} else {
console.log("make call fail, err is:" + JSON.stringify(err));
}
});
复制代码
4.订阅通话业务状态变化。
// 订阅通话业务状态变化(可选)
observer.on("callStateChange", (data) => {
console.log("call state change, data is:" + JSON.stringify(data));
});
复制代码
5.取消订阅通话业务状态变化。
// 取消订阅通话业务状态变化
observer.off("callStateChange", (data) => {
console.log("call state change, data is:" + JSON.stringify(data));
});
复制代码
五、完整代码
// import需要的模块
import call from '@ohos.telephony.call';
import observer from '@ohos.telephony.observer';
@Entry
@Component
struct CAllTest{
build(){
Column(){
Button("打电话给坚果").width(300).height(80) .fontSize(30).fontColor(Color.Orange).onClick(()=>{
// 调用查询能力接口
let isSupport = call.hasVoiceCapability();
if (!isSupport) {
console.info(" support voice capability, return");
return;
}
// 如果设备支持呼叫能力,则继续跳转到拨号界面,并显示拨号的号码
call.makeCall("17752170152", (err)=> {
if (!err) {
console.info(" make call success.");
} else {
console.info("make call fail, err is:" + JSON.stringify(err));
}
});
})
}.width("100%").height("100%").justifyContent(FlexAlign.Center)
}
}
复制代码
源码地址https://gitee.com/jianguo888/callphone
六、总结
本文通过一个按钮,实现了跳转拨号的功能。首先为按钮添加点击事件,其次导入需要的模块,调用 hasVoiceCapability()接口获取当前设备呼叫能力,最终实现一键跳转到拨号界面。大家可以将这个功能扩展到自己的应用里。比如,在一键呼叫,售后服务等场景。
评论