• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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/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/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-overview.md#权限使用的基本原则)。然后参考[配置文件权限声明指导文档](../security/accesstoken-guidelines.md#配置文件权限声明)声明对应权限。
502. 导入call和observer模块。
513. 调用hasVoiceCapability，确认当前设备是否支持拨号。
52   如果设备支持呼叫能力，则继续跳转到拨号界面，并显示拨号的号码。
534. 调用dialCall接口，拨打电话。
545. （可选）订阅通话业务状态变化。
55   ```ts
56    // import需要的模块
57    import call from '@ohos.telephony.call';
58    import observer from '@ohos.telephony.observer';
59    import { BusinessError } from '@ohos.base';
60
61    // 调用查询能力接口
62    let isSupport = call.hasVoiceCapability();
63    if (isSupport) {
64        // 如果设备支持呼叫能力，调用以下接口进行拨号
65        call.dialCall("13xxxx", (err: BusinessError) => {
66            console.log(`callback: dial call err->${JSON.stringify(err)}`);
67        })
68
69        // 订阅通话业务状态变化（可选）
70        class SlotId {slotId: number = 0}
71        class CallStateCallback {
72            state: call.CallState = call.CallState.CALL_STATE_UNKNOWN;
73            number: string = "";
74        }
75        let slotId: SlotId = {slotId: 0}
76        observer.on("callStateChange", slotId, (data: CallStateCallback) => {
77            console.log("call state change, data is:" + JSON.stringify(data));
78        });
79    }
80   ```
81
82### 使用makeCall拨打电话
83
841. 导入call和observer模块。
852. 调用hasVoiceCapability，确认当前设备是否支持拨号。
86   如果设备支持呼叫能力，则继续跳转到拨号界面，并显示拨号的号码。
873. 调用makeCall接口，拉起系统电话应用，拨打电话。
884. （可选）订阅通话业务状态变化。
89
90   ```ts
91    // import需要的模块
92    import call from '@ohos.telephony.call';
93    import observer from '@ohos.telephony.observer';
94    import { BusinessError } from '@ohos.base';
95
96    // 调用查询能力接口
97    let isSupport = call.hasVoiceCapability();
98    if (isSupport) {
99        // 如果设备支持呼叫能力，则继续跳转到拨号界面，并显示拨号的号码
100        call.makeCall("13xxxx", (err: BusinessError) => {
101            if (!err) {
102                console.log("make call success.");
103            } else {
104                console.log("make call fail, err is:" + JSON.stringify(err));
105            }
106        });
107        // 订阅通话业务状态变化（可选）
108        class SlotId {slotId: number = 0}
109        class CallStateCallback {
110            state: call.CallState = call.CallState.CALL_STATE_UNKNOWN;
111            number: string = "";
112        }
113        let slotId: SlotId = {slotId: 0}
114        observer.on("callStateChange", slotId, (data: CallStateCallback) => {
115            console.log("call state change, data is:" + JSON.stringify(data));
116        });
117    }
118   ```
119
120## 相关实例
121
122针对拨打电话，有以下相关实例可供参考：
123
124- [拨打电话（ArkTS）（API9）](https://gitee.com/openharmony/applications_app_samples/tree/OpenHarmony-4.0-Release/code/BasicFeature/Telephony/Call)
125