Loại bề mặt

Trang này mô tả các loại nền tảng có thể dùng để phát video bằng Media3 và cách chọn loại nền tảng phù hợp với trường hợp sử dụng của bạn. Để tìm hiểu thêm về các đối tượng Surface trong Android, hãy đọc tài liệu về đồ hoạ này.

Chọn một loại bề mặt cho PlayerView

Thuộc tính surface_type của PlayerView cho phép bạn đặt loại nền tảng được dùng để phát video. Các giá trị được phép là:

  • surface_view (SurfaceView)
  • texture_view (TextureView)
  • spherical_gl_surface_view (SphericalGLSurfaceView) – để phát video toàn cảnh
  • video_decoder_gl_surface_view (VideoDecoderGLSurfaceView) – kết xuất video bằng trình kết xuất tiện ích
  • none – chỉ dành cho chế độ phát âm thanh và nên được dùng để tránh phải tạo một nền tảng vì việc này có thể tốn nhiều tài nguyên.

Nếu chế độ xem dành cho hoạt động phát video thông thường, thì bạn nên sử dụng surface_view hoặc texture_view. SurfaceView có một số lợi ích so với TextureView khi phát video:

  • Giảm đáng kể mức tiêu thụ năng lượng trên nhiều thiết bị.
  • Thời gian khung hình chính xác hơn, giúp phát video mượt mà hơn.
  • Hỗ trợ đầu ra video HDR chất lượng cao hơn trên các thiết bị có hỗ trợ.
  • Hỗ trợ đầu ra bảo mật khi phát nội dung được bảo vệ bằng DRM.
  • Khả năng kết xuất nội dung video ở độ phân giải tối đa của màn hình trên các thiết bị Android TV có khả năng nâng cấp lớp giao diện người dùng.

Do đó, bạn nên ưu tiên dùng SurfaceView thay vì TextureView nếu có thể. Bạn chỉ nên sử dụng TextureView nếu SurfaceView không đáp ứng được nhu cầu của bạn. Một ví dụ là trường hợp cần có ảnh động mượt mà hoặc thao tác cuộn bề mặt video trước Android 7.0 (API cấp 24), như mô tả trong các lưu ý sau. Trong trường hợp này, bạn nên chỉ sử dụng TextureView khi SDK_INT nhỏ hơn 24 (Android 7.0) và SurfaceView trong trường hợp khác.

Chọn một loại thành phần hiển thị trong Compose

Trong Compose, giải pháp tương tác sử dụng thành phần kết hợp AndroidView để bao bọc SurfaceView và TextureView. Hai thành phần kết hợp tương ứng là AndroidExternalSurface và AndroidEmbeddedExternalSurface.

Mô-đun ui-compose của Media3 cung cấp một thành phần kết hợp PlayerSurface liên kết Player với Surface theo cách nhận biết được vòng đời. Trong trường hợp này, các loại bề mặt là:

Không có loại none vì loại này sẽ tương ứng với việc không đưa PlayerSurface vào cây giao diện người dùng Compose.