SourceType

数据源的值,用于更新表盘上显示的实时值。

此元素在 Wear OS 4 中推出。

  • 版本 1
  • 版本 2
  • 时间和日期
  • 月相
  • 语言
  • 健康数据
  • 设备电池
  • 设备传感器
  • 通知
  • 天气
信息来源 说明 类别 可用性
IS_24_HOUR_MODE 一个布尔值,相当于 is24HourFormat() 的当前返回值,基于用户选择的语言区域和偏好设置。 布尔值 版本 1
IS_DAYLIGHT_SAVING_TIME 一个布尔值,相当于对当前语言区域的 TimeZone 对象调用 inDaylightTime(),并传入包含当前时间的 Date 对象。指示当前设置的时区目前是否采用夏令时。 布尔值 版本 1
TIMEZONE 一个字符串,相当于对当前语言区域的 TimeZone 对象调用 getDisplayName()。返回完整的时区名称,例如冬季将针对纽约市所处的时区返回“东部标准时间”。 字符串 版本 1
TIMEZONE_ABB 一个字符串,相当于对当前语言区域的 TimeZone 对象调用 getDisplayName() 的过载版本,其中给定的样式为 SHORT。返回缩写的时区名称,例如冬季将针对纽约市所处的时区返回“EST”。 字符串 版本 1
TIMEZONE_ID 一个字符串,相当于对当前语言区域的 TimeZone 对象调用 getId()。返回 IANA 时区 ID 值,例如针对纽约市所处的时区返回 America/New_York 字符串 版本 1
TIMEZONE_OFFSET 一个字符串,相当于对当前语言区域的 TimeZone 对象调用 getRawOffset()。此值始终介于 -12+14 之间(包括这两个数值)。可返回一个值,世界协调时间 (UTC) 应与此值相加,才能得出当前时区的标准时间(未校正为夏令时)。 字符串 版本 1
TIMEZONE_OFFSET_DST 一个字符串,相当于将当前日期传入当前语言区域的 TimeZone 对象的 getOffset()。此值始终介于 -12+14 之间(包括这两个数值)。可返回一个值,世界协调时间 (UTC) 应与此值相加,才能得出当前的当地时间(必要时需要考虑到夏令时)。 字符串 版本 1
MOON_PHASE_TYPE 一个整数,用于对当前月相进行编码。可能的值包括:
  • 0:最近一次新月
  • 1:傍晚新月
  • 2:上弦月
  • 3:盈凸月
  • 4:满月
  • 5:亏凸月
  • 6:下弦月
  • 7:清晨新月
整数 版本 1
MOON_PHASE_TYPE_STRING 一个字符串,表示当前的月相。可能的值包括:
  • 新月:自最近一次新月以来经过了不到 0.5 天或超过 27.5 天。
  • 傍晚新月:自最近一次新月以来经过了至少 0.5 天,但不足 6.5 天。
  • 上弦月:自最近一次新月以来经过了至少 6.5 天,但不足 7.5 天。
  • 盈凸月:自最近一次新月以来经过了至少 7.5 天,但不足 13.5 天。
  • 满月:自最近一次新月以来经过了至少 13.5 天,但不足 14.5 天。
  • 亏凸月:自最近一次新月以来经过了至少 14.5 天,但不足 20.5 天。
  • 下弦月:自最近一次新月以来经过了至少 20.5 天,但不足 21.5 天。
  • 清晨新月:自最近一次新月以来经过了至少 21.5 天,但不足 27.5 天。
字符串 版本 1
LANGUAGE_LOCALE_NAME 一个字符串,表示 Wear OS 设备的当前语言区域,表示为一个包含两个字符的 ISO 639-1 语言代码、一条下划线和一个包含两个字符的 ISO 3166-1 地区代码。英语的美国变体表示为 en_US 字符串 版本 1
UNREAD_NOTIFICATION_COUNT 一个字符串,表示已发送到此 Wear OS 设备的用户尚未读取的通知数量。 整数 版本 1
WEATHER.IS_AVAILABLE 如果有可渲染的天气数据,则返回 true。 布尔值 版本 2
WEATHER.IS_ERROR

如果加载天气数据时出错,则返回 true。

IS_ERRORIS_AVAILABLE 并不互斥。当这两个值均为 true 时,表盘的预期行为是继续渲染一些天气数据,但同时显示一个指示器,表明在提取数据时出错。

