harmony 鸿蒙Codec（V1_0）
Codec（V1_0）
概述
Codec模块接口定义。
Codec模块涉及自定义类型、音视频编解码组件初始化、参数设置、数据的轮转和控制等。
起始版本： 3.2
汇总
文件
| 名称 | 描述 |
|---|---|
| CodecImageType.idl | 定义图像编解码器模块API中使用的自定义数据类型，包括编解码器图像参数、类型和缓冲区。 |
| CodecTypes.idl | Codec模块接口定义中使用的自定义数据类型。 |
| ICodecCallback.idl | 主要包括回调函数接口定义。 |
| ICodecComponent.idl | 主要包括Codec组件接口定义。 |
| ICodecComponentManager.idl | 主要包括Codec组件管理类接口。 |
| ICodecImage.idl | 定义图像编解码器的API。 |
类
| 名称 | 描述 |
|---|---|
| struct CodecImageRegion | 定义图像区域信息。 |
| struct CodecImageBuffer | 定义编解码图像缓冲区信息。 |
| struct CodecImageCapability | 定义图像编解码器功能。 |
| struct CodecJpegQuantTable | 定义jpeg图像量化表信息。 |
| struct CodecJpegHuffTable | 定义jpeg图像Huffman表信息。 |
| struct CodecJpegCompInfo | 定义jpeg图像的颜色分量信息。 |
| struct CodecJpegDecInfo | 定义jpeg图像解码信息。 |
| struct Alignment | 对齐结构定义。 |
| struct Rect | 矩形的定义。 |
| struct RangeValue | 取值范围的定义。 |
| struct CodecVideoPortCap | 定义视频编解码能力。 |
| struct CodecAudioPortCap | 定义音频编解码能力。 |
| struct PortCap | 定义音视频编解码能力。 |
| struct OmxVerType | 定义组件的版本信息。 |
| union OMX_VERSIONTYPE | 定义组件的版本信息。 |
| struct CodecCompCapability | 定义Codec编解码能力。 |
| struct OmxCodecBuffer | Codec buffer信息的定义。 |
| struct OMX_TUNNELSETUPTYPE | 用于将数据从输出端口传递到输入端口。 |
| struct CompVerInfo | 定义了组件信息，包含组件名，UUID， 组件版本以及spec版本。 |
| struct EventInfo | 定义事件上报信息。 |
| interface ICodecCallback | Codec回调接口定义。 |
| interface ICodecComponent | Codec组件接口定义。 |
| interface ICodecComponentManager | Codec组件管理类接口定义。 |
| interface ICodecImage | 图像编解码器模块接口。 |
枚举
| 名称 | 描述 |
|---|---|
| CodecImageRole { CODEC_IMAGE_JPEG = 0 , CODEC_IMAGE_HEIF , CODEC_IMAGE_INVALID } | 编解码的图像格式枚举。 |
| CodecImageType { CODEC_IMAGE_TYPE_DECODER = 0 , CODEC_IMAGE_TYPE_ENCODER , CODEC_IMAGE_TYPE_INVALID } | 定义图像编解码器类型。 |
| CodecType { VIDEO_DECODER, VIDEO_ENCODER, AUDIO_DECODER, AUDIO_ENCODER, INVALID_TYPE } |
枚举编解码的类型。 |
| AvCodecRole { MEDIA_ROLETYPE_IMAGE_JPEG = 0, MEDIA_ROLETYPE_VIDEO_AVC, MEDIA_ROLETYPE_VIDEO_HEVC, MEDIA_ROLETYPE_AUDIO_FIRST = 0x10000, MEDIA_ROLETYPE_AUDIO_AAC = 0x10000, MEDIA_ROLETYPE_AUDIO_G711A, MEDIA_ROLETYPE_AUDIO_G711U, MEDIA_ROLETYPE_AUDIO_G726, MEDIA_ROLETYPE_AUDIO_PCM, MEDIA_ROLETYPE_AUDIO_MP3, MEDIA_ROLETYPE_INVALID } |
枚举音视频编解码组件类型。 |
| Profile { INVALID_PROFILE = 0, AAC_LC_PROFILE = 0x1000, AAC_MAIN_PROFILE, AAC_HE_V1_PROFILE, AAC_HE_V2_PROFILE, AAC_LD_PROFILE, AAC_ELD_PROFILE, AVC_BASELINE_PROFILE = 0x2000, AVC_MAIN_PROFILE, AVC_HIGH_PROFILE, HEVC_MAIN_PROFILE = 0x3000, HEVC_MAIN_10_PROFILE } |
枚举Codec规格。 |
| CodecCapsMask { CODEC_CAP_ADAPTIVE_PLAYBACK = 0x1, CODEC_CAP_SECURE_PLAYBACK = 0x2, CODEC_CAP_TUNNEL_PLAYBACK = 0x4, CODEC_CAP_MULTI_PLANE = 0x10000 } | 枚举播放能力。 |
| AudioSampleRate { AUD_SAMPLE_RATE_8000 = 8000, AUD_SAMPLE_RATE_12000 = 12000, AUD_SAMPLE_RATE_11025 = 11025, AUD_SAMPLE_RATE_16000 = 16000, AUD_SAMPLE_RATE_22050 = 22050, AUD_SAMPLE_RATE_24000 = 24000, AUD_SAMPLE_RATE_32000 = 32000, AUD_SAMPLE_RATE_44100 = 44100, AUD_SAMPLE_RATE_48000 = 48000, AUD_SAMPLE_RATE_64000 = 64000, AUD_SAMPLE_RATE_96000 = 96000, AUD_SAMPLE_RATE_INVALID } |
枚举音频采样率。 |
| AudioSampleFormat { AUDIO_SAMPLE_FMT_U8 , AUDIO_SAMPLE_FMT_S16 , AUDIO_SAMPLE_FMT_S32 , AUDIO_SAMPLE_FMT_FLOAT , AUDIO_SAMPLE_FMT_DOUBLE , AUDIO_SAMPLE_FMT_U8P , AUDIO_SAMPLE_FMT_S16P , AUDIO_SAMPLE_FMT_S32P , AUDIO_SAMPLE_FMT_FLOATP , AUDIO_SAMPLE_FMT_DOUBLEP , AUDIO_SAMPLE_FMT_INVALID } |
枚举音频采样格式。 |
| CodecProcessMode { PROCESS_BLOCKING_INPUT_BUFFER = 0X1, PROCESS_BLOCKING_OUTPUT_BUFFER = 0X2, PROCESS_BLOCKING_CONTROL_FLOW = 0X4, PROCESS_NONBLOCKING_INPUT_BUFFER = 0X100, PROCESS_NONBLOCKING_OUTPUT_BUFFER = 0X200, PROCESS_NONBLOCKING_CONTROL_FLOW = 0X400 } |
枚举编解码处理模式。 |
| ShareMemTypes { READ_WRITE_TYPE = 0x1, READ_ONLY_TYPE = 0x2 } | 枚举共享内存类型。 |
| BitRateMode { BIT_RATE_MODE_INVALID , BIT_RATE_MODE_VBR , BIT_RATE_MODE_CBR , BIT_RATE_MODE_CQ , BIT_RATE_MODE_VCBR , BIT_RATE_MODE_ABR } |
枚举比特率类型。 |
| CodecEventType { OMX_EventCmdComplete , OMX_EventError , OMX_EventMark , OMX_EventPortSettingsChanged , OMX_EventBufferFlag , OMX_EventResourcesAcquired , OMX_EventComponentResumed , OMX_EventDynamicResourcesAvailable , OMX_EventPortFormatDetected , OMX_EventKhronosExtensions = 0x6F000000 , OMX_EventVendorStartUnused = 0x7F000000 , OMX_EventMax = 0x7FFFFFFF } |
枚举组件状态 |
| CodecCommandType { OMX_CommandStateSet , OMX_CommandFlush , OMX_CommandPortDisable , OMX_CommandPortEnable , OMX_CommandMarkBuffer , OMX_CommandKhronosExtensions = 0x6F000000 , OMX_CommandVendorStartUnused = 0x7F000000 , OMX_CommandMax = 0x7FFFFFFF } |
枚举ICodecComponent中SendCommand接口的cmd参数 |
| CodecStateType { OMX_StateInvalid , OMX_StateLoaded , OMX_StateIdle , OMX_StateExecuting , OMX_StatePause , OMX_StateWaitForResources , OMX_StateKhronosExtensions = 0x6F000000 , OMX_StateVendorStartUnused = 0x7F000000 , OMX_StateMax = 0x7FFFFFFF } |
更改组件状态 |
| CodecBufferSupplierType { OMX_BufferSupplyUnspecified = 0 , OMX_BufferSupplyInput , OMX_BufferSupplyOutput , OMX_BufferSupplyKhronosExtensions = 0x6F000000 , OMX_BufferSupplyVendorStartUnused = 0x7F000000 , OMX_BufferSupplyMax = 0x7FFFFFFF } |
表示端口供应商在两个端口之间建立隧道时的首选项 |
枚举类型说明
AudioSampleFormat
enum AudioSampleFormat
描述
枚举音频采样格式。
对于平面格式的采样格式，每个声道的数据是独立存储在data中; 对于打包格式的采样格式，只使用第一个data，每个声道的数据是交错存储的。
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| AUDIO_SAMPLE_FMT_U8 | 无符号8位整型，打包格式。 |
| AUDIO_SAMPLE_FMT_S16 | 带符号16位整型, 打包格式。 |
| AUDIO_SAMPLE_FMT_S32 | 带符号32位整型, 打包格式。 |
| AUDIO_SAMPLE_FMT_FLOAT | 浮点型, 打包格式。 |
| AUDIO_SAMPLE_FMT_DOUBLE | 双精度浮点型, 打包格式。 |
| AUDIO_SAMPLE_FMT_U8P | 无符号8位整型, 平面格式。 |
| AUDIO_SAMPLE_FMT_S16P | 带符号16位整型, 平面格式。 |
| AUDIO_SAMPLE_FMT_S32P | 带符号32位整型, 平面格式。 |
| AUDIO_SAMPLE_FMT_FLOATP | 浮点型, 平面格式。 |
| AUDIO_SAMPLE_FMT_DOUBLEP | 双精度浮点型, 平面格式。 |
| AUDIO_SAMPLE_FMT_INVALID | 无效采样格式。 |
AudioSampleRate
enum AudioSampleRate
描述
枚举音频采样率。
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| AUD_SAMPLE_RATE_8000 | 8K采样率。 |
| AUD_SAMPLE_RATE_12000 | 12K采样率。 |
| AUD_SAMPLE_RATE_11025 | 11.025K采样率。 |
| AUD_SAMPLE_RATE_16000 | 16K采样率。 |
| AUD_SAMPLE_RATE_22050 | 22.050K采样率。 |
| AUD_SAMPLE_RATE_24000 | 24K采样率。 |
| AUD_SAMPLE_RATE_32000 | 32K采样率。 |
| AUD_SAMPLE_RATE_44100 | 44.1K采样率。 |
| AUD_SAMPLE_RATE_48000 | 48K采样率。 |
| AUD_SAMPLE_RATE_64000 | 64K采样率。 |
| AUD_SAMPLE_RATE_96000 | 96K采样率。 |
| AUD_SAMPLE_RATE_INVALID | 无效采样率。 |
AvCodecRole
enum AvCodecRole
描述
枚举音视频编解码组件类型。
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| MEDIA_ROLETYPE_IMAGE_JPEG | 图像JPEG媒体类型。 |
| MEDIA_ROLETYPE_VIDEO_AVC | 视频H.264媒体类型。 |
| MEDIA_ROLETYPE_VIDEO_HEVC | 视频H.265媒体类型。 |
| MEDIA_ROLETYPE_AUDIO_FIRST | 音频编解码器类型。 |
| MEDIA_ROLETYPE_AUDIO_AAC | 音频AAC媒体类型。 |
| MEDIA_ROLETYPE_AUDIO_G711A | 音频G711A媒体类型。 |
| MEDIA_ROLETYPE_AUDIO_G711U | 音频G711U媒体类型。 |
| MEDIA_ROLETYPE_AUDIO_G726 | 音频G726媒体类型。 |
| MEDIA_ROLETYPE_AUDIO_PCM | 音频PCM媒体类型。 |
| MEDIA_ROLETYPE_AUDIO_MP3 | 音频MP3媒体类型。 |
| MEDIA_ROLETYPE_INVALID | 无效媒体类型。 |
BitRateMode
enum BitRateMode
描述
枚举比特率类型。
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| BIT_RATE_MODE_INVALID | 定义的一个无效值。 |
| BIT_RATE_MODE_VBR | 可变比特率。 |
| BIT_RATE_MODE_CBR | 恒定比特率。 |
| BIT_RATE_MODE_CQ | 恒定质量。 |
| BIT_RATE_MODE_VCBR | 受约束的可变位速率。 |
| BIT_RATE_MODE_ABR | 平均比特率。 |
CodecBufferSupplierType
enum CodecBufferSupplierType
描述
表示端口供应商在两个端口之间建立隧道时的首选项
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| CODEC_BUFFER_SUPPLY_UNSPECIFIED | 提供缓冲区的端口未指定，或不指定 |
| CODEC_BUFFER_SUPPLY_INPUT | 为输入端口提供缓冲区 |
| CODEC_BUFFER_SUPPLY_OUTPUT | 为输出端口提供缓冲区 |
| CODEC_BUFFER_SUPPLY_KHRONOS_EXTENSIONS | 用于引入Khronos标准扩展的保留区域 |
| CODEC_BUFFER_SUPPLY_VENDOR_START_UNUSED | 用于引入供应商扩展的预留区域 |
| CODEC_BUFFER_SUPPLY_MAX | 枚举的最大值 |
CodecCapsMask
enum CodecCapsMask
描述
枚举播放能力。
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| CODEC_CAP_ADAPTIVE_PLAYBACK | 自适应播放能力。 |
| CODEC_CAP_SECURE_PLAYBACK | 安全播放能力。 |
| CODEC_CAP_TUNNEL_PLAYBACK | 通道播放能力。 |
| CODEC_CAP_MULTI_PLANE | 视频图像平面/音频通道平面能力。 |
CodecCommandType
enum CodecCommandType
描述
枚举ICodecComponent中SendCommand接口的cmd参数
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| CODEC_COMMAND_STATE_SET | 更改组件状态 |
| CODEC_COMMAND_FLUSH | 刷新组件的数据队列 |
| CODEC_COMMAND_PORT_DISABLE | 禁用组件上的端口 |
| CODEC_COMMAND_PORT_ENABLE | 启用组件上的端口 |
| CODEC_COMMAND_MARK_BUFFER | 标记组件/缓冲区以进行观察 |
| CODEC_COMMAND_KHRONOS_EXTENSIONS | 用于引入Khronos标准扩展的保留区域 |
| CODEC_COMMAND_VENDOR_START_UNUSED | 用于引入供应商扩展的预留区域 |
| CODEC_COMMAND_MAX | 枚举的最大值 |
CodecEventType
enum CodecEventType
描述
枚举组件状态
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| CODEC_EVENT_CMD_COMPLETE | 组件已成功完成命令 |
| CODEC_EVENT_ERROR | 组件已检测到错误情况 |
| CODEC_EVENT_MARK | 组件已检测到缓冲区标记 |
| CODEC_EVENT_PORT_SETTINGS_CHANGED | 组件报告端口设置更改 |
| CODEC_EVENT_BUFFER_FLAG | 组件已检测到EOS |
| CODEC_EVENT_RESOURCES_ACQUIRED | 组件已被授予资源，并正在自动启动从OMX_StateWaitForResources状态更改为OMX_StateIdle |
| CODEC_EVENT_COMPONENT_RESUMED | 组件回收由于重新占用的资源 |
| CODEC_EVENT_DYNAMIC_RESOURCES_AVAILABLE | 组件已获取此前不可用的动态资源 |
| CODEC_EVENT_PORT_FORMAT_DETECTED | 组件已经检测出数据格式 |
| CODEC_EVENT_KHRONOS_EXTENSIONS | 用于引入Khronos标准扩展的保留区域 |
| CODEC_EVENT_VENDOR_START_UNUSED | 用于引入供应商扩展的预留区域 |
| CODEC_EVENT_MAX | 枚举的最大值 |
CodecImageRole
enum CodecImageRole
描述
编解码的图像格式枚举。
起始版本： 4.0
| 枚举值 | 描述 |
|---|---|
| CODEC_IMAGE_JPEG | Jpeg格式. |
| CODEC_IMAGE_HEIF | Heif格式. |
| CODEC_IMAGE_INVALID | 无效的格式 |
CodecImageType
enum CodecImageType
描述
定义图像编解码器类型。
起始版本： 4.0
| 枚举值 | 描述 |
|---|---|
| CODEC_IMAGE_TYPE_DECODER | 图像解码器。 |
| CODEC_IMAGE_TYPE_ENCODER | 图像编码器。 |
| CODEC_IMAGE_TYPE_INVALID | 无效类型 |
CodecProcessMode
enum CodecProcessMode
描述
枚举编解码处理模式。
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| PROCESS_BLOCKING_INPUT_BUFFER | 同步模式输入buffer。 |
| PROCESS_BLOCKING_OUTPUT_BUFFER | 同步模式输出buffer。 |
| PROCESS_BLOCKING_CONTROL_FLOW | 同步模式控制流。 |
| PROCESS_NONBLOCKING_INPUT_BUFFER | 异步模式输入buffer。 |
| PROCESS_NONBLOCKING_OUTPUT_BUFFER | 异步模式输出buffer。 |
| PROCESS_NONBLOCKING_CONTROL_FLOW | 异步模式控制流。 |
CodecStateType
enum CodecStateType
描述
更改组件状态
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| CODEC_STATE_INVALID | 组件已检测到其内部数据结构已损坏，以至于无法正确确定其状态 |
| CODEC_STATE_LOADED | 组件已加载，但尚未完成初始化。ICodecComponent.SetParameter 和ICodecComponent.GetParameter是允许发送到处于此状态的组件的唯一有效函数 |
| CODEC_STATE_IDLE | 组件初始化已成功完成，组件已准备好启动 |
| CODEC_STATE_EXECUTING | 组件已接受启动命令并正在处理数据（如果数据可用） |
| CODEC_STATE_PAUSE | 组件已收到暂停命令 |
| CODEC_STATE_WAIT_FOR_RESOURCES | 组件正在等待资源，无论是在抢占之后还是在获得请求的资源之前 |
| CODEC_STATE_KHRONOS_EXTENSIONS | 用于引入Khronos标准扩展的保留区域 |
| CODEC_STATE_VENDOR_START_UNUSED | 用于引入供应商扩展的预留区域 |
| CODEC_STATE_MAX | 枚举最大值 |
CodecType
enum CodecType
描述
枚举编解码的类型。
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| VIDEO_DECODER | 视频解码类型。 |
| VIDEO_ENCODER | 视频编码类型。 |
| AUDIO_DECODER | 音频解码类型。 |
| AUDIO_ENCODER | 音频编码类型。 |
| INVALID_TYPE | 无效类型。 |
Profile
enum Profile
描述
枚举Codec规格。
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| INVALID_PROFILE | 无效的规格。 |
| AAC_LC_PROFILE | AAC低复杂度规格。 |
| AAC_MAIN_PROFILE | AAC主规格。 |
| AAC_HE_V1_PROFILE | AAC高效率和频带重现规格，又称为HEAAC、AAC+、或者AACPlusV1。 |
| AAC_HE_V2_PROFILE | AAC高效率和频带重现以及变量立体声规格，又称为AAC++或者AACPlusV2。 |
| AAC_LD_PROFILE | AAC低延迟规格。 |
| AAC_ELD_PROFILE | AAC增强型低延迟规格。 |
| AVC_BASELINE_PROFILE | H.264低规格。 |
| AVC_MAIN_PROFILE | H.264主规格。 |
| AVC_HIGH_PROFILE | H.264高规格。 |
| HEVC_MAIN_PROFILE | H.265主规格。 |
| HEVC_MAIN_10_PROFILE | H.265 10比特主规格。 |
ShareMemTypes
enum ShareMemTypes
描述
枚举共享内存类型。
起始版本： 3.2
| 枚举值 | 描述 |
|---|---|
| READ_WRITE_TYPE | 可读可写的共享内存类型。 |
| READ_ONLY_TYPE | 只读的共享内存类型。 |
你可能感兴趣的鸿蒙文章
0
赞
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
7、 openharmony
-
9、 golang