@ohos.telephony.call (拨打电话)

该模块提供呼叫管理功能,包括拨打电话、跳转到拨号界面、获取通话状态、格式化电话号码等。

如需订阅通话状态请使用observer.on('callStateChange')

说明:

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

导入模块

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

call.dialCall9+

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

拨打电话。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.PLACE_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.dialCall9+

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

拨打电话,可设置通话参数。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.PLACE_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
phoneNumber string 电话号码。
options DialCallOptions 通话参数,携带呼叫的其他配置信息。
callback AsyncCallback<void> 以callback形式异步返回拨打电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.dialCall9+

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

拨打电话,可设置通话参数。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.PLACE_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
phoneNumber string 电话号码。
options DialCallOptions 通话参数,携带呼叫的其他配置信息。
不填该参数则默认使用如下配置,参考DialCallOptions
- 帐户Id:卡槽1
- 音视频类型:语音通话
- 拨号场景:普通呼叫
- 拨号类型:运营商通话

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

拨打电话。使用callback异步回调。

说明:

从API version 6 开始支持,从API version 9 开始废弃。请使用dialCall替代,替代接口能力仅对系统应用开放。

需要权限:ohos.permission.PLACE_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

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

示例:

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

拨打电话,可设置通话参数。使用callback异步回调。

说明:

从API version 6 开始支持,从API version 9 开始废弃。请使用dialCall替代,替代接口能力仅对系统应用开放。

需要权限:ohos.permission.PLACE_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
phoneNumber string 电话号码。
options DialOptions 通话参数,选择为语音通话还是视频通话。
callback AsyncCallback<boolean> 回调函数,返回true为成功,false为失败。

示例:

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>

拨打电话,可设置通话参数。使用Promise异步回调。

说明:

从API version 6 开始支持,从API version 9 开始废弃。请使用dialCall替代,替代接口能力仅对系统应用开放。

需要权限:ohos.permission.PLACE_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
phoneNumber string 电话号码。
options DialOptions 通话参数,选择为语音通话还是视频通话。

返回值:

类型 说明
Promise<boolean> 以Promise形式返回拨打电话的结果,返回true为成功,false为失败。

示例:

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

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

跳转到拨号界面,并显示待拨出的号码。使用callback异步回调。

系统能力:SystemCapability.Applications.Contacts

参数:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
401 Parameter error.
8300001 Invalid parameter value.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

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

call.makeCall7+

makeCall(phoneNumber: string): Promise<void>

跳转到拨号界面,并显示待拨出的号码。使用Promise异步回调。

系统能力:SystemCapability.Applications.Contacts

参数:

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

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
401 Parameter error.
8300001 Invalid parameter value.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

判断是否存在通话。使用callback异步回调。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<boolean> 回调函数。返回true表示当前存在通话,false表示当前不存在通话。

示例:

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

call.hasCall((err: BusinessError, data: boolean) => {
    if (err) {
        console.error(`hasCall fail, err->${JSON.stringify(err)}`);
    } else {
        console.log(`hasCall success, data->${JSON.stringify(data)}`);
    }
});

call.hasCall

hasCall(): Promise<boolean>

判断是否存在通话。使用Promise异步回调。

系统能力:SystemCapability.Telephony.CallManager

返回值:

类型 说明
Promise<boolean> 以Promise形式异步返回判断是否存在通话。返回true表示当前存在通话,false表示当前不存在通话。

示例:

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

hasCallSync(): boolean

判断是否存在通话。

系统能力:SystemCapability.Telephony.CallManager

返回值:

类型 说明
boolean 返回判断是否存在通话。返回true表示当前存在通话,false表示当前不存在通话。

示例:

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

call.getCallState

getCallState(callback: AsyncCallback<CallState>): void

获取当前通话状态。使用callback异步回调。

系统能力:SystemCapability.Telephony.CallManager

参数:

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

示例:

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

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

call.getCallState

getCallState(): Promise<CallState>

获取当前通话状态。使用Promise异步回调。

系统能力:SystemCapability.Telephony.CallManager

返回值:

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

示例:

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

getCallStateSync(): CallState

获取当前通话状态。

系统能力:SystemCapability.Telephony.CallManager

返回值:

类型 说明
CallState 返回获取到的通话状态。

示例:

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

call.hasVoiceCapability7+

hasVoiceCapability(): boolean

检查当前设备是否具备语音通话能力。

系统能力:SystemCapability.Telephony.CallManager

返回值:

类型 说明
boolean 返回true表示设备具备语音通话能力,返回false表示设备不具备语音通话能力。
let result: boolean = call.hasVoiceCapability();
console.log(`hasVoiceCapability: ${JSON.stringify(result)}`);

call.isEmergencyPhoneNumber7+

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

判断是否是紧急电话号码。使用callback异步回调。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
phoneNumber string 电话号码。
callback AsyncCallback<boolean> 回调函数。返回true表示是紧急电话号码,返回false表示不是紧急电话号码。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
401 Parameter error.
8300001 Invalid parameter value.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

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

call.isEmergencyPhoneNumber7+

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

根据电话号码参数,判断是否是紧急电话号码。使用callback异步回调。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
phoneNumber string 电话号码。
options EmergencyNumberOptions 电话号码参数。
callback AsyncCallback<boolean> 回调函数。返回true表示是紧急电话号码,返回false表示不是紧急电话号码。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
401 Parameter error.
8300001 Invalid parameter value.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

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

