Material3 Compose

Библиотека media3-ui-compose-material3 обрабатывает как управление состоянием, так и стилизацию Material3 внутри себя. Для получения дополнительной информации о том, какую библиотеку использовать, см. обзор Media3 Compose .

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

Настройка компонентов Material3

Хотя media3-ui-compose-material3 предоставляет компоненты, соответствующие дизайну Material3, у вас по-прежнему есть полный контроль над оформлением. Вы можете настраивать цвета, типографику и формы, обернув пользовательский интерфейс плеера в MaterialTheme .

Например, чтобы изменить цвет PlayPauseButton , вы можете указать пользовательскую colorScheme :

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

Доступные материалы3 Компоненты

Библиотека media3-ui-compose-material3 предоставляет набор готовых компонентов для распространенных элементов управления проигрывателем. Вот некоторые из компонентов, которые вы можете использовать непосредственно в своем приложении:

Компонент	Описание
PlayPauseButton	Кнопка, переключающая режимы воспроизведения и паузы.
SeekBackButton	Кнопка для перемотки назад на заданный шаг.
SeekForwardButton	Кнопка для перемотки вперед на заданный шаг.
NextButton	Кнопка для перехода к следующему медиафайлу.
PreviousButton	Кнопка для перехода к предыдущему медиафайлу.
RepeatButton	Кнопка для переключения между режимами повтора.
ShuffleButton	Кнопка для переключения режима случайного воспроизведения.
MuteButton	Кнопка для включения и выключения звука плеера.
PositionAndDurationText	Текстовый элемент, отображающий текущую позицию и общую продолжительность.
PositionText	Текстовый элемент, отображающий текущую позицию.
DurationText	Текстовый элемент, отображающий общую продолжительность.
RemainingDurationText	Текстовый элемент, отображающий оставшееся время.

Это не исчерпывающий список. Для получения информации обо всех доступных компонентах обратитесь к справочнику API библиотеки.

Два других предварительно созданных компонента Composable, которые вам, вероятно, понадобятся, связаны с управлением поверхностью и находятся в модуле media3-ui-compose поскольку в них отсутствует поддержка тем Material Design.

Компонент	Описание
ContentFrame	Поверхность для отображения медиаконтента, которая управляет соотношением сторон, изменением размера и имеет затвор.
PlayerSurface	Сырая поверхность, которая оборачивает SurfaceView и TextureView в AndroidView