AEP yönergesi: Media3

Uygulamaların Android form faktörlerinde karmaşık medya görevlerini işlemek için önerilen API'leri kullanmasını sağlamak amacıyla medya oynatma, oturumlar, düzenleme, meta veriler ve kare çıkarma için standart olarak Jetpack Media3 kitaplığını entegre edin. Eski çerçeve API'lerinden (ör. MediaPlayer, MediaMuxer ve MediaExtractor) Jetpack Media3 kitaplığına geçerek medya mimarisini modernize etmek, tutarlı medya deneyimleri sağlayan birleşik ve özellik açısından zengin bir araç seti sunar.

Zorunlu uygulama

AEP'ye uygun olabilmesi için uygulamanız aşağıdaki koşulları karşılamalıdır:

Kimlik Yönerge
AEP-M3-GAA MediaPlayer, MediaExtractor, MediaMuxer ve MediaMetadataRetriever gibi eski Android framework API'leri kullanılmamalıdır.
AEP-M3-GAB Oynatma, temel bir kullanıcı yolculuğuysa uygulama, işletim sistemi farkındalığı ve cihazlar arası entegrasyon için medya oturumlarını entegre etmelidir.
AEP-M3-GAC Uygulamanın ses içeriği kitaplığı varsa içeriği MediaLibraryService üzerinden sunmalı ve medya devam ettirme desteği uygulamalıdır.

Yönerge geçerliliği

Bu kural aşağıdakiler için geçerlidir:

  • Medya (video veya ses) oynatmayı ya da video düzenlemeyi destekleyen uygulamalar.
  • Uygulamanın kullanılabildiği tüm form faktörlerinde

Muafiyetler

Uygulamalar, ekosistem genelinde benzer kalite, kullanıcı özellikleri, kararlılık ve uyumluluk sağlayan eşdeğer bir alternatif çerçeve kullanabilir. Değerlendirmeye uygun bir çerçeveye sahipseniz destek ekibiyle iletişime geçin. Alternatif uygulamanın uygun olması için aşağıdaki ölçütleri karşılaması gerekir:

Kimlik Muafiyet
AEP-M3-EAA Hızlı bir ağda, ilk video karesi kullanıcı başlatmasından sonraki 500 ms içinde gösterilmelidir.
Oynatma, 30 saniyelik bir süre boyunca kare kaybı veya ses yetersizliği olmadan sorunsuz bir şekilde devam etmelidir.
Uygulama, ses odağını düzgün şekilde yönetmelidir.
Uygulama, arka planda çalışırken bile donanım medya tuşlarına yanıt vermelidir.
Arka planda oynatma destekleniyorsa uygulama, medya tarzı bir bildirim yayınlamalı ve ön plan hizmeti kullanmalıdır.
Uygulama, oynatmaya devam etmeyi destekliyorsa medyaya devam etme özelliğini uygulamalıdır.
Kulaklık bağlantısının kesilmesi düzgün bir şekilde ele alınmalıdır. Örneğin, hoparlöre geçmek yerine oynatmayı duraklatma.
Cihaz yönleri arasında geçiş yaparken oynatma, kare kaybı olmadan devam etmelidir.

Özellik dokümanları ve kaynakları

Aşağıdaki kaynaklarda, Media3 özelliğiyle ilgili uygulama rehberi ve teknik ayrıntılar yer almaktadır. Bu kaynaklar yalnızca referans amaçlıdır ve ek program koşulları içermez.