Android 13 - Media框架（24）- OMXNodeInstance（一）

青山渺渺

已于 2024-08-09 00:07:43 修改

阅读量1.1k

点赞数 18

分类专栏： Android Media学习笔记文章标签： android framework 音视频视频编解码 Framework

于 2023-12-20 23:43:36 首次发布

本文链接：https://blog.csdn.net/qq_41828351/article/details/134759491

版权

Android Media学习笔记专栏收录该内容

40 篇文章 52 订阅

订阅专栏

全新系列文章已更新：

为了了解 ACodec 是如何与 OpenMAX 组件进行 buffer 流转的，我们有必要先来学习 OMXNodeInstance，在前面的章节中，我们已经了解了 media.codec 进程包含的内容，以及 OpenMAX 框架中的一些内容。这一节我们将来学习 OMXNode 与 media.codec 进程之间的关系，了解OMXNode是如何创建、使用、销毁的。

1、创建 OMXNodeInstance

我们回到 Omx.cpp 来看 allocateNode 方法：

Return<void> Omx::allocateNode(
        const hidl_string& name,
        const sp<IOmxObserver>& observer,
        allocateNode_cb _hidl_cb) {

    using ::android::IOMXNode;
    using ::android::IOMXObserver;

    sp<OMXNodeInstance> instance;
    {
    	// 检查是否到达了 OMXNode 实例最大个数
        Mutex::Autolock autoLock(mLock);
        if (mLiveNodes.size() == kMaxNodeInstances) {
            _hidl_cb(toStatus(NO_MEMORY), nullptr);
            return Void();
        }
		// 创建 OMXNodeInstance 实例，传入参数为 IOmx 服务，IOmxObserver，以及组件名称
        instance = new OMXNodeInstance(
                this, new LWOmxObserver(observer), name.c_str());
		// 调用 OMXStore 的方法创建 OMX_COMPONENTTYPE 对象
        OMX_COMPONENTTYPE *handle;
        OMX_ERRORTYPE err = mStore->makeComponentInstance(
                name.c_str(), &OMXNodeInstance::kCallbacks,
                instance.get(), &handle);

        if (err != OMX_ErrorNone) {
            LOG(ERROR) << "Failed to allocate omx component "
                    "'" << name.c_str() << "' "
                    " err=" << asString(err) <<
                    "(0x" << std::hex << unsigned(err) << ")";
            _hidl_cb(toStatus(StatusFromOMXError(err)), nullptr);
            return Void();
        }
        // 将创建的 OMX_COMPONENTTYPE 对象与 OMXNodeInstance 进行绑定
        instance->setHandle(handle);
		// 获取 quirks 信息
        // Find quirks from mParser
        const auto& codec = mParser.getCodecMap().find(name.c_str());
        if (codec == mParser.getCodecMap().cend()) {
            LOG(WARNING) << "Failed to obtain quirks for omx component "
                    "'" << name.c_str() << "' "
                    "from XML files";
        } else {
            uint32_t quirks = 0;
            for (const auto& quirk : codec->second.quirkSet) {
                if (quirk == "quirk::requires-allocate-on-input-ports") {
                    quirks |= OMXNodeInstance::
                            kRequiresAllocateBufferOnInputPorts;
                }
                if (quirk == "quirk::requires-allocate-on-output-ports") {
                    quirks |= OMXNodeInstance::
                            kRequiresAllocateBufferOnOutputPorts;
                }
            }
            // 如果有 quirks 信息则设置
            instance->setQuirks(quirks);
        }
		// 将 IOmxObersver 和 OMXNodeInstance 以键值的形式存储
        mLiveNodes.add(observer.get(), instance);
        // 将 OMXNodeInstance 和 IOmxObersver 以键值的形式存储
        mNode2Observer.add(instance.get(), observer.get());
    }
    observer->linkToDeath(this, 0);
	// 返回 OMXNodeInstance 给 ACodec
    _hidl_cb(toStatus(OK), new TWOmxNode(instance));
    return Void();
}

allocateNode 方法中的内容还是比较清晰简洁的，主要做了如下几件事情：

检查 OMXNode 实例个数是否达到上限；
创建 OMXNodeInstance 实例，传入参数为 IOmx 服务，IOmxObserver，以及组件名称；
将创建的 OMX_COMPONENTTYPE 对象与 OMXNodeInstance 进行绑定；
获取 quirks 并给 OMXNodeInstance 设置相关信息；
将 IOmxObersver 和 OMXNodeInstance 以键值的形式双向绑定存储；
返回 OMXNodeInstance 返回给 ACodec。

以上是代码的解释，接下来是我们对这段代码的理解：

