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. Trong khi chế độ Hình trong hình được giới thiệu từ Android 8.0 (API cấp 26), nhưng tính năng này chưa được áp dụng rộng rãi được hỗ trợ 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ó các yêu cầu khác nhau đối với ứ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ế độ Hình trong hình bằng cách gọi enterPictureInPictureMode(). Các thiết bị TV chạy sớm hơn phiên bản Android không hỗ trợ chế độ PiP.

Lưu ý: Có một phương thức enterPictureInPictureMode() không dùng nữa cho API cấp 26 trở xuống không sử dụng PictureInPictureParams.Builder. Tránh sử dụng tính năng này vì tính năng này không được hỗ trợ trên thiết bị TV.

Dưới đây là ví dụ về cách triển khai logic của một nút để nhập Chế độ 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);
    }
}

Hành động chỉ được thêm vào 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ụ đề để cung cấp thông tin người dùng về mục đích sử dụng của video PIP này.

Lưu ý: Để chuyển sang chế độ hình trong hình, bạn cần phải làm một số việc có chủ ý và rõ ràng của người dùng trong ứng dụng. Để biết chi tiết, hãy xem Nguyên tắc về chất lượng đối với ứng dụng TV.

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 Keep-clear

Trong một số trường hợp, ứng dụng PiP có thể phủ 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 điều này, ứng dụng có thể dùng các API rõ ràng dùng để xác định các thành phần giao diện người dùng quan trọng không nên 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.

Lưu ý: Hệ thống có thể không thực hiện các yêu cầu này nếu có quá nhiều thành phần trên giao diện người dùng được đánh dấu là giữ sạch hoặc nếu các thành phần đó chiếm phần lớn màn hình. Hãy lưu ý điều này khi sử dụng các API này.

Để 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():

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

Đô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 đó.

Lưu ý: Nếu bạn đặt setPreferKeepClear() thành true, toàn bộ View sẽ được đánh dấu là rõ ràng và bất kỳ vùng nào được chỉ định bằng setPreferKeepClearRects() sẽ bị bỏ qua.

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" phải khai báo thuộc tính này bằng một giá trị phù hợp trong bảng dưới đây.

Những cách sử dụng không thuộc bất kỳ danh mục nào trong số này, cụ thể là không được phép phát nội dung nghe nhìn ở chế độ hình trong hình trên TV.

Giá trị	Mô tả
"communication"	Các trường hợp sử dụng liên lạc, chẳng hạn như cuộc gọi video hoặc cuộc gọi thoại.
"smartHome"	Các thiết bị tích hợp nhà thông minh, chẳng hạn như chuông cửa đã kết nối hoặc thiết bị giám sát em bé.
"health"	Các trường hợp sử dụng liên quan đến sức khoẻ, chẳng hạn như theo dõi hoạt động thể dục hoặc theo dõi sức khoẻ.
"ticker"	Các trường hợp sử dụng ticker, chẳng hạn như điểm số thể thao trực tiếp hoặc tin tức và ticker chứng khoán.

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" />