Media player
Tap play.
Открыть живое интерактивное демо →
Меняйте параметры, смотрите удалённый документ, который получается, и разницу после каждого изменения.
Что это
Кнопки воспроизведения с движущейся полосой прогресса — всё анимируется на устройстве.
Подходит для
- Управление музыкой и подкастами
- Таймеры и индикаторы прогресса
Код
Исходник примера с импортами androidx.compose.remote. CI компилирует каждый фрагмент кода на сайте против AndroidX.
import androidx.compose.remote.creation.compose.action.combinedAction
import androidx.compose.remote.creation.compose.action.hostAction
import androidx.compose.remote.creation.compose.action.valueChangeAction
import androidx.compose.remote.creation.compose.capture.RemoteImageVector
import androidx.compose.remote.creation.compose.capture.path
import androidx.compose.remote.creation.compose.layout.RemoteAlignment
import androidx.compose.remote.creation.compose.layout.RemoteArrangement
import androidx.compose.remote.creation.compose.layout.RemoteBox
import androidx.compose.remote.creation.compose.layout.RemoteCanvas
import androidx.compose.remote.creation.compose.layout.RemoteColumn
import androidx.compose.remote.creation.compose.layout.RemoteComposable
import androidx.compose.remote.creation.compose.layout.RemoteOffset
import androidx.compose.remote.creation.compose.layout.RemoteRow
import androidx.compose.remote.creation.compose.layout.RemoteStateLayout
import androidx.compose.remote.creation.compose.layout.RemoteText
import androidx.compose.remote.creation.compose.modifier.RemoteModifier
import androidx.compose.remote.creation.compose.modifier.RemoteRole
import androidx.compose.remote.creation.compose.modifier.background
import androidx.compose.remote.creation.compose.modifier.clickable
import androidx.compose.remote.creation.compose.modifier.clip
import androidx.compose.remote.creation.compose.modifier.contentDescription
import androidx.compose.remote.creation.compose.modifier.fillMaxWidth
import androidx.compose.remote.creation.compose.modifier.height
import androidx.compose.remote.creation.compose.modifier.padding
import androidx.compose.remote.creation.compose.modifier.semantics
import androidx.compose.remote.creation.compose.modifier.size
import androidx.compose.remote.creation.compose.modifier.width
import androidx.compose.remote.creation.compose.shaders.RemoteBrush
import androidx.compose.remote.creation.compose.shaders.solidColor
import androidx.compose.remote.creation.compose.shapes.RemoteCircleShape
import androidx.compose.remote.creation.compose.shapes.RemoteRoundedCornerShape
import androidx.compose.remote.creation.compose.state.MutableRemoteBoolean
import androidx.compose.remote.creation.compose.state.RemotePaint
import androidx.compose.remote.creation.compose.state.RemotePaintingStyle
import androidx.compose.remote.creation.compose.state.RemoteStrokeCap
import androidx.compose.remote.creation.compose.state.RemoteTimeVariables
import androidx.compose.remote.creation.compose.state.rc
import androidx.compose.remote.creation.compose.state.rdp
import androidx.compose.remote.creation.compose.state.rf
import androidx.compose.remote.creation.compose.state.rs
import androidx.compose.remote.creation.compose.state.rsp
import androidx.compose.remote.creation.compose.text.RemoteFontWeight
import androidx.compose.remote.creation.compose.text.RemoteTextOverflow
import androidx.compose.remote.foundation.icon.RemoteBasicIcon
import androidx.compose.runtime.Composable
import androidx.compose.runtime.remember
import androidx.compose.ui.graphics.Color
fun playIcon(): RemoteImageVector =
RemoteImageVector.Builder(
viewportWidth = 24f.rf,
viewportHeight = 24f.rf,
tintColor = Color.Black.rc,
name = "Play",
)
.path(fill = RemoteBrush.solidColor(Color.Black.rc)) {
moveTo(8f.rf, 5f.rf)
lineTo(19f.rf, 12f.rf)
lineTo(8f.rf, 19f.rf)
close()
}
.build()
fun pauseIcon(): RemoteImageVector =
RemoteImageVector.Builder(
viewportWidth = 24f.rf,
viewportHeight = 24f.rf,
tintColor = Color.Black.rc,
name = "Pause",
)
.path(fill = RemoteBrush.solidColor(Color.Black.rc)) {
addRect(6f.rf, 5f.rf, 10f.rf, 19f.rf)
addRect(14f.rf, 5f.rf, 18f.rf, 19f.rf)
}
.build()
/** Media controls: a play/pause toggle drives a progress bar the player animates from the clock. */
@Composable
@RemoteComposable
fun MediaPlayer(track: String, artist: String, trackSeconds: Int) {
val playing = remember { MutableRemoteBoolean(false) }
RemoteColumn(
RemoteModifier.width(300.rdp)
.clip(RemoteRoundedCornerShape(20.rdp))
.background(Color(0xFF212121).rc)
.padding(16.rdp),
verticalArrangement = RemoteArrangement.spacedBy(12.rdp),
) {
RemoteText(
track.rs,
color = Color.White.rc,
fontSize = 18.rsp,
fontWeight = RemoteFontWeight.SemiBold,
maxLines = 1,
overflow = RemoteTextOverflow.Ellipsis,
)
RemoteText(artist.rs, color = Color(0xFFBDBDBD).rc, fontSize = 14.rsp)
RemoteCanvas(RemoteModifier.fillMaxWidth().height(6.rdp)) {
val track = RemotePaint {
color = Color(0xFF424242).rc
strokeWidth = height
strokeCap = RemoteStrokeCap.Round
style = RemotePaintingStyle.Stroke
}
drawLine(
track,
RemoteOffset(height / 2f.rf, height / 2f.rf),
RemoteOffset(width - height / 2f.rf, height / 2f.rf),
)
// Progress from the player's clock while playing; the document is never resent.
val fraction =
playing.select(
(RemoteTimeVariables.continuousSeconds % trackSeconds.toFloat().rf) /
trackSeconds.toFloat().rf,
0.08f.rf,
)
val fill = RemotePaint {
color = Color(0xFF1DB954).rc
strokeWidth = height
strokeCap = RemoteStrokeCap.Round
style = RemotePaintingStyle.Stroke
}
drawLine(
fill,
RemoteOffset(height / 2f.rf, height / 2f.rf),
RemoteOffset(height / 2f.rf + (width - height) * fraction, height / 2f.rf),
)
}
RemoteRow(RemoteModifier.fillMaxWidth(), horizontalArrangement = RemoteArrangement.Center) {
RemoteBox(
RemoteModifier.size(56.rdp)
.clip(RemoteCircleShape)
.background(Color.White.rc)
.clickable(
combinedAction(
valueChangeAction(playing, !playing),
hostAction("play_pause".rs, !playing),
),
role = RemoteRole.Button,
)
.semantics { contentDescription = playing.select("Pause".rs, "Play".rs) },
contentAlignment = RemoteAlignment.Center,
) {
RemoteStateLayout(playing) { isPlaying ->
RemoteBasicIcon(
if (isPlaying) pauseIcon() else playIcon(),
contentDescription = null,
modifier = RemoteModifier.size(28.rdp),
tint = Color(0xFF212121).rc,
)
}
}
}
}
}
API
creation.compose.layout.RemoteCanvas
void RemoteCanvas(optional RemoteModifier modifier, RemoteDrawScope.() -> Unit onDraw)creation.compose.state.RemoteTimeVariables
class RemoteTimeVariables
RemoteFloat animationDeltaTime
RemoteFloat animationTime
RemoteFloat continuousSeconds
RemoteInt dayOfMonth
RemoteInt dayOfWeek
RemoteInt dayOfYear
RemoteInt epochSecond
RemoteInt hourOfDay
RemoteInt minuteOfDay
RemoteInt month
RemoteInt secondOfHour
RemoteInt utcOffsetSeconds
RemoteInt year
RemoteTimeVariables INSTANCE