在功能块中显示动态更新

从 Tiles 1.2 开始，您可以使用动态表达式流式传输平台数据更新。然后，您可以将这些更新与功能块中的动画相关联。您的应用每秒都会收到此值的更新。

使用动态表达式时，如果功能块的内容发生变化，您无需刷新整个功能块。为了在功能块中打造更具吸引力的体验，请为这些动态对象添加动画效果。

将动态表达式与数据源相关联

androidx.wear.protolayout 和 androidx.wear.protolayout.material 命名空间包含许多类，其字段接受动态表达式。以下是此类情况的几个示例：

• 多个长度值，包括 Arc 对象的长度和 CircularProgressIndicator 对象的长度。
• 任何颜色，例如 Button 对象的内容颜色。
• 许多字符串值，包括 Text 对象的内容、LayoutElementsBuilders.Text 对象的内容和 CircularProgressIndicator 对象的内容说明。

若要将动态表达式用作功能块中某个元素可能的值，请使用该元素的相应 *Prop 动态属性类型，并将数据源传递给动态属性类型的构建器类的 setDynamicValue() 方法。

功能块支持以下动态属性类型：

• 对于线性尺寸（以屏幕无关像素为单位），请使用 DimensionBuilders.DpProp。
• 对于角度尺寸（以度为单位），请使用 DimensionBuilders.DegreesProp。
• 对于字符串值，请使用 TypeBuilders.StringProp。
• 对于颜色值，请使用 ColorBuilders.ColorProp。
• 对于浮点值，请使用 TypeBuilders.FloatProp。

如果您使用的动态表达式会影响实际尺寸（功能块中除颜色以外的任何值），您必须也指定一组相关约束条件，例如字符串格式。这些约束条件允许系统渲染程序确定在功能块中某个值可占用的空间上限。您通常可以调用以 setLayoutConstraintsForDynamic* 开头的方法，在元素级别（而不是动态表达式级别）指定这些约束条件。

注意：Material 组件会自动设置这些布局约束条件。

以下代码段展示了如何使用 3 位数（回退值为 --）显示心率的更新：

override fun onTileRequest(requestParams: RequestBuilders.TileRequest) =
    Futures.immediateFuture(
        Tile.Builder()
            .setResourcesVersion(RESOURCES_VERSION)
            .setFreshnessIntervalMillis(60 * 60 * 1000) // 60 minutes
            .setTileTimeline(
                Timeline.fromLayoutElement(
                    Text.Builder(
                        this,
                        TypeBuilders.StringProp.Builder("--")
                            .setDynamicValue(
                                PlatformHealthSources.heartRateBpm()
                                    .format()
                                    .concat(DynamicBuilders.DynamicString.constant(" bpm"))
                            )
                            .build(),
                        TypeBuilders.StringLayoutConstraint.Builder("000").build(),
                    )
                        .build()
                )
            )
            .build()
    )
Tile.kt

在单个功能块中使用少量表达式

Wear OS 对单个功能块可包含的表达式数量设有限制。如果功能块包含的动态表达式总数过多，系统会忽略动态值，并回退到您提供给各个动态属性类型的静态值。

将动态数据整合到状态对象中

您可以将来自数据源的一组最新更新整合到状态中，并将该状态传递到功能块以进行值渲染。

如需在功能块中使用状态信息，请完成以下步骤：

1. 创建一组键，代表功能块的不同状态值。下例创建了代表饮水量和备注的键：

   Kotlin

   companion object {
       val KEY_WATER_INTAKE = AppDataKey<DynamicInt32>("water_intake")
       val KEY_NOTE = AppDataKey<DynamicString>("note")
   }

   Java

   private static final AppDataKey<DynamicInt32> KEY_WATER_INTAKE =
       new AppDataKey<DynamicInt32>("water_intake");
   private static final AppDataKey<DynamicString> KEY_NOTE =
       new AppDataKey<DynamicString>("note");

2. 在 onTileRequest() 的实现中，调用 setState() 并建立每个键与特定动态数据值的初始映射：

   Kotlin

   override fun onTileRequest(requestParams: TileRequest):
           ListenableFuture<Tile> {
       val state = State.Builder()
           .addKeyToValueMapping(KEY_WATER_INTAKE,
               DynamicDataBuilders.DynamicDataValue.fromInt(200))
           .addKeyToValueMapping(KEY_NOTE,
               DynamicDataBuilders.DynamicDataValue.fromString("Note about day"))
       .build()
       // ...
   
       return Futures.immediateFuture(Tile.Builder()
           // Set resources, timeline, and other tile properties.
           .setState(state)
           .build()
       )

   Java

   @Override
   protected ListenableFuture<Tile> onTileRequest(
               ListenableFuture<Tile> {
       State state = new State.Builder()
           .addKeyToValueMapping(KEY_WATER_INTAKE,
               DynamicDataBuilders.DynamicDataValue.fromInt(200))
           .addKeyToValueMapping(KEY_NOTE,
               DynamicDataBuilders.DynamicDataValue.fromString("Note about day"))
       .build();
       // ...
   
       return Futures.immediateFuture(Tile.Builder()
           // Set resources, timeline, and other tile properties.
           .setState(state)
           .build()
       );
   }

3. 创建布局时，在您想要显示状态数据的位置使用 Dynamic* 类型对象。您也可以调用 animate()，以显示从上一个值转换到当前值的动画：

   Kotlin

   DynamicInt32.from(KEY_WATER_INTAKE).animate()

   Java

   DynamicInt32.from(KEY_WATER_INTAKE).animate();

4. 如有需要，您还可以将状态更新为新的值。这可以通过功能块的 LoadAction 来执行。

   下例中的饮水量值会更新为 400：

   Kotlin

   val loadAction = LoadAction.Builder()
       .setRequestState(
           State.Builder()
               .addKeyToValueMapping(
                   KEY_WATER_INTAKE,
                   DynamicDataBuilders.DynamicDataValue.fromInt(400)
               )
               .build()
       )
       .build()

   Java

   LoadAction loadAction = new LoadAction.Builder()
       .setRequestState(
           new State.Builder()
               .addKeyToValueMapping(
                   KEY_WATER_INTAKE,
                   DynamicDataBuilders.DynamicDataValue.fromInt(400)
               ).build()
       ).build();