未验证 提交 4e2b094b 编写于 作者: O openharmony_ci 提交者: Gitee

!22743 add changelog for audio apis change

Merge pull request !22743 from AOL/cherry-pick-1692753695
......@@ -4360,14 +4360,6 @@ getPreferOutputDeviceForRendererInfo(rendererInfo: AudioRendererInfo): Promise&l
| --------------------- | --------------------------- |
| Promise<[AudioDeviceDescriptors](#audiodevicedescriptors)> | Promise返回优先级最高的输出设备信息。 |
**错误码:**
以下错误码的详细介绍请参见[音频错误码](../errorcodes/errorcode-audio.md)
| 错误码ID | 错误信息 |
| ------- | --------------------------------------------|
| 6800101 | if input parameter value error |
**示例:**
```js
......@@ -4828,6 +4820,14 @@ setAudioEffectMode(mode: AudioEffectMode, callback: AsyncCallback\<void>): void
| mode | [AudioEffectMode](#audioeffectmode10) | 是 | 音效模式。 |
| callback | AsyncCallback\<void> | 是 | 用于返回执行结果的回调。 |
**错误码:**
以下错误码的详细介绍请参见[音频错误码](../errorcodes/errorcode-audio.md)
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------|
| 6800101 | Invalid parameter error. Return by callback. |
**示例:**
```js
......@@ -4860,6 +4860,14 @@ setAudioEffectMode(mode: AudioEffectMode): Promise\<void>
| -------------- | ------------------------- |
| Promise\<void> | Promise用于返回执行结果。 |
**错误码:**
以下错误码的详细介绍请参见[音频错误码](../errorcodes/errorcode-audio.md)
| 错误码ID | 错误信息 |
| ------- | ---------------------------------------------|
| 6800101 | Invalid parameter error. Return by promise. |
**示例:**
```js
......
# multimedia子系统ChangeLog
## cl.multimedia.1 @ohos.multimedia.audio.d.ts内带入参的API10接口新增错误码声明
**变更影响**
携带入参的接口,当开发者参数类型或数量传错情况下,接口会同步抛出401错误码的异常,当参数值不符合取值范围,当接口为同步接口,会抛出相应错误码的异常,当接口为异步接口,会通过异步error返回错误码。
如果接口使用符合定义要求,则无兼容性影响。
**关键的接口/组件变更**
涉及新增错误声明的接口:
```ts
setAudioEffectMode(mode: AudioEffectMode, callback: AsyncCallback<void>): void;
setAudioEffectMode(mode: AudioEffectMode): Promise<void>;
```
涉及新增的错误码类型:
```ts
// 入参类型或数量缺少
@throws { BusinessError } 401 - If input parameter type or number mismatch.
// 入参值不符合取值范围
@throws { BusinessError } 6800101 - Invalid parameter error.
```
**适配指导**
接口使用时,当发现抛出错误码为401的异常,开发者需要检查传入的参数类型和数量是否符合接口定义。
当发现接口异步返回了错误,可以根据错误码,检查接口错误的原因,进行合理的异常处置。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册