SourceType

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

此元素在 Wear OS 4 中推出。

来源 说明 类别 适用范围
UTC_TIMESTAMP 自世界协调时间 (UTC) 1970 年 1 月 1 日午夜以来经过的毫秒数。 整数 版本 1
MILLISECOND 一个整数值,表示当前时间的 ZonedDateTime 对象的毫秒字段。此值始终介于 0999 之间(包括这两个数值)。 整数 版本 1
SECOND 一个整数值,表示当前时间的 ZonedDateTime 对象的秒字段。此值始终介于 059 之间(包括这两个数值)。 整数 版本 1
SECOND_Z 一个字符串,表示当前时间的 ZonedDateTime 对象的秒字段,其中包含前导零,以使值的长度为 2 个字符。此值始终介于 0059 之间(包括这两个数值)。 字符串 版本 1
SECOND_TENS_DIGIT 当前秒数的十位数,例如,4 表示 12:03:47。 整数 版本 2
SECOND_UNITS_DIGIT 当前秒的单位数,例如 7 表示 12:03:47。 整数 版本 2
SECOND_MILLISECOND 一个浮点值,用于组合表示当前时间的 ZonedDateTime 对象的秒字段和毫秒字段。此值始终介于 0.059.999 之间(包括这两个数值)。 浮点数 版本 1
SECONDS_IN_DAY 当前日期经过的秒数,基于 HOUR_0_23MINUTESECOND 的值。此值始终介于 086399 ($ 24 * 60 * 60 - 1 $) 之间(包括这两个数值)。 整数 版本 1
MINUTE 一个整数值,表示当前时间的 ZonedDateTime 对象的分钟字段。此值始终介于 059 之间(包括这两个数值)。 整数 版本 1
MINUTE_Z 一个字符串值,表示当前时间的 ZonedDateTime 对象的分钟字段,其中包含前导零,以使值的长度为 2 个字符。此值始终介于 0059 之间(包括这两个数值)。 字符串 版本 1
MINUTE_TENS_DIGIT 当前分钟的十位数,例如 12:03 中的 0 整数 版本 2
MINUTE_UNITS_DIGIT 当前分钟的单位数,例如 12:03 中的 3 整数 版本 2
MINUTE_SECOND 一个浮点值,用于组合表示当前时间的 ZonedDateTime 对象的分钟字段和秒字段。此值始终介于 0.0 和 $ 59 \frac{59}{60} $ 之间(包括这两个数值)。 浮点数 版本 1
HOUR_0_11 当前时间的 12 小时制组件,表示为一个介于 011 之间的值(包括这两个数值)。如果当前 CLOCK_HOUR_OF_AMPM12(如 12:34 PM 中),则此值将转换为 0 整数 版本 1
HOUR_0_11_Z 一个字符串,用于表示当前时间的 12 小时制组件,介于 0011 之间(包括这两个数值),并使用 Wear OS 设备的当前时区。如果此值小于 10,则此值包含前导零。 字符串 版本 1
HOUR_0_11_MINUTE 一个浮点值,用于组合表示当前时间的 ZonedDateTime 对象的经过修改的 CLOCK_HOUR_OF_AMPM 字段和分钟字段。此值始终介于 0.0 和 $ 11 \frac{59}{60} $ 之间(包括这两个数值)。 浮点数 版本 1
HOUR_1_12 当前时间的 12 小时制组件,表示为一个介于 112 之间的值(包括这两个数值)。如果当前 HOUR_OF_DAY0(如 0:12 中,即凌晨 12:12),则此值将转换为 12 整数 版本 1
HOUR_1_12_Z 一个字符串,用于表示当前时间的 12 小时制组件,介于 0112 之间(包括这两个数值),并使用 Wear OS 设备的当前时区。如果此值小于 10,则此值包含前导零。 string 版本 1
HOUR_1_12_MINUTE 一个浮点值,用于组合表示当前时间的 ZonedDateTime 对象的 CLOCK_HOUR_OF_AMPM 字段和分钟字段。此值始终介于 1.0 和 $ 12 \frac{59}{60} $ 之间(包括这两个数值)。 浮点数 版本 1
HOUR_0_23 当前时间的 24 小时制组件,表示为一个介于 023 之间的值(包括这两个数值)。如果此值为 24(如 24:13,即第二天凌晨 12:13),则此值将转换为 0 整数 版本 1
HOUR_0_23_Z 一个字符串,用于表示当前时间的 24 小时制组件,介于 0023 之间(包括这两个数值),并使用 Wear OS 设备的当前时区。如果此值小于 10,则此值包含前导零。 整数 版本 1
HOUR_0_23_MINUTE 一个浮点值,用于组合表示当前时间的 ZonedDateTime 对象的小时字段和分钟字段。此值始终介于 0.0 和 $ 23 \frac{59}{60} $ 之间(包括这两个数值)。 浮点数 版本 1
HOUR_1_24 当前时间的 24 小时制组件,表示为一个介于 124 之间的值(包括这两个数值)。如果此值为 0(如 0:12,即凌晨 12:12),则此值将转换为 24 整数 版本 1
HOUR_1_24_Z 一个字符串,用于表示当前时间的 12 小时制组件,介于 0124 之间(包括这两个数值),并使用 Wear OS 设备的当前时区。如果此值小于 10,则此值包含前导零。 字符串 版本 1
HOUR_1_24_MINUTE 一个浮点值,用于组合表示当前时间的 ZonedDateTime 对象的经过修改的小时字段和分钟字段。此值始终介于 1.0 和 $ 24 \frac{59}{60} $ 之间(包括这两个数值)。 浮点数 版本 1
HOUR_TENS_DIGIT 当前小时的十位数,例如 12:03 中的 1 整数 版本 2
HOUR_UNITS_DIGIT 当前小时的单位数,例如 12:03 中的 2 整数 版本 2
DAY 一个整数值,表示当前日期的 ZonedDateTime 对象的日期字段。此值始终介于 131 之间(包括这两个数值)。 整数 版本 1
DAY_Z 一个字符串值,表示当前日期的 ZonedDateTime 对象的日期字段,其中包含前导零,以使值的长度为 2 个字符。此值始终介于 0131 之间(包括这两个数值)。 字符串 版本 1
DAY_HOUR 一个浮点值,用于组合表示当前日期和时间的 ZonedDateTime 对象的日期字段和小时字段。此值始终介于 1.0 和 $ 31 \frac{23}{24} $ 之间(包括这两个数值)。 浮点数 版本 1
DAY_0_30 表示当前日期的 ZonedDateTime 对象的 getDayOfMonth() 值的修改版,用于表示当前日期,需要减去 1。 此值始终介于 030 之间(包括这两个数值)。 整数 版本 1
DAY_0_30_HOUR 一个浮点值,用于组合表示当前日期和时间的 ZonedDateTime 对象的日期字段和小时字段。此值始终介于 0.0 和 $ 30 \frac{23}{24} $ 之间(包括这两个数值)。 浮点数 版本 1
DAY_OF_YEAR 自日历年更改以来已经开始的天数。此值始终介于 1366 之间(包括这两个数值),并且非闰年的最大值为 365 整数 版本 1
DAY_OF_WEEK 表示当前日期的 ZonedDateTime 对象的 getDayOfWeek() 值的修改版。表盘格式会指定值 1 代表星期天,并指定值 7 代表星期六。 整数 版本 1
DAY_OF_WEEK_F 星期几,表示为一个完整长度的字符串。示例包括 SundayMonday 字符串 版本 1
DAY_OF_WEEK_S 星期几,表示为一个缩写的字符串。示例包括 SunMon 字符串 版本 1
FIRST_DAY_OF_WEEK 根据 getFirstDayOfWeek() 提供一周的第一天,其中 1 表示周日,7 表示周六。例如,美国为星期日,法国为星期一。 整数 版本 2
MONTH 一个整数值,表示当前日期的 ZonedDateTime 对象的月份字段。此值始终介于 112 之间(包括这两个数值)。 整数 版本 1
MONTH_Z 一个字符串值,表示当前日期的 ZonedDateTime 对象的月份字段,其中包含前导零,以使值的长度为 2 个字符。此值始终介于 0112 之间(包括这两个数值)。 字符串 版本 1
MONTH_F 一年中的当前月份,表示为一个完整长度的字符串。示例包括 JanuaryDecember 字符串 版本 1
MONTH_S 一年中的当前月份,表示为一个缩写的字符串。示例包括 JanDec 字符串 版本 1
DAYS_IN_MONTH 当前月份的天数。此值在 2 月为 2829,在 4 月、6 月、9 月和 11 月为 30,在公历的所有其他月份为 31 整数 版本 1
MONTH_DAY 一个浮点值,用于组合表示当前日期的 ZonedDateTime 对象的月份字段和经过修改的日期字段。此值始终介于 1.0 和 $ 12 \frac{29}{30} $ 之间(包括这两个数值)。 浮点数 版本 1
MONTH_0_11 表示当前日期的 ZonedDateTime 对象的 getMonthValue() 值的修改版。此值将为 1 月指定值 0,并为 12 月指定值 11 整数 版本 1
MONTH_0_11_DAY 一个浮点值,用于组合表示当前日期的 ZonedDateTime 对象的经过修改的月份字段和经过修改的日期字段。此值始终介于 0.0 和 $ 11 \frac{29}{30} $ 之间(包括这两个数值)。 浮点数 版本 1
YEAR 一个整数值,表示当前日期的 ZonedDateTime 对象的年份字段。此值的限制取值范围始终介于 19022100 之间(包括这两个数值)。 整数 版本 1
YEAR_S 一个两位整数,表示当前年份的最后两位数字。例如,2023 的值为 23 整数 版本 1
YEAR_MONTH 一个浮点值,用于组合表示当前日期的 ZonedDateTime 对象的年份字段和经过修改的日期字段。2023 年 1 月表示为 2023.0,而 2023 年 12 月表示为 $ 2023 \frac {11}{12} $。 浮点数 版本 1
YEAR_MONTH_DAY 一个浮点值,用于组合表示当前日期的 ZonedDateTime 对象的年份字段、经过修改的月份字段和经过修改的日期字段。2023 年 1 月 1 日表示为 2023.0,而 2023 年 12 月 31 日表示为 $ 2023 \frac{11 \frac{29}{30} }{12} \approx 2023.9972 $。 浮点数 版本 1
WEEK_IN_MONTH 一个整数,表示当前日期的 ChronoField 对象的 ALIGNED_WEEK_OF_MONTH 值。此值始终介于 05 之间(包括这两个数值)。 整数 版本 1
WEEK_IN_YEAR 一个整数,表示当前日期的 ChronoField 对象的 ALIGNED_WEEK_OF_YEAR 值。此值始终介于 153 之间(包括这两个数值)。 整数 版本 1
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
AMPM_STATE 一个整数,用于指示当前时间是在中午之前还是中午还是更晚。可能的值包括 0(针对“凌晨/上午”)和 1(针对“下午/晚上”)。 整数 版本 1
AMPM_POSITION 一个整数,表示“凌晨/上午”或“下午/晚上”指示器应在时间字符串中的显示位置。包含以下某个值:
  • 0 表示“凌晨/上午”或“下午/晚上”应显示在字符串的开头,例如 AM 12:03
  • 1 表示“凌晨/上午”或“下午/晚上”应显示在字符串的末尾,例如 12:03 AM
  • -1 表示不知道“凌晨/上午”或“下午/晚上”应显示在字符串中的什么位置。
