影格中繼資料

在 Android 11 中，我們引入了影格中繼資料，做為 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> 代表動態大小的陣列，其中的資料儲存在個別緩衝區中。這類例項會以 struct 中的 vec<T> 例項表示，這表示 EVS Camera HAL 驅動程式實作會擁有此中繼資料，並應妥善清除。填入中繼資料的方式有兩種：

• 使用 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));
  ...