Material3 Compose

Thư viện media3-ui-compose-material3 xử lý cả việc quản lý trạng thái và tạo kiểu Material3 ở bên trong. Để biết thêm thông tin về thư viện cần dùng, hãy xem phần Tổng quan về Media3 Compose.

// The library provides styled UI components
Row {
  SeekBackButton(player)
  PlayPauseButton(player)
  SeekForwardButton(player)
}
ComposeMaterial3Snippets.kt

Tuỳ chỉnh các thành phần Material3

Mặc dù media3-ui-compose-material3 cung cấp các thành phần tuân theo Material3 Design, nhưng bạn vẫn có toàn quyền kiểm soát việc tạo chủ đề. Bạn có thể tuỳ chỉnh màu sắc, kiểu chữ và hình dạng bằng cách bao bọc giao diện người dùng trình phát trong một MaterialTheme.

Ví dụ: để thay đổi màu của PlayPauseButton, bạn có thể cung cấp một colorScheme tuỳ chỉnh:

MaterialTheme(
  colorScheme =
    lightColorScheme(
      primary = Color.Red, // Change the primary color for the button
      onPrimary = Color.White,
    )
) {
  // The PlayPauseButton will now use the custom colors
  PlayPauseButton(player)
}
ComposeMaterial3Snippets.kt

Các thành phần Material3 hiện có

Thư viện media3-ui-compose-material3 cung cấp một bộ hợp phần tạo sẵn cho các chế độ điều khiển phổ biến của trình phát. Sau đây là một số thành phần mà bạn có thể sử dụng trực tiếp trong ứng dụng của mình:

Thành phần	Mô tả
PlayPauseButton	Nút chuyển đổi giữa phát và tạm dừng.
SeekBackButton	Một nút để tua lại theo một mức tăng xác định.
SeekForwardButton	Một nút để tua đi theo một mức tăng xác định.
NextButton	Một nút để chuyển đến mục nội dung nghe nhìn tiếp theo.
PreviousButton	Một nút để chuyển đến mục nội dung nghe nhìn trước đó.
RepeatButton	Nút chuyển đổi giữa các chế độ lặp lại.
ShuffleButton	Một nút để bật/tắt chế độ trộn bài.
MuteButton	Nút tắt và bật tiếng cho trình phát.
PositionAndDurationText	Một thành phần kết hợp văn bản hiển thị vị trí hiện tại và tổng thời lượng.
PositionText	Một thành phần kết hợp văn bản hiển thị vị trí hiện tại.
DurationText	Một thành phần kết hợp văn bản hiển thị tổng thời lượng.
RemainingDurationText	Một thành phần kết hợp văn bản hiển thị thời lượng còn lại.

Đây chưa phải là danh sách đầy đủ. Tham khảo tài liệu tham khảo API của thư viện để biết tất cả các thành phần hiện có.

Hai thành phần kết hợp dựng sẵn khác mà bạn có thể cần là những thành phần liên quan đến việc quản lý thành phần và nằm trong mô-đun media3-ui-compose vì chúng không có chủ đề Material.

Thành phần	Mô tả
ContentFrame	Một nền tảng để hiển thị nội dung nghe nhìn, xử lý việc quản lý tỷ lệ khung hình, đổi kích thước và màn trập
PlayerSurface	Bề mặt thô bao bọc SurfaceView và TextureView trong AndroidView