call.isEmergencyPhoneNumber7+

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

根据电话号码参数,判断是否是紧急电话号码。使用Promise异步回调。

系统能力:SystemCapability.Telephony.CallManager

参数:

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

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
401 Parameter error.
8300001 Invalid parameter value.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

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

格式化电话号码。使用callback异步回调。

电话号码格式化后为标准数字字串,例如:“138 xxxx xxxx”、“0755 xxxx xxxx”。

系统能力:SystemCapability.Telephony.CallManager

参数:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
401 Parameter error.
8300001 Invalid parameter value.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

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

call.formatPhoneNumber7+

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

格式化电话号码,可设置格式化参数。使用callback异步回调。

电话号码格式化后为标准数字字串,例如:“138 xxxx xxxx”、“0755 xxxx xxxx”。

系统能力:SystemCapability.Telephony.CallManager

参数:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
401 Parameter error.
8300001 Invalid parameter value.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

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

call.formatPhoneNumber7+

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

格式化电话号码,可设置格式化参数。使用Promise异步回调。

电话号码格式化后为标准数字字串,例如:“138 xxxx xxxx”、“0755 xxxx xxxx”。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
phoneNumber string 电话号码。
options NumberFormatOptions 格式化参数,如国家码。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
401 Parameter error.
8300001 Invalid parameter value.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

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

将电话号码格式化为E.164表示形式。使用callback异步回调。

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

系统能力:SystemCapability.Telephony.CallManager

参数:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
401 Parameter error.
8300001 Invalid parameter value.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

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

call.formatPhoneNumberToE1647+

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

将电话号码格式化为E.164表示形式。使用Promise异步回调。

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

支持所有国家码。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
phoneNumber string 电话号码。
countryCode string 国家码,支持所有国家码,如:中国(CN)。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
401 Parameter error.
8300001 Invalid parameter value.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

muteRinger(callback: AsyncCallback<void>): void

如果来电铃声响起,设备将停止铃声。否则,此方法不起作用。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<void> 以回调函数的方式返回停止铃声的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.muteRinger8+

muteRinger(): Promise<void>

如果来电铃声响起,设备将停止铃声。否则,此方法不起作用。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

接听来电。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。可以通过订阅callDetailsChange事件获得。
callback AsyncCallback<void> 以回调函数的方式返回接听电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.answerCall9+

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

接听来电。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。可以通过订阅callDetailsChange事件获得。从API Version 9开始为可选参数。
不填该参数则接通最近一通正在响铃的来电。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

answerCall(callback: AsyncCallback<void>): void

接听来电。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<void> 以回调函数的方式返回接听电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.hangUpCall9+

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

挂断电话。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫id。可以通过订阅callDetailsChange事件获得。
callback AsyncCallback<void> 以回调函数的方式返回挂断电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.hangUpCall9+

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

挂断电话。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫id。可以通过订阅callDetailsChange事件获得。从API Version 9开始为可选参数。
不填该参数则挂断最近一通正在进行/拨号/连接的通话。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

hangUpCall(callback: AsyncCallback<void>): void

挂断电话。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<void> 以回调函数的方式返回挂断电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.rejectCall9+

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

拒绝来电。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。可以通过订阅callDetailsChange事件获得。
callback AsyncCallback<void> 以回调函数的方式返回拒接电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.rejectCall(1, (err: BusinessError) => {
    if (err) {
        console.error(`rejectCall fail, err->${JSON.stringify(err)}`);
    } else {
        console.log(`rejectCall success.`);
    }
});

call.rejectCall9+

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

拒绝来电。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。可以通过订阅callDetailsChange事件获得。
options RejectMessageOptions 拒绝消息选项。
callback AsyncCallback<void> 以回调函数的方式返回拒接电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

let rejectMessageOptions : call.RejectMessageOptions = {
    messageContent: "拦截陌生号码"
}
call.rejectCall(1, rejectMessageOptions, (err: BusinessError) => {
    if (err) {
        console.error(`rejectCall fail, err->${JSON.stringify(err)}`);
    } else {
        console.log(`rejectCall success.`);
    }
});

call.rejectCall9+

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

拒绝来电。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。可以通过订阅callDetailsChange事件获得。从API Version 9开始为可选参数。
不填该参数则拒接最近一通正在响铃的来电。
options RejectMessageOptions 拒绝消息选项。不填该参数则不会发送拒接短信。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

let rejectMessageOptions: call.RejectMessageOptions = {
    messageContent: "拦截陌生号码"
}
call.rejectCall(1, rejectMessageOptions).then(() => {
    console.log(`rejectCall success.`);
}).catch((err: BusinessError) => {
    console.error(`rejectCall fail, promise: err->${JSON.stringify(err)}`);
});

call.rejectCall9+

rejectCall(callback: AsyncCallback<void>): void

拒绝来电。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<void> 以回调函数的方式返回拒接电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.rejectCall((err: BusinessError) => {
    if (err) {
        console.error(`rejectCall fail, err->${JSON.stringify(err)}`);
    } else {
        console.log(`rejectCall success.`);
    }
});

call.rejectCall9+

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

