TV'de çoklu görev

Android 14 (API düzeyi 34), çoklu görev özelliğini etkinleştirmek için resimli pencere (PiP) API'lerinde bazı iyileştirmeler sunar. PiP desteği Android 8.0'da (API düzeyi 26) kullanıma sunulmasına rağmen Android TV'de yaygın olarak desteklenmedi ve Android 13'ten önceki Google TV'de hiç desteklenmedi. TV için çoklu görev özelliği, ekranda iki ayrı uygulamanın birlikte var olmasına olanak tanımak için PiP modunu kullanır. Bunlardan biri tam ekranda, diğeri PiP modunda çalışır. Bu modlardan birinde çalışan uygulamalar için farklı şartlar vardır.

Varsayılan davranış, PiP uygulamasının tam ekran uygulamanın üzerine gelmesidir. Bu, standart Android pencere içinde pencere davranışıyla hemen hemen aynıdır.

Çoklu görev özelliğini entegre ederken uygulamanızın kullanım türlerini TV uygulaması kalite yönergelerine uygun şekilde belirtmesi gerektiğini unutmayın.

Uygulamanızı PiP modunda çalıştırma

Android 14 (API düzeyi 34) veya sonraki sürümleri çalıştıran TV cihazlarında enterPictureInPictureMode() çağrısını yaparak uygulamanızı PiP modunda çalıştırın. Android'in önceki sürümlerini çalıştıran TV cihazları PiP modunu desteklemez.

PiP moduna girmek için bir düğmenin mantığının nasıl uygulanacağına dair bir örnek aşağıda verilmiştir:

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

İşlem yalnızca cihazda FEATURE_PICTURE_IN_PICTURE sistem özelliği varsa eklenir. Ayrıca işlem tetiklendiğinde PiP modunun en boy oranı, oynatılan videonun en boy oranıyla eşleşecek şekilde ayarlanır.

Kullanıcıya bu PIP'nin genel olarak ne için kullanıldığı hakkında bilgi vermek üzere bir başlık ve altyazı eklediğinizden emin olun.

PiP modunda çalışan uygulamalarla birlikte çalışabilir.

Uygulamanız tam ekran modunda çalışırken PIP modunda çalışan diğer uygulamalara uyum sağlaması gerekebilir.

Keep-clear API'leri

Bazı durumlarda PiP uygulaması, tam ekran uygulamadaki önemli kullanıcı arayüzü bileşenlerini örtebilir. Bu sorunu azaltmak için uygulamaların, örtülmemesi gereken önemli kullanıcı arayüzü bileşenlerini tanımlamak üzere kullanabileceği "clear" API'leri vardır. Sistem, PiP penceresini yeniden konumlandırarak bu bileşenlerin kapatılmasını önlemek için istekleri yerine getirmeye çalışır.

Bir görünümün örtüşmemesi gerektiğini belirtmek için XML düzeninizde aşağıdaki örnekte gösterildiği gibi preferKeepClear kullanın:

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

Bunu setPreferKeepClear() kullanarak programatik olarak da yapabilirsiniz:

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

Bir View öğesinin tamamını değil, yalnızca bir bölümünü temiz tutmanız gerekebilir. setPreferKeepClearRects(), View'ın yer paylaşımı yapılmaması gereken bölgelerini belirtmek için kullanılabilir. Flutter, Jetpack Compose ve WebView gibi View'leri doğal olarak kullanmayan kullanıcı arayüzlerinde, bölgelerin boş tutulması gereken alt bölümler olabilir. Bu API, bu tür durumlar için kullanılabilir.

Kullanım türleri

Uygulamanız, pencere içinde pencere modunun birincil türüne veya türlerine karşılık gelen com.google.android.tv.pip.category meta veri değeri özelliği bildirmelidir. android:supportsPictureInPicture="true" ayarlanmış olan tüm <activity> öğeleri, bu özelliği aşağıdaki tablodaki ilgili bir değerle belirtmelidir.

Bu kategorilerin hiçbirine girmeyen kullanım türlerine (özellikle medya içeriği oynatma) TV'de pencere içinde pencere modunda izin verilmez.

Birden fazla değer dikey çubuk (|) ile ayrılır. Örneğin:

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