1# multimedia子系统变更说明 2 3## cl.multimedia.1 AVErrorCode枚举值变更 4 5**访问级别** 6 7公开接口 8 9**变更原因** 10 11播放器当前上报的IO错误码只有一个,为了帮助开发者更好地了解播放失败的原因,本次细化了IO相关错误,提升生态应用友好度。 12 13**变更影响** 14 15该变更为不兼容变更。 16 17变更前:应用使用到该接口时,错误码上报规则保持不变,涉及到IO返回错误的接口返回原有的值。 18 19变更后:播放框架返回IO类网络错误时,对应的错误码会细化,涉及到IO返回错误的接口返回值会有变化,用户升级后需要适配新的错误码上报规则。 20| 接口声明 | 变更前 | 变更后 | 21| :--------------------------------------------------: | :------------------------------: | :---------------------------: | 22| AVPlayer.on(type: 'error', callback: ErrorCallback) | AVERR_IO = 5400103 | 网络场景原有错误码废弃,返回细化后的错误码5411001 ~ 5411011,其余场景不变。 | 23| void (*OH_AVPlayerOnErrorCallback)(OH_AVPlayer *player, int32_t errorCode, const char *errorMsg) | AV_ERR_IO = 4 | 网络场景原有错误码废弃,返回细化后的错误码5411001 ~ 5411011,其余场景不变。 | 24 25**起始 API Level** 26 279 28 29**变更发生的版本** 30 31从OpenHarmony SDK 5.0.0.52开始。 32 33**变更的接口/组件** 34 351. [@ohos.multimedia.media.d.ts](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.multimedia.media.d.ts)中接口: 36AVPlayer.on(type: 'error', callback: ErrorCallback)。 37 382. [avplayer_base.h](https://gitee.com/openharmony/interface_sdk_c/blob/master/multimedia/player_framework/avplayer_base.h)中接口: 39void (*OH_AVPlayerOnErrorCallback)(OH_AVPlayer *player, int32_t errorCode, const char *errorMsg)。 40 41**适配指导** 42 43变更后,应用监听IO相关错误时,需新增5411001 ~ 5411011内的错误码监听。 44 45参考[Media错误码说明文档](../../../application-dev/reference/apis-media-kit/errorcode-media.md)。