拒绝来电。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
options RejectMessageOptions 拒绝消息选项。
callback AsyncCallback<void> 以回调函数的方式返回拒接电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

let rejectMessageOptions: call.RejectMessageOptions = {
    messageContent: "拦截陌生号码"
}
call.rejectCall(rejectMessageOptions, (err: BusinessError) => {
    if (err) {
        console.error(`rejectCall fail, err->${JSON.stringify(err)}`);
    } else {
        console.log(`rejectCall success.`);
    }
});

call.holdCall7+

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

保持通话。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
callback AsyncCallback<void> 以回调函数的方式返回保持电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.holdCall7+

holdCall(callId: number): Promise<void>

保持通话。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

取消保持通话。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
callback AsyncCallback<void> 以回调函数的方式返回取消保持电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.unHoldCall7+

unHoldCall(callId: number): Promise<void>

取消保持通话。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

切换呼叫。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
callback AsyncCallback<void> 以回调函数的方式返回交换电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.switchCall7+

switchCall(callId: number): Promise<void>

切换呼叫。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.ANSWER_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

合并通话,将两通电话合并成会议电话。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
callback AsyncCallback<void> 以回调函数的方式返回合并会议的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.combineConference7+

combineConference(callId: number): Promise<void>

合并通话,将两通电话合并成会议电话。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

移出电话会议,将指定通话从会议电话中挂断。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.PLACE_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
callback AsyncCallback<void> 以回调函数的方式返回移出会议的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.kickOutFromConference10+

kickOutFromConference(callId: number): Promise<void>

移出电话会议,将指定通话从会议电话中挂断。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.PLACE_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

获取主呼叫Id。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
callback AsyncCallback<number> 回调函数。返回主呼叫Id。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.getMainCallId7+

getMainCallId(callId: number): Promise<number>

获取主呼叫Id。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。

返回值:

类型 说明
Promise<number> 以Promise形式异步返回主呼叫Id。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

获取子呼叫Id列表。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
callback AsyncCallback<Array<string>> 回调函数。返回子呼叫Id列表。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.getSubCallIdList7+

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

获取子呼叫Id列表。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。

返回值:

类型 说明
Promise<Array<string>> 以Promise形式异步返回子呼叫Id列表。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

获取会议的呼叫Id列表。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
callback AsyncCallback<Array<string>> 回调函数。返回会议的呼叫Id列表。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.getCallIdListForConference7+

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

获取会议的呼叫Id列表。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。

返回值:

类型 说明
Promise<Array<string>> 以Promise形式异步返回会议的呼叫Id列表。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

获取呼叫等待状态。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<CallWaitingStatus> 回调函数。
返回呼叫等待状态。
- 0:禁用呼叫等待
- 1:启用呼叫等待

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.getCallWaitingStatus7+

getCallWaitingStatus(slotId: number): Promise<CallWaitingStatus>

获取呼叫等待状态。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

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

返回值:

类型 说明
Promise<CallWaitingStatus> 以Promise形式异步返回呼叫等待状态。
- 0:禁用呼叫等待
- 1:启用呼叫等待

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

设置呼叫等待。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
activate boolean 呼叫等待是否处于启用状态。
- false:禁用呼叫等待
- true:启用呼叫等待
callback AsyncCallback<void> 以回调函数的方式返回设置呼叫等待的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.setCallWaiting7+

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

设置呼叫等待。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
activate boolean 呼叫等待是否处于启用状态。
- false:禁用呼叫等待
- true:启用呼叫等待

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

启动双音多频。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
character string DTMF码。
callback AsyncCallback<void> 以回调函数的方式返回启动双音多频的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.startDTMF7+

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

启动双音多频。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
character string DTMF码。

返回值:

类型 说明
Promise<void> 以Promise形式异步返回。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

停止双音多频。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
callback AsyncCallback<void> 以回调函数的方式返回停止双音多频的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.stopDTMF7+

stopDTMF(callId: number): Promise<void>

停止双音多频。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

isInEmergencyCall(callback: AsyncCallback<boolean>): void

判断是否正在处于紧急呼叫。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<boolean> 以回调函数的方式返回结果,true表示紧急号码,false表示非紧急号码。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.isInEmergencyCall7+

isInEmergencyCall(): Promise<boolean>

判断是否正在处于紧急呼叫。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

返回值:

类型 说明
Promise<boolean> 以Promise形式异步返回结果,true表示正在处于紧急呼叫,false表示不处于紧急呼叫。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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')7+

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

订阅callDetailsChange事件。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
type string 通话时监听通话详情的变化,参数固定为'callDetailsChange'。
callback Callback<CallAttributeOptions> 以回调函数的方式返回订阅callDetailsChange事件的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.on('callEventChange')8+

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

订阅callEventChange事件。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
type string 通话时监听通话事件的变化,参数固定为'callEventChange'。
callback Callback<CallEventOptions> 以回调函数的方式返回订阅callEventChange事件的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.on('callDisconnectedCause')8+

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

订阅callDisconnectedCause事件。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
type string 通话时监听断开连接的原因,参数固定为'callDisconnectedCause'。
callback Callback<DisconnectedDetails> 以回调函数的方式返回订阅callDisconnectedCausee事件的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.on('mmiCodeResult')9+

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

