本頁面由 Cloud Translation API 翻譯而成。

電視上的多工處理功能

Android 14 (API 級別 34) 為子母畫面 (PiP) API 導入了一些強化功能，以實現多工處理。雖然 Android 8.0 (API 級別 26) 推出了 PiP 支援功能，但 Android TV 並未廣泛支援這項功能，在 Android 13 之前，Google TV 也完全不支援這項功能。電視的多工處理功能會使用子母畫面模式，讓兩個不同的應用程式在畫面上同時運作：一個應用程式以全螢幕執行，另一個在子母畫面模式下執行。以這兩種模式執行的應用程式各有不同的要求。

預設行為是子母畫面應用程式會疊加全螢幕應用程式。這與標準 Android 子母畫面行為非常相似。

請注意，整合多工處理功能時，應用程式必須根據 TV 應用程式品質指南宣告使用類型。

在 PiP 模式下執行應用程式

如果是搭載 Android 14 (API 級別 34) 以上版本的電視裝置，請呼叫 enterPictureInPictureMode()，在 PiP 模式下執行應用程式。搭載舊版 Android 的電視裝置不支援 PiP 模式。

以下範例說明如何實作按鈕的邏輯，以便進入 PiP 模式：

Kotlin

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    pictureInPictureButton.visibility =
        if (requireActivity().packageManager.hasSystemFeature(FEATURE_PICTURE_IN_PICTURE)) {
            pictureInPictureButton.setOnClickListener {
                val aspectRatio = Rational(view.width, view.height)
                val params = PictureInPictureParams.Builder()
                    .setAspectRatio(aspectRatio)
                    .build()
                val result = requireActivity().enterPictureInPictureMode(params)
            }
            View.VISIBLE
        } else {
            View.GONE
        }
}

Java

@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
    super.onViewCreated(view, savedInstanceState);
    if (requireActivity().getPackageManager().hasSystemFeature(FEATURE_PICTURE_IN_PICTURE)) {
        pictureInPictureButton.setVisibility(View.VISIBLE);
        pictureInPictureButton.setOnClickListener(v -> {
            Rational aspectRatio = new Rational(view.getWidth(), view.getHeight());
            PictureInPictureParams params = new PictureInPictureParams.Builder()
                    .setAspectRatio(aspectRatio)
                    .setTitle("My Streaming App")
                    .setSubtitle("My On-Demand Content")
                    .build();
            Boolean result = requireActivity().enterPictureInPictureMode(params);
        });
    } else {
        pictureInPictureButton.setVisibility(View.GONE);
    }
}

只有在裝置具有 FEATURE_PICTURE_IN_PICTURE 系統功能時，系統才會新增這項操作。此外，當動作觸發時，系統會將子母畫面模式的顯示比例設為與播放的影片顯示比例相符。

請務必新增標題和子標題，為使用者提供這個子母畫面的一般用途資訊。

與在 PiP 模式下執行的應用程式共存

當應用程式以全螢幕模式執行時，可能需要配合以子母畫面模式執行的其他應用程式。

Keep-clear API

在某些情況下，PiP 應用程式可能會在全螢幕應用程式中疊加重要 UI 元件。為避免這種情況發生，應用程式可使用 keep-clear API，識別不應疊加的重要 UI 元件。系統會嘗試回應這類要求，藉由重新調整 PiP 視窗來避免遮蓋這些元件。

如要指定不應重疊檢視畫面，請在 XML 版面配置中使用 preferKeepClear，如以下範例所示：

<TextView
    android:id="@+id/important_text"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:preferKeepClear="true"
    android:text="@string/app_name"/>

您也可以使用 setPreferKeepClear() 以程式輔助方式執行這項操作：

Kotlin

private lateinit var binding: MyLayoutBinding

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    binding = MyLayoutBinding.inflate(layoutInflater)
    setContentView(binding.root)
    binding.importantText.isPreferKeepClear = true
}

Java

private MyLayoutBinding binding;

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    binding = MyLayoutBinding.inflate(getLayoutInflater());
    setContentView(binding.getRoot());
    binding.importantText.setPreferKeepClear(true);
}

有時您可能不需要清除整個 View，只需要清除其中的一部分即可。setPreferKeepClearRects() 可用於指定 View 中不應重疊的區域。不原生使用 View 的 UI (例如 Flutter、Jetpack Compose 和 WebView)，可能會有需要保留區域的子區段。這個 API 可用於這些情況。

用量類型

您的應用程式必須宣告 com.google.android.tv.pip.category 的中繼資料值屬性，對應到分割畫面模式的主要用途類型。任何已設定 android:supportsPictureInPicture="true" 的 <activity> 都應使用下表中的相關值宣告這個屬性。

不屬於上述任一類別的用途 (尤其是媒體內容播放模式) 不得使用電視的子母畫面模式。

值	說明
「`communication`」	通訊用途，例如視訊或語音通話。
「`smartHome`」	智慧住宅裝置整合，例如連網門鈴或嬰兒監視器。
「`health`」	健康用途，例如健身追蹤或健康監測。
「`ticker`」	即時運動賽事即時比分，或是最新消息和股票代號。

多個值會以直線 (|) 分隔，例如：

<meta-data android:name="com.google.android.tv.pip.category" android:value="smartHome|health" />

建立電視導覽功能

在 Google TV 上提高參與度的最佳做法