相容媒體轉碼

在 Android 12 (API 級別 31) 以上版本中，如果應用程式不支援 HEVC，系統會自動將以 HEVC (H.265) 等格式錄製的影片轉換為 AVC (H.264)。這項功能可讓影片擷取應用程式使用更現代、更節省儲存空間的編碼，為裝置上錄製的影片編碼，同時不影響與其他應用程式的相容性。

系統會自動轉碼在裝置端建立的內容，格式如下：

媒體格式 XML 屬性 MediaFormat MIME 類型
HEVC (H.265) HEVC MediaFormat.MIMETYPE_VIDEO_HEVC
HDR10HDR10 MediaFeature.HdrType.HDR10
HDR10+ HDR10Plus MediaFeature.HdrType.HDR10_PLUS

Android 假設應用程式可以支援播放所有媒體格式，因此預設會關閉相容媒體轉碼功能。

轉碼的使用時機

轉碼作業需要耗費大量運算資源，且開啟影片檔案時會大幅延遲。舉例來說，在 Pixel 3 手機上，一分鐘的 HEVC 影片檔案大約需要 20 秒才能轉碼為 AVC。因此，只有在將影片檔案傳送至裝置外時，才應轉碼。例如與同一個應用程式的其他使用者，或不支援現代影片格式的雲端伺服器，共用影片檔案時。

開啟影片檔案以在裝置端播放或建立縮圖時，請勿轉碼。

設定轉碼

應用程式可以宣告媒體功能，控管轉碼行為。宣告這些功能的方式有兩種：在程式碼中或在資源中。

在程式碼中宣告功能

您可以使用建構工具建構 ApplicationMediaCapabilities 物件的例項，在程式碼中宣告媒體功能：

Kotlin

val mediaCapabilities = ApplicationMediaCapabilities.Builder()
    .addSupportedVideoMimeType(MediaFormat.MIMETYPE_VIDEO_HEVC)
    .addUnsupportedHdrType(MediaFeature.HdrType.HDR10)
    .addUnsupportedHdrType(MediaFeature.HdrType.HDR10_PLUS)
    .build()

Java

ApplicationMediaCapabilities mediaCapabilities = new ApplicationMediaCapabilities.Builder()
        .addSupportedVideoMimeType(MediaFormat.MIMETYPE_VIDEO_HEVC)
        .addUnsupportedHdrType(MediaFeature.HdrType.HDR10)
        .addUnsupportedHdrType(MediaFeature.HdrType.HDR10_PLUS)
        .build();

透過 ContentResolver#openTypedAssetFileDescriptor() 等方法存取媒體內容時，請使用這個物件：

Kotlin

val providerOptions = Bundle().apply {
    putParcelable(MediaStore.EXTRA_MEDIA_CAPABILITIES, mediaCapabilities)
}
contentResolver.openTypedAssetFileDescriptor(mediaUri, mediaMimeType, providerOptions)
    .use { fileDescriptor ->
        // Content will be transcoded based on values defined in the
        // ApplicationMediaCapabilities provided.
    }

Java

Bundle providerOptions = new Bundle();
providerOptions.putParcelable(MediaStore.EXTRA_MEDIA_CAPABILITIES, mediaCapabilities);
try (AssetFileDescriptor fileDescriptor =  contentResolver.openTypedAssetFileDescriptor(mediaUri, mediaMimeType, providerOptions)) {
    // Content will be transcoded based on values defined in the
    // ApplicationMediaCapabilities provided.
}

這個方法可精細控管特定程式碼路徑，例如僅在將影片檔案傳出裝置時，才叫用轉碼。優先順序高於下文所述的方法。

在資源中宣告功能

在資源中宣告功能，即可全面控管轉碼。這個方法只適用於非常特殊的情況。舉例來說，如果應用程式只會從其他應用程式接收影片檔案 (而非直接開啟)，並將檔案上傳至不支援現代影片轉碼器的伺服器 (請參閱下方的範例情境 1)。

如果非必要時使用這個方法，可能會在非預期的情況下叫用轉碼，例如在縮圖影片時，導致使用者體驗不佳。

如要使用這個方法，請建立 media_capabilities.xml 資源檔案：

<?xml version="1.0" encoding="utf-8"?>
<media-capabilities xmlns:android="http://schemas.android.com/apk/res/android">
    <format android:name="HEVC" supported="true"/>
    <format android:name="HDR10" supported="false"/>
    <format android:name="HDR10Plus" supported="false"/>
