HarmonyOS NEXT开发实战：实现拨打电话

鸿蒙开发实战往期文章必看：

HarmonyOS NEXT应用开发性能实践总结

一分钟了解”纯血版！鸿蒙HarmonyOS Next应用开发！

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）

 “一杯冰美式的时间” 了解鸿蒙HarmonyOS Next应用开发路径！

---

场景介绍

开发者可以通过以下方式实现拨打电话的功能：

• 对于三方应用，开发者可以使用makeCall接口，拉起系统电话应用，用户可以自行呼出通话。

基本概念

• 通话状态码

  将当前的通话状态上报给app，可以根据当前的通话状态去做一些逻辑处理。例如在当前没有正在进行呼叫的时候，可以正常拨打新的一通电话。

  名称	值	说明
  CALL_STATE_UNKNOWN	-1	无效状态，当获取呼叫状态失败时返回。
  CALL_STATE_IDLE	0	表示没有正在进行的呼叫。
  CALL_STATE_RINGING	1	表示来电正在振铃或等待。
  CALL_STATE_OFFHOOK	2	表示至少有一个呼叫处于拨号、通话中或呼叫保持状态，并且没有新的来电振铃或等待。

约束与限制

1. 仅支持在标准系统上运行。
2. 设备需插入可用的SIM卡。

接口说明

说明

为了保证应用的运行效率，大部分API调用都是异步的，对于异步调用的API均提供了callback和Promise两种方式，以下示例均采用callback函数，更多方式可以查阅API参考。

接口名	描述
hasVoiceCapability(): boolean;	判断是否具有语音功能。
makeCall(phoneNumber: string, callback: AsyncCallback<void>): void	转到拨号屏幕，显示被叫号码。

observer模块为开发者提供订阅和取消订阅通话业务状态的功能。具体API说明详见接口文档。

接口名	描述
on(type: 'callStateChange', options: { slotId: number }, callback: Callback<{ state: CallState, number: string }>): void;	监听通话状态变化。

开发步骤

使用makeCall拨打电话

1. 导入call和observer模块。

2. 调用hasVoiceCapability，确认当前设备是否支持拨号。

3. 调用makeCall接口，跳转到拨号界面并显示待拨号的号码。

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

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

最后

如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员

→  鸿蒙Next全栈全套开发学习笔记希望这一份鸿蒙学习文档能够给大家带来帮助~

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、（南向驱动、嵌入式等）鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

路线图适合人群：

IT开发人员：想要拓展职业边界
零基础小白：鸿蒙爱好者，希望从0到1学习，增加一项技能。
技术提升/进阶跳槽：发展瓶颈期，提升职场竞争力，快速掌握鸿蒙技术