diff --git a/zh-cn/application-dev/reference/apis/js-apis-call.md b/zh-cn/application-dev/reference/apis/js-apis-call.md index f4f444e3d438f9a29f30a77737d8407ff8620250..4d993ff57b762092e75bc2dc0d4e5ab475235d8f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-call.md +++ b/zh-cn/application-dev/reference/apis/js-apis-call.md @@ -3598,7 +3598,7 @@ setAudioDevice\(device: AudioDevice, callback: AsyncCallback\\): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------- | ---- | ---------- | -| device | [AudioDevice](#audiodevice8) | 是 | 音频设备。 | +| device | [AudioDevice](#audiodevice10) | 是 | 音频设备。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | **错误码：** @@ -3617,11 +3617,58 @@ setAudioDevice\(device: AudioDevice, callback: AsyncCallback\\): void **示例：** ```js -call.setAudioDevice(1, (err) => { +let audioDevice={ + deviceType: 1 +} +call.setAudioDevice(audioDevice, (err) => { console.log(`callback: err->${JSON.stringify(err)}`); }); ``` +## call.setAudioDevice10+ + +setAudioDevice\(device: AudioDevice): Promise\ + +设置通话音频设备。使用Promise异步回调。 + +**系统接口：** 此接口为系统接口。 + +**需要权限**：ohos.permission.SET_TELEPHONY_STATE + +**系统能力**：SystemCapability.Telephony.CallManager + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ---------------------------- | ---- | ---------- | +| device | [AudioDevice](#audiodevice10) | 是 | 音频设备。 | + +**错误码：** + +以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 + +| 错误码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. | + +**示例：** + +```js +let audioDevice={ + deviceType: 1 +} +call.setAudioDevice(audioDevice).then(() => { + console.log(`setAudioDevice success.`); +}).catch((err) => { + console.error(`setAudioDevice fail, promise: err->${JSON.stringify(err)}`); +}); +``` ## call.setAudioDevice9+ @@ -3637,7 +3684,7 @@ setAudioDevice\(device: AudioDevice, options: AudioDeviceOptions, callback: Asyn | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------------------------ | ---- | -------------- | -| device | [AudioDevice](#audiodevice8) | 是 | 音频设备。 | +| device | [AudioDevice](#audiodevice10) | 是 | 音频设备。 | | options | [AudioDeviceOptions](#audiodeviceoptions9) | 是 | 音频设备参数。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | @@ -3657,10 +3704,13 @@ setAudioDevice\(device: AudioDevice, options: AudioDeviceOptions, callback: Asyn **示例：** ```js +let audioDevice={ + deviceType: 1 +} let audioDeviceOptions={ bluetoothAddress: "IEEE 802-2014" } -call.setAudioDevice(1, audioDeviceOptions, (err) => { +call.setAudioDevice(audioDevice, audioDeviceOptions, (err) => { console.log(`callback: err->${JSON.stringify(err)}`); }); ``` @@ -3680,7 +3730,7 @@ setAudioDevice\(device: AudioDevice, options?: AudioDeviceOptions\): Promise\ { +call.setAudioDevice(audioDevice, audioDeviceOptions).then(() => { console.log(`setAudioDevice success.`); }).catch((err) => { console.error(`setAudioDevice fail, promise: err->${JSON.stringify(err)}`); @@ -4248,7 +4301,7 @@ call.closeUnfinishedUssd(slotId).then(() => { ## call.setVoNRState10+ -setVoNRState\(slotId: number, state: VoNRState, callback: AsyncCallback\\): void +setVoNRState\(slotId: number, state: VoNRState, callback: AsyncCallback\\): void 设置NR语音的开关状态。使用callback异步回调。 @@ -4264,7 +4317,7 @@ setVoNRState\(slotId: number, state: VoNRState, callback: AsyncCallback\- 0：卡槽1
- 1：卡槽2 | | state | [VoNRState](#vonrstate10) | 是 | 开关状态。 | -| callback | AsyncCallback<boolean> | 是 | 回调函数。返回true表示设置成功，返回false表示设置失败。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | **错误码：** @@ -4293,7 +4346,7 @@ call.setVoNRState(slotId, state, (err, data) => { ## call.setVoNRState10+ -setVoNRState\(slotId: number, state: VoNRState\): Promise\ +setVoNRState\(slotId: number, state: VoNRState\): Promise\ 设置NR语音的开关状态。使用Promise异步回调。 @@ -4314,7 +4367,7 @@ setVoNRState\(slotId: number, state: VoNRState\): Promise\ | 类型 | 说明 | | ---------------------- | --------------------------------------------- | -| Promise<boolean> | 以Promise形式异步返回开关状态是否设置成功。 | +| Promise<void> | 以Promise形式异步返回结果。 | **错误码：** @@ -4335,7 +4388,7 @@ setVoNRState\(slotId: number, state: VoNRState\): Promise\ ```js let slotId = 0; let state = 1; -call.setVoNRState(slotId, state).then(() => { +call.setVoNRState(slotId, state).then((data) => { console.log(`setVoNRState success, promise: data->${JSON.stringify(data)}`); }).catch((err) => { console.error(`setVoNRState fail, promise: err->${JSON.stringify(err)}`); @@ -4522,7 +4575,7 @@ canSetCallTransferTime\(slotId: number\): Promise\ ```js let slotId = 0; -call.canSetCallTransferTime(slotId).then(() => { +call.canSetCallTransferTime(slotId).then((data) => { console.log(`canSetCallTransferTime success, promise: data->${JSON.stringify(data)}`); }).catch((err) => { console.error(`canSetCallTransferTime fail, promise: err->${JSON.stringify(err)}`); @@ -4710,7 +4763,7 @@ IP多媒体系统调用模式。 | VONR_STATE_OFF | 0 | 关闭状态 | | VONR_STATE_ON | 1 | 打开状态 | -## AudioDevice8+ +## AudioDevice10+ 音频设备。 @@ -4718,13 +4771,10 @@ IP多媒体系统调用模式。 **系统能力**：SystemCapability.Telephony.CallManager -| 名称 | 值 | 说明 | -| -------------------- | ---- | ------------ | -| DEVICE_EARPIECE | 0 | 耳机设备 | -| DEVICE_SPEAKER | 1 | 扬声器设备 | -| DEVICE_WIRED_HEADSET | 2 | 有线耳机设备 | -| DEVICE_BLUETOOTH_SCO | 3 | 蓝牙SCO设备 | -| DEVICE_MIC | 4 | 麦克风设备 | +| 名称 | 类型 | 必填 | 说明 | +| --------------------------------- | ------------------------------------- | ---- | ---------------- | +| deviceType 10+ | [AudioDeviceType](#audiodevicetype10) | 是 | 音频设备类型。 | +| address 10+ | string | 否 | 音频设备地址。 | ## AudioDeviceType10+ @@ -4751,8 +4801,8 @@ IP多媒体系统调用模式。 | 名称 | 类型 | 必填 | 说明 | | --------------------------------- | ------------------------------------- | ---- | ---------------- | -| audioDeviceList 10+ | [Array\](#audiodevice8) | 是 | 音频设备列表。 | -| currentAudioDevice 10+ | [AudioDevice](#audiodevice8) | 是 | 音频设备类型。 | +| audioDeviceList 10+ | [Array\](#audiodevice10) | 是 | 音频设备列表。 | +| currentAudioDevice 10+ | [AudioDevice](#audiodevice10) | 是 | 音频设备类型。 | | isMuted 10+ | boolean | 是 | 是否静音。 |