harmony 鸿蒙multimedia子系统变更说明

  • 2025-06-16
  • 浏览 (5)

multimedia子系统变更说明

cl.multimedia.1 AVErrorCode枚举值变更

访问级别

公开接口

变更原因

播放器当前上报的IO错误码只有一个,为了帮助开发者更好地了解播放失败的原因,本次细化了IO相关错误,提升生态应用友好度。

变更影响

该变更为不兼容变更。

变更前:应用使用到该接口时,错误码上报规则保持不变,涉及到IO返回错误的接口返回原有的值。

变更后:播放框架返回IO类网络错误时,对应的错误码会细化,涉及到IO返回错误的接口返回值会有变化,用户升级后需要适配新的错误码上报规则。 | 接口声明 | 变更前 | 变更后 | |:————————————————–:|:——————————:|:—————————:| |AVPlayer.on(type: ‘error’, callback: ErrorCallback)| AVERR_IO = 5400103 | 网络场景原有错误码废弃,返回细化后的错误码5411001 ~ 5411011,其余场景不变。 | |void (*OH_AVPlayerOnErrorCallback)(OH_AVPlayer *player, int32_t errorCode, const char *errorMsg)| AV_ERR_IO = 4 | 网络场景原有错误码废弃,返回细化后的错误码5411001 ~ 5411011,其余场景不变。 |

起始 API Level

9

变更发生的版本

从OpenHarmony SDK 5.0.0.52开始。

变更的接口/组件

  1. @ohos.multimedia.media.d.ts中接口: AVPlayer.on(type: ‘error’, callback: ErrorCallback)。

  2. avplayer_base.h中接口: void (*OH_AVPlayerOnErrorCallback)(OH_AVPlayer *player, int32_t errorCode, const char *errorMsg)。

适配指导

变更后,应用监听IO相关错误时,需新增5411001 ~ 5411011内的错误码监听。

参考Media错误码说明文档

你可能感兴趣的鸿蒙文章

harmony 鸿蒙程序访问控制子系统变更说明

harmony 鸿蒙ArkUI子系统Changelog

harmony 鸿蒙包管理子系统Changelog

harmony 鸿蒙DFX子系统Changelog

harmony 鸿蒙驱动子系统扩展外设管理模块Changelog

0  赞