订阅mmiCodeResult事件。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
type string 通话时监听MMI码结果,参数固定为'mmiCodeResult'。
callback Callback<MmiCodeResults> 以回调函数的方式返回订阅mmiCodeResult事件的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.off('callDetailsChange')7+

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

取消订阅callDetailsChange事件。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
type string 通话结束时取消监听通话详情的变化,参数固定为'callDetailsChange'。
callback Callback<CallAttributeOptions> 回调函数。不填该参数将不会收到取消订阅的处理结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.off('callEventChange')8+

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

取消订阅callEventChange事件。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
type string 通话结束时取消监听通话事件的变化,参数固定为'callEventChange'。
callback Callback<CallEventOptions> 回调函数。不填该参数将不会收到取消订阅的处理结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.off('callDisconnectedCause')8+

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

取消订阅callDisconnectedCause事件。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
type string 调用断开连接的原因,参数固定为'callDisconnectedCause'。
callback Callback<DisconnectedDetails> 回调函数。不填该参数将不会收到取消订阅的处理结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.off('mmiCodeResult')9+

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

取消订阅mmiCodeResult事件。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
type string MMI码结果,参数固定为'mmiCodeResult'。
callback Callback<MmiCodeResults> 回调函数。不填该参数将不会收到取消订阅的处理结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.on('audioDeviceChange')10+

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

订阅通话音频设备切换事件。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
type string 通话音频设备发生变化,参数固定为'audioDeviceChange'。
callback Callback<AudioDeviceCallbackInfo> 以回调函数的方式返回订阅通话音频设备切换事件的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.off('audioDeviceChange')10+

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

取消订阅audioDeviceChange事件。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
type string 通话音频设备发生变化,参数固定为'audioDeviceChange'。
callback Callback<AudioDeviceCallbackInfo> 回调函数。不填该参数将不会收到取消订阅的处理结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.isNewCallAllowed8+

isNewCallAllowed(callback: AsyncCallback<boolean>): void

判断是否允许再拨打一通新电话。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<boolean> 以回调函数的方式返回结果,true表示允许拨打,false表示不可拨打。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.isNewCallAllowed8+

isNewCallAllowed(): Promise<boolean>

判断是否允许再拨打一通新电话。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

返回值:

类型 说明
Promise<boolean> 以Promise形式异步返回结果,true表示允许拨打,false表示不可拨打。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
202 Non-system applications use system APIs.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

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

分离会议电话。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
callback AsyncCallback<void> 以回调函数的方式返回分离会议电话的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.separateConference8+

separateConference(callId: number): Promise<void>

分离会议电话。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

获取呼叫限制状态。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
type CallRestrictionType 呼叫限制类型。
callback AsyncCallback<RestrictionStatus> 回调函数。返回限制状态。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.getCallRestrictionStatus8+

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

获取呼叫限制状态。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
type CallRestrictionType 呼叫限制类型。

返回值:

类型 说明
Promise<RestrictionStatus> 以Promise形式异步返回结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

设置呼叫限制状态。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
info CallRestrictionInfo 呼叫限制信息。
callback AsyncCallback<void> 以回调函数的方式返回设置呼叫限制状态的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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) => {
    if (err) {
        console.error(`setCallRestriction fail, err->${JSON.stringify(err)}`);
    } else {
        console.log(`setCallRestriction success.`);
    }
});

call.setCallRestriction8+

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

设置呼叫限制状态。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
info CallRestrictionInfo 呼叫限制信息。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

修改呼叫限制密码。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
oldPassword string 呼叫限制旧密码。
newPassword string 呼叫限制新密码。
callback AsyncCallback<void> 以回调函数的方式返回修改呼叫限制密码的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.setCallRestrictionPassword10+

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

修改呼叫限制密码。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
oldPassword string 呼叫限制旧密码。
newPassword string 呼叫限制新密码。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

获取呼叫转移信息。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
type CallTransferType 呼叫转移类型。
callback AsyncCallback<CallTransferResult> 回调函数。返回呼叫转移信息。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.getCallTransferInfo8+

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

获取呼叫转移信息。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
type CallTransferType 呼叫转移类型。

返回值:

类型 说明
Promise<CallTransferResult> 以Promise形式异步返回结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

设置呼叫转移信息。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
info CallTransferInfo 呼叫转移信息。
callback AsyncCallback<void> 以回调函数的方式返回设置呼叫转移信息的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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) => {
    if (err) {
        console.error(`setCallTransfer fail, err->${JSON.stringify(err)}`);
    } else {
        console.log(`setCallTransfer success.`);
    }
});

call.setCallTransfer8+

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

设置呼叫转移信息。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
info CallTransferInfo 呼叫转移信息。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

isRinging(callback: AsyncCallback<boolean>): void

判断是否正在响铃。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<boolean> 以回调函数的方式返回是否正在响铃的结果,true表示正在响铃,false表示没有在响铃。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.isRinging8+

isRinging(): Promise<boolean>

判断是否正在响铃。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

返回值:

类型 说明
Promise<boolean> 以Promise形式异步返回结果,true表示正在响铃,false表示没有响铃。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

setMuted(callback: AsyncCallback<void>): void

设置通话中的静音。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<void> 以回调函数的方式返回设置通话中的静音的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.setMuted8+

setMuted(): Promise<void>