整数 版本 1
AMPM_STRING 一个包含两个字符的字符串,表示当前时间的“凌晨/上午”或“下午/晚上”状态。其值为“凌晨/上午”或“下午/晚上”。 字符串 版本 1
MOON_PHASE_POSITION 一个整数值,表示自最近一次新月以来已经开始的天数。此值始终介于 028 之间(包括这两个数值)。 整数 版本 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
STEP_COUNT 用户今天到目前为止走过的步数,基于 Wear OS 传感器。 整数 版本 1
STEP_GOAL 用户选择作为每日步数目标的步数。此值始终不小于 1000 整数 版本 1
STEP_PERCENT 一个整数,表示用户当前实现步数目标的进度,表示为经过四舍五入的百分比。此值始终介于 0100 之间(包括这两个数值)。 整数 版本 1
HEART_RATE 用户当前的心率,基于 Wear OS 传感器。此值始终介于 0240 之间(包括这两个数值)。 整数 版本 1
HEART_RATE_Z 一个字符串,表示用户当前的心率,基于 Wear OS 传感器。可视需要在此值左侧添加零,以使其长度至少为 2 个字符。因此,如果用户的心率为 65,则此值为 65。如果用户的心率为 0,则此值为 00 字符串 版本 1
ACCELEROMETER_IS_SUPPORTED 布尔值,表示表盘是否可以从当前 Wear OS 设备的传感器获取加速度计数据。 00 布尔值 版本 1
ACCELEROMETER_X 一个浮点值,表示 x 轴的当前线性加速度,基于 Wear OS 设备的加速度计。正值表示当表盘指向天空或天花板时,Wear OS 设备会向右加速。 浮点数 版本 1
ACCELEROMETER_Y 一个浮点值,表示 y 轴的当前线性加速度,基于 Wear OS 设备的加速度计。正值表示当表盘指向天空或天花板时,Wear OS 设备会沿着表盘在 12 点(顶部)方向上加速。 浮点数 版本 1
ACCELEROMETER_Z 一个浮点值,表示 z 轴的当前线性加速度,基于 Wear OS 设备的加速度计。正值表示当表盘指向天空或天花板时,Wear OS 设备会朝着天空或天花板加速。 注意:在设备处于静态时,为考虑重力因素,此值约为 -9.8 浮点数 版本 1
ACCELEROMETER_Z 一个浮点值,表示 z 轴的当前线性加速度,基于 Wear OS 设备的加速度计。正值表示当表盘指向天空或天花板时,Wear OS 设备会朝着天空或天花板加速。 注意:在设备处于静态时,为考虑重力因素,此值约为 -9.8 浮点数 版本 1
ACCELEROMETER_ANGLE_X 一个浮点值,表示相对于 x 轴的当前角加速度(以度为单位)。此值始终在 $ [-90.0, 90.0 $] 的范围内。 浮点数 版本 1
ACCELEROMETER_ANGLE_Y 一个浮点值,表示相对于 y 轴的当前角加速度(以度为单位)。此值始终在 $ [-90.0, 90.0 $] 的范围内。 浮点数 版本 1
ACCELEROMETER_ANGLE_Z 一个浮点值,表示相对于 z 轴的当前角加速度(以度为单位)。此值始终在 $ [-90.0, 90.0 $] 的范围内。 浮点数 版本 1
ACCELEROMETER_ANGLE_XY 一个浮点值,它是 ACCELEROMETER_ANGLE_XACCELEROMETER_ANGLE_Y 的总和。 浮点数 版本 1
BATTERY_PERCENT 一个整数,表示 Wear OS 设备的当前电池电量(以百分比表示)。值 100 表示电池电量已满;值 0 表示电池电量极低。 整数 版本 1
BATTERY_CHARGING_STATUS 指示 Wear OS 设备的电池是否正在充电的布尔值。如果电池已完成充电且电量充足,则此值为 true 布尔值 版本 1
BATTERY_IS_LOW 一个布尔值,表示 Wear OS 设备的电池电量是否不足。确切阈值取决于制造商。如果电池正在充电,则此值为 false 布尔值 版本 1
BATTERY_TEMPERATURE_CELSIUS 一个浮点值,表示 Wear OS 设备的电池温度(以摄氏度为单位)。此值的计算方法为电池的原始温度值(以十分之一摄氏度为单位)除以 10。 浮点数 版本 1
BATTERY_TEMPERATURE_FAHRENHEIT 一个浮点值,表示 Wear OS 设备的电池温度(以华氏度为单位)。此值由摄氏度换算而来。 浮点数 版本 1
UNREAD_NOTIFICATION_COUNT 一个字符串,表示已发送到此 Wear OS 设备的用户尚未读取的通知数量。 整数 版本 1
[WEATHER.IS_AVAILABLE] 一个布尔值,表示是否有可用的天气数据可呈现。 布尔值 版本 2
[WEATHER.IS_ERROR]

