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) sağlam 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.

Gerekli uygulama

AEP'ye uygun olmak için uygulamanız aşağıdaki şartlara uymalıdır:

  • MediaPlayer, MediaExtractor, MediaMuxer ve MediaMetadataRetriever gibi eski Android çerçevesi API'leri kullanılmamalıdır.
  • Oynatma, temel bir kullanıcı yolculuğuysa uygulama, işletim sistemi farkındalığı ve cihazlar arası entegrasyon için medya oturumlarını entegre etmelidir.
  • Uygulamanın sesli içerik kitaplığı varsa içeriği MediaLibraryService aracılığıyla sunmalı ve medya devam ettirme desteği uygulamalıdır.

Yönerge uygulanabilirliği

Bu kuralın geçerli olduğu alanlar:

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

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. Uygun olmak için alternatif uygulamanın aşağıdaki ölçütleri karşılaması gerekir:

  • 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 görünür kare düşmesi veya duyulabilir 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 media resumption'ı uygulaması gerekir.
  • Kulaklık bağlantısının kesilmesi kontrollü 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 şartları içermez.