设置通话中的静音。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
202 Non-system applications use system APIs.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

cancelMuted(callback: AsyncCallback<void>): void

取消通话中的静音。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<void> 以回调函数的方式返回取消通话中的静音的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.cancelMuted8+

cancelMuted(): Promise<void>

取消通话中的静音。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
202 Non-system applications use system APIs.
8300002 Operation failed. Cannot connect to service.
8300003 System internal error.
8300999 Unknown error code.

示例:

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

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

设置通话音频设备。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
device AudioDevice 音频设备。
callback AsyncCallback<void> 以回调函数的方式返回设置通话音频设备的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.setAudioDevice10+

setAudioDevice(device: AudioDevice): Promise<void>

设置通话音频设备。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
device AudioDevice 音频设备。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

加入会议。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
mainCallId number 主通话Id。
callNumberList Array<string> 呼叫号码列表。
callback AsyncCallback<void> 以回调函数的方式返回加入会议的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.joinConference8+

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

加入会议。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
mainCallId number 主通话Id。
callNumberList Array<string> 呼叫号码列表。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

更新Ims呼叫模式。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
mode ImsCallMode Ims呼叫模式。
callback AsyncCallback<void> 以回调函数的方式返回更新Ims呼叫模式的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.updateImsCallMode8+

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

更新Ims呼叫模式。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callId number 呼叫Id。
mode ImsCallMode Ims呼叫模式。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

启用Ims开关。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<void> 以回调函数的方式返回启用Ims开关的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.enableImsSwitch8+

enableImsSwitch(slotId: number): Promise<void>

启用Ims开关。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

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

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

禁用Ims开关。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<void> 以回调函数的方式返回禁用Ims开关的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.disableImsSwitch8+

disableImsSwitch(slotId: number): Promise<void>

禁用Ims开关。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

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

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

判断Ims开关是否启用。使用callback异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<boolean> 以回调函数的方式返回判断Ims开关是否启用的结果。true表示Ims开关启用,false表示未启用。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.isImsSwitchEnabled8+

isImsSwitchEnabled(slotId: number): Promise<boolean>

判断Ims开关是否启用。使用Promise异步回调。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

参数:

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

返回值:

类型 说明
Promise<boolean> 以Promise形式异步返回结果,true表示Ims开关启用,false表示未启用。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

取消未激活完成的非结构化补充数据业务。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<void> 以回调函数的方式返回取消未激活完成的非结构化补充数据业务的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.closeUnfinishedUssd10+

closeUnfinishedUssd(slotId: number): Promise<void>

取消未激活完成的非结构化补充数据业务。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

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

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

设置NR语音的开关状态。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
state VoNRState 开关状态。
callback AsyncCallback<void> 以回调函数的方式返回设置NR语音的开关状态的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.setVoNRState10+

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

设置NR语音的开关状态。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2。
state VoNRState 开关状态。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

查询NR语音的开关状态。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<VoNRState> 回调函数。返回NR语音开关的状态。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.getVoNRState10+

getVoNRState(slotId: number): Promise<VoNRState>

查询NR语音的开关状态。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

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

返回值:

类型 说明
Promise<VoNRState> 以Promise形式异步返回开关状态。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

检查是否可以设置呼叫转移时间。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
slotId number 卡槽ID。
- 0:卡槽1
- 1:卡槽2
callback AsyncCallback<boolean> 回调函数。返回true表示可以设置,返回false表示不可以设置。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.canSetCallTransferTime10+

canSetCallTransferTime(slotId: number): Promise<boolean>

检查是否可以设置呼叫转移时间。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.GET_TELEPHONY_STATE

系统能力:SystemCapability.Telephony.CallManager

参数:

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

返回值:

类型 说明
Promise<boolean> 以Promise形式异步返回是否可以设置呼叫转移时间。返回true表示可以设置,返回false表示不可以设置。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

暗码广播。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.PLACE_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
inputCode string 暗码。支持暗码字段, 如:2846579(工程菜单)。
callback AsyncCallback<void> 以回调函数的方式返回暗码广播的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.inputDialerSpecialCode('2846579', (err: BusinessError) => {
    if (err) {
        console.error(`inputDialerSpecialCode fail, err->${JSON.stringify(err)}`);
    } else {
        console.log(`inputDialerSpecialCode success`);
    }
});

call.inputDialerSpecialCode10+

inputDialerSpecialCode(inputCode: string): Promise<void>

暗码广播。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.PLACE_CALL

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
inputCode string 暗码。支持暗码字段, 如:2846579(工程菜单)。

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

call.removeMissedIncomingCallNotification10+

removeMissedIncomingCallNotification(callback: AsyncCallback<void>): void

删除未接来电通知。使用callback异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE, ohos.permission.READ_CALL_LOG 和 ohos.permission.WRITE_CALL_LOG

系统能力:SystemCapability.Telephony.CallManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<void> 以回调函数的方式返回删除未接来电通知的结果。

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

call.removeMissedIncomingCallNotification((err: BusinessError) => {
    if (err) {
        console.error(`removeMissedIncomingCallNotification failed, err->${JSON.stringify(err)}`);
    } else {
        console.log(`removeMissedIncomingCallNotification success`);
    }
});

call.removeMissedIncomingCallNotification10+

removeMissedIncomingCallNotification(): Promise<void>

