Gambar di dalam gambar

Fitur picture-in-picture (PIP) untuk perangkat genggam Android memungkinkan pengguna mengubah ukuran aplikasi dengan aktivitas yang sedang berlangsung ke dalam jendela kecil. PIP sangat berguna untuk aplikasi video karena konten terus diputar sementara pengguna bebas melakukan tindakan lain. Pengguna dapat memanipulasi posisi jendela ini melalui SystemUI dan berinteraksi dengan aplikasi yang saat ini ada dalam gambar-dalam-gambar dengan (hingga tiga) tindakan yang disediakan aplikasi.

PIP memerlukan keikutsertaan eksplisit dari aplikasi yang mendukungnya dan bekerja berdasarkan aktivitas per aktivitas. (Satu aplikasi dapat memiliki beberapa aktivitas, hanya satu yang ada di PIP.) Aktivitas meminta untuk memasukkan gambar-dalam-gambar dengan memanggil enterPictureInPictureMode() , dan menerima panggilan balik aktivitas dalam bentuk onPictureInPictureModeChanged() .

Metode setPictureInPictureParams() memungkinkan aktivitas mengontrol rasio aspeknya saat berada di PIP dan tindakan kustom, yang memungkinkan pengguna berinteraksi dengan aktivitas tanpa harus memperluasnya. Di PIP, aktivitas dalam jeda, tetapi rendering, status dan tidak secara langsung menerima input sentuh atau fokus jendela. Hanya satu tugas yang dapat berada di PIP pada satu waktu.

Informasi lebih lanjut tersedia di dokumentasi Gambar-dalam-gambar Pengembang Android.

Persyaratan perangkat

Untuk mendukung PIP, aktifkan fitur sistem PackageManager#FEATURE_PICTURE_IN_PICTURE di /android/frameworks/base/core/java/android/content/pm/PackageManager.java . Perangkat yang mendukung PIP harus memiliki layar yang lebih besar dari 220dp pada lebar terkecilnya. Mirip dengan multi-jendela layar terpisah, PIP memungkinkan beberapa aktivitas berjalan di layar secara bersamaan. Oleh karena itu, perangkat harus memiliki CPU dan RAM yang cukup untuk mendukung kasus penggunaan ini.

Penerapan

Sebagian besar manajemen siklus hidup aktivitas dilakukan dalam sistem antara ActivityManager dan WindowManager . Implementasi referensi UI ada dalam paket SystemUI .

Modifikasi pada sistem tidak boleh memengaruhi perilaku intrinsiknya seperti yang ditentukan oleh pengujian Compatibility Test Suite (CTS) . Logika sistem untuk PIP terutama berkisar pada pengelolaan tugas dan aktivitas dalam tumpukan "disematkan". Berikut adalah ikhtisar kelas singkat:

  • ActivityRecord : melacak status gambar-dalam-gambar setiap aktivitas. Untuk mencegah pengguna memasukkan PIP dalam keadaan tertentu, seperti dari layar kunci atau selama VR, tambahkan kasus ke checkEnterPictureInPictureState() .
  • ActivityManagerService : antarmuka utama dari aktivitas untuk meminta memasukkan PIP dan antarmuka untuk panggilan dari WindowManager dan SystemUI untuk mengubah status aktivitas PIP.
  • ActivityStackSupervisor : dipanggil dari ActivityManagerService untuk memindahkan tugas masuk atau keluar dari tumpukan yang disematkan, memperbarui WindowManager seperlunya.
  • PinnedStackWindowController : antarmuka WindowManager dari ActivityManager .
  • PinnedStackController : melaporkan perubahan dalam sistem ke SystemUI , seperti IME ditampilkan/disembunyikan, rasio aspek diubah, atau tindakan diubah.
  • BoundsAnimationController : menganimasikan jendela aktivitas PIP dengan cara yang tidak memicu perubahan konfigurasi saat mengubah ukuran.
  • PipSnapAlgorithm : kelas bersama yang digunakan baik di sistem maupun SystemUI yang mengontrol perilaku gertakan jendela PIP di dekat tepi layar.

SystemUI referensi menyediakan implementasi lengkap PIP yang mendukung penyajian tindakan kustom kepada pengguna dan manipulasi umum, seperti perluasan dan penghentian. Produsen perangkat dapat membangun perubahan ini, selama mereka tidak mempengaruhi perilaku intrinsik seperti yang didefinisikan oleh CDD. Berikut adalah ikhtisar kelas singkat:

  • PipManager : komponen SystemUI yang dimulai dengan SystemUI .
  • PipTouchHandler : pengendali sentuh, yang mengontrol gerakan yang memanipulasi PIP. Ini hanya digunakan saat konsumen input untuk PIP aktif (lihat InputConsumerController ). Gerakan baru dapat ditambahkan di sini.
  • PipMotionHelper : kelas kenyamanan yang melacak posisi PIP, dan wilayah yang diizinkan di layar. Memanggil melalui ActivityManagerService untuk memperbarui atau menganimasikan posisi dan ukuran PIP.
  • PipMenuActivityController : memulai aktivitas yang menunjukkan tindakan yang diberikan oleh aktivitas saat ini di PIP. Aktivitas ini adalah aktivitas overlay tugas, dan menghapus input konsumen overlay untuk memungkinkannya menjadi interaktif.
  • PipMenuActivity : implementasi untuk aktivitas menu.
  • PipMediaController : listener yang memperbarui SystemUI saat sesi media berubah dengan cara yang mungkin memengaruhi tindakan default pada PIP.
  • PipNotificationController : pengontrol yang memastikan bahwa notifikasi aktif saat pengguna menggunakan fitur PIP.
  • PipDismissViewController : overlay yang ditampilkan kepada pengguna saat mereka mulai berinteraksi dengan PIP untuk menunjukkan bahwa itu dapat ditutup.

Penempatan default

Ada berbagai sumber daya sistem yang mengontrol penempatan default PIP:

  • config_defaultPictureInPictureGravity : bilangan bulat gravitasi , yang mengontrol sudut untuk menempatkan PIP, seperti BOTTOM|RIGHT .
  • config_defaultPictureInPictureScreenEdgeInsets : offset dari sisi layar untuk menempatkan PIP.
  • config_pictureInPictureDefaultSizePercent dan config_pictureInPictureDefaultAspectRatio : kombinasi persentase lebar layar dan rasio aspek mengontrol ukuran PIP. Ukuran PIP default yang dihitung tidak boleh lebih kecil dari @dimen/default_minimal_size_pip_resizable_task , seperti yang ditentukan oleh CTS dan CDD.
  • config_pictureInPictureSnapMode : perilaku gertakan seperti yang didefinisikan dalam PipSnapAlgorithm .

Implementasi perangkat tidak boleh mengubah rasio aspek minimum dan maksimum yang ditentukan dalam CDD dan CTS.

Izin

"Operasi aplikasi" per-paket ( OP_PICTURE_IN_PICTURE ) di AppOpsManager ( master/core/java/android/app/AppOpsManager.java ), memungkinkan pengguna untuk mengontrol PIP pada tingkat per-aplikasi melalui pengaturan sistem. Implementasi perangkat harus mematuhi pemeriksaan ini saat aktivitas meminta untuk masuk ke mode gambar-dalam-gambar.

Pengujian

Untuk menguji implementasi PIP, jalankan semua pengujian terkait gambar-dalam-gambar yang ditemukan dalam pengujian CTS sisi host di bawah /cts/hostsidetests/services/activitymanager , khususnya di ActivityManagerPinnedStackTests.java .