OMX_COMPONENTTYPE 是由 OMXStore 创建，这个指针由 OMXStore 来管理，所以最终也由 OMXStore 来释放；
OMX_COMPONENTTYPE 和 OMXNodeInstance 进行了绑定，OMXNodeInstance帮我们进行OMX组件方法的封装，之后上层调用 OMXNodeInstance 的方法，OMXNodeInstance 最终调用到组件的接口；
OMXNodeInstance 的引用计数为2，mLiveNodes 中存有一个计数，上层ACodec存有一个计数，mNode2Observer 中存储的是指针，所以不会有计数增加。

2、OMXNodeInstance 构造函数

OMXNodeInstance::OMXNodeInstance(
        Omx *owner, const sp<IOMXObserver> &observer, const char *name)
    : mOwner(owner),
      mHandle(NULL),
      mObserver(observer),
      mDying(false),
      mSailed(false),
      mQueriedProhibitedExtensions(false),
      mQuirks(0),
      mBufferIDCount(0),
      mRestorePtsFailed(false),
      mMaxTimestampGapUs(0LL),
      mPrevOriginalTimeUs(-1LL),
      mPrevModifiedTimeUs(-1LL)
{
    mName = ADebug::GetDebugName(name);
    DEBUG = ADebug::GetDebugLevelFromProperty(name, "debug.stagefright.omx-debug");
    ALOGV("debug level for %s is %d", name, DEBUG);
    DEBUG_BUMP = DEBUG;
    mNumPortBuffers[0] = 0;
    mNumPortBuffers[1] = 0;
    mDebugLevelBumpPendingBuffers[0] = 0;
    mDebugLevelBumpPendingBuffers[1] = 0;
    mMetadataType[0] = kMetadataBufferTypeInvalid;
    mMetadataType[1] = kMetadataBufferTypeInvalid;
    mPortMode[0] = IOMX::kPortModePresetByteBuffer;
    mPortMode[1] = IOMX::kPortModePresetByteBuffer;
    mSecureBufferType[0] = kSecureBufferTypeUnknown;
    mSecureBufferType[1] = kSecureBufferTypeUnknown;
    mGraphicBufferEnabled[0] = false;
    mGraphicBufferEnabled[1] = false;
    mIsSecure = AString(name).endsWith(".secure");
    mLegacyAdaptiveExperiment = ADebug::isExperimentEnabled("legacy-adaptive");
}

OMXNodeInstance 的构造函数主要就初始化了几个数组，这个数组中都是由两个元素，索引0表示input port，索引 1 表示 output port，以下是一些数组的意义：

mNumPortBuffers：port 中buffer的数量；
mMetadataType：meta data 的类型，这个用于确定有surface的情况下ouput buffer的类型，以及input为camera或者是graphic（录屏）的情况下 input buffer的类型；
mPortMode：端口模式；
mSecureBufferType：secure buffer 的类型；
mGraphicBufferEnabled：是否使用graphic buffer；

看过前面章节的小伙伴应该大致可以揣摩出使用的枚举类型的意义。

void OMXNodeInstance::setHandle(OMX_HANDLETYPE handle) {
    CLOG_LIFE(allocateNode, "handle=%p", handle);
    CHECK(mHandle == NULL);
    mHandle = handle;
    if (handle != NULL) {
        mDispatcher = new CallbackDispatcher(this);
    }
}

setHandle方法可以把创建的OMX组件和OMXNodeInstance实例进行绑定，同时会创建一个CallbackDispatcher对象。

3、CallbackDispatcher

CallbackDispatcher 从名字上来看是回调的调度者，它的作用是开启一个线程，所有由OMX组件发上来的消息或者事件都会进入到该线程的队列当中，按照顺序一个一个通过 IOmxObserver 发回到 ACodec 层。

OMX callback 会把事件或者消息封装成为 omx_message，再通过IOmxObserver发送，具体如何封装的，以及ACodec如何解封装，参考OnEvent、OnEmptyBufferDone、OnFillBufferDone这三个方法的实现。

具体 CallbackDispatcher 和 CallbackDispatcherThread 是如何实现的我们这里不做过多的了解。

关注公众号《青山渺渺》阅读完整内容；如有问题可在公众号后台私信，也可进入音视频开发技术分享群一起讨论！

在这里插入图片描述

青山渺渺

关注

18
点赞
踩
4

收藏

觉得还不错? 一键收藏
打赏
0
评论
Android 13 - Media框架（24）- OMXNodeInstance（一）

这一节开始我们正式学习 ACodec 的对外接口实现，虽然ACodec代码很长，但是从头文件中我们可以发现，ACodec 对外开放的公有方法非常少，基本就是CodeBase中定义的接口，所以学起来并不会非常困难。另外 ACodec 的本质其实就是在帮助我们进行编解码组件的配置，以及控制输入输出buffer，所以我们只要知道每个阶段都需要做些什么，buffer对应会有什么动作就会比较简单了。
复制链接

扫一扫