布尔值 版本 2
WEATHER.CONDITION

表示当前天气状况的枚举值。

可能的值为:

  • 0 - UNKNOWN_VALUE
  • 1 - CLEAR
  • 2 - CLOUDY
  • 3 - FOG
  • 4 - HEAVY_RAIN
  • 5 - HEAVY_SNOW
  • 6 - RAIN
  • 7 - SNOW
  • 8 - SUNNY
  • 9 - THUNDERSTORM
  • 10 - SLEET
  • 11 - LIGHT_SNOW
  • 12 - LIGHT_RAIN
  • 13 - MIST
  • 14 - PARTLY_CLOUDY
  • 15 - WINDY

注意:如果使用 WEATHER.CONDITION 数据源,强烈建议表盘能够识别所有枚举值。

整数 版本 2
WEATHER.CONDITION_NAME 以人类可读的方式表示的天气数据,已翻译成用户的首选语言。 字符串 版本 2
WEATHER.LAST_UPDATED 上次更新天气数据时的时间戳。此值以 Unix 纪元时间的毫秒数表示。 整数 版本 2
对于以下数据源,您可以将 index 设置为适当的值以检索预测值。index 从 0 开始。
例如,您可以使用 WEATHER.HOURS.2.CONDITION 检索 2 小时后的天气状况。
WEATHER.HOURS.{index}.IS_AVAILABLE

如果预报天气数据可供在 index 小时后使用,则返回 true。

开发者应先检查此值,然后再访问给定编号值的任何按小时划分的天气数据。

布尔值 版本 2
WEATHER.HOURS.{index}.CONDITION

预报的天气状况,表示距离现在的小时数。

返回的值与 WEATHER.CONDITION 相同。

整数 版本 2
WEATHER.HOURS.{index}.CONDITION_NAME 以用户的首选语言表示的预报天气状况(index 小时后),以人类可读的方式表示。 字符串 版本 2
WEATHER.HOURS.{index}.IS_DAY 如果现在是夏令时,则返回 index 小时。非常有用,因为一天的时长会随着一年的变化而变化。 布尔值 版本 2
WEATHER.HOURS.{index}.TEMPERATURE index 小时后的预报温度(以用户的首选单位表示) 整数 版本 2
WEATHER.HOURS.{index}.UV_INDEX 紫外线指数预报,以用户的首选单位表示,小时后。 整数 版本 2
对于以下数据源,您可以将 index 设置为适当的值以检索预测值。index 从 0 开始。
例如,您可以使用 WEATHER.DAYS.1.TEMPERATURE_LOW 检索明天的最低温度值(从现在算起 1 天)。
WEATHER.DAYS.{index}.IS_AVAILABLE

如果现在起 index 天后的天气预报数据可用,则返回 true。

开发者应先检查此值,然后再访问给定编号值的任何基于日期的天气数据。

布尔值 版本 2
WEATHER.DAYS.{index}.CONDITION_DAY

白天预报的天气状况,从现在起 index 天后。

返回的值与 WEATHER.CONDITION 相同。

整数 版本 2
WEATHER.DAYS.{index}.CONDITION_DAY_NAME 以用户首选语言表示的白天预报天气状况(index 天后),可供用户轻松理解。 字符串 版本 2
WEATHER.DAYS.{index}.CONDITION_NIGHT

index 天后的夜间预报天气状况。

返回的值与 WEATHER.CONDITION 相同。

整数 版本 2
WEATHER.DAYS.{index}.CONDITION_NIGHT_NAME 以用户首选语言表示的夜间预报天气状况(index 天后),可供人轻松理解。 字符串 版本 2
WEATHER.DAYS.{index}.TEMPERATURE_LOW 预计当天最低气温,自现在起 index 天。 整数 版本 2
WEATHER.DAYS.{index}.TEMPERATURE_HIGH 从现在起 index 天后的当天最高温度预报。 整数 版本 2
WEATHER.DAYS.{index}.CHANCE_OF_PRECIPITATION

未来 index 天内的降水概率预报。

返回值在 0100 之间。

整数 版本 2
WEATHER.DAYS.{index}.CHANCE_OF_PRECIPITATION_NIGHT

预计的夜间降水概率,自现在起 index 天。

返回值在 0100 之间。

整数 版本 2
WEATHER.DAYS.{index}.UV_INDEX 紫外线指数预报,天数后。 整数 版本 2