@ohos.telephony.call (Call)

The call module provides call management functions, including making calls, redirecting to the dial screen, obtaining the call status, and formatting phone numbers.

To subscribe to call status changes, use observer.on('callStateChange').

NOTE

The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

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

call.dialCall⁹⁺

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

Initiates a call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required Permissions: ohos.permission.PLACE_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300005	Airplane mode is on.
8300006	Network not in service.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.dialCall⁹⁺

dialCall(phoneNumber: string, options: DialCallOptions, callback: AsyncCallback<void>): void

Initiates a call. You can set call options as needed. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required Permissions: ohos.permission.PLACE_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
options	DialCallOptions	Yes	Call options, which carry other configuration information of the call.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300005	Airplane mode is on.
8300006	Network not in service.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let dialCallOptions: call.DialCallOptions = {
    accountId: 0,
    videoState: 0,
    dialScene: 0,
    dialType: 0,
}
call.dialCall("138xxxxxxxx", dialCallOptions, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.dialCall⁹⁺

dialCall(phoneNumber: string, options?: DialCallOptions): Promise<void>

Initiates a call. You can set call options as needed. This API uses a promise to return the result.

System API: This is a system API.

Required Permissions: ohos.permission.PLACE_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
options	DialCallOptions	No	Call options, which carry other configuration information of the call. If this field is not set, the following configuration is used by default. For details, see DialCallOptions. - accountId: 0 (card slot 1) - videoState: voice call - dialScene: common call - dialType: carrier call

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300005	Airplane mode is on.
8300006	Network not in service.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let dialCallOptions: call.DialCallOptions = {
    accountId: 0,
    videoState: 0,
    dialScene: 0,
    dialType: 0,
}
call.dialCall("138xxxxxxxx", dialCallOptions).then(() => {
    console.log(`dialCall success.`);
}).catch((err: BusinessError) => {
    console.error(`dialCall fail, promise: err->${JSON.stringify(err)}`);
});

call.dial^(deprecated)

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

Initiates a call. This API uses an asynchronous callback to return the result.

NOTE

This API is supported since API version 6 and deprecated since API version 9. You are advised to use dialCall. The substitute API is available only for system applications.

Required Permissions: ohos.permission.PLACE_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
callback	AsyncCallback<boolean>	Yes	Callback used to return the result. The value true indicates that the operation is successful, and the value false indicates the opposite.

Example

import { BusinessError } from '@ohos.base';

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

call.dial^(deprecated)

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

Initiates a call. You can set call options as needed. This API uses an asynchronous callback to return the result.

NOTE

This API is supported since API version 6 and deprecated since API version 9. You are advised to use dialCall. The substitute API is available only for system applications.

Required Permissions: ohos.permission.PLACE_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
options	DialOptions	Yes	Call option, which indicates whether the call is a voice call or video call.
callback	AsyncCallback<boolean>	Yes	Callback used to return the result. The value true indicates that the operation is successful, and the value false indicates the opposite.

Example

import { BusinessError } from '@ohos.base';

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

call.dial^(deprecated)

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

Initiates a call. You can set call options as needed. This API uses a promise to return the result.

NOTE

This API is supported since API version 6 and deprecated since API version 9. You are advised to use dialCall. The substitute API is available only for system applications.

Required Permissions: ohos.permission.PLACE_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
options	DialOptions	No	Call option, which indicates whether the call is a voice call or video call.

Return value

Type	Description
Promise<boolean>	Promise used to return the result. The value true indicates that the operation is successful, and the value false indicates the opposite.

Example

import { BusinessError } from '@ohos.base';

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

call.makeCall⁷⁺

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

Launches the call screen and displays the dialed number. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Applications.Contacts

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.makeCall⁷⁺

makeCall(phoneNumber: string): Promise<void>

Launches the call screen and displays the dialed number. This API uses a promise to return the result.

System capability: SystemCapability.Applications.Contacts

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.hasCall

hasCall(callback: AsyncCallback<boolean>): void

Checks whether a call is in progress. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<boolean>	Yes	Callback used to return the result. The value true indicates that a call is in progress, and the value false indicates the opposite.

Example

import { BusinessError } from '@ohos.base';

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

call.hasCall

hasCall(): Promise<boolean>

Checks whether a call is in progress. This API uses a promise to return the result.

System capability: SystemCapability.Telephony.CallManager

Return value

Type	Description
Promise<boolean>	Promise used to return the result.

Example

import { BusinessError } from '@ohos.base';

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

call.hasCallSync¹⁰⁺

hasCallSync(): boolean

Checks whether a call is in progress.

System capability: SystemCapability.Telephony.CallManager

Return value

Type	Description
boolean	Promise used to return the result.

Example

let hasCall: boolean = call.hasCallSync();
console.log(`hasCallSync success, has call is ` + hasCall);

call.getCallState

getCallState(callback: AsyncCallback<CallState>): void

Obtains the call status. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<CallState>	Yes	Callback used to return the result.

Example

import { BusinessError } from '@ohos.base';

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

call.getCallState

getCallState(): Promise<CallState>

Obtains the call status. This API uses a promise to return the result.

System capability: SystemCapability.Telephony.CallManager

Return value

Type	Description
Promise<CallState>	Promise used to return the result.

Example

import { BusinessError } from '@ohos.base';

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

call.getCallStateSync¹⁰⁺

getCallStateSync(): CallState

Obtains the call status.

System capability: SystemCapability.Telephony.CallManager

Return value

Type	Description
CallState	Promise used to return the result.

Example

let callState: call.CallState = call.getCallStateSync();
console.log(`the call state is:` + callState);

call.hasVoiceCapability⁷⁺

hasVoiceCapability(): boolean

Checks whether a device supports voice calls.

System capability: SystemCapability.Telephony.CallManager

Return value

Type	Description
boolean	Result indicating whether the device supports voice calls. The value true indicates yes, and the value false indicates no.

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

call.isEmergencyPhoneNumber⁷⁺

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

Checks whether the called number is an emergency number. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
callback	AsyncCallback<boolean>	Yes	Callback used to return the result. The value true indicates that the called number is an emergency number, and the value false indicates the opposite.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.isEmergencyPhoneNumber⁷⁺

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

Checks whether the called number is an emergency number based on the phone number. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
options	EmergencyNumberOptions	Yes	Emergency number options.
callback	AsyncCallback<boolean>	Yes	Callback used to return the result. The value true indicates that the called number is an emergency number, and the value false indicates the opposite.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.isEmergencyPhoneNumber⁷⁺

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

Checks whether the called number is an emergency number based on the phone number. This API uses a promise to return the result.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
options	EmergencyNumberOptions	No	Emergency number options.

Return value

Type	Description
Promise<boolean>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.formatPhoneNumber⁷⁺

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

Formats a phone number. This API uses an asynchronous callback to return the result.

A formatted phone number is a standard numeric string, for example, 555 0100.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
callback	AsyncCallback<string>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.formatPhoneNumber⁷⁺

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

Formats a phone number based on specified formatting options. This API uses an asynchronous callback to return the result.

A formatted phone number is a standard numeric string, for example, 555 0100.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
options	NumberFormatOptions	Yes	Number formatting options, for example, country code.
callback	AsyncCallback<string>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.formatPhoneNumber⁷⁺

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

Formats a phone number based on specified formatting options. This API uses a promise to return the result.

A formatted phone number is a standard numeric string, for example, 555 0100.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
options	NumberFormatOptions	No	Number formatting options, for example, country code.

Return value

Type	Description
Promise<string>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.formatPhoneNumberToE164⁷⁺

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

Converts a phone number into the E.164 format. This API uses an asynchronous callback to return the result.

The phone number must match the specified country code. For example, for a China phone number, the country code must be CN. Otherwise, null will be returned.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
countryCode	string	Yes	Country code, for example, CN (China). All country codes are supported.
callback	AsyncCallback<string>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.formatPhoneNumberToE164⁷⁺

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

Converts a phone number into the E.164 format. This API uses a promise to return the result.

The phone number must match the specified country code. For example, for a China phone number, the country code must be CN. Otherwise, null will be returned.

All country codes are supported.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
phoneNumber	string	Yes	Phone number.
countryCode	string	Yes	Country code, for example, CN (China). All country codes are supported.

Return value

Type	Description
Promise<string>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.muteRinger⁸⁺

muteRinger(callback: AsyncCallback<void>): void

Mutes the ringtone while it is playing. It does not work if the ringtone has been muted. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

call.muteRinger((err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.muteRinger⁸⁺

muteRinger(): Promise<void>

Mutes the ringtone while it is playing. It does not work if the ringtone has been muted. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.answerCall⁹⁺

answerCall(callId: number, callback: AsyncCallback<void>): void

Answers a call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID. You can obtain the value by subscribing to callDetailsChange events.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.answerCall⁹⁺

answerCall(callId?: number): Promise<void>

Answers a call. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	No	Call ID. You can obtain the value by subscribing to callDetailsChange events. This field is optional from API version 9. If this field is not set, the latest ringing call will be connected.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.answerCall⁹⁺

answerCall(callback: AsyncCallback<void>): void

Answers a call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

call.answerCall((err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.hangUpCall⁹⁺

hangUpCall(callId: number, callback: AsyncCallback<void>): void

Ends a call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID. You can obtain the value by subscribing to callDetailsChange events.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.hangUpCall⁹⁺

hangUpCall(callId?: number): Promise<void>

Ends a call. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	No	Call ID. You can obtain the value by subscribing to callDetailsChange events. This field is optional from API version 9. If this field is not set, the latest ongoing, dialed, or connected call will be ended.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.hangUpCall⁹⁺

hangUpCall(callback: AsyncCallback<void>): void

Ends a call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

call.hangUpCall((err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.rejectCall⁹⁺

rejectCall(callId: number, callback: AsyncCallback<void>): void

Rejects a call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID. You can obtain the value by subscribing to callDetailsChange events.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.rejectCall⁹⁺

rejectCall(callId: number, options: RejectMessageOptions, callback: AsyncCallback<void>): void

Rejects a call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID. You can obtain the value by subscribing to callDetailsChange events.
options	RejectMessageOptions	Yes	Options for the call rejection message.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let rejectMessageOptions : call.RejectMessageOptions = {
    messageContent: "Unknown number blocked"
}
call.rejectCall(1, rejectMessageOptions, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.rejectCall⁹⁺

rejectCall(callId?: number, options?: RejectMessageOptions): Promise<void>

Rejects a call. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	No	Call ID. You can obtain the value by subscribing to callDetailsChange events. This field is optional from API version 9. If this field is not set, the latest ringing call will be rejected.
options	RejectMessageOptions	No	Options for the call rejection message. If this field is not set, no call rejection message will be sent.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let rejectMessageOptions: call.RejectMessageOptions = {
    messageContent: "Unknown number blocked"
}
call.rejectCall(1, rejectMessageOptions).then(() => {
    console.log(`rejectCall success.`);
}).catch((err: BusinessError) => {
    console.error(`rejectCall fail, promise: err->${JSON.stringify(err)}`);
});

call.rejectCall⁹⁺

rejectCall(callback: AsyncCallback<void>): void

Rejects a call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

call.rejectCall((err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.rejectCall⁹⁺

rejectCall(options: RejectMessageOptions, callback: AsyncCallback<void>): void

Rejects a call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
options	RejectMessageOptions	Yes	Options for the call rejection message.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let rejectMessageOptions: call.RejectMessageOptions = {
    messageContent: "Unknown number blocked"
}
call.rejectCall(rejectMessageOptions, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.holdCall⁷⁺

holdCall(callId: number, callback: AsyncCallback<void>): void

Holds a call based on the specified call ID. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.holdCall⁷⁺

holdCall(callId: number): Promise<void>

Holds a call based on the specified call ID. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.unHoldCall⁷⁺

unHoldCall(callId: number, callback: AsyncCallback<void>): void

Unholds a call based on the specified call ID. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.unHoldCall⁷⁺

unHoldCall(callId: number): Promise<void>

Unholds a call based on the specified call ID. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.switchCall⁷⁺

switchCall(callId: number, callback: AsyncCallback<void>): void

Switches a call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.switchCall⁷⁺

switchCall(callId: number): Promise<void>

Switches a call. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.ANSWER_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.combineConference⁷⁺

combineConference(callId: number, callback: AsyncCallback<void>): void

Combines two calls into a conference call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

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

call.combineConference⁷⁺

combineConference(callId: number): Promise<void>

Combines two calls into a conference call. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

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

call.kickOutFromConference¹⁰⁺

kickOutFromConference(callId: number, callback: AsyncCallback<void>): void

Removes a specified call from a conference call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required Permissions: ohos.permission.PLACE_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.kickOutFromConference¹⁰⁺

kickOutFromConference(callId: number): Promise<void>

Removes a specified call from a conference call. This API uses a promise to return the result.

System API: This is a system API.

Required Permissions: ohos.permission.PLACE_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.getMainCallId⁷⁺

getMainCallId(callId: number, callback: AsyncCallback<number>): void

Obtains the main call ID. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
callback	AsyncCallback<number>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

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

call.getMainCallId⁷⁺

getMainCallId(callId: number): Promise<number>

Obtains the main call ID. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.

Return value

Type	Description
Promise<number>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

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

call.getSubCallIdList⁷⁺

getSubCallIdList(callId: number, callback: AsyncCallback<Array<string>>): void

Obtains the list of subcall IDs. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
callback	AsyncCallback<Array<string>>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.getSubCallIdList(1, (err: BusinessError, data: Array<string>) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.getSubCallIdList⁷⁺

getSubCallIdList(callId: number): Promise<Array<string>>

Obtains the list of subcall IDs. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.

Return value

Type	Description
Promise<Array<string>>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.getSubCallIdList(1).then((data: Array<string>) => {
    console.log(`getSubCallIdList success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getSubCallIdList fail, promise: err->${JSON.stringify(err)}`);
});

call.getCallIdListForConference⁷⁺

getCallIdListForConference(callId: number, callback: AsyncCallback<Array<string>>): void

Obtains the list of call IDs in a conference. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
callback	AsyncCallback<Array<string>>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.getCallIdListForConference(1, (err: BusinessError, data: Array<string>) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.getCallIdListForConference⁷⁺

getCallIdListForConference(callId: number): Promise<Array<string>>

Obtains the list of call IDs in a conference. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.

Return value

Type	Description
Promise<Array<string>>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.getCallIdListForConference(1).then((data: Array<string>) => {
    console.log(`getCallIdListForConference success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getCallIdListForConference fail, promise: err->${JSON.stringify(err)}`);
});

call.getCallWaitingStatus⁷⁺

getCallWaitingStatus(slotId: number, callback: AsyncCallback<CallWaitingStatus>): void

Obtains the call waiting status. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.GET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
callback	AsyncCallback<CallWaitingStatus>	Yes	Callback used to return the result. The value can be: - 0: Call waiting is disabled. - 1: Call waiting is enabled.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

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

call.getCallWaitingStatus⁷⁺

getCallWaitingStatus(slotId: number): Promise<CallWaitingStatus>

Obtains the call waiting status. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.GET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2

Return value

Type	Description
Promise<CallWaitingStatus>	Promise used to return the result. - 0: Call waiting is disabled. - 1: Call waiting is enabled.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

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

call.setCallWaiting⁷⁺

setCallWaiting(slotId: number, activate: boolean, callback: AsyncCallback<void>): void

Specifies whether to enable the call waiting service. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
activate	boolean	Yes	Whether to enable call waiting. - false: Disable call waiting. - true: Enable call waiting.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.setCallWaiting(0, true, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.setCallWaiting⁷⁺

setCallWaiting(slotId: number, activate: boolean): Promise<void>

Specifies whether to enable the call waiting service. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
activate	boolean	Yes	Whether to enable call waiting. - false: Disable call waiting. - true: Enable call waiting.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.setCallWaiting(0, true).then(() => {
    console.log(`setCallWaiting success.`);
}).catch((err: BusinessError) => {
    console.error(`setCallWaiting fail, promise: err->${JSON.stringify(err)}`);
});

call.startDTMF⁷⁺

startDTMF(callId: number, character: string, callback: AsyncCallback<void>): void

Starts playing DTMF tones. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
character	string	Yes	DTMF string.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.startDTMF(1, "0", (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.startDTMF⁷⁺

startDTMF(callId: number, character: string): Promise<void>

Starts playing DTMF tones. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
character	string	Yes	DTMF string.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.startDTMF(1, "0").then(() => {
    console.log(`startDTMF success.`);
}).catch((err: BusinessError) => {
    console.error(`startDTMF fail, promise: err->${JSON.stringify(err)}`);
});

call.stopDTMF⁷⁺

stopDTMF(callId: number, callback: AsyncCallback<void>): void

Stops playing DTMF tones. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

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

call.stopDTMF⁷⁺

stopDTMF(callId: number): Promise<void>

Stops playing DTMF tones. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

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

call.postDialProceed¹¹⁺

postDialProceed(callId: number, proceed: boolean, callback: AsyncCallback<void>): void

Continues a call by playing a post-dial DTMF string. This API uses an asynchronous callback to return the result.

If the called number is in the format of "common phone number + semicolon (;) + DTMF string", for example, 400xxxxxxx;123, and the listening for postDialDelay events is enabled, the system reports a postDialDelay event when the call is connected. The application can then call this API to send DTMF tones.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
proceed	boolean	Yes	Whether to send DTMF tones.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.postDialProceed(1, true, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.postDialProceed¹¹⁺

postDialProceed(callId: number, proceed: boolean): Promise<void>

Continues a call by playing a post-dial DTMF string. This API uses a promise to return the result.

If the called number is in the format of "common phone number + semicolon (;) + DTMF string", for example, 400xxxxxxx;123, and the listening for postDialDelay events is enabled, the system reports a postDialDelay event when the call is connected. The application can then call this API to send DTMF tones.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
proceed	boolean	Yes	Whether to send DTMF tones.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.postDialProceed(1, true).then(() => {
    console.log(`postDialProceed success.`);
}).catch((err: BusinessError) => {
    console.error(`postDialProceed fail, promise: err->${JSON.stringify(err)}`);
});

call.isInEmergencyCall⁷⁺

isInEmergencyCall(callback: AsyncCallback<boolean>): void

Checks whether a call is an emergency call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<boolean>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.isInEmergencyCall⁷⁺

isInEmergencyCall(): Promise<boolean>

Checks whether a call is an emergency call. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Return value

Type	Description
Promise<boolean>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.on('callDetailsChange')⁷⁺

on(type: 'callDetailsChange', callback: Callback<CallAttributeOptions>): void

Subscribes to callDetailsChange events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Call event change. This field has a fixed value of callDetailsChange.
callback	Callback<CallAttributeOptions>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

call.on('callDetailsChange', (data: call.CallAttributeOptions) => {
    console.log(`callback: data->${JSON.stringify(data)}`);
});

call.on('callEventChange')⁸⁺

on(type: 'callEventChange', callback: Callback<CallEventOptions>): void

Subscribes to callEventChange events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Call event change. This field has a fixed value of callEventChange.
callback	Callback<CallEventOptions>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

call.on('callEventChange', (data: call.CallEventOptions) => {
    console.log(`callback: data->${JSON.stringify(data)}`);
});

call.on('callDisconnectedCause')⁸⁺

on(type: 'callDisconnectedCause', callback: Callback<DisconnectedDetails>): void

Subscribes to callDisconnectedCause events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Call disconnection cause. This field has a fixed value of callDisconnectedCause.
callback	Callback<DisconnectedDetails>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

call.on('callDisconnectedCause', (data: call.DisconnectedDetails) => {
    console.log(`callback: data->${JSON.stringify(data)}`);
});

call.on('mmiCodeResult')⁹⁺

on(type: 'mmiCodeResult', callback: Callback<MmiCodeResults>): void

Subscribes to mmiCodeResult events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	MMI code result. This field has a fixed value of mmiCodeResult.
callback	Callback<MmiCodeResults>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

call.on('mmiCodeResult', (data: call.MmiCodeResults) => {
    console.log(`callback: data->${JSON.stringify(data)}`);
});

call.off('callDetailsChange')⁷⁺

off(type: 'callDetailsChange', callback?: Callback<CallAttributeOptions>): void

Unsubscribes from callDetailsChange events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Call details change. This field has a fixed value of callDetailsChange.
callback	Callback<CallAttributeOptions>	No	Callback used to return the result. If this field is not set, no subscription cancellation result will be received.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

call.off('callDetailsChange', (data: call.CallAttributeOptions) => {
    console.log(`callback: data->${JSON.stringify(data)}`);
});

call.off('callEventChange')⁸⁺

off(type: 'callEventChange', callback?: Callback<CallEventOptions>): void

Unsubscribes from callEventChange events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Call event change. This field has a fixed value of callEventChange.
callback	Callback<CallEventOptions>	No	Callback used to return the result. If this field is not set, no subscription cancellation result will be received.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

call.off('callEventChange', (data: call.CallEventOptions) => {
    console.log(`callback: data->${JSON.stringify(data)}`);
});

call.off('callDisconnectedCause')⁸⁺

off(type: 'callDisconnectedCause', callback?: Callback<DisconnectedDetails>): void

Unsubscribes from callDisconnectedCause events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Call disconnection cause. This field has a fixed value of callDisconnectedCause.
callback	Callback<DisconnectedDetails>	No	Callback used to return the result. If this field is not set, no subscription cancellation result will be received.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

call.off('callDisconnectedCause', (data: call.DisconnectedDetails) => {
    console.log(`callback: data->${JSON.stringify(data)}`);
});

call.off('mmiCodeResult')⁹⁺

off(type: 'mmiCodeResult', callback?: Callback<MmiCodeResults>): void

Unsubscribes from mmiCodeResult events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	MMI code result. This field has a fixed value of mmiCodeResult.
callback	Callback<MmiCodeResults>	No	Callback used to return the result. If this field is not set, no subscription cancellation result will be received.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

call.off('mmiCodeResult', (data: call.MmiCodeResults) => {
    console.log(`callback: data->${JSON.stringify(data)}`);
});

call.on('audioDeviceChange')¹⁰⁺

on(type: 'audioDeviceChange', callback: Callback<AudioDeviceCallbackInfo>): void

Subscribes to audio device change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Audio device change. This field has a fixed value of audioDeviceChange.
callback	Callback<AudioDeviceCallbackInfo>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

call.on('audioDeviceChange', (data: call.AudioDeviceCallbackInfo) => {
    console.log(`callback: data->${JSON.stringify(data)}`);
});

call.off('audioDeviceChange')¹⁰⁺

off(type: 'audioDeviceChange', callback?: Callback<AudioDeviceCallbackInfo>): void

Unsubscribes from audioDeviceChange events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Audio device change. This field has a fixed value of audioDeviceChange.
callback	Callback<AudioDeviceCallbackInfo>	No	Callback used to return the result. If this field is not set, no subscription cancellation result will be received.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

call.off('audioDeviceChange', (data: call.AudioDeviceCallbackInfo) => {
    console.log(`callback: data->${JSON.stringify(data)}`);
});

call.on('postDialDelay')¹¹⁺

on(type: 'postDialDelay', callback: Callback<string>): void

Subscribes to postDialDelay events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Post-dial delay. This field has a fixed value of postDialDelay.
callback	Callback<string>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

call.on('postDialDelay', (data: string) => {
    console.log(`callback: data->${JSON.stringify(data)}`);
});

call.off('postDialDelay')¹¹⁺

off(type: 'postDialDelay', callback?: Callback<string>): void

Unsubscribes from postDialDelay events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Post-dial delay. This field has a fixed value of postDialDelay.
callback	Callback<string>	No	Callback used to return the result. If this field is not set, no subscription cancellation result will be received.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

call.off('postDialDelay', (data: string) => {
    console.log(`callback: data->${JSON.stringify(data)}`);
});

call.isNewCallAllowed⁸⁺

isNewCallAllowed(callback: AsyncCallback<boolean>): void

Checks whether a new call is allowed. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<boolean>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.isNewCallAllowed⁸⁺

isNewCallAllowed(): Promise<boolean>

Checks whether a new call is allowed. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Return value

Type	Description
Promise<boolean>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.separateConference⁸⁺

separateConference(callId: number, callback: AsyncCallback<void>): void

Separates calls from a conference call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.separateConference⁸⁺

separateConference(callId: number): Promise<void>

Separates calls from a conference call. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.getCallRestrictionStatus⁸⁺

getCallRestrictionStatus(slotId: number, type: CallRestrictionType, callback: AsyncCallback<RestrictionStatus>): void

Obtains the call restriction status. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.GET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
type	CallRestrictionType	Yes	Call restriction type.
callback	AsyncCallback<RestrictionStatus>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.getCallRestrictionStatus(0, 1, (err: BusinessError, data: call.RestrictionStatus) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.getCallRestrictionStatus⁸⁺

getCallRestrictionStatus(slotId: number, type: CallRestrictionType): Promise<RestrictionStatus>

Obtains the call restriction status. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.GET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
type	CallRestrictionType	Yes	Call restriction type.

Return value

Type	Description
Promise<RestrictionStatus>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.getCallRestrictionStatus(0, 1).then((data: call.RestrictionStatus) => {
    console.log(`getCallRestrictionStatus success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getCallRestrictionStatus fail, promise: err->${JSON.stringify(err)}`);
});

call.setCallRestriction⁸⁺

setCallRestriction(slotId: number, info: CallRestrictionInfo, callback: AsyncCallback<void>): void

Sets the call restriction status. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
info	CallRestrictionInfo	Yes	Call restriction information.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

let callRestrictionInfo: call.CallRestrictionInfo = {
    type: call.CallRestrictionType.RESTRICTION_TYPE_ALL_OUTGOING,
    password: "123456",
    mode: call.CallRestrictionMode.RESTRICTION_MODE_ACTIVATION
}
call.setCallRestriction(0, callRestrictionInfo, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.setCallRestriction⁸⁺

setCallRestriction(slotId: number, info: CallRestrictionInfo): Promise<void>

Sets the call restriction status. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
info	CallRestrictionInfo	Yes	Call restriction information.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

let callRestrictionInfo: call.CallRestrictionInfo = {
    type: call.CallRestrictionType.RESTRICTION_TYPE_ALL_INCOMING,
    password: "123456",
    mode: call.CallRestrictionMode.RESTRICTION_MODE_ACTIVATION
}
call.setCallRestriction(0, callRestrictionInfo).then(() => {
    console.log(`setCallRestriction success.`);
}).catch((err: BusinessError) => {
    console.error(`setCallRestriction fail, promise: err->${JSON.stringify(err)}`);
});

call.setCallRestrictionPassword¹⁰⁺

setCallRestrictionPassword(slotId: number, oldPassword: string, newPassword: string, callback: AsyncCallback<void>): void

Changes the call barring password. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
oldPassword	string	Yes	Old password for call barring.
newPassword	string	Yes	New password for call barring.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.setCallRestrictionPassword(0, "123456", "654321", (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.setCallRestrictionPassword¹⁰⁺

setCallRestrictionPassword(slotId: number, oldPassword: string, newPassword: string): Promise<void>

Changes the call barring password. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
oldPassword	string	Yes	Old password for call barring.
newPassword	string	Yes	New password for call barring.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.setCallRestrictionPassword(0, "123456", "654321").then(() => {
    console.log(`setCallRestrictionPassword success.`);
}).catch((err: BusinessError) => {
    console.error(`setCallRestrictionPassword fail, promise: err->${JSON.stringify(err)}`);
});

call.getCallTransferInfo⁸⁺

getCallTransferInfo(slotId: number, type: CallTransferType, callback: AsyncCallback<CallTransferResult>): void

Obtains call transfer information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.GET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
type	CallTransferType	Yes	Call transfer type.
callback	AsyncCallback<CallTransferResult>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.getCallTransferInfo(0, call.CallTransferType.TRANSFER_TYPE_BUSY, (err: BusinessError, data: call.CallTransferResult) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.getCallTransferInfo⁸⁺

getCallTransferInfo(slotId: number, type: CallTransferType): Promise<CallTransferResult>

Obtains call transfer information. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.GET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
type	CallTransferType	Yes	Call transfer type.

Return value

Type	Description
Promise<CallTransferResult>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.getCallTransferInfo(0, call.CallTransferType.TRANSFER_TYPE_BUSY).then((data: call.CallTransferResult) => {
    console.log(`getCallTransferInfo success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getCallTransferInfo fail, promise: err->${JSON.stringify(err)}`);
});

call.setCallTransfer⁸⁺

setCallTransfer(slotId: number, info: CallTransferInfo, callback: AsyncCallback<void>): void

Sets call transfer information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
info	CallTransferInfo	Yes	Call transfer information.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

let callTransferInfo: call.CallTransferInfo = {
    transferNum: "111",
    type: call.CallTransferType.TRANSFER_TYPE_BUSY,
    settingType: call.CallTransferSettingType.CALL_TRANSFER_ENABLE
}
call.setCallTransfer(0, callTransferInfo, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.setCallTransfer⁸⁺

setCallTransfer(slotId: number, info: CallTransferInfo): Promise<void>

Sets call transfer information. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
info	CallTransferInfo	Yes	Call transfer information.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
801	Capability not supported.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

let callTransferInfo: call.CallTransferInfo = {
    transferNum: "111",
    type: call.CallTransferType.TRANSFER_TYPE_BUSY,
    settingType: call.CallTransferSettingType.CALL_TRANSFER_ENABLE
}
call.setCallTransfer(0, callTransferInfo).then(() => {
    console.log(`setCallTransfer success.`);
}).catch((err: BusinessError) => {
    console.error(`setCallTransfer fail, promise: err->${JSON.stringify(err)}`);
});

call.isRinging⁸⁺

isRinging(callback: AsyncCallback<boolean>): void

Checks whether the ringtone is playing. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<boolean>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.isRinging⁸⁺

isRinging(): Promise<boolean>

Checks whether the ringtone is playing. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Return value

Type	Description
Promise<boolean>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.setMuted⁸⁺

setMuted(callback: AsyncCallback<void>): void

Sets call muting. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

call.setMuted((err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.setMuted⁸⁺

setMuted(): Promise<void>

Sets call muting. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.cancelMuted⁸⁺

cancelMuted(callback: AsyncCallback<void>): void

Cancels call muting. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

call.cancelMuted((err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.cancelMuted⁸⁺

cancelMuted(): Promise<void>

Cancels call muting. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.setAudioDevice⁸⁺

setAudioDevice(device: AudioDevice, callback: AsyncCallback<void>): void

Sets the audio device for a call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
device	AudioDevice	Yes	Audio device.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let audioDevice: call.AudioDevice = {
    deviceType: call.AudioDeviceType.DEVICE_EARPIECE
}
call.setAudioDevice(audioDevice, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.setAudioDevice¹⁰⁺

setAudioDevice(device: AudioDevice): Promise<void>

Sets the audio device for a call. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
device	AudioDevice	Yes	Audio device.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let audioDevice: call.AudioDevice = {
    deviceType: call.AudioDeviceType.DEVICE_EARPIECE
}
call.setAudioDevice(audioDevice).then(() => {
    console.log(`setAudioDevice success.`);
}).catch((err: BusinessError) => {
    console.error(`setAudioDevice fail, promise: err->${JSON.stringify(err)}`);
});

call.joinConference⁸⁺

joinConference(mainCallId: number, callNumberList: Array<string>, callback: AsyncCallback<void>): void

Joins a conference call. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
mainCallId	number	Yes	Main call ID.
callNumberList	Array<string>	Yes	List of call numbers.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let callNumberList: Array<string> = [
    "138XXXXXXXX"
];
call.joinConference(1, callNumberList, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.joinConference⁸⁺

joinConference(mainCallId: number, callNumberList: Array<string>): Promise<void>

Joins a conference call. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
mainCallId	number	Yes	Main call ID.
callNumberList	Array<string>	Yes	List of call numbers.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let callNumberList: Array<string> = [
    "138XXXXXXXX"
];
call.joinConference(1, callNumberList).then(() => {
    console.log(`joinConference success.`);
}).catch((err: BusinessError) => {
    console.error(`joinConference fail, promise: err->${JSON.stringify(err)}`);
});

call.updateImsCallMode⁸⁺

updateImsCallMode(callId: number, mode: ImsCallMode, callback: AsyncCallback<void>): void

Updates the IMS call mode. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
mode	ImsCallMode	Yes	IMS call mode.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.updateImsCallMode⁸⁺

updateImsCallMode(callId: number, mode: ImsCallMode): Promise<void>

Updates the IMS call mode. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callId	number	Yes	Call ID.
mode	ImsCallMode	Yes	IMS call mode.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.enableImsSwitch⁸⁺

enableImsSwitch(slotId: number, callback: AsyncCallback<void>): void

Enables the IMS service. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.enableImsSwitch⁸⁺

enableImsSwitch(slotId: number): Promise<void>

Enables the IMS service. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.disableImsSwitch⁸⁺

disableImsSwitch(slotId: number, callback: AsyncCallback<void>): void

Disables the IMS service. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.disableImsSwitch⁸⁺

disableImsSwitch(slotId: number): Promise<void>

Disables the IMS service. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.isImsSwitchEnabled⁸⁺

isImsSwitchEnabled(slotId: number, callback: AsyncCallback<boolean>): void

Checks whether the IMS service is enabled. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
callback	AsyncCallback<boolean>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.isImsSwitchEnabled⁸⁺

isImsSwitchEnabled(slotId: number): Promise<boolean>

Checks whether the IMS service is enabled. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2

Return value

Type	Description
Promise<boolean>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

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

call.closeUnfinishedUssd¹⁰⁺

closeUnfinishedUssd(slotId: number, callback: AsyncCallback<void>): void

Cancels the unfinished USSD services. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
call.closeUnfinishedUssd(slotId, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.closeUnfinishedUssd¹⁰⁺

closeUnfinishedUssd(slotId: number): Promise<void>

Cancels the unfinished USSD services. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
call.closeUnfinishedUssd(slotId).then(() => {
    console.log(`closeUnfinishedUssd success.`);
}).catch((err: BusinessError) => {
    console.error(`closeUnfinishedUssd fail, promise: err->${JSON.stringify(err)}`);
});

call.setVoNRState¹⁰⁺

setVoNRState(slotId: number, state: VoNRState, callback: AsyncCallback<void>): void

Sets the status of the VoNR switch. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
state	VoNRState	Yes	Status of the VoNR switch.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let state: call.VoNRState = call.VoNRState.VONR_STATE_ON;
call.setVoNRState(slotId, state, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.setVoNRState¹⁰⁺

setVoNRState(slotId: number, state: VoNRState): Promise<void>

Sets the status of the VoNR switch. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
state	VoNRState	Yes	Status of the VoNR switch.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let state: call.VoNRState = call.VoNRState.VONR_STATE_ON;
call.setVoNRState(slotId, state).then(() => {
    console.log(`setVoNRState success`);
}).catch((err: BusinessError) => {
    console.error(`setVoNRState fail, promise: err->${JSON.stringify(err)}`);
});

call.getVoNRState¹⁰⁺

getVoNRState(slotId: number, callback: AsyncCallback<VoNRState>): void

Obtains the status of the VoNR switch. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.GET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
callback	AsyncCallback<VoNRState>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
call.getVoNRState(slotId, (err: BusinessError, data: call.VoNRState) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.getVoNRState¹⁰⁺

getVoNRState(slotId: number): Promise<VoNRState>

Obtains the status of the VoNR switch. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.GET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2

Return value

Type	Description
Promise<VoNRState>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
call.getVoNRState(slotId).then((data: call.VoNRState) => {
    console.log(`getVoNRState success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getVoNRState fail, promise: err->${JSON.stringify(err)}`);
});

call.canSetCallTransferTime¹⁰⁺

canSetCallTransferTime(slotId: number, callback: AsyncCallback<boolean>): void

Checks whether the call forwarding time can be set. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permission: ohos.permission.GET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2
callback	AsyncCallback<boolean>	Yes	Callback used to return the result. The value true indicates that the call forwarding time can be set, and the value false indicates the opposite.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
call.canSetCallTransferTime(slotId, (err: BusinessError, data: boolean) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

call.canSetCallTransferTime¹⁰⁺

canSetCallTransferTime(slotId: number): Promise<boolean>

Checks whether the call forwarding time can be set. This API uses a promise to return the result.

System API: This is a system API.

Required permission: ohos.permission.GET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2

Return value

Type	Description
Promise<boolean>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

let slotId: number = 0;
call.canSetCallTransferTime(slotId).then((data: boolean) => {
    console.log(`canSetCallTransferTime success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`canSetCallTransferTime fail, promise: err->${JSON.stringify(err)}`);
});

call.inputDialerSpecialCode¹⁰⁺

inputDialerSpecialCode(inputCode: string, callback: AsyncCallback<void>): void

Performs a secret code broadcast. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required Permissions: ohos.permission.PLACE_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
inputCode	string	Yes	Secret code, for example, 2846579 (project menu).
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

call.inputDialerSpecialCode('2846579', (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.inputDialerSpecialCode¹⁰⁺

inputDialerSpecialCode(inputCode: string): Promise<void>

Performs a secret code broadcast. This API uses a promise to return the result.

System API: This is a system API.

Required Permissions: ohos.permission.PLACE_CALL

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
inputCode	string	Yes	Secret code, for example, 2846579 (project menu).

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.

Example

import { BusinessError } from '@ohos.base';

try {
    call.inputDialerSpecialCode('2846579');
    console.log(`inputDialerSpecialCode success`);
} catch (error) {
    console.log(`inputDialerSpecialCode fail, promise: err->${JSON.stringify(error)}`);
}

call.removeMissedIncomingCallNotification¹⁰⁺

removeMissedIncomingCallNotification(callback: AsyncCallback<void>): void

Removes missed call notifications. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.SET_TELEPHONY_STATE, ohos.permission.READ_CALL_LOG, and ohos.permission.WRITE_CALL_LOG

System capability: SystemCapability.Telephony.CallManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

call.removeMissedIncomingCallNotification((err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

call.removeMissedIncomingCallNotification¹⁰⁺

removeMissedIncomingCallNotification(): Promise<void>

Removes missed call notifications. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.SET_TELEPHONY_STATE, ohos.permission.READ_CALL_LOG, and ohos.permission.WRITE_CALL_LOG

System capability: SystemCapability.Telephony.CallManager

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

import { BusinessError } from '@ohos.base';

call.removeMissedIncomingCallNotification().then(() => {
    console.log(`removeMissedIncomingCallNotification success`);
}).catch((err: BusinessError) => {
    console.log(`removeMissedIncomingCallNotification failed, promise: err->${JSON.stringify(err)}`);
});

DialOptions

Provides an option for determining whether a call is a video call.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
extras	boolean	No	Whether the call is a video call. - true: video call - false (default): voice call
accountId 8+	number	No	Account ID. - 0: card slot 1 - 1: card slot 2 This is a system API.
videoState 8+	VideoStateType	No	Video state type. This is a system API.
dialScene 8+	DialScene	No	Dialup scenario. This is a system API.
dialType 8+	DialType	No	Dialup type. This is a system API.

DialCallOptions⁹⁺

Provides an option for determining whether a call is a video call.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
accountId 9+	number	No	Account ID. - 0: card slot 1 - 1: card slot 2
videoState 9+	VideoStateType	No	Video state type.
dialScene 9+	DialScene	No	Dialup scenario.
dialType 9+	DialType	No	Dialup type.

CallState

Enumerates call states.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
CALL_STATE_UNKNOWN	-1	The call status fails to be obtained and is unknown.
CALL_STATE_IDLE	0	No call is in progress.
CALL_STATE_RINGING	1	The call is in the ringing or waiting state.
CALL_STATE_OFFHOOK	2	At least one call is in dialing, active, or on hold, and no new incoming call is ringing or waiting.

EmergencyNumberOptions⁷⁺

Provides an option for determining whether a number is an emergency number for the SIM card in the specified slot.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
slotId	number	No	Card slot ID. - 0: card slot 1 - 1: card slot 2

NumberFormatOptions⁷⁺

Provides an option for number formatting.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
countryCode	string	No	Country code, for example, CN (China). All country codes are supported. The default value is CN.

ImsCallMode⁸⁺

Enumerates IMS call modes.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
CALL_MODE_AUDIO_ONLY	0	Audio call only.
CALL_MODE_SEND_ONLY	1	Sending calls only.
CALL_MODE_RECEIVE_ONLY	2	Receiving calls only.
CALL_MODE_SEND_RECEIVE	3	Sending and receiving calls.
CALL_MODE_VIDEO_PAUSED	4	Pausing video calls.

VoNRState¹⁰⁺

Enumerates VoNR switch states.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
VONR_STATE_OFF	0	Disabled.
VONR_STATE_ON	1	Enabled.

AudioDevice¹⁰⁺

Enumerates audio devices.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
deviceType 10+	AudioDeviceType	Yes	Audio device type.
address 10+	string	No	Audio device address.

AudioDeviceType¹⁰⁺

Enumerates audio device types.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
DEVICE_EARPIECE	0	Headset device.
DEVICE_SPEAKER	1	Speaker device.
DEVICE_WIRED_HEADSET	2	Wired headset device.
DEVICE_BLUETOOTH_SCO	3	Bluetooth SCO device.

AudioDeviceCallbackInfo¹⁰⁺

Defines the audio device information.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
audioDeviceList 10+	Array<AudioDevice>	Yes	Audio device list.
currentAudioDevice 10+	AudioDevice	Yes	Current audio device.
isMuted 10+	boolean	Yes	Whether the audio device is muted.

CallRestrictionType⁸⁺

Enumerates call restriction types.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
RESTRICTION_TYPE_ALL_INCOMING	0	Barring of all incoming calls.
RESTRICTION_TYPE_ALL_OUTGOING	1	Barring of all outgoing calls.
RESTRICTION_TYPE_INTERNATIONAL	2	Barring of international calls.
RESTRICTION_TYPE_INTERNATIONAL_EXCLUDING_HOME	3	Barring of international calls except those in the home country.
RESTRICTION_TYPE_ROAMING_INCOMING	4	Barring of incoming roaming calls.
RESTRICTION_TYPE_ALL_CALLS	5	Barring of all calls.
RESTRICTION_TYPE_OUTGOING_SERVICES	6	Barring of outgoing services.
RESTRICTION_TYPE_INCOMING_SERVICES	7	Barring of incoming services.

CallTransferInfo⁸⁺

Defines the call transfer information.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
transferNum	string	Yes	Call transfer number.
type	CallTransferType	Yes	Call transfer type.
settingType	CallTransferSettingType	Yes	Call transfer setting type.
startHour9+	number	No	Hour in the start time.
startMinute9+	number	No	Minute in the start time.
endHour9+	number	No	Minute in the end time.
endMinute9+	number	No	Minute in the end time.

CallTransferType⁸⁺

Enumerates call transfer types.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
TRANSFER_TYPE_UNCONDITIONAL	0	Call forwarding unconditional.
TRANSFER_TYPE_BUSY	1	Call forwarding busy.
TRANSFER_TYPE_NO_REPLY	2	Call forwarding on no reply.
TRANSFER_TYPE_NOT_REACHABLE	3	Call forwarding on no user not reachable.

CallTransferSettingType⁸⁺

Enumerates call transfer setting types.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
CALL_TRANSFER_DISABLE	0	Disabling of call transfer.
CALL_TRANSFER_ENABLE	1	Enabling of call transfer.
CALL_TRANSFER_REGISTRATION	3	Registration of call transfer.
CALL_TRANSFER_ERASURE	4	Erasing of call transfer.

CallAttributeOptions⁷⁺

Defines the call attribute options.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
accountNumber	string	Yes	Account number.
speakerphoneOn	boolean	Yes	Speakerphone on.
accountId	number	Yes	Account ID.
videoState	VideoStateType	Yes	Video state type.
startTime	number	Yes	Start time.
isEcc	boolean	Yes	Whether the call is an ECC.
callType	CallType	Yes	Call type.
callId	number	Yes	Call ID.
callState	DetailedCallState	Yes	Detailed call state.
conferenceState	ConferenceState	Yes	Conference state.

ConferenceState⁷⁺

Enumerates conference states.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
TEL_CONFERENCE_IDLE	0	Idle state.
TEL_CONFERENCE_ACTIVE	1	Active state.
TEL_CONFERENCE_DISCONNECTING	2	Disconnecting state.
TEL_CONFERENCE_DISCONNECTED	3	Disconnected state.

CallType⁷⁺

Enumerates call types.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
TYPE_CS	0	CS call.
TYPE_IMS	1	IMS call.
TYPE_OTT	2	OTT call.
TYPE_ERR_CALL	3	Error call type.

VideoStateType⁷⁺

Video state type.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
TYPE_VOICE	0	Voice state.
TYPE_VIDEO	1	Video state.

DetailedCallState⁷⁺

Enumerates detailed call states.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
CALL_STATUS_ACTIVE	0	Active state.
CALL_STATUS_HOLDING	1	Hold state.
CALL_STATUS_DIALING	2	Dialing state.
CALL_STATUS_ALERTING	3	Alerting state.
CALL_STATUS_INCOMING	4	Incoming state.
CALL_STATUS_WAITING	5	Waiting state.
CALL_STATUS_DISCONNECTED	6	Disconnected state.
CALL_STATUS_DISCONNECTING	7	Disconnecting state.
CALL_STATUS_IDLE	8	Idle state.

CallRestrictionInfo⁸⁺

Defines the call restriction information.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
type	CallRestrictionType	Yes	Call restriction type.
password	string	Yes	Password.
mode	CallRestrictionMode	Yes	Call restriction mode.

CallRestrictionMode⁸⁺

Enumerates call restriction modes.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
RESTRICTION_MODE_DEACTIVATION	0	Call restriction deactivated.
RESTRICTION_MODE_ACTIVATION	1	Call restriction activated.

CallEventOptions⁸⁺

Defines the call event options.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
eventId	CallAbilityEventId	Yes	Call ability event ID.

CallAbilityEventId⁸⁺

Enumerates call ability event IDs.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
EVENT_DIAL_NO_CARRIER	1	No available carrier during dialing.
EVENT_INVALID_FDN_NUMBER	2	Invalid FDN.
EVENT_HOLD_CALL_FAILED11+	3	Failed to place the call on hold.
EVENT_SWAP_CALL_FAILED11+	4	Failed to place the current call on hold and answer the waiting call.

DialScene⁸⁺

Enumerates dialup scenarios.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
CALL_NORMAL	0	Common call.
CALL_PRIVILEGED	1	Privileged call.
CALL_EMERGENCY	2	Emergency call.

DialType⁸⁺

Enumerates dialup types.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
DIAL_CARRIER_TYPE	0	Carrier.
DIAL_VOICE_MAIL_TYPE	1	Voice mail.
DIAL_OTT_TYPE	2	OTT.

RejectMessageOptions⁷⁺

Defines options for the call rejection message.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
messageContent	string	Yes	Message content.

CallTransferResult⁸⁺

Defines the call transfer result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
status	TransferStatus	Yes	Call transfer status.
number	string	Yes	Call transfer number.
startHour9+	number	Yes	Hour in the start time.
startMinute9+	number	Yes	Minute in the start time.
endHour9+	number	Yes	Minute in the end time.
endMinute9+	number	Yes	Minute in the end time.

CallWaitingStatus⁷⁺

Enumerates call waiting states.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
CALL_WAITING_DISABLE	0	Call waiting disabled.
CALL_WAITING_ENABLE	1	Call waiting enabled.

RestrictionStatus⁸⁺

Enumerates call restriction states.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
RESTRICTION_DISABLE	0	Call restriction disabled.
RESTRICTION_ENABLE	1	Call restriction enabled.

TransferStatus⁸⁺

Enumerates call transfer states.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
TRANSFER_DISABLE	0	Call transfer disabled.
TRANSFER_ENABLE	1	Call transfer enabled.

DisconnectedDetails⁹⁺

Defines the call disconnection cause.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
reason	DisconnectedReason	Yes	Call disconnection cause.
message	string	Yes	Call ending message.

DisconnectedReason⁸⁺

Enumerates call disconnection causes.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
UNASSIGNED_NUMBER	1	Unallocated (unassigned) number.
NO_ROUTE_TO_DESTINATION	3	No route to destination.
CHANNEL_UNACCEPTABLE	6	Channel unacceptable.
OPERATOR_DETERMINED_BARRING	8	Operator determined barring (ODB).
CALL_COMPLETED_ELSEWHERE9+	13	Call completed elsewhere.
NORMAL_CALL_CLEARING	16	Normal call clearing.
USER_BUSY	17	User busy.
NO_USER_RESPONDING	18	No user responding.
USER_ALERTING_NO_ANSWER	19	User alerting, no answer.
CALL_REJECTED	21	Call rejected.
NUMBER_CHANGED	22	Number changed.
CALL_REJECTED_DUE_TO_FEATURE_AT_THE_DESTINATION9+	24	Call rejected due to feature at the destination.
FAILED_PRE_EMPTION9+	25	Failed preemption.
NON_SELECTED_USER_CLEARING9+	26	Non-selected user clearing.
DESTINATION_OUT_OF_ORDER	27	Destination out of order.
INVALID_NUMBER_FORMAT	28	Invalid number format (incomplete number).
FACILITY_REJECTED9+	29	Facility rejected.
RESPONSE_TO_STATUS_ENQUIRY9+	30	Response to status enquiry.
NORMAL_UNSPECIFIED9+	31	Normal, unspecified.
NO_CIRCUIT_CHANNEL_AVAILABLE9+	34	No circuit/channel available.
NETWORK_OUT_OF_ORDER	38	Network fault.
TEMPORARY_FAILURE	41	Temporary failure.
SWITCHING_EQUIPMENT_CONGESTION9+	42	Switching equipment congestion.
ACCESS_INFORMATION_DISCARDED9+	43	Access information discarded.
REQUEST_CIRCUIT_CHANNEL_NOT_AVAILABLE9+	44	Requested circuit/channel unavailable
RESOURCES_UNAVAILABLE_UNSPECIFIED9+	47	Resources unavailable, unspecified.
QUALITY_OF_SERVICE_UNAVAILABLE9+	49	QoS unavailable.
REQUESTED_FACILITY_NOT_SUBSCRIBED9+	50	Requested facility not subscribed.
INCOMING_CALLS_BARRED_WITHIN_THE_CUG9+	55	Incoming calls barred within the CUG.
BEARER_CAPABILITY_NOT_AUTHORIZED9+	57	Bearer capability not authorized.
BEARER_CAPABILITY_NOT_PRESENTLY_AVAILABLE9+	58	Bearer capability presently available.
SERVICE_OR_OPTION_NOT_AVAILABLE_UNSPECIFIED9+	63	Service or option not available, unspecified.
BEARER_SERVICE_NOT_IMPLEMENTED9+	65	Bearer service not implemented.
ACM_EQUALTO_OR_GREATER_THAN_THE_MAXIMUM_VALUE9+	68	ACM greater than or equal to the maximum value.
REQUESTED_FACILITY_NOT_IMPLEMENTED9+	69	Requested facility not implemented.
ONLY_RESTRICTED_DIGITAL_INFO_BEARER_CAPABILITY_IS_AVAILABLE9+	70	Only restricted digital information bearer capability available.
SERVICE_OR_OPTION_NOT_IMPLEMENTED_UNSPECIFIED9+	79	Service or option not implemented, unspecified.
INVALID_TRANSACTION_IDENTIFIER_VALUE9+	81	Invalid transaction identifier value.
USER_NOT_MEMBER_OF_CUG9+	87	User not member of CUG.
INCOMPATIBLE_DESTINATION9+	88	Incompatible destination.
INVALID_TRANSIT_NETWORK_SELECTION9+	91	Invalid transit network selection.
SEMANTICALLY_INCORRECT_MESSAGE9+	95	Semantically incorrect message.
INVALID_MANDATORY_INFORMATION9+	96	Invalid mandatory information.
MESSAGE_TYPE_NON_EXISTENT_OR_NOT_IMPLEMENTED9+	97	Message type non-existent or not implemented.
MESSAGE_TYPE_NOT_COMPATIBLE_WITH_PROTOCOL_STATE9+	98	Message type not compatible with protocol state.
INFORMATION_ELEMENT_NON_EXISTENT_OR_NOT_IMPLEMENTED9+	99	IE non-existent or not implemented.
CONDITIONAL_IE_ERROR9+	100	Conditional IE error.
MESSAGE_NOT_COMPATIBLE_WITH_PROTOCOL_STATE9+	101	Message not compatible with protocol state.
RECOVERY_ON_TIMER_EXPIRED9+	102	Recovery on timer expiry.
PROTOCOL_ERROR_UNSPECIFIED9+	111	Protocol error, unspecified.
INTERWORKING_UNSPECIFIED9+	127	Interworking, unspecified.
CALL_BARRED9+	240	Call barred.
FDN_BLOCKED9+	241	FDN blocked.
IMSI_UNKNOWN_IN_VLR9+	242	IMSI unknown in VLR.
IMEI_NOT_ACCEPTED9+	243	IMEI not accepted.
DIAL_MODIFIED_TO_USSD9+	244	Dial request modified to USSD request.
DIAL_MODIFIED_TO_SS9+	245	Dial request modified to SS request.
DIAL_MODIFIED_TO_DIAL9+	246	Dial request modified to dial with different number.
RADIO_OFF9+	247	Radio off.
OUT_OF_SERVICE9+	248	Out of service.
NO_VALID_SIM9+	249	No valid SIM.
RADIO_INTERNAL_ERROR9+	250	Radio internal error.
NETWORK_RESP_TIMEOUT9+	251	Network response timeout.
NETWORK_REJECT9+	252	Request rejected by network.
RADIO_ACCESS_FAILURE9+	253	Radio access failure.
RADIO_LINK_FAILURE9+	254	Radio link failure.
RADIO_LINK_LOST9+	255	Radio link lost.
RADIO_UPLINK_FAILURE9+	256	Radio uplink failure.
RADIO_SETUP_FAILURE9+	257	Radio setup failure.
RADIO_RELEASE_NORMAL9+	258	Radio release normal.
RADIO_RELEASE_ABNORMAL9+	259	Radio release abnormal.
ACCESS_CLASS_BLOCKED9+	260	Access class blocked.
NETWORK_DETACH9+	261	Network detached.
INVALID_PARAMETER	1025	Invalid parameter.
SIM_NOT_EXIT	1026	SIM not exit.
SIM_PIN_NEED	1027	SIM PIN needed.
CALL_NOT_ALLOW	1029	Call not allowed.
SIM_INVALID	1045	No valid SIM.
UNKNOWN	1279	Unknown reason.

MmiCodeResults⁹⁺

Defines the MMI code result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Type	Mandatory	Description
result	MmiCodeResult	Yes	MMI code result.
message	string	Yes	MMI code message.

MmiCodeResult⁹⁺

Defines the MMI code result.

System API: This is a system API.

System capability: SystemCapability.Telephony.CallManager

Name	Value	Description
MMI_CODE_SUCCESS	0	Success.
MMI_CODE_FAILED	1	Failure.

你可能感兴趣的鸿蒙文章

harmony 鸿蒙APIs

harmony 鸿蒙System Common Events (To Be Deprecated Soon)

harmony 鸿蒙System Common Events

harmony 鸿蒙API Reference Document Description

harmony 鸿蒙Enterprise Device Management Overview (for System Applications Only)

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager)

harmony 鸿蒙@ohos.distributedBundle (Distributed Bundle Management)

harmony 鸿蒙@ohos.bundle (Bundle)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (EnterpriseAdminExtensionAbility)