Fuchsia.mediacodec

解碼器或編碼器

壓縮格式的 MIME 類型。對解碼器來說，這會是輸入內容的 MIME 類型。對編碼器而言，這是指輸出的 MIME 類型。

每個欄位的預設值都是最強大的設定，但如果轉碼器不支援最強大的行為，則轉碼器必須覆寫預設值。

程式碼範例

編碼器

關閉

開啟

1

1

解碼器的輸入 MIME 類型。

目前可識別的 MIME 類型： video/h264 video/vp9 audio/aac input_details.oob_bytes 必須是 Audio 特定 Config() (依照 AAC 規格定義)。 audio/sbc input_details.oob_bytes 必須為 SBC 的 Codec 特定資訊元素，具體由 A2DP 規格定義。

2

設為 true 之後，用戶端才能在輸入封包中放置時間戳記，而這也會導致用戶端取得任何輸出封包上的任何時間戳記。

向解碼器提供個別的存取單位 (因此 AU) 一律合法，但這個布林值必須設為 true，解碼器才能接受並傳播時間戳記值。

建立影片編碼器時，這個值必須為 true，否則 CodecFactory 管道會關閉。

如果未設定，則解讀為 false。

3

要求所選轉碼器能接受非獨立封包的輸入。

這不代表解碼器可以找到第一個 AU 的開頭；如需該範例，請參閱 required_can_find_start。這不代表解碼器可以在串流資料損壞時自行重新同步處理；如需瞭解 required_can_re_sync，

如果 promise_Separate_access_units_on_input 和 require_can_stream_bytes_input 皆為 true，CodecFactory 管道將會關閉。

如果是 false，客戶就必須在 fuchsia.ui.input 中分別動態饋給 AU。如果是影片編碼器，這個值必須為「false」，如為 True，CodecFactory 管道會關閉。

除非用戶端要求解碼器能處理串連的 AU (require_can_stream_bytes_input true)，否則用戶端必須分別向解碼器傳送 AU。這表示用戶端不得在同一個封包中同時包含兩個獨立的 AU 部分，除非 required_can_stream_bytes_input 為 true。

如果未設定，則解讀為 false。

4

解碼器可以串流位元組，但無法搜尋第一個可用的 AU。如要要求兩者，請同時設定 require_can_stream_bytes_input 和 Require_can_find_start。設定 if_can_find_start without required_can_stream_bytes_input 無效。

如果使用 required_can_stream_bytes_input true，但 required_can_find_start false，用戶端就必須從 AU 開始啟動第一個封包，但可以在之後傳送一串位元組。

如果未設定，則解讀為 false。

5

對於有問題的輸入資料，所有解碼器都至少應能夠關閉管道，而不是卡在失敗和/或毀損狀態。

透過 required_can_re_sync 要求傳回的解碼器，或許可以在不關閉 Codec 管道的情況下處理受損的輸入。我們建議 (但非強制性) 轉碼器同時符合 require_report_all_detected_errors 的要求。

如果未設定，則解讀為 false。

6

有時用戶端會失敗，導致解碼器的整體使用失敗，而不是發現資料毀損。針對這類情況，用戶端可以指定 require_report_all_detected_errors。針對已設定 required_report_all_detected_errors 的要求所傳回的任何轉碼器，當偵測任何輸入資料毀損時，轉碼器會透過下列一或多種方式回報：

• 關閉轉碼器管道
• OnStreamFailed()
• error_detected_before
• error_detected_during

如果為 false，轉碼器可能會在沒有訊息的情況下略過毀損的輸入資料。

沒有任何解碼器可以偵測到所有損毀情形，因為某些損毀的情況可能為有效的串流資料。這項要求僅適用於要求寫入的轉碼器，用於偵測「並回報」輸入串流損毀的情形。

這個標記的用途並非 100% 項目符號。如果用戶端需要可靠確保「一律」偵測到「所有」可偵測到的串流毀損情形，則這個標記無法保證一定達成此目的。由於某些串流損毀的本質在任何情況下均無法偵測，因此用戶端應考慮使用更強大的上游技術，確保即使有必要機率非常接近 1，仍可偵測毀損情形。

這個標記為 true 不代表轉碼器會捨棄毀損的資料，也不會產生相應的損壞輸出。只有轉碼器會在適當情況下將 error_detected_* 布林值設為 true。

無論這項設定為何，您在輸入內容時提供的所有 timestamp_ish 值都不保證會顯示在輸出中。

如果未設定，則解讀為 false。

7

如為 true，要求傳回的轉碼器採用 HW 加速功能。另請參閱 require_sw。

如果未設定，則解讀為 false。

8

allow_lack_of_split_header_handling

這個欄位是臨時欄位，之後將停用。

TODO(dustingreen)：在我們停止運作到零轉碼器，導致處理分割標頭時發生問題，請移除這個欄位。

根據預設，必須使用 Codec 執行個體來處理「分割標頭」，意味著用戶端可以一次傳送 AU1 位元組的部分，包括 AU 開頭附近的部分，並且需要轉碼器才能妥善容許和處理。不過，可惜並非所有轉碼器都能正確支援分割標頭。如果用戶端願意允許使用這類轉碼器，用戶端可以將這個值設為 true。用戶端不建議進行這項設定，但可能「目前」需要進行設定，才能找到某些格式的轉碼器。如果用戶端將這個值設為 true，用戶端應傳送每個 AU 的資料，當中包含每個 AU 開頭的連續非分割位元組。用戶端不必每次都傳送一個 AU，只確保所有 AU 位元組都位於單一封包中，或是在每個 AU 開始時都含有幾個位元組。

用戶端應如何使用這個規格，以及用戶端在設為 true 時應採取的行為是否模糊，因為缺少標頭分割的支援機制，並建議為暫時性措施，且所有轉碼器應長期處理分割標頭。這個欄位的主要用途是，避免在無法正確處理分割標頭的轉碼器使用預設值 false 提供無益的用戶端。這不會嘗試完全解決無法處理分割標頭的轉碼器。

如果未設定，則解讀為 false。

9

如果設為「ON」，解碼器必須在輸出時支援安全緩衝區，且必須在輸出時拒絕不安全的緩衝區。

如果設為「關閉」或不設定，建立的解碼器會關閉 StreamProcessor 管道，在輸出時拒絕安全緩衝區。

如果「secure_input_mode」已設為「ON」，則「secure_output_mode」必須設為「開啟」。

10

如果設為「開啟」，解碼器必須在輸入時支援安全緩衝區，且必須在輸入內容時拒絕非安全緩衝區。

如果設為「關閉」或不設定，建立的解碼器會關閉 StreamProcessor 管道，在輸入時拒絕安全緩衝區。

如果「secure_input_mode」已設為「ON」，則「secure_output_mode」必須設為「開啟」。

11

設為 true 時，要求傳回的轉碼器完全以 SW 為基礎，而非 HW 加速 (使用向量 CPU 指令時除外)。這適用於測試目的或其他特殊情況，但不建議用於易受效能影響的情境。此外，部分建構作業可能會針對部分格式缺少以 SW 為基礎的解碼器。另請參閱 require_hw。

如果未設定，則解讀為 false。

1

未壓縮輸入資料的格式。

這個欄位應為原始 mime_type (例如「video/raw」) 和未壓縮格式的詳細資料，供編碼器在讀取緩衝區時使用。

如要有效使用編碼器，編碼器必須支援輸入格式。

2

如為 true，要求傳回的轉碼器採用 HW 加速功能。

如果未設定，則解讀為 false。

1

這個解碼器支援的轉碼器設定檔。如果用戶端想要使用這個設定檔，請務必遵守此資料表中指定的要求。

2

這個解碼器為指定的 |profile| 支援的圖片大小下限。解碼器必須設定這個欄位，且這個欄位必須指定 >= 為轉碼器規格為設定檔定義的最小尺寸。

此大小是指記憶體中的像素版面配置，而不是 display_rect 小於 fuchsia.Images2.ImageFormat.size / fuchsia.sysmem.ImageFormat2.coded_width/height，

3

此解碼器支援的圖片大小上限。

解碼器必須設定這個欄位，且這個欄位必須指定在轉碼器規格中為設定檔定義的大小上限 <=。

此大小是指記憶體中的像素版面配置，而不是 display_rect 小於 fuchsia.Images2.ImageFormat.size / fuchsia.sysmem.ImageFormat2.coded_width/height，

設定這個欄位後，解碼器即使指定的串流大小大於串流設定檔通常允許的大小，也不需要解碼器。解碼器不一定會將未列出的設定檔或不在所列設定檔大小邊界的串流解碼。

4

這個 |profile| 項目可套用至已加密的輸入資料。如果 requirements_encryption 為 false 或未設定，這個 |profile| 項目也可以套用至未加密的輸入資料。

在 Fuchsia 支援解碼過程中，系統會取消這項設定 (即使 allow_input_protection 或 requirements_input_protection 為 true)，直到程式碼的一部分進行解密為止 (對比，它是牽涉保護記憶體的另一個步驟)。如果 allow_encryption 為 false/un-set，但 allow_input_protection 為 true，用戶端在解碼 DRM 解碼之前，應先將解密功能設為獨立步驟，之後才能在解密和解碼之間使用受保護的記憶體進行解碼。

5

這個 |profile| 項目僅適用於輸入資料經過加密的情況。這個 |profile| 項目不適用於未加密的輸入資料。未設定時，系統會將未設定狀態視為 false。

如果設為 true，且同一個詳細 CodecDescription 中沒有含 required_encryption false 設定檔，則解碼器僅支援加密的輸入內容。

在 Fuchsia 支援解碼時進行解密 (即使 allow_input_protection 或 required_input_protection 為 true) ，這項設定才會取消設定。另請參閱 allow_encryption、allow_input_protection、require_input_protection。

6

這個 |profile| 項目適用於透過受保護的記憶體傳送的資料。指定是否保護輸入，以及要保護輸入的受保護「堆積」(如果保護輸入的話) 會在 sysmem 限制匯總期間，並透過 DRM 機制決定。另請參閱 required_input_protection、allow_encryption、require_encryption。

7

此 |profile| 項目僅適用於透過受保護的記憶體傳送輸入資料時。是否要保護輸入，以及保護輸入的受保護「堆積」(如果保護輸入的話) 會在 sysmem 限制匯總期間，以及個別的 DRM 機制來決定。

如果設為 true，且同一個 DetailCodecDescription 中沒有含有 required_input_protection false 設定檔，這個解碼器就只會支援受保護的輸入內容。

在 sysmem 中匯總輸出緩衝區限制時，以及透過 DRM 機制，系統會分別協商輸出保護機制。

另請參閱 allow_input_protection、allow_encryption、require_encryption。

8

如果設為 true，解碼器可以處理跨封包邊界 (標頭與酬載之間，或酬載位元組之間) 分割的輸入區塊酬載 (包含壓縮資料)，而解碼器也能在單一輸入封包中處理多個包含壓縮輸入資料的輸入區塊。另請參閱 split_header_handling，確認解碼器是否也能處理分割標頭。

如未設定，則代表 false。

雖然這個欄位一律表示可以將輸入區塊分割至一個封包界線，但這個欄位設定一律表示可以有來自多個輸入區塊的單一輸入封包，其中包含來自多個輸入區塊的位元組，包括輸入區塊包含壓縮的輸入資料時，還是有一些細微的意義不同。

無論設定或未設定這個欄位，音訊解碼器一律必須允許單一輸入封包中的多個輸入區塊，包括多個輸入區塊，每個區塊都含有經過壓縮的輸入資料 (而不僅是開頭的「內容」標頭)。針對音訊解碼器，這個欄位只能表示是否允許將輸入區塊分割到不同封包。

除非音訊解碼器同時將 can_stream_bytes_input 設為 true，否則音訊解碼器不應將 split_header_handling 設為 true，因為除非允許分割輸入區塊，否則允許分割標頭位元組並無意義。

對於影片解碼器，如果這個欄位未設定或設為 false，解碼器可能無法在單一輸入封包中處理超過一個輸入區塊的位元組。不過，對於所有解碼器 (包括視訊和音訊)，先前「內容」標頭 (例如 h264 SPS 和 PPS 標頭) 一律可以接受，與下列包含壓縮輸入資料 (例如 h264 配量) 的輸入封包相同。影片解碼器一律必須允許繼續在下一個封包中的輸入區塊，包含標頭位元組和壓縮的輸入資料位元組，或在不同壓縮的輸入資料位元組之間 (但不一定是介於兩個標頭位元組之間；請參閱 split_header_handling)。

