Android 13 - Media框架（14）- OpenMax（四）

这一节继续了解 openmax 目录下的内容。

1、OMX_Core.h

1.1、OMX_BUFFERHEADERTYPE

这是一个比较关键的结构体，上层ACodec/MediaCodec用到的 buffer id、OMXNode 与 OMX component 进行 buffer 传递都是通过该结构体完成，这里将会初步了解结构体中的部分成员意义：

• OMX_U32 nSize：结构体的大小，用的不多；
• OMX_U8* pBuffer：指向真正存储数据的 buffer；
• OMX_U32 nAllocLen：分配的 buffer 的字节数；
• OMX_U32 nFilledLen：buffer中填充的数据的字节数；
• OMX_U32 nOffset：buffer 有效数据的偏移量；
• OMX_PTR pAppPrivate：指向应用层与之关联的 buffer；
• OMX_PTR pPlatformPrivate：指向平台与之关联的 buffer；
• OMX_PTR pInputPortPrivate：指向 input 端口与之关联的 buffer；
• OMX_PTR pOutputPortPrivate：指向 output 端口与之关联的 buffer；
• OMX_TICKS nTimeStamp：buffer 对应的 pts；
• OMX_U32 nFlags：buffer 所携带的标志位；
• OMX_U32 nOutputPortIndex：输出端口上的索引；
• OMX_U32 nInputPortIndex：输入端口上的索引；

结构体中 pBuffer、pAppPrivate、pPlatformPrivate 指向的内容这里暂时不做了解，后面了解 OMXNode 时再做研究。

1.2、OMX_EVENTTYPE

这个枚举类型定义了 OMX 组件的 callback 事件：

• OMX_EventCmdComplete：组件执行完成一个命令；
• OMX_EventError：组件发生错误；
• OMX_EventMark：组件检测到 buffer 标识，用的较少；
• OMX_EventPortSettingsChanged：组件的端口设置发生变化；
• OMX_EventBufferFlag：组件收到 EOS；
• OMX_EventComponentResumed：组件恢复工作；
• OMX_EventOutputRendered ：用作 tunnel mode 下 pts 上传给上层
• OMX_EventDataSpaceChanged：数据空间发生变化；
• OMX_EventOnFirstTunnelFrameReady：tunnel mode下第一帧被解出并且准备好渲染；

1.3、OMX_CALLBACKTYPE

这个结构体定义了 OMX 组件的 callback 类型，总共包含三个函数指针：

• EventHandler：这个方法用于通知应用层OMX组件有事件发生；
• EmptyBufferDone：这个方法用于将 input 端口的使用完的（空的） buffer 返回给应用层；这个方法是阻塞调用的，所以应用层不应该再其他线程中填充这块buffer；
• FillBufferDone：这个方法用于将 output 端口的填充完的（满的）buffer 返回给应用层，同样的这个方法也是阻塞调用的；

1.4 OMX_BUFFERSUPPLIERTYPE

tunnel mode 相关，暂不了解。

---

2、OMX_Component.h

OMX_Component 头文件下定义了一个OMX组件所必要的公有接口，这个头文件将会被组件层和应用层共同使用。

2.1、struct OMX_PARAM_PORTDEFINITIONTYPE

每个组件都会有input 和 output 两个端口，每个端口都会有一个详细的信息描述，比如端口有几个buffer、端口当前的状态等等，这些信息就用 OMX_PARAM_PORTDEFINITIONTYPE来描述，结构体中有如下内容：

• nPortIndex：端口的索引，使用较少；
• eDir：表示当前 port 是 input 还是 output；
• nBufferCountActual：当前端口上实际分配的buffer的数量；
• nBufferCountMin：当前端口最少应该分配的buffer的数量；
• nBufferSize：端口上每个buffer的大小；
• bEnabled：当前端口是否被使能，默认是 enabled；
• bPopulated：当前端口的数量是否已经被充满（数量等于nBufferCountActual），disable状态下端口将不会被认为是充满的；
• eDomain：当前端口中buffer存储的数据的类型，video数据还是audio数据，用于决定端口的format类型；
• format：表示端口中buffer的格式，不同数据类型对应于不同的格式，这将在后续了解；
• bBuffersContiguous：buffer是否连续；
• nBufferAlignment：buffer的对齐方式；

ACodec 中分配buffer时会先获取 port 定义，读取端口对应的 buffer 数量，后续也可能修改端口的buffer数量，另外读取输入输出格式时就是从端口定义的format中读取的。

2.2 struct OMX_COMPONENTTYPE

我们在OMX中见到的OMX_HANDLETYPE指代的就是这里的OMX_COMPONENTTYPE，它表示一个组件的句柄，通过这个句柄我们可以调用到组件的公有方法，也可以获取到组件的私有数据块（每个组件实现的方式与细节）。组件句柄由OMX Core创建，组件加载完成后，应用层可以安全的调用组件的方法。

接下来了解这个结构体中的部分内容：

• pComponentPrivate：指向组件的私有数据块（内部实现）；
• pApplicationPrivate：指向OMX组件的调用者（client），也就是OMXNode；
• 公有函数指针：由OMX组件实现，给client调用。

调用一个 OMX 方法后，组件的处理流程应该是这样：

• 调用 OMX_COMPONENTTYPE 的标准方法，传入参数为 OMX_COMPONENTTYPE 自身；
• 标准方法实现中对内部实现 pComponentPrivate 进行处理和调用，比如说 SetCallbacks 应该会把回调函数注册给 pComponentPrivate 的一个成员。

OMX Core 创建的是一个基类对象，实际调用的是我们的子类实现，大致就是这个意思。