Remote Compose Storybook English GitHub

Media player

Tap play.

Media player: документ, нарисованный плеером Remote Compose
Открыть живое интерактивное демо →

Меняйте параметры, смотрите удалённый документ, который получается, и разницу после каждого изменения.

Что это

Кнопки воспроизведения с движущейся полосой прогресса — всё анимируется на устройстве.

Подходит для

  • Управление музыкой и подкастами
  • Таймеры и индикаторы прогресса

Код

Исходник примера с импортами 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

Справочник

Ещё в разделе «Готовые экраны»