Utilizzare la libreria Jetpack Picture in picture

La libreria Jetpack Picture in picture (PIP) offre una soluzione semplice e solida per gli sviluppatori di app per Android per implementare la funzionalità PIP, in particolare per app di riproduzione multimediale, comunicazione video e navigazione. Fornendo un'API unificata, la libreria contribuisce a eliminare il codice boilerplate, i bug comuni nelle app e a migliorare la qualità complessiva dell'esperienza utente PiP.

La libreria Jetpack PiP facilita le API PiP esistenti risolvendo diversi problemi e incongruenze chiave nell'ecosistema Android:

  • Frammentazione del sistema operativo: la libreria gestisce automaticamente le differenze nelle chiamate API PiP tra le varie versioni di Android, ad esempio utilizzando enterPictureInPictureMode prima di Android 12 e isAutoEnterEnabled dopo, in modo che gli sviluppatori non debbano gestire le differenze di versione.
  • Parametri PIP errati: fornisce una soluzione unificata per impostare correttamente i parametri PIP, ad esempio setSourceRectHint, per creare animazioni fluide e di alta qualità durante la riproduzione dei contenuti multimediali.
  • Callback unificati dello stato PIP: consolida onPictureInPictureModeChanged e onPictureInPictureUiStateChanged in un'unica interfaccia di callback unificata (PictureInPictureDelegate.OnPictureInPictureEventListener) per una gestione semplificata dello stato e della UI.
  • Riduzione del codice boilerplate: la libreria riduce la quantità di codice boilerplate ripetitivo offrendo set predefiniti di RemoteActions per casi d'uso comuni, come controlli di riproduzione e azioni di videochiamata.
  • Preparazione per il futuro: altre funzionalità PIP vengono fornite tramite la libreria Jetpack, consentendo agli utenti di accedere a funzionalità aggiuntive con uno sforzo minimo o nullo.

Adottare Jetpack

Per adottare la libreria Jetpack, sostituisci l'implementazione personalizzata esistente della funzionalità PIP con le API della libreria Jetpack. La complessità e il costo dell'adozione variano in base all'implementazione attuale dell'app.

Le sezioni seguenti descrivono alcuni dei casi d'uso tipici di PIP e i passaggi di implementazione necessari:

L'app comunica alla libreria lo stato attivo o inattivo della navigazione e imposta le proporzioni. La libreria Jetpack si occupa del resto.

Differenze principali:

  1. Non è necessario distinguere l'inserimento automatico dall'inserimento legacy sul lato app.
  2. Interfacce di callback consolidate.
  3. Nuovo generatore PictureInPictureParams per la compatibilità con le versioni precedenti.

Videochiamata

L'app comunica alla libreria lo stato attivo o non attivo della chiamata e imposta le proporzioni.

Differenze principali:

  1. Non è necessario distinguere l'inserimento automatico dall'inserimento legacy sul lato app.
  2. Interfacce di callback consolidate.
  3. Nuovo generatore PictureInPictureParams per la compatibilità con le versioni precedenti.
  4. Icone di azione standardizzate per le videochiamate.

Riproduzione video

La libreria Jetpack offre delegati del player che puoi integrare per gestire l'attivazione o la disattivazione della modalità PIP e impostare con precisione il suggerimento del rettangolo di origine. Puoi anche attivare un insieme predefinito di oggetti RemoteAction, simili a quelli utilizzati negli scenari di videochiamata.

Funzionalità principali:

  1. Gestisce la compatibilità con le versioni precedenti, non è necessario alcun controllo della versione del sistema operativo.
  2. Sincronizzazione dello stato di riproduzione e controllo dell'inserimento automatico.
  3. Monitoraggio continuo della geometria utilizzando SourceRectHint.