Добавьте зависимость
Библиотека Media3 включает два модуля интерфейса на основе Jetpack Compose. Вам не нужно добавлять их оба, поскольку Material3 зависит от основного.
Kotlin
// Include only one of the following dependencies
implementation("androidx.media3:media3-ui-compose:1.11.1")
implementation("androidx.media3:media3-ui-compose-material3:1.11.1")
Яркий
// Include only one of the following dependencies
implementation "androidx.media3:media3-ui-compose:1.11.1"
implementation "androidx.media3:media3-ui-compose-material3:1.11.1"
Мы настоятельно рекомендуем разрабатывать приложения в первую очередь с помощью Compose или перейти на него с View.
Демонстрационное приложение, полностью созданное с помощью Compose
Хотя библиотека media3-ui-compose не включает готовые composable-функции (такие как кнопки, индикаторы, изображения или диалоговые окна), вы можете найти демо-приложение, полностью написанное на Compose, в котором не используются решения для совместимости, такие как упаковка PlayerView в AndroidView. Демонстрационное приложение использует классы хранилища состояния интерфейса из модуля media3-ui-compose и библиотеки Compose Material3.
Какую библиотеку выбрать?
В зависимости от того, насколько глубокая настройка вам нужна, вы можете выбрать одну из двух библиотек Media3 Compose. Чтобы понять разницу, полезно подумать о конвейере создания состояния пользовательского интерфейса: Business logic → UI logic → UI.
Используйте media3-ui-compose, чтобы полностью контролировать компоненты интерфейса.
Эта библиотека обеспечивает подключение Business logic → UI logic. Он содержит базовые компоненты, такие как PlayerSurface и ContentFrame, а также классы хранилища состояния (например, PlayPauseButtonState, CurrentMediaItemState, PlaylistState, ErrorState), которые преобразуют состояние Player в состояние пользовательского интерфейса.
Эта библиотека не предоставляет готовые к использованию компоненты Material Design. Вы сами создаете и оформляете компоненты интерфейса. Это дает вам максимальный контроль над внешним видом, что делает его идеальным, если у вас есть система проектирования с широкими возможностями настройки.
Используйте media3-ui-compose-material3 для более быстрой интеграции с Material Design.
Эта библиотека предоставляет последнюю часть конвейера – UI. Она зависит от media3-ui-compose и включает встроенные composable-функции, стилизованные с помощью компонентов Material3, в том числе composable-функции Player и MiniController. Composable-функция Player позволяет воспроизводить медиаконтент с видео, элементами управления и индикатором выполнения, которые можно настроить с помощью PlayerDefaults. MiniController – это компактная composable-функция, которая позволяет управлять проигрывателем и показывает информацию о текущем мультимедийном объекте. Это избавляет вас от необходимости создавать собственные кнопки и другие элементы пользовательского интерфейса с нуля. Вы можете настраивать тему, цвета и значки этих компонентов, но основная реализация предоставляется вам.
Самое главное
| Функция | media3-ui-compose |
media3-ui-compose-material3 |
|---|---|---|
| Компоненты интерфейса | Базовые элементы, такие как PlayerSurface и ContentFrame, но без предварительно стилизованных кнопок или элементов управления. |
Предоставляет composable-функции Player и MiniController, а также полный набор встроенных composable-функций в стиле Material3, таких как PlayPauseButton, SeekBackButton, PositionAndDurationText, ErrorText и т. д. |
| Управление состоянием | Предоставляет держатели remember...State для управления логикой. |
Управляет состоянием внутри, но вы по-прежнему можете получить доступ к хранилищам состояния, если это необходимо. |
| Зависимости | androidx.compose.foundation |
media3-ui-compose, androidx.compose.material3, com.google.android.material |
| Основной способ использования | Создание интерфейса проигрывателя с помощью собственной системы проектирования. Полный контроль над внешним видом и функциями. | Быстрое создание интерфейса проигрывателя, соответствующего рекомендациям Material Design 3. |
Похожие руководства
- Масштабирование медиаконтента на устройствах разных форм-факторов. Узнайте, как работать с отступами при отображении контента во весь экран, динамическими размерами окон и масштабированием контента на телефонах, складных устройствах и планшетах.