ผสานรวมไลบรารี Jetpack Media3 เป็นมาตรฐานสำหรับการเล่นสื่อ เซสชัน การแก้ไข ข้อมูลเมตา และการแยกเฟรม เพื่อให้มั่นใจว่าแอปใช้ API ที่แนะนำสำหรับการจัดการงานสื่อที่ซับซ้อนในอุปกรณ์ Android ทุกรูปแบบ การปรับปรุงสถาปัตยกรรมสื่อให้ทันสมัยด้วยการย้ายข้อมูลจาก API ของเฟรมเวิร์กรุ่นเดิม (เช่น MediaPlayer, MediaMuxer และ MediaExtractor) ไปยังไลบรารี Jetpack Media3 ที่มีประสิทธิภาพ จะช่วยให้คุณมีชุดเครื่องมือแบบครบวงจรที่มีฟีเจอร์มากมาย ซึ่งจะช่วยให้มั่นใจได้ถึงประสบการณ์การใช้งานสื่อที่สอดคล้องกัน
การติดตั้งใช้งานที่จำเป็น
แอปของคุณต้องเป็นไปตามข้อกำหนดต่อไปนี้จึงจะมีสิทธิ์เข้าร่วม AEP
- ไม่ควรใช้ API ของเฟรมเวิร์ก Android รุ่นเดิม ซึ่งรวมถึง MediaPlayer, MediaExtractor, MediaMuxer และ MediaMetadataRetriever
- หากการเล่นเป็นเส้นทางของผู้ใช้หลัก แอปต้องผสานรวมเซสชันสื่อ เพื่อให้ระบบปฏิบัติการรับรู้และผสานรวมข้ามอุปกรณ์
- หากแอปมีคลังเนื้อหาเสียง แอปจะต้องแสดงเนื้อหาผ่าน MediaLibraryService และรองรับการเล่นสื่อต่อ
การบังคับใช้หลักเกณฑ์
หลักเกณฑ์นี้ใช้กับ
- แอปที่รองรับการเล่นสื่อ (วิดีโอหรือเสียง) หรือการตัดต่อวิดีโอ
- ในอุปกรณ์ทุกรูปแบบที่แอปพร้อมให้บริการ
การยกเว้น
แอปสามารถใช้เฟรมเวิร์กทางเลือกที่เทียบเท่าซึ่งมีคุณภาพ ความสามารถของผู้ใช้ ความเสถียร และความเข้ากันได้ที่คล้ายกันในระบบนิเวศ โปรดติดต่อทีมสนับสนุนหากคุณมีกรอบการพิจารณาที่เหมาะสม หากต้องการ มีสิทธิ์ การใช้งานทางเลือกต้องเป็นไปตามเกณฑ์เปรียบเทียบต่อไปนี้
- ในเครือข่ายที่รวดเร็ว เฟรมวิดีโอแรกต้องแสดงภายใน 500 มิลลิวินาทีหลังจากที่ ผู้ใช้เริ่มเล่น
- การเล่นต้องราบรื่นโดยไม่มีเฟรมหลุดที่มองเห็นได้หรือเสียงขาดหายที่ได้ยินในระหว่างช่วง 30 วินาที
- แอปต้องจัดการโฟกัสเสียงอย่างเหมาะสม
- แอปต้องตอบสนองต่อปุ่มสื่อของฮาร์ดแวร์ แม้ว่าจะทำงานใน เบื้องหลังก็ตาม
- หากรองรับการเล่นในเบื้องหลัง แอปต้องโพสต์การแจ้งเตือนสไตล์สื่อ และใช้บริการที่ทำงานอยู่เบื้องหน้า
- หากแอปสนับสนุนการเล่นต่อ แอปจะต้องใช้ media resumption
- ต้องจัดการการยกเลิกการเชื่อมต่อหูฟังอย่างเหมาะสม เช่น การหยุดเล่นชั่วคราว แทนการเปลี่ยนไปใช้ลำโพง
- การเล่นต้องดำเนินต่อไปโดยไม่มีเฟรมหลุดเมื่อเปลี่ยนการวางแนวของอุปกรณ์
เอกสารและแหล่งข้อมูลของฟีเจอร์
แหล่งข้อมูลต่อไปนี้ให้คำแนะนำในการใช้งานและรายละเอียดทางเทคนิคเกี่ยวกับฟีเจอร์ Media3 แหล่งข้อมูลเหล่านี้มีไว้เพื่อการอ้างอิงเท่านั้นและไม่มีข้อกำหนดเพิ่มเติมของโปรแกรม
- Jetpack Media3
- Media3 ExoPlayer
- ควบคุมและโฆษณาการเล่นโดยใช้ MediaSession
- MediaExtractorCompat API
- MediaMuxerCompat API
- MetadataRetriever API
- FrameExtractor API