一个布尔值,表示在加载天气数据时是否出现错误。

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.IS_DAY] 表示当前条件是否在白天适用。这个时间段会随时间推移而发生变化,因此非常实用。 布尔值 版本 2
[WEATHER.TEMPERATURE] 当前温度,采用用户的首选单位。 整数 版本 2
[WEATHER.TEMPERATURE_UNIT]

温度单位。可能的值包括:

  • 1 - CELSIUS
  • 2 - FAHRENHEIT
整数 版本 2
[WEATHER.DAY_TEMPERATURE_LOW] 当天的最低温度。 整数 版本 2
[WEATHER.DAY_TEMPERATURE_HIGH] 当天的最高温度。 整数 版本 2
[WEATHER.CHANCE_OF_PRECIPITATION] 当前降水概率。该值介于 0100 之间。 整数 版本 2
[WEATHER.UV_INDEX] 当前紫外线指数 整数 版本 2
[WEATHER.LAST_UPDATED] 上次更新天气数据的时间戳。此值以 unix 纪元时间中的毫秒数表示。 整数 版本 2
[WEATHER.HOURS.{index}.IS_AVAILABLE]

表示指定的 {index} 小时是否有每小时天气数据,其中 {index} 表示从当前时间算起的小时数。

在访问给定 {index} 值的任何基于小时的天气数据之前,表盘开发者应检查此值。