删除未接来电通知。使用Promise异步回调。

系统接口: 此接口为系统接口。

需要权限:ohos.permission.SET_TELEPHONY_STATE, ohos.permission.READ_CALL_LOG 和 ohos.permission.WRITE_CALL_LOG

系统能力:SystemCapability.Telephony.CallManager

返回值:

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

错误码:

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码

错误码ID 错误信息
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.

示例:

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

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

DialOptions

拨打电话的可选参数。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
extras boolean 根据extras的值判断是否为视频通话,默认为语音通话。
- true:视频通话。
- false:语音通话。
accountId 8+ number 帐户Id。
- 0:卡槽1
- 1:卡槽2
。此接口为系统接口。
videoState 8+ VideoStateType 视频状态类型。此接口为系统接口。
dialScene 8+ DialScene 拨号场景。此接口为系统接口。
dialType 8+ DialType 拨号类型。此接口为系统接口。

DialCallOptions9+

拨打电话的可选参数。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
accountId 9+ number 帐户Id。
- 0:卡槽1
- 1:卡槽2
videoState 9+ VideoStateType 视频状态类型。
dialScene 9+ DialScene 拨号场景。
dialType 9+ DialType 拨号类型。

CallState

通话状态码。

系统能力:SystemCapability.Telephony.CallManager

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

EmergencyNumberOptions7+

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

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
slotId number 卡槽ID:
- 卡槽1:0
- 卡槽2:1

NumberFormatOptions7+

格式化号码的可选参数。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
countryCode string 国家码,支持所有国家的国家码,如:CN(中国)。默认为:CN。

ImsCallMode8+

IP多媒体系统调用模式。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
CALL_MODE_AUDIO_ONLY 0 仅限音频呼叫
CALL_MODE_SEND_ONLY 1 仅发送呼叫
CALL_MODE_RECEIVE_ONLY 2 仅接收呼叫
CALL_MODE_SEND_RECEIVE 3 允许发送和接收呼叫
CALL_MODE_VIDEO_PAUSED 4 暂停视频呼叫

VoNRState10+

5G语音开关状态。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
VONR_STATE_OFF 0 关闭状态
VONR_STATE_ON 1 打开状态

AudioDevice10+

音频设备。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
deviceType 10+ AudioDeviceType 音频设备类型。
address 10+ string 音频设备地址。

AudioDeviceType10+

音频设备类型。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
DEVICE_EARPIECE 0 耳机设备
DEVICE_SPEAKER 1 扬声器设备
DEVICE_WIRED_HEADSET 2 有线耳机设备
DEVICE_BLUETOOTH_SCO 3 蓝牙SCO设备

AudioDeviceCallbackInfo10+

音频设备信息。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
audioDeviceList 10+ Array<AudioDevice> 音频设备列表。
currentAudioDevice 10+ AudioDevice 当前音频设备。
isMuted 10+ boolean 是否静音。

CallRestrictionType8+

呼叫限制类型。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
RESTRICTION_TYPE_ALL_INCOMING 0 限制所有呼入
RESTRICTION_TYPE_ALL_OUTGOING 1 限制所有呼出
RESTRICTION_TYPE_INTERNATIONAL 2 限制国际通话
RESTRICTION_TYPE_INTERNATIONAL_EXCLUDING_HOME 3 限制除归属国以外的国际通话
RESTRICTION_TYPE_ROAMING_INCOMING 4 限制漫游呼入
RESTRICTION_TYPE_ALL_CALLS 5 限制所有通话
RESTRICTION_TYPE_OUTGOING_SERVICES 6 限制传出业务
RESTRICTION_TYPE_INCOMING_SERVICES 7 限制呼入业务

CallTransferInfo8+

呼叫转移信息。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
transferNum string 转移编号
type CallTransferType 呼叫转移类型
settingType CallTransferSettingType 设置呼叫转移类型
startHour9+ number 开始时间的小时数
startMinute9+ number 开始时间的分钟数
endHour9+ number 结束时间的小时数
endMinute9+ number 结束时间的分钟数

CallTransferType8+

呼叫转移类型。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
TRANSFER_TYPE_UNCONDITIONAL 0 无条件转移
TRANSFER_TYPE_BUSY 1 忙线转移
TRANSFER_TYPE_NO_REPLY 2 无回复转移
TRANSFER_TYPE_NOT_REACHABLE 3 无法访问转移

CallTransferSettingType8+

设置呼叫转移类型。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
CALL_TRANSFER_DISABLE 0 禁用呼叫转移
CALL_TRANSFER_ENABLE 1 启用呼叫转移
CALL_TRANSFER_REGISTRATION 3 登记呼叫转移
CALL_TRANSFER_ERASURE 4 消除呼叫转移

CallAttributeOptions7+

调用属性选项。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
accountNumber string 帐号号码
speakerphoneOn boolean 扬声器接通电话
accountId number 帐户Id
videoState VideoStateType 视频状态类型
startTime number 开始时间
isEcc boolean 是否是Ecc
callType CallType 通话类型
callId number 呼叫Id
callState DetailedCallState 详细呼叫状态
conferenceState ConferenceState 会议状态

ConferenceState7+

