Làm nhiều việc cùng lúc trên TV

Android 14 (API cấp 34) giới thiệu một số tính năng nâng cao cho API hình trong hình (PiP) để cho phép thực hiện nhiều thao tác cùng lúc. Mặc dù tính năng hỗ trợ PiP được ra mắt trong Android 8.0 (API cấp 26), nhưng tính năng này không được hỗ trợ rộng rãi trên Android TV và hoàn toàn không được hỗ trợ trên Google TV trước Android 13. Tính năng đa nhiệm cho TV sử dụng chế độ Hình trong hình để cho phép hai ứng dụng riêng biệt cùng tồn tại trên màn hình: một ứng dụng chạy ở chế độ toàn màn hình và ứng dụng thứ hai chạy ở chế độ Hình trong hình. Có nhiều yêu cầu khác nhau đối với các ứng dụng chạy ở một trong hai chế độ này.

Hành vi mặc định là ứng dụng PiP sẽ phủ lên ứng dụng toàn màn hình. Điều này tương tự như hành vi hình trong hình trên Android tiêu chuẩn.

Xin lưu ý rằng khi tích hợp tính năng đa nhiệm, ứng dụng của bạn phải khai báo các loại hình sử dụng theo nguyên tắc về chất lượng ứng dụng TV.

Chạy ứng dụng ở chế độ PiP

Đối với các thiết bị TV chạy Android 14 (API cấp 34) trở lên, hãy chạy ứng dụng của bạn ở chế độ PiP bằng cách gọi enterPictureInPictureMode(). Các thiết bị TV chạy các phiên bản Android cũ không hỗ trợ chế độ PiP.

Dưới đây là ví dụ về cách triển khai logic của một nút để chuyển sang chế độ PiP:

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
        }
}

@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);
    }
}

Thao tác này chỉ được thêm nếu thiết bị có tính năng hệ thống FEATURE_PICTURE_IN_PICTURE. Ngoài ra, khi hành động được kích hoạt, tỷ lệ khung hình của chế độ PiP sẽ được đặt khớp với tỷ lệ khung hình của video đang phát.

Hãy nhớ thêm tiêu đề và phần phụ đề để cung cấp cho người dùng thông tin về mục đích sử dụng phổ biến của PIP này.

Cùng tồn tại với các ứng dụng chạy ở chế độ PiP

Khi ứng dụng của bạn đang chạy ở chế độ toàn màn hình, ứng dụng đó có thể cần phải điều chỉnh cho phù hợp với các ứng dụng khác đang chạy ở chế độ PiP.

API xoá sạch

Trong một số trường hợp, ứng dụng PiP có thể phủ lên các thành phần giao diện người dùng quan trọng trong ứng dụng toàn màn hình. Để giảm thiểu vấn đề này, có các API giữ rõ ràng mà ứng dụng có thể sử dụng để xác định các thành phần giao diện người dùng quan trọng không được phủ lên. Hệ thống cố gắng đáp ứng các yêu cầu để tránh che các thành phần này bằng cách định vị lại cửa sổ PiP.

Để chỉ định rằng không nên phủ một thành phần hiển thị, hãy sử dụng preferKeepClear trong bố cục XML như trong ví dụ sau:

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

Bạn cũng có thể thực hiện việc này theo phương thức lập trình bằng cách sử dụng setPreferKeepClear():

private lateinit var binding: MyLayoutBinding

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

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

private MyLayoutBinding binding;

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

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

Đôi khi, bạn không cần phải xoá toàn bộ View mà chỉ cần xoá một phần của View. Bạn có thể sử dụng setPreferKeepClearRects() để chỉ định các vùng của View không được phủ lên. Các giao diện người dùng không sử dụng View gốc, chẳng hạn như Flutter, Jetpack Compose và WebView, có thể có các mục con cần giữ rõ các vùng. Bạn có thể sử dụng API này cho những trường hợp đó.

Loại hình sử dụng

Ứng dụng của bạn phải khai báo thuộc tính giá trị siêu dữ liệu của com.google.android.tv.pip.category tương ứng với loại chính hoặc các loại hình sử dụng cho chế độ hình trong hình. Mọi <activity> đã đặt android:supportsPictureInPicture="true" đều phải khai báo thuộc tính này bằng một giá trị có liên quan trong bảng bên dưới.

Các loại hình sử dụng không thuộc bất kỳ danh mục nào trong số này, đặc biệt là mọi hoạt động phát nội dung nghe nhìn, đều không được phép ở chế độ hình trong hình trên TV.

Nhiều giá trị được phân tách bằng dấu gạch đứng (|). Ví dụ:

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