xref: /docs/en/release-notes/api-diff/OpenHarmony_4.0.8.5/native-apidiff-avcodec.md (revision e41f4b71)

# Native API Differences

Compared with earlier versions, OpenHarmony 4.0.8.5 has the following API changes in its native APIs:
 *
## Standard System API Changes

| Module| API                                                    | Change Type| Change Description            |
| -------- | ------------------------------------------------------------ | -------- | -------------------- |
| avmuxer  | OH_AVMuxer \*OH_AVMuxer_Create(int32_t fd, OH_AVOutputFormat format); | Added    | This API is added to create an **OH_AVMuxer** instance.      |
| avmuxer  | OH_AVErrCode OH_AVMuxer_SetRotation(OH_AVMuxer \*muxer, int32_t rotation); | Added    | This API is added to set the rotation angle of an output video.    |
| avmuxer  | OH_AVErrCode OH_AVMuxer_AddTrack(OH_AVMuxer \*muxer, int32_t \*trackIndex, OH_AVFormat \*trackFormat); | Added    | This API is added to add a media track.          |
| avmuxer  | OH_AVErrCode OH_AVMuxer_Start(OH_AVMuxer \*muxer);           | Added    | This API is added to start encapsulation.            |
| avmuxer  | OH_AVErrCode OH_AVMuxer_WriteSample(OH_AVMuxer \*muxer, uint32_t trackIndex, OH_AVMemory \*sample, OH_AVCodecBufferAttr info); | Added    | This API is added to write data to the muxer.    |
| avmuxer  | OH_AVErrCode OH_AVMuxer_Stop(OH_AVMuxer \*muxer);            | Added    | This API is added to stop encapsulation.            |
| avmuxer  | OH_AVErrCode OH_AVMuxer_Destroy(OH_AVMuxer \*muxer);         | Added    | This API is added to destroy an **OH_AVMuxer** instance.      |
| avsource  | OH_AVSource *OH_AVSource_CreateWithURI(char *uri);         | Added    | This API is added to create an **OH_AVSource** instance based on a URI.      |
| avsource  | OH_AVSource *OH_AVSource_CreateWithFD(int32_t fd, int64_t offset, int64_t size);         | Added    | This API is added to create an **OH_AVSource** instance based on a file descriptor (FD).      |
| avsource  | OH_AVErrCode OH_AVSource_Destroy(OH_AVSource *source);         | Added    | This API is added to destroy an **OH_AVSource** instance.      |
| avsource  | OH_AVFormat *OH_AVSource_GetSourceFormat(OH_AVSource *source);         | Added    | This API is added to obtain source information.      |
| avsource  | OH_AVFormat *OH_AVSource_GetTrackFormat(OH_AVSource *source, uint32_t trackCount);         | Added    | This API is added to obtain track information.      |
| avdemuxer  | OH_AVDemuxer *OH_AVDemuxer_CreateWithSource(OH_AVSource *source);         | Added    | This API is added to create an **OH_AVDemuxer** instance based on source information.      |
| avdemuxer  | OH_AVErrCode OH_AVDemuxer_Destroy(OH_AVDemuxer *demuxer);         | Added    | This API is added to destroy an **OH_AVDemuxer** instance.      |
| avdemuxer  | OH_AVErrCode OH_AVDemuxer_SelectTrackByID(OH_AVDemuxer *demuxer, uint32_t trackIndex);         | Added    | This API is added to select a track, from which the demuxer reads data.     |
| avdemuxer  | OH_AVErrCode OH_AVDemuxer_UnselectTrackByID(OH_AVDemuxer *demuxer, uint32_t trackIndex);         | Added    | This API is added to deselect a track.      |
| avdemuxer  | OH_AVErrCode OH_AVDemuxer_ReadSample(OH_AVDemuxer *demuxer, uint32_t trackIndex, OH_AVMemory *sample, OH_AVCodecBufferAttr *info);         | Added    | This API is added to read the frame from a track specified by **trackIndex**.    |
| avdemuxer  | OH_AVErrCode OH_AVDemuxer_SeekToTime(OH_AVDemuxer *demuxer, int64_t millisecond, OH_AVSeekMode mode);         | Added    | This API is added to seek to the specified time.      |
|avcapability|OH_AVCapability *OH_AVCodec_GetCapability(const char *mime, bool isEncoder);|Added|This API is added to obtain a handle to the codec capability recommended by the system.|
|avcapability|OH_AVCapability *OH_AVCodec_GetCapabilityByCategory(const char *mime, bool isEncoder, OH_AVCodecCategory category);|Added|This API is added to obtain a handle to the codec capability by category, which can be a hardware codec or software codec.|
|avcapability|bool OH_AVCapability_IsHardware(OH_AVCapability *capability);|Added|This API is added to check whether a codec capability instance describes a hardware codec.|
|avcapability|const char *OH_AVCapability_GetName(OH_AVCapability *capability);|Added|This API is added to obtain the codec name.|
|avcapability|int32_t OH_AVCapability_GetMaxSupportedInstances(OH_AVCapability *capability);|Added|This API is added to obtain the maximum number of codec instances supported by a codec.|
|avcapability|OH_AVErrCode OH_AVCapability_GetEncoderBitrateRange(OH_AVCapability *capability, OH_AVRange *bitrateRange);|Added|This API is added to obtain the bit rate range supported by an encoder.|
|avcapability|bool OH_AVCapability_IsEncoderBitrateModeSupported(OH_AVCapability *capability, OH_BitrateMode bitrateMode);|Added|This API is added to check whether a specific bit rate mode is supported.|
|avcapability|OH_AVErrCode OH_AVCapability_GetEncoderQualityRange(OH_AVCapability *capability, OH_AVRange *qualityRange);|Added|This API is added to obtain the quality range supported by an encoder.|
|avcapability|OH_AVErrCode OH_AVCapability_GetEncoderComplexityRange(OH_AVCapability *capability, OH_AVRange *complexityRange);|Added|This API is added to obtain the complexity range supported by an encoder.|
|avcapability|OH_AVErrCode OH_AVCapability_GetAudioSupportedSampleRates(OH_AVCapability *capability, const int32_t **sampleRates, uint32_t *sampleRateNum);|Added|This API is added to obtain the sampling rates supported by an audio codec.|
|avcapability|OH_AVErrCode OH_AVCapability_GetAudioChannelCountRange(OH_AVCapability *capability, OH_AVRange *channelCountRange);|Added|This API is added to obtain the count range of audio channels supported by an audio codec.|
|avcapability|OH_AVErrCode OH_AVCapability_GetVideoWidthAlignment(OH_AVCapability *capability, int32_t *widthAlignment);|Added|This API is added to obtain the video width alignment.|
|avcapability|OH_AVErrCode OH_AVCapability_GetVideoHeightAlignment(OH_AVCapability *capability, int32_t *heightAlignment);|Added|This API is added to obtain the video height alignment.|
|avcapability|OH_AVErrCode OH_AVCapability_GetVideoWidthRangeForHeight(OH_AVCapability *capability, int32_t height, OH_AVRange *widthRange);|Added|This API is added to obtain the video width range based on a given height.|
|avcapability|OH_AVErrCode OH_AVCapability_GetVideoHeightRangeForWidth(OH_AVCapability *capability, int32_t width, OH_AVRange *heightRange);|Added|This API is added to obtain the video height range based on a given width.|
|avcapability|OH_AVErrCode OH_AVCapability_GetVideoWidthRange(OH_AVCapability *capability, OH_AVRange *widthRange);|Added|This API is added to obtain the video width range.|
|avcapability|OH_AVErrCode OH_AVCapability_GetVideoHeightRange(OH_AVCapability *capability, OH_AVRange *heightRange);|Added|This API is added to obtain the video height range.|
|avcapability|bool OH_AVCapability_IsVideoSizeSupported(OH_AVCapability *capability, int32_t width, int32_t height);|Added|This API is added to check whether a video size is supported.|
|avcapability|OH_AVErrCode OH_AVCapability_GetVideoFrameRateRange(OH_AVCapability *capability, OH_AVRange *frameRateRange);|Added|This API is added to obtain the video frame rate range.|
|avcapability|OH_AVErrCode OH_AVCapability_GetVideoFrameRateRangeForSize(OH_AVCapability *capability, int32_t width, int32_t height, OH_AVRange *frameRateRange);|Added|This API is added to obtain the video frame rate range based on a given size.|
|avcapability|bool OH_AVCapability_AreVideoSizeAndFrameRateSupported(OH_AVCapability *capability, int32_t width, int32_t height, int32_t frameRate);|Added|This API is added to check whether the combination of a video size and frame rate is supported.|
|avcapability|OH_AVErrCode OH_AVCapability_GetVideoSupportedPixelFormats(OH_AVCapability *capability, const int32_t **pixFormats, uint32_t *pixFormatNum);|Added|This API is added to obtain the video pixel formats supported.|
|avcapability|OH_AVErrCode OH_AVCapability_GetSupportedProfiles(OH_AVCapability *capability, const int32_t **profiles, uint32_t *profileNum);|Added|This API is added to obtain the profiles supported.|
|avcapability|OH_AVErrCode OH_AVCapability_GetSupportedLevelsForProfile(OH_AVCapability *capability, int32_t profile, const int32_t **levels,uint32_t *levelNum);|Added|This API is added to obtain the codec levels supported by a profile.|
|avcapability|bool OH_AVCapability_AreProfileAndLevelSupported(OH_AVCapability *capability, int32_t profile, int32_t level);|Added|This API is added to check whether the combination of a profile and level is supported.|
|avformat|struct OH_AVFormat \*OH_AVFormat_CreateAudioFormat(const char \*mimeType, int32_t sampleRate, int32_t channelCount);|Added|This API is added to create an **OH_AVFormat** instance for an audio track (used in **avmuxer**).|
|avformat|struct OH_AVFormat \*OH_AVFormat_CreateVideoFormat(const char \*mimeType, int32_t width, int32_t height);|Added|This API is added to create an **OH_AVFormat** instance for a video track (used in avmuxer).|
|avmemory|OH_AVMemory \*OH_AVMemory_Create(int32_t size);|Added|This API is added to create an **OH_AVMemory** instance.|
|avmemory|OH_AVErrCode OH_AVMemory_Destroy(struct OH_AVMemory \*mem);|Added|This API is added to destroy an **OH_AVMemory** instance.|
| avcodec | OH_AVErrCode OH_AudioDecoder_IsValid(OH_AVCodec \*codec, bool \*isValid); | Added| This API is added to check whether a codec instance is valid. It is used for fault rectification.|
| avcodec | OH_AVErrCode OH_AudioEncoder_IsValid(OH_AVCodec \*codec, bool \*isValid); | Added| This API is added to check whether a codec instance is valid. It is used for fault rectification.|
| avcodec  | OH_AVErrCode OH_VideoDecoder_IsValid(OH_AVCodec \*codec, bool \*isValid);         | Added    | This API is added to check whether a codec instance is valid.     |
| avcodec  | OH_AVErrCode OH_VideoEncoder_IsValid(OH_AVCodec \*codec, bool \*isValid);         | Added    | This API is added to check whether a codec instance is valid.     |
| avcodec  | OH_AVErrCode OH_VideoEncoder_PushInputData(OH_AVCodec \*codec, uint32_t index, OH_AVCodecBufferAttr attr);         | Added    | This API is added to push the input buffer filled with data to a video encoder.     |
| avcodec  | OH_AVFormat \*OH_VideoEncoder_GetInputDescription(OH_AVCodec \*codec);         | Added    | This API is added to obtain the description received by a video encoder.     |