1# 拨打电话 2 3## 场景介绍 4 5开发者可以通过两种不同的方式实现拨打电话的功能： 6- 对于系统应用，开发者可以使用dialCall接口，直接进行音频/视频呼叫，在应用界面显示对应的通话。 7- 对于三方应用，开发者可以使用makeCall接口，拉起系统电话应用，用户可以自行呼出通话。 8 9## 基本概念 10 11- 通话状态码 12 将当前的通话状态上报给app，可以根据当前的通话状态去做一些逻辑处理。例如在当前没有正在进行呼叫的时候，可以正常拨打新的一通电话。 13 14 | 名称 | 值 | 说明 | 15 | ------------------ | ---- | ------------------------------------------------------------ | 16 | CALL_STATE_UNKNOWN | -1 | 无效状态，当获取呼叫状态失败时返回。 | 17 | CALL_STATE_IDLE | 0 | 表示没有正在进行的呼叫。 | 18 | CALL_STATE_RINGING | 1 | 表示来电正在振铃或等待。 | 19 | CALL_STATE_OFFHOOK | 2 | 表示至少有一个呼叫处于拨号、通话中或呼叫保持状态，并且没有新的来电振铃或等待。 | 20 21## 约束与限制 22 231. 仅支持在标准系统上运行。 242. 设备需插入可用的SIM卡。 25 26 27## 接口说明 28 29> **说明：** 30> 为了保证应用的运行效率，大部分API调用都是异步的，对于异步调用的API均提供了callback和Promise两种方式，以下示例均采用callback函数，更多方式可以查阅[API参考](../reference/apis-telephony-kit/js-apis-call.md)。 31 32| 接口名 | 描述 | 33| ----------------------------------------------------------------------------------- | ------------------------------------------------------------ | 34| hasVoiceCapability(): boolean; | 判断是否具有语音功能。 | 35| dialCall(phoneNumber: string, callback: AsyncCallback<void>): void | 拨号。该接口为系统接口。 | 36| makeCall(phoneNumber: string, callback: AsyncCallback<void>): void | 转到拨号屏幕，显示被叫号码。 | 37 38observer模块为开发者提供订阅和取消订阅通话业务状态的功能。具体API说明详见[接口文档](../reference/apis-telephony-kit/js-apis-observer.md)。 39 40| 接口名 | 描述 | 41| ------------------------------------------------------------ | ------------------ | 42| on(type: 'callStateChange', options: { slotId: number }, callback: Callback<{ state: CallState, number: string }>): void; | 监听通话状态变化。 | 43 44## 开发步骤 45 46### 使用dialCall拨打电话（仅供系统应用使用） 47 481. 声明接口调用所需要的权限：ohos.permission.PLACE_CALL。 49此权限级别为system_basic，在申请权限前，请保证符合[权限使用的基本原则](../security/AccessToken/app-permission-mgmt-overview.md#权限使用的基本原则)。然后参考[申请应用权限](../security/AccessToken/determine-application-mode.md#system_basic等级的应用申请权限)声明对应权限。 502. 导入call和observer模块。 513. 调用hasVoiceCapability，确认当前设备是否支持拨号。 524. 调用dialCall接口，拨打电话。 535. （可选）订阅通话业务状态变化。 54 ```ts 55 // import需要的模块 56 import call from '@ohos.telephony.call'; 57 import observer from '@ohos.telephony.observer'; 58 import { BusinessError } from '@ohos.base'; 59 60 // 调用查询能力接口 61 let isSupport = call.hasVoiceCapability(); 62 if (isSupport) { 63 // 如果设备支持呼叫能力，调用以下接口进行拨号 64 call.dialCall("13xxxx", (err: BusinessError) => { 65 console.log(`callback: dial call err->${JSON.stringify(err)}`); 66 }) 67 68 // 订阅通话业务状态变化（可选） 69 class SlotId {slotId: number = 0} 70 class CallStateCallback { 71 state: call.CallState = call.CallState.CALL_STATE_UNKNOWN; 72 number: string = ""; 73 } 74 let slotId: SlotId = {slotId: 0} 75 observer.on("callStateChange", slotId, (data: CallStateCallback) => { 76 console.log("call state change, data is:" + JSON.stringify(data)); 77 }); 78 } 79 ``` 80 81### 使用makeCall拨打电话 82 831. 导入call和observer模块。 842. 调用hasVoiceCapability，确认当前设备是否支持拨号。 853. 调用makeCall接口，跳转到拨号界面并显示待拨号的号码。 864. （可选）订阅通话业务状态变化。 87 88 ```ts 89 // import需要的模块 90 import call from '@ohos.telephony.call'; 91 import observer from '@ohos.telephony.observer'; 92 import { BusinessError } from '@ohos.base'; 93 94 // 调用查询能力接口 95 let isSupport = call.hasVoiceCapability(); 96 if (isSupport) { 97 // 如果设备支持呼叫能力，则继续跳转到拨号界面，并显示拨号的号码 98 call.makeCall("13xxxx", (err: BusinessError) => { 99 if (!err) { 100 console.log("make call success."); 101 } else { 102 console.log("make call fail, err is:" + JSON.stringify(err)); 103 } 104 }); 105 // 订阅通话业务状态变化（可选） 106 class SlotId {slotId: number = 0} 107 class CallStateCallback { 108 state: call.CallState = call.CallState.CALL_STATE_UNKNOWN; 109 number: string = ""; 110 } 111 let slotId: SlotId = {slotId: 0} 112 observer.on("callStateChange", slotId, (data: CallStateCallback) => { 113 console.log("call state change, data is:" + JSON.stringify(data)); 114 }); 115 } 116 ``` 117 118## 相关实例 119 120针对拨打电话，有以下相关实例可供参考： 121 122- [拨打电话（ArkTS）（API9）](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/Call) 123