البيانات الوصفية للإطار

تم تقديم البيانات الوصفية للإطار في Android 11 كعضو في بنية data BufferDesc. تمّ الإعلان عن هذا الحقل الجديد على أنّه vec<uint8_t> لاستيعاب تنسيق بيانات يحدّده العميل، وهو غير شفاف لمدير EVS.

struct BufferDesc {
    /**
     * HIDL counterpart of AHardwareBuffer_Desc. Please see
     * hardware/interfaces/graphics/common/1.2/types.hal for more details.
     */
    HardwareBuffer buffer;
    ...

    /**
     * Time that this buffer is being filled.
     */
    int64_t timestamp;

    /**
     * Frame metadata field. This is opaque to EVS manager.
     */
    vec<uint8_t> metadata;
};

يمثّل HIDL vec<T> صفائف ذات حجم ديناميكي مع تخزين البيانات في مخزن ذاكرة مؤقت منفصل. يتم تمثيل هذه المثيلات باستخدام مثيل من vec<T> في struct، ما يعني أنّ تنفيذ برنامج تشغيل HAL لكاميرا EVS يملك هذه البيانات الوصفية ويجب أن يزيل البيانات الوصفية بشكل صحيح. هناك طريقتان لملء البيانات الوصفية:

• تغيير حجم الحاوية وملء البيانات باستخدام operator[]

      struct BufferDesc desc = {};
      ...
      desc.metadata.resize(10);
      for (auto i = 0; i < 10; ++i) {
          desc.metadata[i] = frameInfo[i];
      }
      ...
      

• استخدِم setToExternal() لتوجيه vec<T> إلى بنية البيانات المخصّصة.

  struct BufferDesc desc = {};
  struct FrameMetadata metadata = {
     ...
  }; // this is in vendor-defined format.
  
  
  desc.metadata.setToExternal(&metadata, sizeof(metadata));
  ...