• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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)。