</media-capabilities>

在這個範例中，裝置上錄製的 HDR 影片會順暢轉碼為 AVC SDR (標準動態範圍) 影片，但 HEVC 影片則不會。

在 application 標記中使用 property 標記，新增媒體功能檔案的參照。將這些屬性新增至 AndroidManifest.xml 檔案：

<property
    android:name="android.media.PROPERTY_MEDIA_CAPABILITIES"
    android:resource="@xml/media_capabilities" />

使用其他應用程式的媒體功能開啟影片檔案

如果應用程式與其他應用程式共用影片檔案，影片檔案可能需要先轉碼，接收應用程式才能開啟。

如要處理這種情況，請使用 openTypedAssetFileDescriptor 開啟影片檔案，並指定接收應用程式的 UID (可使用 Binder.getCallingUid 取得)。接著，平台會使用接收應用程式的媒體功能，判斷是否應為影片檔案轉碼。

Kotlin

val providerOptions = Bundle().apply {
    putParcelable(MediaStore.EXTRA_MEDIA_CAPABILITIES_UID, Binder.getCallingUid())
}
contentResolver.openTypedAssetFileDescriptor(mediaUri, mediaMimeType, providerOptions)
    .use { fileDescriptor ->
        // Content will be transcoded based on the media capabilities of the
        // calling app.
    }

Java

Bundle providerOptions = new Bundle();
providerOptions.putParcelable(MediaStore.EXTRA_MEDIA_CAPABILITIES_UID, Binder.getCallingUid());
try (AssetFileDescriptor fileDescriptor =  contentResolver.openTypedAssetFileDescriptor(mediaUri, mediaMimeType, providerOptions)) {
    // Content will be transcoded based on the media capabilities of the
    // calling app.
}

範例情境

以下圖表說明兩種常見用途。在這兩種情況下，原始影片都是以 HEVC 格式儲存，而影片分享應用程式不支援 HEVC。

範例 1：轉碼作業由影片擷取應用程式啟動。 範例 1 影片分享應用程式在其媒體功能資源檔案中，宣告不支援 HEVC。然後向影片擷取應用程式要求影片。影片擷取應用程式會處理要求，並使用 openTypedAssetFileDescriptor 開啟檔案，指定分享應用程式的 UID。這會啟動轉碼程序。收到轉碼後的影片後，系統會將影片提供給分享應用程式，並上傳到雲端伺服器。

範例 2：轉碼作業是由影片分享應用程式啟動。 範例 2 影片拍攝應用程式會使用 MediaStore URI，與影片分享應用程式分享影片。影片分享應用程式會使用 openTypedAssetFileDescriptor 開啟影片檔案，並指定其媒體功能不支援 HEVC。這會啟動轉碼程序，完成後，檔案會上傳到雲端伺服器。

未宣告的格式

系統會為所有宣告不支援的格式啟用相容媒體轉碼，並為所有宣告支援的格式停用相容媒體轉碼。對於未宣告的其他格式，平台會決定是否要轉碼。在 Android 12 中，所有未宣告的格式都會停用轉碼功能。日後新格式的行為可能會有變動。

開發人員選項

您可以使用下列開發人員選項，覆寫 Android 的預設轉碼行為：

  • 覆寫轉碼預設值：這項設定決定平台是否控管自動轉碼。啟用覆寫功能後，系統會忽略平台預設值，並由「enable transcoding」(啟用轉碼) 設定控制自動轉碼。這個選項預設為停用。

  • 啟用轉碼：這項設定會指定是否要自動轉碼未宣告的格式。這項功能預設為啟用，但只有在覆寫轉碼預設設定也啟用時才會生效。

  • 假設應用程式支援新式格式：這項設定可控制應用程式嘗試播放未宣告格式時的行為。如果資訊清單未宣告應用程式是否支援特定格式，或 Google 尚未將應用程式加入伺服器端強制轉碼清單，就會發生這種情況。啟用這項設定時，應用程式不會轉碼；停用時，應用程式會轉碼。這個選項預設為啟用。

  • 顯示轉碼通知：啟用後，如果應用程式因讀取不支援的媒體檔案而觸發轉碼，就會顯示轉碼進度通知。這個選項預設為啟用。

  • 停用轉碼快取：啟用後，需要轉碼的應用程式不會使用轉碼快取。這項功能在開發期間相當實用，可輕鬆觸發不支援媒體檔案的轉碼作業，但可能會導致裝置效能不佳。這個選項預設為停用。