1# multimedia子系统ChangeLog
2
3## cl.multimedia.1 @ohos.multimedia.audio.d.ts内带入参的API10接口新增错误码声明
4
5**变更影响**
6
7携带入参的接口，当开发者参数类型或数量传错情况下，接口会同步抛出401错误码的异常，当参数值不符合取值范围，当接口为同步接口，会抛出相应错误码的异常，当接口为异步接口，会通过异步error返回错误码。
8如果接口使用符合定义要求，则无兼容性影响。
9
10**关键的接口/组件变更**
11
12涉及新增错误声明的接口：
13
14 ```ts
15getPreferOutputDeviceForRendererInfo(rendererInfo: AudioRendererInfo, callback: AsyncCallback<AudioDeviceDescriptors>): void;
16getPreferOutputDeviceForRendererInfo(rendererInfo: AudioRendererInfo): Promise<AudioDeviceDescriptors>;
17on(type: 'preferredOutputDeviceChangeForRendererInfo', rendererInfo: AudioRendererInfo, callback: Callback<AudioDeviceDescriptors>): void;
18off(type: 'preferredOutputDeviceChangeForRendererInfo', callback?: Callback<AudioDeviceDescriptors>): void;
19setAudioEffectMode(mode: AudioEffectMode, callback: AsyncCallback<void>): void;
20setAudioEffectMode(mode: AudioEffectMode): Promise<void>;
21 ```
22
23涉及新增的错误码类型：
24
25 ```ts
26// 入参类型或数量缺少
27@throws { BusinessError } 401 - If input parameter type or number mismatch.
28// 入参值不符合取值范围
29@throws { BusinessError } 6800101 - Invalid parameter error.
30// 系统通用内部错误
31@throws { BusinessError } 6800301 - System error.
32 ```
33
34**适配指导**
35
36接口使用时，当发现抛出错误码为401的异常，开发者需要检查传入的参数类型和数量是否符合接口定义。
37当发现接口异步返回了错误，可以根据错误码，检查接口错误的原因，进行合理的异常处置。
38