ประเภทพื้นผิว

หน้านี้อธิบายประเภทต่างๆ ของ Surface ที่ใช้สำหรับการเล่นวิดีโอด้วย Media3 และวิธีเลือกประเภทที่เหมาะสมกับ Use Case ของคุณ ดูข้อมูลเพิ่มเติมเกี่ยวกับออบเจ็กต์ Surface ใน Android ได้ที่เอกสารประกอบเกี่ยวกับกราฟิกนี้

ตั้งค่า Surface

Player มีจุดเข้าใช้งาน 4 จุดสำหรับเชื่อมต่อเอาต์พุตวิดีโอกับSurfaceบางรุ่น ดังนี้

นอกจากนี้ยังมีวิธีล้างข้อมูลที่แตกต่างกันดังนี้

เลือกประเภทแพลตฟอร์มสำหรับ PlayerView

แอตทริบิวต์ surface_type ของ PlayerView ช่วยให้คุณกำหนดประเภทของแพลตฟอร์มที่ใช้สำหรับการเล่นวิดีโอได้ ค่าที่อนุญาตมีดังนี้

  • surface_view (SurfaceView)
  • texture_view (TextureView)
  • spherical_gl_surface_view (SphericalGLSurfaceView) - สำหรับการเล่นวิดีโอทรงกลม
  • video_decoder_gl_surface_view (VideoDecoderGLSurfaceView) - การแสดงผลวิดีโอโดยใช้โปรแกรมแสดงผลส่วนขยาย
  • none - ซึ่งใช้สำหรับการเล่นเสียงเท่านั้น และควรใช้เพื่อหลีกเลี่ยงการสร้างแพลตฟอร์มเนื่องจากการดำเนินการดังกล่าวอาจมีค่าใช้จ่ายสูง

หากเป็นการดูเพื่อเล่นวิดีโอตามปกติ ควรใช้ surface_view หรือ texture_view SurfaceView มีข้อดีหลายประการเหนือกว่า TextureView สำหรับการเล่นวิดีโอ ดังนี้

  • ลดการใช้พลังงานในอุปกรณ์หลายเครื่องได้อย่างมาก
  • เวลาที่ใช้ในการแสดงผลเฟรมแม่นยำยิ่งขึ้น ส่งผลให้การเล่นวิดีโอราบรื่นขึ้น
  • รองรับเอาต์พุตวิดีโอ HDR คุณภาพสูงขึ้นในอุปกรณ์ที่รองรับ
  • รองรับเอาต์พุตที่ปลอดภัยเมื่อเล่นเนื้อหาที่ได้รับการคุ้มครองโดย DRM
  • ความสามารถในการแสดงผลเนื้อหาวิดีโอที่ความละเอียดเต็มของจอแสดงผลในอุปกรณ์ Android TV ที่เพิ่มสเกลเลเยอร์ UI

ดังนั้น คุณจึงควรใช้ SurfaceView แทน TextureView หากเป็นไปได้ ควรใช้ TextureView เฉพาะในกรณีที่ SurfaceView ไม่ตรงกับความต้องการของคุณ ตัวอย่างหนึ่งคือกรณีที่ต้องใช้ภาพเคลื่อนไหวที่ราบรื่นหรือการเลื่อนพื้นผิววิดีโอก่อน Android 7.0 (ระดับ API 24) ตามที่อธิบายไว้ในหมายเหตุต่อไปนี้ ในกรณีนี้ ควรใช้ TextureView เฉพาะเมื่อ SDK_INT น้อยกว่า 24 (Android 7.0) และใช้ SurfaceView ในกรณีอื่นๆ

เลือกประเภทพื้นผิวใน Compose

ใน Compose โซลูชันการทำงานร่วมกันจะใช้ Composable AndroidView เพื่อรวม SurfaceView และ TextureView โดย Composable 2 รายการที่สอดคล้องกับเรื่องนี้คือ AndroidExternalSurface และ AndroidEmbeddedExternalSurface จาก androidx.compose.foundation อย่างไรก็ตาม คลาสพร็อกซีเหล่านี้มีแพลตฟอร์ม API ที่จำกัดการเข้าถึงมุมมองที่สำคัญ Player ต้องใช้มุมมองเหล่านั้นเพื่อจัดการวงจรทั้งหมดของแพลตฟอร์ม (การสร้างและการอัปเดตขนาด)

ในโมดูล media3-ui-compose คุณจะเห็นคอมโพสิเบิล ContentFrame และ PlayerSurface ที่ลิงก์ Player กับ Surface ในลักษณะที่รับรู้ถึงวงจร ประเภทแพลตฟอร์มในกรณีนี้มีดังนี้

  • androidx.media3.ui.compose.SURFACE_TYPE_SURFACE_VIEW
  • androidx.media3.ui.compose.SURFACE_TYPE_TEXTURE_VIEW

ไม่มีประเภท none เนื่องจากจะสอดคล้องกับการไม่รวม Composable ไว้ในแผนผัง Compose UI

ดูวิธีจัดการสัดส่วนภาพของวิดีโอ การปรับขนาดหน้าต่างแบบไดนามิก และการปรับขนาดเนื้อหาใน Compose ได้ที่ปรับขนาดเนื้อหาสื่อในรูปแบบต่างๆ