表盘格式的天气数据

从版本 2 开始，表盘格式就开始支持天气数据。此数据涵盖一系列指标和时间范围，从当前条件到每小时和每日预测，不一而足。

您可以使用表达式访问天气信息。例如，如需在 <Text> 元素中显示当前天气条件，请使用类似于以下内容的表达式：

<Text>
  <Font family="SYNC_TO_DEVICE" size="32">
    <Template>Today's weather: %s
        <Parameter expression="[WEATHER.CONDITION_NAME]"/>
    </Template>
  </Font>
</Text>

适用范围

在访问 [WEATHER.*] 对象的其他成员之前，表盘应始终检查 [WEATHER.IS_AVAILABLE] 值：

<Condition>
  <Expressions>
    <Expression name="is_weather_available">[WEATHER.IS_AVAILABLE]</Expression>
  </Expressions>
  <Compare expression="is_weather_available">
    <!-- Weather is available, so show the weather data. -->
  </Compare>
  <Default>
    <!-- Weather isn't available, so show an appropriate message. -->
  </Default>
</Condition>

此外，表盘还应检查 [WEATHER.IS_ERROR]，这表示加载天气数据时出错。

请注意，[WEATHER.IS_AVAILABLE] 和 [WEATHER.IS_ERROR] 可能均为 true，表示数据已过时且尝试刷新数据失败。在这种情况下，可显示可用的天气，以及指示提取新数据时出错的指示符。

数据新鲜度

您可以使用 [WEATHER.LAST_UPDATED] 访问可用数据的时间戳，该时间戳是以毫秒为单位的 Unix 纪元时间戳。

可以使用 icuText(,) 方法设置此值的格式，以获取直观易懂的表示法，如天气示例所示。

天气状况

[WEATHER.CONDITION] 中提供了当前条件，[WEATHER.CONDITION_NAME] 中提供了直观易懂的版本。

[WEATHER.CONDITION] 的值可在数据源中查看。例如，4 表示 HEAVY_RAIN。

注意 ：如果表盘表示当前条件，我们强烈建议您处理 [WEATHER.CONDITION] 枚举中的所有潜在值。

其他指标

表盘格式提供了一系列其他指标，例如 [WEATHER.TEMPERATURE] 和 [WEATHER.UV_INDEX]。如需了解可用指标的完整详情（包括单位和数据类型），请访问数据源参考页面。

每小时和每日天气预报

您可以访问未来特定小时或日期的预测条件，如下所示：

• [WEATHER.HOURS.1.CONDITION] - 1 小时后的预测条件。
• [WEATHER.DAYS.2.CONDITION] - 2 天后的预测条件。

每小时数据最多可提前 8 小时获取，每日数据最多可提前 5 天获取。不过，表盘应始终检查预测数据的可用性。在不同的时间或设备上，可能会有不同的时段或天数范围。例如，如需检查从现在起 1 小时后的预测数据是否可用，请使用 [WEATHER.HOURS.1.IS_AVAILABLE]。

注意 ：如果表盘为预测数据呈现 CONDITION，我们强烈建议您处理 CONDITION 枚举中的所有潜在值。

每日和每小时预报还包含一系列指标，例如 [WEATHER.HOURS.<N>.TEMPERATURE] 和 [WEATHER.DAYS.<N>.CHANCE_OF_PRECIPITATION]。如需了解可用指标的完整详情（包括单位和数据类型），请访问数据源参考页面。

使用天气数据进行测试

如需获取天气数据，Wear OS 设备必须知道设备的位置。

为了节省电量，手表不会使用板载 GPS 传感器来确定天气预报位置，而是依靠来自连接的手持设备或可用网络的位置信息。

如需使位置数据可供测试，请执行以下操作之一：

• 将 Wear OS 模拟器与实体手机或模拟器手机配对。
• 通过以下 adb 命令模拟位置：

adb unroot
adb shell cmd location set-location-enabled true
adb root
adb shell appops set 0 android:mock_location allow
adb shell cmd location providers add-test-provider gps
adb shell cmd location providers set-test-provider-enabled gps true
adb shell cmd location providers set-test-provider-location gps --location 37.773972,-122.431297

更多详情

如需查看访问和渲染天气数据的完整示例，请参阅 GitHub 示例。