Thêm phần phụ thuộc
Thư viện Media3 bao gồm 2 mô-đun giao diện người dùng dựa trên Jetpack Compose. Bạn không cần phải thêm cả 2 mô-đun này vì mô-đun Material3 phụ thuộc vào mô-đun cốt lõi.
Kotlin
// Include only one of the following dependencies
implementation("androidx.media3:media3-ui-compose:1.9.2")
implementation("androidx.media3:media3-ui-compose-material3:1.9.2")
Groovy
// Include only one of the following dependencies
implementation "androidx.media3:media3-ui-compose:1.9.2"
implementation "androidx.media3:media3-ui-compose-material3:1.9.2"
Bạn nên phát triển ứng dụng theo kiểu ưu tiên Compose hoặc di chuyển từ việc sử dụng Khung hiển thị.
Ứng dụng minh hoạ hoàn toàn bằng Compose
Mặc dù thư viện media3-ui-compose không bao gồm các thành phần kết hợp có sẵn (chẳng hạn như nút, chỉ báo, hình ảnh hoặc hộp thoại), nhưng bạn có thể tìm thấy một
ứng dụng minh hoạ được viết hoàn toàn bằng Compose tránh mọi giải pháp tương tác
như gói PlayerView trong AndroidView. Ứng dụng minh hoạ
sử dụng các lớp phần tử giữ trạng thái giao diện người dùng từ media3-ui-compose mô-đun và sử dụng
thư viện Compose Material3.
Tôi cần thư viện nào?
Tuỳ thuộc vào mức độ tuỳ chỉnh mà bạn yêu cầu, bạn có thể chọn giữa 2
thư viện Compose Media3. Để hiểu rõ sự khác biệt, bạn nên nghĩ về
quy trình tạo trạng thái giao diện người dùng: Business logic → UI logic → UI.
Sử dụng media3-ui-compose để kiểm soát hoàn toàn các thành phần giao diện người dùng.
Thư viện này cung cấp kết nối Business logic → UI logic. Thư viện này chứa
các thành phần cơ bản như PlayerSurface và ContentFrame, cùng với
các lớp phần tử giữ trạng thái (ví dụ: PlayPauseButtonState) chuyển đổi trạng thái Player
thành trạng thái giao diện người dùng.
Thư viện này không cung cấp các thành phần Material Design sẵn sàng sử dụng. Bạn chịu trách nhiệm xây dựng các thành phần giao diện người dùng của riêng mình và định kiểu cho các thành phần đó. Thư viện này giúp bạn kiểm soát tối đa giao diện và cảm nhận, rất phù hợp nếu bạn có một hệ thống thiết kế có tính tuỳ chỉnh cao.
Sử dụng media3-ui-compose-material3 để tích hợp nhanh hơn với Material
Design.
Thư viện này cung cấp phần UI cuối cùng của quy trình. Thư viện này phụ thuộc vào
media3-ui-compose và bao gồm các hàm có khả năng kết hợp được tạo sẵn, được định kiểu
bằng các thành phần Material3. Thư viện này giúp bạn không cần phải tự xây dựng các
nút và các phần tử giao diện người dùng khác từ đầu. Bạn vẫn có thể tuỳ chỉnh giao diện,
màu sắc và biểu tượng của các thành phần này, nhưng quá trình triển khai cốt lõi được cung cấp
cho bạn.
Xem nhanh
| Tính năng | media3-ui-compose |
media3-ui-compose-material3 |
|---|---|---|
| Thành phần giao diện người dùng | Các phần tử cơ bản như PlayerSurface và ContentFrame, nhưng không có các nút hoặc thành phần điều khiển được định kiểu sẵn. |
Cung cấp một tập hợp đầy đủ các Composables được tạo sẵn, được định kiểu theo Material3 như PlayPauseButton, SeekBackButton, PositionAndDurationText, v.v. |
| Quản lý trạng thái | Cung cấp các phần tử giữ remember...State để quản lý logic. |
Quản lý trạng thái nội bộ, nhưng bạn vẫn có thể truy cập vào các phần tử giữ trạng thái nếu cần. |
| Phần phụ thuộc | androidx.compose.foundation |
media3-ui-compose, androidx.compose.material3, com.google.android.material |
| Trường hợp sử dụng chính | Xây dựng giao diện người dùng trình phát bằng hệ thống thiết kế tuỳ chỉnh. Kiểm soát hoàn toàn giao diện và cảm nhận. | Nhanh chóng xây dựng giao diện người dùng trình phát tuân theo các nguyên tắc Material Design 3. |