会议状态。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
TEL_CONFERENCE_IDLE 0 电话会议空闲
TEL_CONFERENCE_ACTIVE 1 电话会议激活
TEL_CONFERENCE_DISCONNECTING 2 电话会议断开
TEL_CONFERENCE_DISCONNECTED 3 电话会议已断开

CallType7+

通话类型。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
TYPE_CS 0 CS通话
TYPE_IMS 1 IMS通话
TYPE_OTT 2 OTT通话
TYPE_ERR_CALL 3 其他类型通话

VideoStateType7+

视频状态类型。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
TYPE_VOICE 0 语音状态
TYPE_VIDEO 1 视频状态

DetailedCallState7+

详细的呼叫状态。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
CALL_STATUS_ACTIVE 0 激活呼叫状态
CALL_STATUS_HOLDING 1 保持呼叫状态
CALL_STATUS_DIALING 2 呼叫状态拨号
CALL_STATUS_ALERTING 3 电话报警状态
CALL_STATUS_INCOMING 4 呼叫传入状态
CALL_STATUS_WAITING 5 呼叫等待状态
CALL_STATUS_DISCONNECTED 6 呼叫状态已断开
CALL_STATUS_DISCONNECTING 7 呼叫状态断开
CALL_STATUS_IDLE 8 呼叫状态空闲

CallRestrictionInfo8+

呼叫限制信息。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
type CallRestrictionType 呼叫限制类型
password string 密码
mode CallRestrictionMode 呼叫限制模式

CallRestrictionMode8+

呼叫限制模式。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
RESTRICTION_MODE_DEACTIVATION 0 限制模式停用
RESTRICTION_MODE_ACTIVATION 1 限制模式激活

CallEventOptions8+

呼叫事件的可选参数。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
eventId CallAbilityEventId 呼叫能力事件Id

CallAbilityEventId8+

呼叫能力事件Id。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
EVENT_DIAL_NO_CARRIER 1 拨号无载波事件
EVENT_INVALID_FDN_NUMBER 2 无效的FDN号事件

DialScene8+

拨号场景。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
CALL_NORMAL 0 呼叫正常
CALL_PRIVILEGED 1 呼叫特权
CALL_EMERGENCY 2 拨打紧急电话

DialType8+

拨号类型。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
DIAL_CARRIER_TYPE 0 载波拨号类型
DIAL_VOICE_MAIL_TYPE 1 语音邮件拨号类型
DIAL_OTT_TYPE 2 OTT拨号类型

RejectMessageOptions7+

拒绝消息可选参数。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
messageContent string 消息内容

CallTransferResult8+

呼叫转移结果。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
status TransferStatus 转移状态
number string 号码
startHour9+ number 开始时间的小时数
startMinute9+ number 开始时间的分钟数
endHour9+ number 结束时间的小时数
endMinute9+ number 结束时间的分钟数

CallWaitingStatus7+

呼叫等待状态。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
CALL_WAITING_DISABLE 0 禁用呼叫等待
CALL_WAITING_ENABLE 1 启用呼叫等待

RestrictionStatus8+

限制状态。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
RESTRICTION_DISABLE 0 禁用限制
RESTRICTION_ENABLE 1 启用限制

TransferStatus8+

转移状态。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
TRANSFER_DISABLE 0 禁用转移
TRANSFER_ENABLE 1 启用转移

DisconnectedDetails9+

通话结束原因。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
reason DisconnectedReason 通话结束原因
message string 通话结束提示信息

DisconnectedReason8+

