AEP-Richtlinie: Media3

Integrieren Sie die Jetpack Media3-Bibliothek als Standard für die Medienwiedergabe, Sitzungen, Bearbeitung, Metadaten und Frame-Extraktion, damit Apps empfohlene APIs für die Verarbeitung komplexer Medienaufgaben auf allen Android-Formfaktoren verwenden. Durch die Modernisierung der Medienarchitektur durch die Migration von Legacy-Framework-APIs (z. B. MediaPlayer, MediaMuxer und MediaExtractor) zur robusten Jetpack Media3-Bibliothek wird ein einheitliches, funktionsreiches Toolkit bereitgestellt, das für ein konsistentes Medienerlebnis sorgt.

Erforderliche Implementierung

Damit Ihre App für das AEP infrage kommt, muss sie die folgenden Anforderungen erfüllen:

  • Es dürfen keine Legacy-Android-Framework-APIs verwendet werden, darunter MediaPlayer, MediaExtractor, MediaMuxer und MediaMetadataRetriever.
  • Wenn die Wiedergabe ein wichtiger Teil der Nutzererfahrung ist, muss die App Mediensitzungen für die Betriebssystemerkennung und die geräteübergreifende Integration einbinden.
  • Wenn die App eine Bibliothek mit Audioinhalten hat, müssen die Inhalte über MediaLibraryService verfügbar gemacht werden und die App muss die Wiederaufnahme der Medienwiedergabe unterstützen.

Anwendbarkeit der Richtlinie

Diese Richtlinie gilt für:

  • Apps, die die Wiedergabe von Medien (Video oder Audio) oder die Videobearbeitung unterstützen.
  • Alle Formfaktoren, auf denen die App verfügbar ist.

Ausnahmen

Apps können ein gleichwertiges alternatives Framework verwenden, das eine ähnliche Qualität, ähnliche Nutzerfunktionen, Stabilität und Kompatibilität im gesamten Ökosystem bietet. Wenden Sie sich an den Support, wenn Sie ein geeignetes Framework haben, das in Betracht gezogen werden soll. Damit die alternative Implementierung infrage kommt, muss sie die folgenden Benchmarks erfüllen:

  • In einem schnellen Netzwerk muss der erste Videoframe innerhalb von 500 ms nach der Nutzeraktion angezeigt werden.
  • Die Wiedergabe muss innerhalb von 30 Sekunden reibungslos sein, ohne sichtbare Frame-Drops oder hörbare Audio-Underruns.
  • Die App muss den Audiofokus richtig verwalten.
  • Die App muss auf Hardware-Medientasten reagieren, auch wenn sie im Hintergrund ausgeführt wird.
  • Wenn die Hintergrundwiedergabe unterstützt wird, muss die App eine Benachrichtigung im Media-Style posten und einen Dienst im Vordergrund verwenden.
  • Wenn die App die Wiederaufnahme der Wiedergabe unterstützt, muss sie die Medien wiedergabe implementieren.
  • Das Trennen von Kopfhörern muss ordnungsgemäß verarbeitet werden. Beispielsweise durch Pausieren der Wiedergabe anstelle des Wechsels zum Lautsprecher.
  • Die Wiedergabe muss ohne Frame-Drops fortgesetzt werden, wenn zwischen Geräteausrichtungen gewechselt wird.

Dokumentation und Ressourcen zu Funktionen

Die folgenden Ressourcen enthalten Implementierungsleitfäden und technische Details zur Media3-Funktion. Diese Ressourcen dienen nur als Referenz und enthalten keine zusätzlichen Programmanforderungen.