multimedia子系统变更说明

cl.multimedia.1 Core模块接口废弃

访问级别

公开接口

变更原因

媒体数据结构AVMemory废弃，支持AVBuffer。

变更影响

该变更为兼容性变更，需要开发者进行适配。

API Level

变更发生版本

从OpenHarmony SDK 4.1.6.3 开始。

变更的接口/组件

适配指导

变更前：

在媒体编解码/封装/解封装等功能实现时，使用AVMemory相应的创建/获取内存地址/内存长度/销毁接口操作数据内存

变更后：

在媒体编解码/封装/解封装等功能实现时，使用AVBuffer相应的创建/获取内存地址/内存长度/销毁接口操作数据内存

cl.multimedia.2 CodecBase模块接口废弃

访问级别

公开接口

变更原因

接口数据流转废弃AVMemory，支持AVBuffer，删除不支持的规格。

变更影响

该变更为兼容性变更，需要开发者进行适配。

API Level

变更发生版本

从OpenHarmony SDK 4.1.6.3 开始。

变更的接口/组件

适配指导

变更前：

音视频编解码器，注册回调函数指针集合OH_AVCodecAsyncCallback，其中：

编解码输入回调实现OH_AVCodecOnNeedInputData

编解码输出回调实现OH_AVCodecOnNewOutputData

封装格式指定为OH_AVCODEC_MIMETYPE_VIDEO_MPEG4进行封装

使用 AudioChannelSet 枚举定义音频声道设置

使用 AudioChanelLayout 枚举定义音频声道布局

变更后：

音视频编解码器，注册回调函数指针集合OH_AVCodecCallback，其中：

编解码输入回调实现OH_AVCodecOnNeedInputBuffer

编解码输出回调实现OH_AVCodecOnNewOutputBuffer

封装格式不支持OH_AVCODEC_MIMETYPE_VIDEO_MPEG4

使用 OH_AudioChannelSet 枚举定义音频声道设置

使用 OH_AudioChannelLayout 枚举定义音频声道布局

cl.multimedia.3 VideoDecoder模块接口废弃

访问级别

公开接口

变更原因

接口数据流转废弃AVMemory，支持AVBuffer

变更影响

该变更为兼容性变更，需要开发者进行适配。

API Level

变更发生版本

从OpenHarmony SDK 4.1.6.3 开始。

变更的接口/组件

适配指导

变更前：

调用OH_VideoDecoder_SetCallback()设置回调函数

当收到输入回调通知，调用OH_VideoDecoder_PushInputData填入码流数据

当收到输出回调通知，调用OH_VideoDecoder_FreeOutputData释放输出图像或调用OH_VideoDecoder_RenderOutputData渲染图像

变更后：

调用OH_VideoDecoder_RegisterCallback()设置回调函数

当收到输入回调通知，调用OH_VideoDecoder_PushInputBuffer填入码流数据

当收到输出回调通知，调用OH_VideoDecoder_FreeOutputBuffer释放输出图像或调用OH_VideoDecoder_RenderOutputBuffer渲染图像

cl.multimedia.4 VideoEncoder模块接口废弃

访问级别

公开接口

变更原因

接口数据流转废弃AVMemory，支持AVBuffer

变更影响

该变更为兼容性变更，需要开发者进行适配。

API Level

变更发生版本

从OpenHarmony SDK 4.1.6.3 开始。

变更的接口/组件

适配指导

变更前：

调用OH_VideoEncoder_SetCallback()设置回调函数

当收到输入回调通知，调用OH_VideoEncoder_PushInputData填入待编码数据

当收到输出回调通知，调用OH_VideoEncoder_FreeOutputData释放输出数据

变更后：

调用OH_VideoEncoder_RegisterCallback()设置回调函数

当收到输入回调通知，调用OH_VideoEncoder_PushInputBuffer填入待编码数据

当收到输出回调通知，调用OH_VideoEncoder_FreeOutputBuffer释放输出数据

cl.multimedia.5 AVDemuxer模块接口废弃

访问级别

公开接口

变更原因

接口数据流转废弃AVMemory，支持AVBuffer

变更影响

该变更为兼容性变更，需要开发者进行适配。

API Level

变更发生版本

从OpenHarmony SDK 4.1.6.3 开始。

变更的接口/组件

适配指导

变更前：

调用OH_AVDemuxer_ReadSample()获取压缩帧及相关信息

变更后：

调用OH_AVDemuxer_ReadSampleBuffer()获取压缩帧及相关信息

cl.multimedia.6 AVMuxer模块接口废弃

访问级别

公开接口

变更原因

接口数据流转废弃AVMemory，支持AVBuffer

变更影响

该变更为兼容性变更，需要开发者进行适配。

API Level

变更发生版本

从OpenHarmony SDK 4.1.6.3 开始。

变更的接口/组件

适配指导

变更前：

调用OH_AVMuxer_WriteSample()写入压缩帧及相关信息

变更后：

调用OH_AVMuxer_WriteSampleBuffer()写入压缩帧及相关信息

cl.multimedia.7 AudioDecoder模块接口废弃

访问级别

公开接口

变更原因

接口数据流转废弃AVMemory，支持AVBuffer，原音频解码模块变更为音频编解码模块。

变更影响

该变更为兼容性变更，需要开发者进行适配。

API Level

变更发生版本

