AEP-Richtlinie: Media3

Die Jetpack Media3-Bibliothek ist der Standard für die Medienwiedergabe, Sitzungen, Bearbeitung, Metadaten und Frame-Extraktion. So wird sichergestellt, dass Apps empfohlene APIs für die Verarbeitung komplexer Medienaufgaben auf verschiedenen Android-Formfaktoren verwenden. Durch die Migration von Legacy-Framework-APIs (z. B. MediaPlayer, MediaMuxer und MediaExtractor) zur robusten Jetpack Media3-Bibliothek wird die Medienarchitektur modernisiert. So erhalten Sie ein einheitliches, funktionsreiches Toolkit, das für eine konsistente Medienwiedergabe sorgt.

Erforderliche Implementierung

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

ID Richtlinie
AEP-M3-GAA Sie dürfen keine Legacy-APIs des Android-Frameworks verwenden, darunter MediaPlayer, MediaExtractor, MediaMuxer und MediaMetadataRetriever.
AEP-M3-GAB Wenn die Wiedergabe ein wichtiger Nutzerablauf ist, muss die App Media-Sitzungen für die Betriebssystemerkennung und die geräteübergreifende Integration einbinden.
AEP-M3-GAC Wenn die App eine Audioinhaltsbibliothek hat, muss sie Inhalte über MediaLibraryService bereitstellen und die Fortsetzung der Medienwiedergabe unterstützen.

Gültigkeit der Richtlinien

Diese Richtlinie gilt für:

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

Ausnahmen

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

ID Befreiung
AEP-M3-EAA In einem schnellen Netzwerk muss der erste Videoframes innerhalb von 500 ms nach der Nutzeraktion angezeigt werden.
Die Wiedergabe muss flüssig sein und darf innerhalb eines 30‑Sekunden-Fensters keine sichtbaren Frame-Drops oder hörbaren Audio-Underruns aufweisen.
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-Stil senden und einen Dienst im Vordergrund verwenden.
Wenn die App die Fortsetzung der Wiedergabe unterstützt, muss sie die Wiederaufnahme von Medien implementieren.
Das Trennen der Kopfhörer muss ordnungsgemäß behandelt werden. Beispielsweise wird die Wiedergabe pausiert, anstatt zum Lautsprecher zu wechseln.
Die Wiedergabe muss beim Wechsel zwischen Geräteausrichtungen ohne Frame-Drops fortgesetzt werden.

Dokumentation und Ressourcen zu Funktionen

In den folgenden Ressourcen finden Sie Implementierungsanleitungen und technische Details zur Media3-Funktion. Diese Ressourcen dienen nur zu Ihrer Information und enthalten keine zusätzlichen Programmanforderungen.