หน้านี้อธิบายประเภทต่างๆ ของ Surface ที่ใช้สำหรับการเล่นวิดีโอด้วย Media3 และวิธีเลือกประเภทที่เหมาะสมกับ Use Case ของคุณ ดูข้อมูลเพิ่มเติมเกี่ยวกับออบเจ็กต์ Surface ใน Android ได้ที่เอกสารประกอบเกี่ยวกับกราฟิกนี้
ตั้งค่า Surface
Player มีจุดเข้าใช้งาน 4 จุดสำหรับเชื่อมต่อเอาต์พุตวิดีโอกับSurfaceบางรุ่น ดังนี้
void setVideoSurface(@Nullable Surface surface)void setVideoSurfaceHolder(@Nullable SurfaceHolder surfaceHolder)void setVideoSurfaceView(@Nullable SurfaceView surfaceView)void setVideoTextureView(@Nullable TextureView textureView)
นอกจากนี้ยังมีวิธีล้างข้อมูลที่แตกต่างกันดังนี้
void clearVideoSurface()void clearVideoSurface(@Nullable Surface surface)void clearVideoSurfaceHolder(@Nullable SurfaceHolder surfaceHolder)void clearVideoSurfaceView(@Nullable SurfaceView surfaceView)void clearVideoTextureView(@Nullable TextureView textureView)
เลือกประเภทแพลตฟอร์มสำหรับ 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_VIEWandroidx.media3.ui.compose.SURFACE_TYPE_TEXTURE_VIEW
ไม่มีประเภท none เนื่องจากจะสอดคล้องกับการไม่รวม Composable ไว้ในแผนผัง Compose UI
ดูวิธีจัดการสัดส่วนภาพของวิดีโอ การปรับขนาดหน้าต่างแบบไดนามิก และการปรับขนาดเนื้อหาใน Compose ได้ที่ปรับขนาดเนื้อหาสื่อในรูปแบบต่างๆ