撥打電話

call模塊提供呼叫管理功能，包括撥打電話、跳轉(zhuǎn)到撥號界面、獲取通話狀態(tài)、格式化電話號碼等。

如需訂閱通話狀態(tài)請使用[observer.on('callStateChange')]

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]點(diǎn)擊或者復(fù)制轉(zhuǎn)到。
本模塊首批接口從API version 6開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

導(dǎo)入模塊

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

call.dial

dial(phoneNumber: string, callback: AsyncCallback): void

撥打電話。使用callback異步回調(diào)。

需要權(quán)限 ：ohos.permission.PLACE_CALL，該權(quán)限為系統(tǒng)權(quán)限

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

示例：

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): void

撥打電話，可設(shè)置通話參數(shù)。使用callback異步回調(diào)。

需要權(quán)限 ：ohos.permission.PLACE_CALL，該權(quán)限為系統(tǒng)權(quán)限

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

示例：

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

撥打電話，可設(shè)置通話參數(shù)。使用Promise異步回調(diào)。

需要權(quán)限 ：ohos.permission.PLACE_CALL，該權(quán)限為系統(tǒng)權(quán)限

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

返回值：

示例：

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.makeCall7+

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

跳轉(zhuǎn)到撥號界面，并顯示待撥出的號碼。使用callback異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.Applications.Contacts

參數(shù)：

示例：

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

call.makeCall7+

makeCall(phoneNumber: string): Promise

跳轉(zhuǎn)到撥號界面，并顯示待撥出的號碼。使用Promise異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.Applications.Contacts

參數(shù)：

返回值：

示例：

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): void

判斷是否存在通話。使用callback異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

示例：

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

call.hasCall

hasCall(): Promise

判斷是否存在通話。使用Promise異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

返回值：

示例：

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): void

獲取當(dāng)前通話狀態(tài)。使用callback異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

示例：

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

call.getCallState

getCallState(): Promise

獲取當(dāng)前通話狀態(tài)。使用Promise異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

返回值：

示例：

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.hasVoiceCapability7+

hasVoiceCapability(): boolean

檢查當(dāng)前設(shè)備是否具備語音通話能力。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

返回值：

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

call.isEmergencyPhoneNumber7+

isEmergencyPhoneNumber(phoneNumber: string, callback: AsyncCallback): void

判斷是否是緊急電話號碼。使用callback異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

示例：

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

call.isEmergencyPhoneNumber7+

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

根據(jù)電話號碼參數(shù)，判斷是否是緊急電話號碼。使用callback異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

示例：

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

call.isEmergencyPhoneNumber7+

isEmergencyPhoneNumber(phoneNumber: string, options?: EmergencyNumberOptions): Promise

根據(jù)電話號碼參數(shù)，判斷是否是緊急電話號碼。使用Promise異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

返回值：

示例：

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.formatPhoneNumber7+

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

格式化電話號碼。使用callback異步回調(diào)。

電話號碼格式化后為標(biāo)準(zhǔn)數(shù)字字串，例如：“138 xxxx xxxx”、“0755 xxxx xxxx”。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

示例：

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

call.formatPhoneNumber7+

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

格式化電話號碼，可設(shè)置格式化參數(shù)。使用callback異步回調(diào)。

電話號碼格式化后為標(biāo)準(zhǔn)數(shù)字字串，例如：“138 xxxx xxxx”、“0755 xxxx xxxx”。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

示例：

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

call.formatPhoneNumber7+

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

格式化電話號碼，可設(shè)置格式化參數(shù)。使用Promise異步回調(diào)。

電話號碼格式化后為標(biāo)準(zhǔn)數(shù)字字串，例如：”138 xxxx xxxx“、”0755 xxxx xxxx“。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

返回值：

示例：

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.formatPhoneNumberToE1647+

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

將電話號碼格式化為E.164表示形式。使用callback異步回調(diào)。

待格式化的電話號碼需要與傳入的國家碼相匹配，如中國電話號碼需要傳入國家碼CN，否則格式化后的電話號碼為null。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

示例：

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

call.formatPhoneNumberToE1647+

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

將電話號碼格式化為E.164表示形式。使用Promise異步回調(diào)。

待格式化的電話號碼需要與傳入的國家碼相匹配，如中國電話號碼需要傳入國家碼CN，否則格式化后的電話號碼為null。

支持所有國家碼。

系統(tǒng)能力 ：SystemCapability.Telephony.CallManager

參數(shù)：

返回值：

示例：

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

撥打電話的可選參數(shù)。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.CallManager。

CallState

通話狀態(tài)碼。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.CallManager。

EmergencyNumberOptions7+

判斷是否是緊急電話號碼的可選參數(shù)。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.CallManager。

NumberFormatOptions7+

格式化號碼的可選參數(shù)。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.CallManager。