布尔值 版本 2
[WEATHER.HOURS.{index}.CONDITION] 表示预报天气状况的枚举值,其中 {index} 表示从当前时间起经过的小时数。枚举值与 [WEATHER.CONDITION] 相同。 整数 版本 2
[WEATHER.HOURS.{index}.CONDITION_NAME] 人类可读的天气状况表示法,已翻译成用户的首选语言。 字符串 版本 2
[WEATHER.HOURS.{index}.IS_DAY] 表示预测小时条件是否在白天适用。这个时间段会随时间推移而发生变化,因此非常实用。 布尔值 版本 2
[WEATHER.HOURS.{index}.TEMPERATURE] 预测时点的温度,采用用户的首选单位,其中 {index} 表示距离当前时间经过的小时数。 整数 版本 2
[WEATHER.HOURS.{index}.UV_INDEX] 预报时段的紫外线指数,采用用户的首选单位,其中 {index} 表示距离当前时间经过的小时数。 整数 版本 2
[WEATHER.DAYS.{index}.IS_AVAILABLE]

表示指定的 {index} 天是否有每日天气数据,其中 {index} 表示从当前日期算起的天数。

在访问给定 {index} 值的任何基于日期的天气数据之前,表盘开发者应检查此值。

布尔值 版本 2
[WEATHER.DAYS.{index}.CONDITION_DAY] 一个枚举值,表示日间预报天气状况,其中 {index} 表示从当天开始的天数。枚举值与 [WEATHER.CONDITION] 相同。 整数 版本 2
[WEATHER.DAYS.{index}.CONDITION_DAY_NAME] 以人类可读的形式表示的预测日天气状况,并翻译成用户的首选语言。 字符串 版本 2
[WEATHER.DAYS.{index}.CONDITION_NIGHT] 表示夜间预报天气状况的枚举值,其中 {index} 表示从当天开始的天数。枚举值与 [WEATHER.CONDITION] 相同。 整数 版本 2
[WEATHER.DAYS.{index}.CONDITION_NIGHT_NAME] 以人类可读的方式表示的预报夜间天气状况,会翻译成用户的首选语言。 字符串 版本 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