从OpenHarmony SDK 4.1.6.3 开始。

变更的接口/组件

适配指导

变更前：

调用OH_AudioDecoder_CreateByName()或OH_AudioDecoder_CreateByMime()，创建解码器。

调用OH_AudioDecoder_SetCallback()，设置回调函数。

调用OH_AudioDecoder_Configure()，配置解码器。

调用OH_AudioDecoder_Prepare()，解码器就绪。

调用OH_AudioDecoder_Start()，启动解码器，进入运行态。

调用OH_AudioDecoder_PushInputData()，写入待解码的数据。

调用OH_AudioDecoder_FreeOutputData()，输出解码后的PCM码流。

（可选）调用OH_AudioDecoder_Flush()，刷新解码器。

（可选）调用OH_AudioDecoder_IsValid()，可以判断在执行过程中是否可以继续执行。

（可选）调用OH_AudioDecoder_Reset()，重置解码器。

调用OH_AudioDecoder_Stop()，停止解码器。

调用OH_AudioDecoder_Destroy()，销毁解码器实例，释放资源。

变更后：

调用OH_AudioCodec_CreateByName()或OH_AudioCodec_CreateByMime，创建编解码器。

调用OH_AudioCodec_SetCallback()，设置回调函数。

调用OH_AudioCodec_Configure()，配置编解码器。

调用OH_AudioCodec_Prepare()，编解码器就绪。

调用OH_AudioCodec_Start()，启动编解码器，进入运行态。

调用OH_AudioCodec_PushInputData()，写入待编解码的数据。

调用OH_AudioCodec_FreeOutputData()，输出编解码格式码流。

（可选）调用OH_AudioCodec_Flush()，刷新编解码器。

（可选）调用OH_AudioCodec_IsValid()，可以判断在执行过程中是否可以继续执行。

（可选）调用OH_AudioCodec_Reset()，重置编解码器。

调用OH_AudioCodec_Stop()，停止编解码器。

调用OH_AudioCodec_Destroy()，销毁编解码器实例，释放资源。

cl.multimedia.8 AudioEncoder模块接口废弃

访问级别

公开接口

变更原因

接口数据流转废弃AVMemory，支持AVBuffer，原音频编码模块变更为音频编解码模块。

变更影响

该变更为兼容性变更，需要开发者进行适配。

API Level

变更发生版本

从OpenHarmony SDK 4.1.6.3 开始。

变更的接口/组件

适配指导

变更前：

调用OH_AudioEncoder_CreateByName()或OH_AudioEncoder_CreateByMime，创建编码器。

调用OH_AudioEncoder_SetCallback()，设置回调函数。

调用OH_AudioEncoder_Configure()，配置编码器。

调用OH_AudioEncoder_Prepare()，编码器就绪。

调用OH_AudioEncoder_Start()，启动编码器，进入运行态。

调用OH_AudioEncoder_PushInputData()，写入待编码的数据。

调用OH_AudioEncoder_FreeOutputData()，输出编码格式码流。

（可选）调用OH_AudioEncoder_Flush()，刷新编码器。

（可选）调用OH_AudioEncoder_IsValid()，可以判断在执行过程中是否可以继续执行。

（可选）调用OH_AudioEncoder_Reset()，重置编码器。

调用OH_AudioEncoder_Stop()，停止编码器。

调用OH_AudioEncoder_Destroy() 销毁编码器实例，释放资源。

变更后：

调用OH_AudioCodec_CreateByName() 或 OH_AudioCodec_CreateByMime，创建编解码器。

调用OH_AudioCodec_SetCallback()，设置回调函数。

调用OH_AudioCodec_Configure()，配置编解码器。

调用OH_AudioCodec_Prepare()，编解码器就绪。

调用OH_AudioCodec_Start()，启动编解码器，进入运行态。

调用OH_AudioCodec_PushInputData()，写入待编解码的数据。

调用OH_AudioCodec_FreeOutputData()，输出编解码格式码流。

（可选）调用OH_AudioCodec_Flush()，刷新编解码器。

（可选）调用OH_AudioCodec_IsValid()，可以判断在执行过程中是否可以继续执行。

（可选）调用OH_AudioCodec_Reset()，重置编解码器。

调用OH_AudioCodec_Stop()，停止编解码器。

调用OH_AudioCodec_Destroy()，销毁编解码器实例，释放资源。

cl.multimedia.9 AVPlayer/AVRecorder支持的格式规格变更

访问级别

公开接口

变更原因

使用AVCodec进行解封装、编解码。

变更影响

不支持以下格式： 解封装格式：WebM 视频解码：H.263, MPEG2, MPEG4, VP8 视频编码：MPEG4

API Level

11

变更发生版本

从OpenHarmony SDK 4.1.6.3开始。

变更的接口/组件 AVPlayer组件，AVRecorder组件

适配指导 1. 视频编码使用 AVC 代替MPEG4。 2. 音视频播放资源涉及封装格式 WebM，或视频解码格式 H.263/MPEG2/MPEG4/VP8，会播放失败，尽量使用封装格式 MP4，视频解码格式 AVC 的资源代替。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkUI子系统变更说明

harmony 鸿蒙图形子系统变更说明

harmony 鸿蒙包管理子系统变更说明

harmony 鸿蒙Camera子系统变更说明

harmony 鸿蒙输入法框架子系统ChangeLog