Remote Compose Storybook English GitHub

Weather widget

Change Viewport to Widget 320×180 or Small 240×240 to see the layout switch; change temperature in the Host values tab to see live data arrive without a new document.

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

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

Что это

Виджет, который перестраивается под свой размер и показывает живые данные от приложения.

Подходит для

  • Виджеты на главном экране
  • Живые счета, цены, статус доставки

Код

Исходник примера с импортами androidx.compose.remote. CI компилирует каждый фрагмент кода на сайте против AndroidX.

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.RemoteColumn
import androidx.compose.remote.creation.compose.layout.RemoteComposable
import androidx.compose.remote.creation.compose.layout.RemoteFitBox
import androidx.compose.remote.creation.compose.layout.RemoteRow
import androidx.compose.remote.creation.compose.layout.RemoteText
import androidx.compose.remote.creation.compose.modifier.RemoteModifier
import androidx.compose.remote.creation.compose.modifier.background
import androidx.compose.remote.creation.compose.modifier.clip
import androidx.compose.remote.creation.compose.modifier.fillMaxSize
import androidx.compose.remote.creation.compose.modifier.fillMaxWidth
import androidx.compose.remote.creation.compose.modifier.padding
import androidx.compose.remote.creation.compose.modifier.size
import androidx.compose.remote.creation.compose.shapes.RemoteRoundedCornerShape
import androidx.compose.remote.creation.compose.state.RemoteInt
import androidx.compose.remote.creation.compose.state.RemoteString
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.rememberNamedRemoteInt
import androidx.compose.remote.creation.compose.state.rememberNamedRemoteString
import androidx.compose.remote.creation.compose.state.ri
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.runtime.Composable
import androidx.compose.ui.graphics.Color

/** An integer as two digits ("07"): a remote select, evaluated by the player. */
fun twoDigits(value: RemoteInt): RemoteString =
    value.isLessThan(10.ri).select("0".rs + value.toRemoteString(), value.toRemoteString())

/**
 * A weather widget at three sizes. The temperature and the condition are named values the app
 * refreshes (try the Host values tab); the clock is the player's own.
 */
@Composable
@RemoteComposable
fun WeatherWidget(city: String, temperature: Int, condition: String) {
    val temp = rememberNamedRemoteInt("temperature", temperature)
    val sky = rememberNamedRemoteString("condition", condition)
    val time = RemoteTimeVariables
    val clock = twoDigits(time.hourOfDay) + ":".rs + twoDigits(time.minuteOfDay % 60.ri)
    val gradientTop = Color(0xFF42A5F5).rc
    RemoteBox(
        RemoteModifier.fillMaxSize().clip(RemoteRoundedCornerShape(24.rdp)).background(gradientTop),
        contentAlignment = RemoteAlignment.Center,
    ) {
        // The player picks the largest layout that fits the widget's size.
        RemoteFitBox(
            RemoteModifier.fillMaxSize(),
            horizontalAlignment = RemoteAlignment.CenterHorizontally,
            verticalArrangement = RemoteArrangement.Center,
        ) {
            RemoteColumn(
                RemoteModifier.size(300.rdp, 160.rdp).padding(16.rdp),
                verticalArrangement = RemoteArrangement.SpaceBetween,
            ) {
                RemoteRow(
                    RemoteModifier.fillMaxWidth(),
                    horizontalArrangement = RemoteArrangement.SpaceBetween,
                ) {
                    RemoteText(city.rs, color = Color.White.rc, fontSize = 18.rsp)
                    RemoteText(clock, color = Color(0xCCFFFFFF).rc, fontSize = 14.rsp)
                }
                RemoteText(
                    temp.toRemoteString() + "°".rs,
                    color = Color.White.rc,
                    fontSize = 56.rsp,
                    fontWeight = RemoteFontWeight.Light,
                )
                RemoteText(sky, color = Color.White.rc, fontSize = 16.rsp)
            }
            RemoteColumn(
                RemoteModifier.size(150.rdp, 150.rdp).padding(12.rdp),
                horizontalAlignment = RemoteAlignment.CenterHorizontally,
                verticalArrangement = RemoteArrangement.Center,
            ) {
                RemoteText(city.rs, color = Color.White.rc, fontSize = 14.rsp, maxLines = 1)
                RemoteText(
                    temp.toRemoteString() + "°".rs,
                    color = Color.White.rc,
                    fontSize = 44.rsp,
                )
                RemoteText(sky, color = Color.White.rc, fontSize = 12.rsp, maxLines = 1)
            }
            RemoteBox(RemoteModifier.size(72.rdp), contentAlignment = RemoteAlignment.Center) {
                RemoteText(
                    temp.toRemoteString() + "°".rs,
                    color = Color.White.rc,
                    fontSize = 28.rsp,
                )
            }
        }
    }
}

API

creation.compose.layout.RemoteFitBox

void RemoteFitBox(optional RemoteModifier modifier, optional RemoteAlignment.Horizontal horizontalAlignment, optional RemoteArrangement.Vertical verticalArrangement, optional () -> Unit content)

creation.compose.state.rememberNamedRemoteInt

RemoteInt rememberNamedRemoteInt(String name, int defaultValue, optional RemoteState.Domain domain)

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

Справочник

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