解碼器將 can_stream_bytes_input 設為 true 通常很常見，但由於 HW、FW 或驅動程式庫中的剖析限制，讓 split_header_handling 取消設定，或者將 Split_header_handling 設為 false。將 can_stream_bytes_input false 設為 false 或離開 can_stream_bytes_input 的解碼器，可能會強迫輸入資料在某些情境中重新封裝。如果可以，建議一併設定 allow_encryption 的設定檔，因為在某些涉及加密的情境中，重新封裝輸入資料可能比較困難。

9

如果設為 true，解碼器可以在串流開始時進行掃描，找出第一個完全呈現的輸入區塊的開頭，即使輸入資料從區塊中間的位元組開始也一樣。

對影片和音訊解碼器來說，將這個欄位設為 true 表示能處理 (略過或部分使用) 因為缺少參照之前資料，而無法解碼 (或無法完全解碼) 的任何輸入區塊。

如果未設定或為 False，解碼器可能無法掃描向前掃描與輸入串流，除非輸入串流的開頭從適當區塊的開頭開始。

10

如果設為 True，即使缺少輸入區塊，解碼器仍可與輸入串流 (最終) 重新同步，並且可以處理部分輸入區塊，而不會讓串流或 StreamProcessor 控制連線失敗。

11

如果設為 true，解碼器會視情況設定 error_detected_before 和/或 error_detected_during，藉此指出部分或偵測到遺漏或偵測到損壞的輸入區塊。值得注意的是，即使這個欄位設為 true，解碼器通常也無法偵測所有可能的資料毀損情形，因為轉碼器通常也不會在串流中納入錯誤偵測位元。這並不會取代真實 (如同極可能針對隨機位元翻轉和位元插入/刪除) 資料完整性檢查的情況。

12

如果設為 true，解碼器可以處理任何標頭在封包邊界分割的位元組。如果設為 False 或未設定，解碼器會要求標頭的所有標頭位元組都必須在同一封包內。

系統一律允許在兩個正式獨立輸入區塊之間，於兩個標頭之間的指定界限啟動新封包。

為了使用這個欄位，h264 SPS 和 PPS 標頭等標頭會視為不同的輸入區塊，因此無論這個欄位的設定為何，具有專屬輸入區塊的標頭都能透過獨立封包傳送，而後續的 h264 配量標頭可以放在另一個封包中。

無論這個欄位的「內容」標頭 (例如 h264 SPS 和 PPS 標頭) 設定在與後續傳送壓縮圖片資料 (例如 h264 配量) 相同的封包中傳送，一律是可接受的。

即使這個欄位設為 true，也無法在 codec_oob_bytes 與串流資料之間分割單一標頭 (如同用戶端一律不得依賴)，

另請參閱 can_stream_bytes_input。

包含 can_stream_bytes_input true 的影片解碼器，但 split_header_handling 否含有 can_stream_bytes_input false 和 split_header_handling true 的影片解碼器無法容忍單一封包中超過一個輸入區塊的位元組，但無論分割發生位置為何，都可以容忍輸入區塊的連續位元組 (例如在 h264 SPS、PPS 或切片標頭中發生)。

除非音訊解碼器也將 can_stream_bytes_input 設為 true，否則音訊解碼器不應將 split_header_handling 設為 true，因為對音訊解碼器來說，要分割標頭位元組並不明確 (針對音訊解碼器)，除非也允許分割輸入區塊。

1

解碼器或編碼器

2

壓縮格式的 MIME 類型。對解碼器來說，這會是輸入內容的 MIME 類型。對編碼器而言，這是指輸出的 MIME 類型。

3

如果解碼器/編碼器會使用基礎硬體執行作業

4

設定檔說明清單，說明這個編碼器/解碼器支援的轉碼器設定檔，以及每個設定檔的使用要求。

1

1

|DecoderProfileDescription| 清單，說明這個解碼器支援哪些轉碼器設定檔，以及用戶端在使用解碼器時必須遵循的規定。CodecFactory 會向用戶端保證 |decoder_profile_descriptions| 中的每個 |DecoderProfileDescription| 都有專屬的 |profile|。

2

限制透過 OnCodecList 指定的向量長度，並限制 GetDetailedCodecDescriptions 回應內任何向量中的項目數量上限。不過，轉碼器上限資訊的整體強制限制是管道訊息大小上限，因為巢狀向量的各大小上限，否則可能會超過管道訊息大小上限。

如果呼叫 AttachLifetimeTracking() 沒有超過此呼叫，就會從伺服器端關閉 CodecFactory 管道。

將 mime_type 限制在不會造成問題的大小。