Menggunakan Library Picture-in-Picture Jetpack

Library Jetpack Picture-in-Picture (PiP) menawarkan solusi yang disederhanakan dan andal bagi developer aplikasi Android untuk menerapkan fungsi PiP, terutama untuk aplikasi pemutaran media, komunikasi video, dan navigasi. Dengan menyediakan API terpadu, library ini membantu menghilangkan kode boilerplate, bug umum dalam aplikasi, dan meningkatkan kualitas keseluruhan pengalaman pengguna PiP.

Library Jetpack PiP memfasilitasi API PiP yang ada dengan mengatasi beberapa tantangan dan inkonsistensi utama di seluruh ekosistem Android:

  • Fragmentasi OS: Library ini otomatis menangani perbedaan panggilan API PiP di berbagai versi Android, seperti menggunakan enterPictureInPictureMode sebelum Android 12 dan isAutoEnterEnabled setelahnya, sehingga developer tidak perlu mengelola perbedaan versi.
  • Parameter PiP yang salah: API ini menyediakan solusi terpadu untuk menyetel parameter PiP dengan benar, misalnya setSourceRectHint, untuk membuat animasi yang lancar dan berkualitas tinggi selama pemutaran media.
  • Callback status PiP terpadu: Callback ini menggabungkan onPictureInPictureModeChanged dan onPictureInPictureUiStateChanged ke dalam satu antarmuka callback terpadu (PictureInPictureDelegate.OnPictureInPictureEventListener) untuk menyederhanakan pengelolaan status dan UI.
  • Pengurangan kode boilerplate: Library ini mengurangi jumlah kode boilerplate yang berulang dengan menawarkan kumpulan RemoteActions yang telah ditentukan sebelumnya untuk kasus penggunaan umum, seperti kontrol pemutaran dan tindakan panggilan video.
  • Persiapan untuk masa depan: Fitur PiP lainnya disediakan melalui library Jetpack, sehingga pengguna dapat mengakses fungsi tambahan dengan sedikit atau tanpa upaya.

Menggunakan Jetpack

Untuk menggunakan Library Jetpack, ganti implementasi PiP kustom yang ada dengan API Library Jetpack. Kompleksitas dan biaya adopsi akan bervariasi berdasarkan penerapan aplikasi saat ini.

Bagian berikut menjelaskan beberapa kasus penggunaan umum PiP dan langkah-langkah penerapan yang diperlukan:

Aplikasi memberi tahu library tentang status aktif atau tidak aktif navigasi dan menetapkan rasio aspek. Library Jetpack akan menangani sisanya.

Perbedaan utama:

  1. Tidak perlu membedakan masuk otomatis dan masuk lama di sisi aplikasi.
  2. Antarmuka callback gabungan.
  3. Builder PictureInPictureParams baru untuk kompatibilitas mundur.

Panggilan Video

Aplikasi memberi tahu library tentang status aktif atau tidak aktif panggilan dan menetapkan rasio aspek.

Perbedaan utama:

  1. Tidak perlu membedakan masuk otomatis dan masuk lama di sisi aplikasi.
  2. Antarmuka callback gabungan.
  3. Builder PictureInPictureParams baru untuk kompatibilitas mundur.
  4. Ikon tindakan standar untuk panggilan video.

Pemutaran Video

Library Jetpack menawarkan delegasi pemutar yang dapat Anda integrasikan untuk mengelola pengaktifan atau penonaktifan PiP dan menyetel petunjuk persegi panjang sumber secara akurat. Anda juga dapat memilih untuk menggunakan sekumpulan objek RemoteAction yang telah ditentukan sebelumnya, mirip dengan yang digunakan dalam skenario panggilan video.

Fitur utama:

  1. Menangani kompatibilitas mundur, tidak diperlukan pemeriksaan versi OS.
  2. Sinkronisasi status pemutaran dan kontrol entri otomatis.
  3. Pelacakan geometri berkelanjutan menggunakan SourceRectHint.