断开连接的详细信息。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
UNASSIGNED_NUMBER 1 未分配的号码(空号)
NO_ROUTE_TO_DESTINATION 3 无至目的地的路由
CHANNEL_UNACCEPTABLE 6 不可接受的通路
OPERATOR_DETERMINED_BARRING 8 运营商闭锁
CALL_COMPLETED_ELSEWHERE9+ 13 呼叫在其他地方完成
NORMAL_CALL_CLEARING 16 清除正常呼叫
USER_BUSY 17 用户忙
NO_USER_RESPONDING 18 无用户响应
USER_ALERTING_NO_ANSWER 19 已有用户提醒,但无应答
CALL_REJECTED 21 呼叫拒绝
NUMBER_CHANGED 22 号码改变
CALL_REJECTED_DUE_TO_FEATURE_AT_THE_DESTINATION9+ 24 当由于目标地址(例如匿名)导致呼叫被拒绝
FAILED_PRE_EMPTION9+ 25 抢占失败
NON_SELECTED_USER_CLEARING9+ 26 非选定用户清除
DESTINATION_OUT_OF_ORDER 27 终点故障
INVALID_NUMBER_FORMAT 28 无效号码格式
FACILITY_REJECTED9+ 29 增补业务拒绝
RESPONSE_TO_STATUS_ENQUIRY9+ 30 对状态查询的响应
NORMAL_UNSPECIFIED9+ 31 正常,未指定
NO_CIRCUIT_CHANNEL_AVAILABLE9+ 34 无电路/通道可用
NETWORK_OUT_OF_ORDER 38 网络故障
TEMPORARY_FAILURE 41 临时故障
SWITCHING_EQUIPMENT_CONGESTION9+ 42 交换设备拥塞
ACCESS_INFORMATION_DISCARDED9+ 43 已丢弃访问信息
REQUEST_CIRCUIT_CHANNEL_NOT_AVAILABLE9+ 44 请求的电路/通道不可用
RESOURCES_UNAVAILABLE_UNSPECIFIED9+ 47 未指定资源不可用
QUALITY_OF_SERVICE_UNAVAILABLE9+ 49 服务质量不可用
REQUESTED_FACILITY_NOT_SUBSCRIBED9+ 50 请求的设施未订阅
INCOMING_CALLS_BARRED_WITHIN_THE_CUG9+ 55 CUG内禁止来电
BEARER_CAPABILITY_NOT_AUTHORIZED9+ 57 未授权承载能力
BEARER_CAPABILITY_NOT_PRESENTLY_AVAILABLE9+ 58 承载能力目前不可用
SERVICE_OR_OPTION_NOT_AVAILABLE_UNSPECIFIED9+ 63 服务或选项不可用,未指定
BEARER_SERVICE_NOT_IMPLEMENTED9+ 65 未实现承载服务
ACM_EQUALTO_OR_GREATER_THAN_THE_MAXIMUM_VALUE9+ 68 ACM大于或等于最大值
REQUESTED_FACILITY_NOT_IMPLEMENTED9+ 69 请求的设施未实施
ONLY_RESTRICTED_DIGITAL_INFO_BEARER_CAPABILITY_IS_AVAILABLE9+ 70 仅限BC有限数字信息可用
SERVICE_OR_OPTION_NOT_IMPLEMENTED_UNSPECIFIED9+ 79 服务或选项未实施,未指定
INVALID_TRANSACTION_IDENTIFIER_VALUE9+ 81 无效的业务标识符值
USER_NOT_MEMBER_OF_CUG9+ 87 用户不是CUG成员
INCOMPATIBLE_DESTINATION9+ 88 目标不兼容
INVALID_TRANSIT_NETWORK_SELECTION9+ 91 选择的传输网络无效
SEMANTICALLY_INCORRECT_MESSAGE9+ 95 语义错误的消息
INVALID_MANDATORY_INFORMATION9+ 96 无效的强制信息
MESSAGE_TYPE_NON_EXISTENT_OR_NOT_IMPLEMENTED9+ 97 消息类型不存在或未实现
MESSAGE_TYPE_NOT_COMPATIBLE_WITH_PROTOCOL_STATE9+ 98 消息类型与协议状态不兼容
INFORMATION_ELEMENT_NON_EXISTENT_OR_NOT_IMPLEMENTED9+ 99 IE不存在或未实现
CONDITIONAL_IE_ERROR9+ 100 条件IE错误
MESSAGE_NOT_COMPATIBLE_WITH_PROTOCOL_STATE9+ 101 消息与协议状态不兼容
RECOVERY_ON_TIMER_EXPIRED9+ 102 计时器过期时恢复计时器编号
PROTOCOL_ERROR_UNSPECIFIED9+ 111 协议错误,未指定
INTERWORKING_UNSPECIFIED9+ 127 互通,未指定
CALL_BARRED9+ 240 呼叫被禁止
FDN_BLOCKED9+ 241 FDN受阻
IMSI_UNKNOWN_IN_VLR9+ 242 VLR中的IMSI未知
IMEI_NOT_ACCEPTED9+ 243 IMEI未被接受
DIAL_MODIFIED_TO_USSD9+ 244 拨号修改为USSD
DIAL_MODIFIED_TO_SS9+ 245 拨号修改为USSD号
DIAL_MODIFIED_TO_DIAL9+ 246 拨号已修改为正常
RADIO_OFF9+ 247 无线电通讯已关闭
OUT_OF_SERVICE9+ 248 停止服务
NO_VALID_SIM9+ 249 SIM卡无效
RADIO_INTERNAL_ERROR9+ 250 无线电通讯内部错误
NETWORK_RESP_TIMEOUT9+ 251 网络响应超时
NETWORK_REJECT9+ 252 网络拒绝
RADIO_ACCESS_FAILURE9+ 253 无线电接入故障
RADIO_LINK_FAILURE9+ 254 无线电链路故障
RADIO_LINK_LOST9+ 255 无线电链路丢失
RADIO_UPLINK_FAILURE9+ 256 无线电上行链路故障
RADIO_SETUP_FAILURE9+ 257 无线电通讯设置失败
RADIO_RELEASE_NORMAL9+ 258 无线电释放正常
RADIO_RELEASE_ABNORMAL9+ 259 无线电释放异常
ACCESS_CLASS_BLOCKED9+ 260 访问类被阻止
NETWORK_DETACH9+ 261 网络分离
INVALID_PARAMETER 1025 无效参数
SIM_NOT_EXIT 1026 SIM卡未退出
SIM_PIN_NEED 1027 需要SIM卡PIN码
CALL_NOT_ALLOW 1029 不允许呼叫
SIM_INVALID 1045 SIM卡无效
UNKNOWN 1279 未知原因

MmiCodeResults9+

MMI码结果。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 类型 必填 说明
result MmiCodeResult MMI码结果
message string MMI码消息

MmiCodeResult9+

MMI码结果。

系统接口: 此接口为系统接口。

系统能力:SystemCapability.Telephony.CallManager

名称 说明
MMI_CODE_SUCCESS 0 表示MMI码成功
MMI_CODE_FAILED 1 表示MMI码失败