拨打电话

说明：

本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import call from '@ohos.telephony.call';

call.dial

dial(phoneNumber: string, callback: AsyncCallback<boolean>): void

拨打电话，使用callback方式作为异步方法。

需要权限：ohos.permission.PLACE_CALL，该权限为系统权限

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。
callback	AsyncCallback<boolean>	是	回调函数： - true：成功。 - false：失败。

示例：

call.dial("138xxxxxxxx", (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.dial

dial(phoneNumber: string, options: DialOptions, callback: AsyncCallback<boolean>): void

拨打电话，可设置通话参数，使用callback方式作为异步方法。

需要权限：ohos.permission.PLACE_CALL，该权限为系统权限

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。
options	DialOptions	是	通话参数，参考DialOptions。
callback	AsyncCallback<boolean>	是	回调函数： - true：成功。 - false：失败。

示例：

call.dial("138xxxxxxxx", {
    extras: false
}, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.dial

dial(phoneNumber: string, options?: DialOptions): Promise<boolean>

拨打电话，可设置通话参数，使用promise方式作为异步方法。

需要权限：ohos.permission.PLACE_CALL，该权限为系统权限

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。
options	DialOptions	是	通话参数，参考DialOptions。

返回值：

类型	说明
Promise<boolean>	以Promise形式返回拨打电话的结果。

示例：

let promise = call.dial("138xxxxxxxx", {
    extras: false
});
promise.then(data => {
    console.log(`dial success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`dial fail, promise: err->${JSON.stringify(err)}`);
});

call.makeCall⁷⁺

makeCall(phoneNumber: string, callback: AsyncCallback<void>): void

跳转到拨号界面，并显示拨号的号码，使用callback方式作为异步方法。

本接口在Openharmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。

系统能力：SystemCapability.Applications.Contacts

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。
callback	AsyncCallback<void>	是	以callback形式异步返回跳转拨号界面的结果。

示例：

call.makeCall("138xxxxxxxx", err => { 
    console.log(`makeCall callback: err->${JSON.stringify(err)}`); 
});

call.makeCall⁷⁺

makeCall(phoneNumber: string): Promise<void>

跳转到拨号界面，并显示拨号的号码，使用Promise方式作为异步方法。

本接口在Openharmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。

系统能力：SystemCapability.Applications.Contacts

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。

返回值：

类型	说明
Promise<void>	以Promise形式异步返回拨号的结果。

示例：

let promise = call.makeCall("138xxxxxxxx"); 
promise.then(() => { 
    console.log(`makeCall success`); 
}).catch(err => { 
    console.error(`makeCall fail, promise: err->${JSON.stringify(err)}`); 
});

call.hasCall

hasCall(callback: AsyncCallback<boolean>): void

判断是否存在通话，使用callback方式作为异步方法。

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
callback	AsyncCallback<boolean>	是	回调函数： - true：当前存在通话。 - false：当前不存在通话。

示例：

call.hasCall((err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.hasCall

hasCall(): Promise<boolean>

判断是否存在通话，使用Promise方式作为异步方法。

系统能力：SystemCapability.Telephony.CallManager

返回值：

类型	说明
Promise<boolean>	以Promise形式异步返回判断是否存在通话。

示例：

let promise = call.hasCall();
promise.then(data => {
    console.log(`hasCall success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`hasCall fail, promise: err->${JSON.stringify(err)}`);
});

call.getCallState

getCallState(callback: AsyncCallback<CallState>): void

获取通话状态，使用callback方式作为异步方法。

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
callback	AsyncCallback<CallState>	是	回调函数：异步返回获取到的通话状态。

示例：

call.getCallState((err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.getCallState

getCallState(): Promise<CallState>

获取通话状态，使用Promise方式作为异步方法。

系统能力：SystemCapability.Telephony.CallManager

返回值：

类型	说明
Promise<CallState>	以Promise形式异步返回获取通话状态的结果。

示例：

let promise = call.getCallState();
promise.then(data => {
    console.log(`getCallState success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`getCallState fail, promise: err->${JSON.stringify(err)}`);
});

call.hasVoiceCapability⁷⁺

hasVoiceCapability(): boolean

检查当前设备是否具备语音通话能力，该方法是同步方法。

系统能力：SystemCapability.Telephony.CallManager

返回值：

类型	说明
boolean	- true：设备具备语音通话能力 - false：设备不具备语音通话能力

let result = call.hasVoiceCapability(); 
console.log(`hasVoiceCapability: ${JSON.stringify(result)}`);

call.isEmergencyPhoneNumber⁷⁺

isEmergencyPhoneNumber(phoneNumber: string, callback: AsyncCallback<boolean>): void

判断是否是紧急电话号码，使用callback方式作为异步方法。

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。
callback	AsyncCallback<boolean>	是	回调函数，返回判断是否是紧急电话号码的结果： - true：是紧急电话号码。 - false：不是紧急电话号码。

示例：

call.isEmergencyPhoneNumber("138xxxxxxxx", (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.isEmergencyPhoneNumber⁷⁺

isEmergencyPhoneNumber(phoneNumber: string, options: EmergencyNumberOptions, callback: AsyncCallback<boolean>): void

判断是否是紧急电话号码，使用callback方式作为异步方法。

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。
options	EmergencyNumberOptions	是	电话号码参数，参考EmergencyNumberOptions。
callback	AsyncCallback<boolean>	是	回调函数，返回判断是否是紧急电话号码的结果： - true：是紧急电话号码。 - false：不是紧急电话号码。

示例：

call.isEmergencyPhoneNumber("112", {slotId: 1}, (err, value) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.isEmergencyPhoneNumber⁷⁺

isEmergencyPhoneNumber(phoneNumber: string, options?: EmergencyNumberOptions): Promise<boolean>

判断是否是紧急电话号码，使用promise方式作为异步方法。

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。
options	EmergencyNumberOptions	是	电话号码参数，参考EmergencyNumberOptions。

返回值：

类型	说明
Promise<boolean>	以Promise形式异步返回判断是否是紧急电话号码的结果。

示例：

let promise = call.isEmergencyPhoneNumber("138xxxxxxxx", {slotId: 1});
promise.then(data => {
    console.log(`isEmergencyPhoneNumber success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`isEmergencyPhoneNumber fail, promise: err->${JSON.stringify(err)}`);
});

call.formatPhoneNumber⁷⁺

formatPhoneNumber(phoneNumber: string, callback: AsyncCallback<string>): void

格式化电话号码，使用callback方式作为异步方法。

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。
callback	AsyncCallback<string>	是	回调函数，返回格式化电话号码的结果。

示例：

call.formatPhoneNumber("138xxxxxxxx", (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.formatPhoneNumber⁷⁺

formatPhoneNumber(phoneNumber: string, options: NumberFormatOptions, callback: AsyncCallback<string>): void

格式化电话号码，可设置格式化参数，使用callback方式作为异步方法。

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。
options	NumberFormatOptions	是	格式化参数，参考NumberFormatOptions。
callback	AsyncCallback<string>	是	回调函数，返回格式化电话号码的结果。

示例：

call.formatPhoneNumber("138xxxxxxxx",{
    countryCode: "CN"
}, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.formatPhoneNumber⁷⁺

formatPhoneNumber(phoneNumber: string, options?: NumberFormatOptions): Promise<string>

格式化电话号码，可设置格式化参数，使用promise方式作为异步方法。

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。
options	NumberFormatOptions	是	格式化参数，参考NumberFormatOptions。

返回值：

类型	说明
Promise<string>	以Promise形式异步返回格式化电话号码的结果。

示例：

let promise = call.formatPhoneNumber("138xxxxxxxx", {
    countryCode: "CN"
});
promise.then(data => {
    console.log(`formatPhoneNumber success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`formatPhoneNumber fail, promise: err->${JSON.stringify(err)}`);
});

call.formatPhoneNumberToE164⁷⁺

formatPhoneNumberToE164(phoneNumber: string, countryCode: string, callback: AsyncCallback<string>): void

将电话号码格式化为E.164表示形式，使用callback方式作为异步方法。

需要格式化的电话号码需要与传入国家码相匹配，如中国电话号码需要传入国家码CN，否则格式化后的电话号码为null。

支持所有国家码。

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。
countryCode	string	是	国家码，支持所有国家码，如：中国（CN）。
callback	AsyncCallback<string>	是	回调函数，返回将电话号码格式化为E.164表示形式的结果。

示例：

call.formatPhoneNumberToE164("138xxxxxxxx",{
    countryCode: "CN"
}, (err, data) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.formatPhoneNumberToE164⁷⁺

formatPhoneNumberToE164(phoneNumber: string, countryCode: string): Promise<string>

将电话号码格式化为E.164表示形式，使用promise方式作为异步方法。

需要格式化的电话号码需要与传入国家码相匹配，如中国电话号码需要传入国家码CN，否则格式化后的电话号码为null。

支持所有国家码。

系统能力：SystemCapability.Telephony.CallManager

参数：

参数名	类型	必填	说明
phoneNumber	string	是	电话号码。
countryCode	string	是	国家码，支持所有国家码，如：中国（CN）。

返回值：

类型	说明
Promise<string>	以Promise形式异步返回将电话号码格式化为E.164表示形式的结果。

示例：

let promise = call.formatPhoneNumberToE164("138xxxxxxxx", {
    countryCode: "CN"
});
promise.then(data => {
    console.log(`formatPhoneNumberToE164 success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
    console.error(`formatPhoneNumberToE164 fail, promise: err->${JSON.stringify(err)}`);
});

DialOptions

拨打电话的可选参数。

系统能力：以下各项对应的系统能力均为SystemCapability.Telephony.CallManager。

参数名	类型	必填	说明
extras	boolean	否	根据extras的值判断是否为视频通话，默认为语音通话。 - true：视频通话。 - false：语音通话。

CallState

通话状态码。

系统能力：以下各项对应的系统能力均为SystemCapability.Telephony.CallManager。

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

EmergencyNumberOptions⁷⁺

判断是否是紧急电话号码的可选参数。

系统能力：以下各项对应的系统能力均为SystemCapability.Telephony.CallManager。

参数名	类型	必填	说明
slotId	number	否	卡槽ID： - 0：卡槽1。 - 1：卡槽2。

NumberFormatOptions⁷⁺

格式化号码的可选参数。

系统能力：以下各项对应的系统能力均为SystemCapability.Telephony.CallManager。

参数名	类型	必填	说明
countryCode	string	否	国家码，支持所有国家的国家码，如：中国（CN）。默认为：CN。

拨打电话

导入模块

call.dial

call.dial

call.dial

call.makeCall7+

call.makeCall7+

call.hasCall

call.hasCall

call.getCallState

call.getCallState

call.hasVoiceCapability7+

call.isEmergencyPhoneNumber7+

call.isEmergencyPhoneNumber7+

call.isEmergencyPhoneNumber7+

call.formatPhoneNumber7+

call.formatPhoneNumber7+

call.formatPhoneNumber7+

call.formatPhoneNumberToE1647+

call.formatPhoneNumberToE1647+

DialOptions

CallState

EmergencyNumberOptions7+

NumberFormatOptions7+

call.makeCall⁷⁺

call.makeCall⁷⁺

call.hasVoiceCapability⁷⁺

call.isEmergencyPhoneNumber⁷⁺

call.isEmergencyPhoneNumber⁷⁺

call.isEmergencyPhoneNumber⁷⁺

call.formatPhoneNumber⁷⁺

call.formatPhoneNumber⁷⁺

call.formatPhoneNumber⁷⁺

call.formatPhoneNumberToE164⁷⁺

call.formatPhoneNumberToE164⁷⁺

EmergencyNumberOptions⁷⁺

NumberFormatOptions⁷⁺