从第 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.TEMPERATURE]
和 [WEATHER.UV_INDEX]
。有关可用指标的完整详细信息(包括单位和数据类型),请访问数据源参考页面。
每小时和每日预报
您可以按如下方式访问针对未来的特定小时或日期的预测状况
[WEATHER.HOURS.1.CONDITION]
- 1 小时后的预测状况。[WEATHER.DAYS.2.CONDITION]
- 2 天后的预测状况。
每小时数据最长可提前 8 小时提供,每日数据最长可提前 5 天提供。但是,表盘应始终检查预测数据的可用性。不同的小时或天数范围可能在不同时间或不同设备上可用。例如,要检查 1 小时后是否有预测数据,请使用 [WEATHER.HOURS.1.IS_AVAILABLE]
。
每日和每小时预报也提供了一系列指标,例如 [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 示例。
推荐给您
- 注意:如果 JavaScript 处于关闭状态,则会显示链接文本
- 更改焦点行为
- Compose 中的附带效应
- AGSL 快速参考