diff --git a/docs/CROWDIN/zh_CN/ExchangeSiteCustomWatchfaces/CustomWatchfaceReference.md b/docs/CROWDIN/zh_CN/ExchangeSiteCustomWatchfaces/CustomWatchfaceReference.md index d1d6178a1399..3f8204ac060f 100644 --- a/docs/CROWDIN/zh_CN/ExchangeSiteCustomWatchfaces/CustomWatchfaceReference.md +++ b/docs/CROWDIN/zh_CN/ExchangeSiteCustomWatchfaces/CustomWatchfaceReference.md @@ -229,7 +229,7 @@ JSON文件可通过记事本（或notepad++）文本编辑器编辑（推荐能 -![CustomWatchface layers](../images/CustomWatchface_1.jpg) +![CustomWatchface layers ](../images/CustomWatchface_1.jpg) @@ -338,7 +338,7 @@ CustomWatchface可自动调整部分手表偏好设置，以确保表盘正确 下例中Gota表盘需配置1个必要参数。 未获授权时该参数显示为白色；获授权后，参数将被设定并锁定（此时数字显示为橙色） -![Required parameters](../images/CustomWatchface_2.jpg) +![Required parameters ](../images/CustomWatchface_2.jpg) @@ -350,7 +350,7 @@ CustomWatchface可自动调整部分手表偏好设置，以确保表盘正确 下例展示AAPS（驾驶舱）表盘：设置中所有视图均可见，以及关闭"显示设备电量"和"显示平均差值"后的同一表盘效果 -![Twin Views](../images/CustomWatchface_3.jpg) +![Twin Views ](../images/CustomWatchface_3.jpg) 可见当双视图之一隐藏时，另一视图会自动居中显示 @@ -400,7 +400,7 @@ DynData是最强大的功能，可根据内部数值（如血糖值、血糖水 为说明此功能，现以AAPS（蒸汽朋克）表盘为例： -![CustomWatchface_4](../images/CustomWatchface_4.png) +![CustomWatchface_4 ](../images/CustomWatchface_4.png) 该表盘需实现：右侧[血糖值旋转](#cwf-reference-background-management)（30度至330度）、[平均差值动态范围](#cwf-reference-avg-delta-management)（根据数值按5/10/20mgdl缩放）、[指针旋转](#cwf-reference-dynamic-rotation-management)（需与刻度同步），以及各视图层级控制... @@ -408,7 +408,7 @@ DynData是最强大的功能，可根据内部数值（如血糖值、血糖水 注：为展示透明度，所有图片均采用黄色背景并添加红色边框 -![Steampunk images](../images/CustomWatchface_5.jpg) +![Steampunk images ](../images/CustomWatchface_5.jpg) - 首行Background.jpg和CoverPlate.png将自动关联至对应视图（默认视图文件名），steampunk_pointer.png则由dynData控制 - 次行显示avg_delta动态范围的3种刻度，同样由dynData调控 @@ -1015,7 +1015,7 @@ AAPS 3.3.0版本中已移除这些旧表盘，替换为3款全新自定义表盘 为说明该功能运作方式，现以AAPS（大号）表盘为例，根据"时间间隔值"及"status"视图显示状态展示效果： -![AAPS (Large)](../images/CustomWatchface_6.jpg) +![AAPS (Large) ](../images/CustomWatchface_6.jpg) - 左侧首张截图中status视图可见（含IOB、详细IOB及BGI），故仅1/3行空间显示时间戳（极简格式如`1'`，上传器电量显示为`U:55%`） - 右侧截图中`status`视图已通过手表参数隐藏，因此有充足空间完整显示时间戳及上传器电量信息（`1分钟前`和`上传器：55%`） @@ -1167,7 +1167,7 @@ AAPS 3.3.0版本中已移除这些旧表盘，替换为3款全新自定义表盘 新增三个视图（`"patient_name"`、`"patient_name_Ext1"`及`"patient_name_Ext2"`*），用于在表盘中自动显示患者姓名（通过AAPS偏好设置配置，参见下方示例）。 -![CustomWatchface_7](../images/CustomWatchface_7.png) +![CustomWatchface_7 ](../images/CustomWatchface_7.png) (cwf-reference-key-and-keyvalue-reference)= @@ -1303,13 +1303,13 @@ delta_Ext1
delta_Ext2 | `"hour"` | Text View | HH | | | `"minute"` | Text View | MM | | | `"second"` | Text View | SS | | -| `"timePeriod"` | Text View | AM or PM | | +| `"timePeriod"` | Text View | 上午/下午 | | | `"day_name"` | Text View | name of the day (cf. dayNameFormat) | day_name | | `"day"` | Text View | DD date | day | | `"week_number"` | Text View | (WW) week number | week_number | | `"month"` | Text View | month name (cf. monthFormat) | | | `"loop"`
`"loop_Ext1"` *
`"loop_Ext2"` * | Text View | 上次运行至今的分钟数及状态（背景色箭头），可通过DynData调整箭头颜色 | loop | -| `"direction"`
`"direction_Ext1"` *
`"direction_Ext2"` * | Image View | TrendArrows | direction | +| `"direction"`
`"direction_Ext1"` *
`"direction_Ext2"` * | Image View | 趋势箭头 | direction | | `"timestamp"`
`"timestamp_Ext1"` *
`"timestamp_Ext2"` * | Text View | integer (min ago) | timestamp | | `"sgv"`
`"sgv_Ext1"` *
`"sgv_Ext2"` * | Text View | sgv value (mgdl or mmol) | sgv
sgvLevel
sgv_Ext1
sgvLevel_Ext1
sgv_Ext2
sgvLevel_Ext2 | | `"cover_plate"` | Image View | | | @@ -1364,11 +1364,11 @@ delta_Ext1
delta_Ext2 自Custom Watchface插件v2（AAPS 3.3）起，textvalue可包含其他文本视图的格式字符串（需配合`dynValue`键及`dynData`或`dynPref`使用）。 例如 | | `"dynValue"`* | boolean | 若需包含原始数值（双精度型）则设为true 若需用特定格式显示数值，与`texvalue`键配合使用 | -**Key added in Custom Watchface V2.0 or above (available on AAPS 3.3.0 wear apk or above)* +**在自定义表盘V2.0或更高版本中添加了按键（适用于AAPS 3.3.0 wear apk或更高版本）* (cwf-reference-imageview-keys)= -#### ImageView keys +#### ImageView键 | 键 | 类型 | 备注 | | --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -1376,7 +1376,7 @@ delta_Ext1
delta_Ext2 (cwf-reference-chartview-keys)= -#### ChartView keys +#### ChartView键 | 键 | 类型 | 备注 | | -------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -1385,114 +1385,114 @@ delta_Ext1
delta_Ext2 (cwf-reference-key-values)= -### Key values - -| Key value | key | 备注 | -| ---------------------------- | ---------- | --------------------------------------------------------------------------------- | -| `"gone"` | visibility | view hidden | -| `"visible"` | visibility | view visible in watchface (but visibility can be enable or disable in parameters) | -| `"center"` | gravity | text is vertical and horizontal centered into the view | -| `"left"` | gravity | text is vertical centered but left aligned into the view | -| `"right"` | gravity | text is vertical centered but right aligned into the view | -| `"sans_serif"` | font | | -| `"default"` | font | | -| `"default_bold"` | font | | -| `"monospace"` | font | | -| `"serif"` | font | | -| `"roboto_condensed_bold"` | font | | -| `"roboto_condensed_light"` | font | | -| `"roboto_condensed_regular"` | font | | -| `"roboto_slab_light"` | font | | -| `"normal"` | fontStyle | | -| `"bold"` | fontStyle | | -| `"bold_italic"` | fontStyle | | -| `"italic"` | fontStyle | | +### 键值 + +| 键值 | 键 | 备注 | +| ---------------------------- | ---- | ---------------------- | +| `"gone"` | 可见性 | 视图隐藏 | +| `"visible"` | 可见性 | 表盘视图可见（但可通过参数启用或禁用可见性） | +| `"center"` | 重力 | 文本在视图中垂直水平居中 | +| `"left"` | 重力 | 文本垂直居中但左对齐于视图 | +| `"right"` | 重力 | 文本垂直居中但右对齐于视图 | +| `"sans_serif"` | 字体 | | +| `"default"` | 字体 | | +| `"default_bold"` | 字体 | | +| `"monospace"` | 字体 | | +| `"serif"` | 字体 | | +| `"roboto_condensed_bold"` | 字体 | | +| `"roboto_condensed_light"` | 字体 | | +| `"roboto_condensed_regular"` | 字体 | | +| `"roboto_slab_light"` | 字体 | | +| `"normal"` | 字体风格 | | +| `"bold"` | 字体风格 | | +| `"bold_italic"` | 字体风格 | | +| `"italic"` | 字体风格 | | (cwf-reference-dyndata-keys)= -### DynData keys - -| 键 | 类型 | 备注 | -| ------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `"dynData"` | block | define the block of all dynamic data blocks that will be used for the views. generally after the last view.
All the keys defined within this block will be used as key Value within view block:
`"dynData": { dynData blocks }`
and each block is defined by a custom name and several keys inside:
`"customName": { one dynData block }` | -| `"valueKey"` | string | name of dynamic data to use (generally same that associated view key).
If not existing, the default will be the values used for the view that uses this block.
for example you can define one block to customize battery level percentage without specifying valueKey, and then use the same block to customize uploader_battery and rig_battery | -| `"minData"` | int | specify the minimum value to take into account for AAPS data : for example if value is sgv (unit mgdl internally), if minData is set to 50, all bg values below 50mgdl will be set to 50.
- Note that minData and maxData will be used to calculate dynamic values (in pixel or in degrees). | -| `"maxData"` | int | specify the maximum value to take into account for AAPS data : for example if value is sgv (unit mgdl internally), if maxData is set to 330, all bg values above 330mgdl will be set to 330. | -| `"leftOffset"` | block | Specify the horizontal shift of the view according to min and max values in pixels.
- It includes minValue key, maxValueKey and invalidValue key (optional)
- If data is below or equal minData, then the view will be shifted to minValue pixels, and if data is above or equal to maxData, then the view will be shifted to maxValue pixels
Note that to apply this shift, `leftOffset` should be set to true within the view | -| `"topOffset"` | block | Specify the vertical shift of the view according to min and max values in pixels.
- It includes minValue key, maxValueKey and invalidValue key (optional)
- If data is below or equal minData, then the view will be shifted to minValue pixels, and if data is above or equal to maxData, then the view will be shifted to maxValue pixels
Note that to apply this shift topOffset should be set to true within the view | -| `"rotationOffset"` | block | Specify the rotation angle in degrees of the view according to min and max values in pixels.
- It includes `minValue` key, `maxValue` Key and `invalidValue` key (optional)
- If data is below or equal `minData`, then the view will rotate by `minValue` degrees, and if data is above or equal to `maxData`, then the view will rotate by `maxValue` degrees
Note that to apply this rotation, `rotationOffset` should be set to true within the view | -| `"dynValue"`* | block | Specify the dynValue conversion from min and max range to min and max values in pixels.
- It includes `minValue` key, `maxValue` Key and `invalidValue` key (optional)
- If data is below or equal `minData`, then the dynValue sent will be minValue (converted to double) , and if data is above or equal to `maxData`, then the dynValue calculated will be maxValue (converted to double)
Note that to apply this conversion, `dynValue` key should be set to true within the view | -| `"minValue"` | int | result value to apply to the view (key only applicable within a leftOffset, topOffset or rotationOffset block) | -| `"maxValue"` | int | result value to apply to the view (key only applicable within a leftOffset, topOffset or rotationOffset block) | -| `"invalidValue"` | int | result value to apply to the view if data is invalid (key only applicable within a leftOffset, topOffset or rotationOffset block) | -| `"invalidImage"` | string | `resource_filename` to use for the ImageView or background TextView if the data is invalid | -| image*1_to_n* | string | `resource_filename` image to use for each step between minData (or close to minData) with `"image1"` and maxData (or close to maxData) with image*n*
If for example your put 5 images (from image1 to image5), the range between minData and maxData will be divided in 5 steps and according to data value, the corresponding image will be shown | -| `"invalidFontColor"` | string | Manage fontColor steps if the data is invalid
`"#RRVVBB"` or `"#AARRVVBB"`: Color to use if an invalid data is received (can be transparent if AA=00) | -| fontColor*1_to_n* | string | Manage fontColor steps
`"#RRVVBB"` or `"#AARRVVBB"`: color to use for each step between minData (or close to minData) with `"fontColor1"` and maxData (or close to maxData) with fontColor*n* | -| `"invalidColor"` | string | Manage background color or image color steps if the data is invalid
`"#RRVVBB"` or `"#AARRVVBB"`: Color to use if an invalid data is received (can be transparent if AA=00) | -| color*1_to_n* | string | Manage background color or image Color steps
`"#RRVVBB"` or `"#AARRVVBB"`: color to use for each step between minData (or close to minData) with `"color1"` and maxData (or close to maxData) with color*n* | -| `"invalidTextSize"` | int | Manage text size steps if the data is invalid | -| textsize*1_to_n* | int | Manage text size to use for each step between minData (or close to minData) with `"textsize1"` and maxData (or close to maxData) with textsize*n* | -| `"invalidLeftOffset"` | int | Manage leftOffset steps if the data is invalid | -| leftOffset*1_to_n* | int | Manage leftOffset to use for each step between minData (or close to minData) with `"leftOffset1"` and maxData (or close to maxData) with leftOffset*n*
Note, can be used with dynPref to shift a view when another is hidden... | -| `"invalidTopOffset"` | int | Manage topOffset steps if the data is invalid | -| topOffset*1_to_n* | int | Manage topOffset to use for each step between minData (or close to minData) with topOffset1 and maxData (or close to maxData) with topOffset*n*
Note, can be used with dynPref to shift a view when another is hidden... | -| `"invalidRotationOffset"` | int | Manage rotationOffset steps if the data is invalid | -| rotationOffset*1_to_n* | int | Manage rotationOffset to use for each step between minData (or close to minData) with rotationOffset1 and maxData (or close to maxData) with rotationOffset*n* | -| `"invalidTextvalue"`* | string | Manage textvalue if the data in invalid | -| textvalue*1_to_n* * | string | Manage texvalue to use for each step between minData (or close to minData) with textvalue1 and maxData (or close to maxData) with textvalue*n*
Note, can include formatting string if `"dynValue"` is set to true within view | - -**Key added in Custom Watchface V2.0 or above (available on AAPS 3.3.0 wear apk or above)* +### 动态数据键 + +| 键 | 类型 | 备注 | +| ------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `"dynData"` | 区块 | 定义视图将使用的所有动态数据区块 通常在末视图后
定义。本区块内所有键将作为视图区块的键值使用：
`"dynData": { 动态数据区块 }`
每个区块通过自定义名称及内部多个键定义：
`"customName": { 单个动态数据区块 }` | +| `"valueKey"` | string | 使用的动态数据名称（通常与关联视图键同名）
若不存在，则默认采用调用本区块的视图数值。
例如可定义区块自定义电池百分比而不指定valueKey，随后复用该区块自定义上传器电池与设备电池 | +| `"minData"` | int | 设定AAPS数据的最小有效值：例如若数值为sgv（内部单位mgdl），当minData设为50时，所有低于50mgdl的血糖值将强制设为50
- 注意minData与maxData将用于计算动态值（像素或角度） | +| `"maxData"` | int | 设定AAPS数据的最大有效值：例如若数值为sgv（内部单位mgdl），当maxData设为330时，所有高于330mgdl的血糖值将强制设为330。 | +| `"leftOffset"` | 区块 | 根据最小/最大值设定视图水平位移像素值
- 包含minValue键、maxValue键及invalidValue键（可选）
- 若数据≤minData则视图位移至minValue像素，若数据≥maxData则位移至maxValue像素
注意：需在视图中将`leftOffset`设为true方可生效 | +| `"topOffset"` | 区块 | 根据最小/最大值设定视图垂直位移像素值
- 包含minValue键、maxValue键及invalidValue键（可选）
- 若数据≤minData则视图位移至minValue像素，若数据≥maxData则位移至maxValue像素
注意：需在视图中将topOffset设为true方可生效 | +| `"rotationOffset"` | 区块 | 根据最小/最大值设定视图旋转角度值（单位：度）
- 包含`minValue`键、`maxValue`键及`invalidValue`键（可选）
- 若数据≤`minData`则视图旋转`minValue`度，若数据≥`maxData`则旋转`maxValue`度
注意：需在视图中将`rotationOffset`设为true方可生效 | +| `"dynValue"`* | 区块 | 设定动态值转换规则：将数据范围映射为像素值范围
- 包含`minValue`键、`maxValue`键及`invalidValue`键（可选）
- 若数据≤`minData`则输出minValue（转为双精度），若数据≥`maxData`则输出maxValue（转为双精度）
注意：需在视图中启用`dynValue`键方可生效 | +| `"minValue"` | int | 应用于视图的最终数值（该键仅适用于leftOffset、topOffset或rotationOffset区块内） | +| `"maxValue"` | int | 应用于视图的最终数值（该键仅适用于leftOffset、topOffset或rotationOffset区块内） | +| `"invalidValue"` | int | 数据无效时应用于视图的最终数值（该键仅适用于leftOffset、topOffset或rotationOffset区块内） | +| `"invalidImage"` | string | 数据无效时ImageView或背景TextView使用的`资源文件名` | +| image*1_to_n* | string | `资源文件名`图像用于从接近minData的`"image1"`到接近maxData的image*n*之间的每个阶梯
例如若设置5张图像（从image1到image5），minData与maxData之间的范围将被分为5个阶梯，根据数据值显示对应图像 | +| `"invalidFontColor"` | string | 管理数据无效时的字体颜色阶梯
`"#RRVVBB"`或`"#AARRVVBB"`：接收无效数据时使用的颜色（若AA=00可为透明色） | +| fontColor*1_to_n* | string | 管理字体颜色阶梯
`"#RRVVBB"`或`"#AARRVVBB"`：从接近minData的`"fontColor1"`到接近maxData的fontColor*n*之间每个阶梯使用的颜色 | +| `"invalidColor"` | string | 管理数据无效时的背景色/图像颜色阶梯
`"#RRVVBB"`或`"#AARRVVBB"`：接收无效数据时使用的颜色（若AA=00可为透明色） | +| color*1_to_n* | string | 管理背景色/图像颜色阶梯
`"#RRVVBB"`或`"#AARRVVBB"`：从接近minData的`"color1"`到接近maxData的color*n*之间每个阶梯使用的颜色 | +| `"invalidTextSize"` | int | 管理数据无效时的文本字号阶梯 | +| textsize*1_to_n* | int | 管理文本字号阶梯：从接近minData的`"textsize1"`到接近maxData的textsize*n*之间每个阶梯使用的字号 | +| `"invalidLeftOffset"` | int | 管理数据无效时的水平位移阶梯 | +| leftOffset*1_to_n* | int | 管理水平位移阶梯：从接近minData的`"leftOffset1"`到接近maxData的leftOffset*n*之间每个阶梯使用的位移值
注：可与dynPref配合实现视图隐藏时的位移联动 | +| `"invalidTopOffset"` | int | 管理数据无效时的垂直位移阶梯 | +| topOffset*1_to_n* | int | 管理垂直位移阶梯：从接近minData的topOffset1到接近maxData的topOffset*n*之间每个阶梯使用的位移值
注：可与dynPref配合实现视图隐藏时的位移联动 | +| `"invalidRotationOffset"` | int | 管理数据无效时的旋转角度阶梯 | +| rotationOffset*1_to_n* | int | 管理旋转角度阶梯：从接近minData的rotationOffset1到接近maxData的rotationOffset*n*之间每个阶梯使用的旋转角度 | +| `"invalidTextvalue"`* | string | 管理数据无效时的文本值 | +| textvalue*1_to_n* * | string | 管理文本值阶梯：从接近minData的textvalue1到接近maxData的textvalue*n*之间每个阶梯使用的文本值
注：若在视图中启用`"dynValue"`键可包含格式化字符串 | + +**在自定义表盘V2.0或更高版本中添加了按键（适用于AAPS 3.3.0 wear apk或更高版本）* (cwf-reference-dyndata-key-values)= -### DynData key values - -| Key value | key | 备注 | -| ------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `"sgv"`
`"sgv_Ext1"` *
`"sgv_Ext2"` * | valueKey | default minData = 39 mgdl
default maxData = 400 mgdl
- Note that real maxData is linked to your sensor and units are always in mgdl for internal values | -| `"sgvLevel"`
`"sgvLevel_Ext1"` *
`"sgvLevel_Ext2"` * | valueKey | default minData = -1 (Hypo)
default maxData = 1 (Hyper)
if BG is within Range = 0 | -| `"direction"`
`"direction_Ext1"` *
`"direction_Ext2"` * | valueKey | default minData = 1 (double Down)
default maxValue = 7 (double Up)
flat arrow data = 4
Error or missing data = 0 (??) | -| `"delta"`
`"delta_Ext1"` *
`"delta_Ext2"` * | valueKey | default minData = -25 mgdl
default maxData = 25 mgdl
- Note that real min and maxData can be above, and units are always mgdl for internal values | -| `"avg_delta"`
`"avg_delta_Ext1"` *
`"avg_delta_Ext2"` * | valueKey | default minData = -25 mgdl
default maxData = 25 mgdl
- Note that real min and maxData can be above, and units are always mgdl for internal values | -| `"tempTarget"`*
`"tempTarget_Ext1"` *
`"tempTarget_Ext2"` * | valueKey | default minData = 0 (Profile Target)
default maxData = 2 (Temp Target)
Target is adjusted byt the loop = 1
Default or missing information = 0 | -| `"reservoir"`*
`"reservoir_Ext1"` *
`"reservoir_Ext2"` * | valueKey | default minData = 0 U
default maxData = 500 U | -| `"reservoirLevel"`*
`"reservoirLevel_Ext1"` *
`"reservoirLevel_Ext2"` * | valueKey | default minData = 0 (Standard Color)
default maxData = 2 (Urgent Color)
Warning Color = 1 | -| `"uploader_battery"` | valueKey | default minData = 0 %
default maxData = 100% | -| `"rig_battery"`
`"rig_battery_Ext1"` *
`"rig_battery_Ext2"` * | valueKey | default minData = 0 %
default maxData = 100% | -| `"timestamp"`
`"timestamp_Ext1"` *
`"timestamp_Ext2"` * | valueKey | default minData = 0 min
default maxData = 60 min | -| `"loop"`
`"loop_Ext1"` *
`"loop_Ext2"` * | valueKey | default minData = 0 min
default maxData = 28 min
- Note that status arrows are in green below 14 min and in red above 14 min so if you put 2 images, you can replace status background with your custom images with default min and maxData | -| `"day"` | valueKey | default minData = 1
default maxData = 31 | -| `"day_name"` | valueKey | default minData = 1
default maxData = 7 | -| `"month"` | valueKey | default minData = 1
default maxData = 12 | -| `"week_number"` | valueKey | default minData = 1
default maxData = 53 | - -**Key added in Custom Watchface V2.0 or above (available on AAPS 3.3.0 wear apk or above)* +### 动态数据键值 + +| 键值 | 键 | 备注 | +| ------------------------------------------------------------------------------------------- | -- | ------------------------------------------------------------------------------------------------------------------------------ | +| `"sgv"`
`"sgv_Ext1"` *
`"sgv_Ext2"` * | 键值 | 默认minData = 39 mgdl
默认maxData = 400 mgdl
- 注意实际maxData取决于传感器，且内部计算值单位始终为mgdl | +| `"sgvLevel"`
`"sgvLevel_Ext1"` *
`"sgvLevel_Ext2"` * | 键值 | 默认minData = -1（低血糖）
默认maxData = 1（高血糖）
血糖在范围内 = 0 | +| `"direction"`
`"direction_Ext1"` *
`"direction_Ext2"` * | 键值 | 默认minData = 1（双下箭头）
默认maxValue = 7（双上箭头）
水平箭头数据 = 4
错误或缺失数据 = 0（??） | +| `"delta"`
`"delta_Ext1"` *
`"delta_Ext2"` * | 键值 | 默认minData = -25 mgdl
默认maxData = 25 mgdl
- 注意实际最小/最大值可能超出此范围，且内部计算值单位始终为mgdl | +| `"avg_delta"`
`"avg_delta_Ext1"` *
`"avg_delta_Ext2"` * | 键值 | 默认minData = -25 mgdl
默认maxData = 25 mgdl
- 注意实际最小/最大值可能超出此范围，且内部计算值单位始终为mgdl | +| `"tempTarget"`*
`"tempTarget_Ext1"` *
`"tempTarget_Ext2"` * | 键值 | 默认minData = 0（配置文件目标）
默认maxData = 2（临时目标）
由闭环调整的目标 = 1
默认或缺失信息 = 0 | +| `"reservoir"`*
`"reservoir_Ext1"` *
`"reservoir_Ext2"` * | 键值 | 默认minData = 0单位
默认maxData = 500单位 | +| `"reservoirLevel"`*
`"reservoirLevel_Ext1"` *
`"reservoirLevel_Ext2"` * | 键值 | 默认minData = 0（标准颜色）
默认maxData = 2（紧急颜色）
警告颜色 = 1 | +| `"uploader_battery"` | 键值 | 默认minData = 0%
默认maxData = 100% | +| `"rig_battery"`
`"rig_battery_Ext1"` *
`"rig_battery_Ext2"` * | 键值 | 默认minData = 0%
默认maxData = 100% | +| `"timestamp"`
`"timestamp_Ext1"` *
`"timestamp_Ext2"` * | 键值 | 默认minData = 0分钟
默认maxData = 60分钟 | +| `"loop"`
`"loop_Ext1"` *
`"loop_Ext2"` * | 键值 | 默认minData = 0分钟
默认maxData = 28分钟
- 注意：14分钟以下状态箭头显示绿色，14分钟以上显示红色。若设置2张图像，可使用自定义图像替换状态背景（保持默认min和maxData值） | +| `"day"` | 键值 | 默认minData = 1
默认maxData = 31 | +| `"day_name"` | 键值 | 默认minData = 1
默认maxData = 7 | +| `"month"` | 键值 | 默认minData = 1
默认maxData = 12 | +| `"week_number"` | 键值 | 默认minData = 1
默认maxData = 53 | + +**在自定义表盘V2.0或更高版本中添加了按键（适用于AAPS 3.3.0 wear apk或更高版本）* (cwf-reference-dynpref-keys)= -### DynPref keys +### 动态偏好键 -| 键 | 类型 | 备注 | -| ---------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `"dynPref"` | block | define the block of all dynamic preference blocks that will be used for the views. Generally after the last view or after the dynData block.
All the keys defined within this block will be used as key Value within view block:
`"dynPref": { dynPref blocks }`
and each block is defined by a custom name and several keys inside:
`"customName": { one dynPref block }` | -| `"dynPref"` | string | *Within a view Block*
name of dynamic dynPref block to use (generally same that associated view key or associated preference). | -| `"dynPref"` | string | *Within a partial dynData Block included into a dynPref Block*
name of dynamic dynPref block to use to complete the dynData block. This allow you to tune a dynData block according to several preferences | -| `"dynPrefColor"` | string | this key is specific to the main block with all main colors (highColor, midColor, lowColor, graph colors...). you will use it if you want to tune main colors according to preferences | -| `"prefKey"` | string | specify the preference key Value that will be used to get user preferences (see [PrefKey values](#cwf-reference-prefkey-values) below). This key should be used within a `dynPref` block.
Then according to preference key, the `dynPref`block should contains as many keys than prefKey has values.
Note that most of the time preferences are "Boolean" so you should find within the dynPref block these two dynData blocks:
`"true": { dynData Block },`
`"false": { dynData Block }` | -| `"true"` | block | most preferences will set a boolean `"true"` or `"false"`. You will specify the dynData block to use if preference selected by user is true.
Note that if the block also contains a `"dynPref":`key, the dynData block will be merged with other block. This allow you to tune for example color according to one preference, and textsize according to another preference | -| `"false"` | block | most preferences will set a boolean `"true"` or `"false"`. You will specify the dynData block to use if preference selected by user is false.
Note that if the block also contains a `"dynPref":`key, the dynData block will be merged with other block. This allow you to tune for example color according to one preference, and textsize according to another preference | +| 键 | 类型 | 备注 | +| ---------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `"dynPref"` | 区块 | 定义视图将使用的所有动态偏好设置块。 通常放置在最后一个视图或dynData块之后。
本块内定义的所有键都将作为视图块中的键值使用：
`"dynPref": { 动态偏好设置块 }`
每个块由自定义名称和若干内部键组成：
`"自定义名称": { 单个动态偏好设置块 }` | +| `"dynPref"` | string | *在视图块内*
指定使用的动态dynPref块名称（通常与关联视图键或关联偏好设置同名）。 | +| `"dynPref"` | string | *在包含于dynPref块的部分dynData块内*
指定用于补全dynData块的动态dynPref块名称。 这允许您根据多项偏好设置来调整dynData块 | +| `"dynPrefColor"` | string | 此键专用于包含所有主颜色（高值颜色、中值颜色、低值颜色、图表颜色等）的主配置块。 若需根据偏好设置调整主颜色时使用此键 | +| `"prefKey"` | string | 指定用于获取用户偏好的键值（参见下方[PrefKey取值](#cwf-reference-prefkey-values)）。 此键应在`dynPref`块中使用。
根据偏好键的不同，`dynPref`块应包含与prefKey取值数量相同的键。
注意多数情况下偏好为"布尔型"，因此dynPref块中通常包含这两个dynData块：
`"true": { dynData块 },`
`"false": { dynData块 }` | +| `"true"` | 区块 | 大多数偏好设置将使用布尔值`"true"`或`"false"`。 指定用户选择偏好为true时使用的dynData块。
注意：若该块同时包含`"dynPref":`键，此dynData块将与其他块合并。 这允许您根据一项偏好调整颜色，同时根据另一项偏好调整文本大小 | +| `"false"` | 区块 | 大多数偏好设置将使用布尔值`"true"`或`"false"`。 指定用户选择偏好为false时使用的dynData块。
注意：若该块同时包含`"dynPref":`键，此dynData块将与其他块合并。 这允许您根据一项偏好调整颜色，同时根据另一项偏好调整文本大小 | (cwf-reference-prefkey-values)= -### PrefKey values +### PrefKey取值 -All keys included into [Preference keys](#cwf-reference-preference-keys) chapter above can be used to tune view parameters +上文[偏好设置键](#cwf-reference-preference-keys)章节中包含的所有键都可用于调整视图参数 -You can also you these additional key below included into AAPS (Custom) specific parameters: +您还可以使用以下AAPS(自定义)专属参数中包含的附加键： -| 键 | 类型 | 备注 | -| --------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `"key_units"` | boolean | *true*: if units selected on AAPS is mgdl
*false*: if units selected on AAPS is mmol | -| `"key_dark"` | boolean | *true*: to use a dark background
false: to use a light background
Note: this parameter is often use into previous AAPS watchfaces (AAPS, AAPS V2...) | -| `"key_match_divider"` | boolean | *true*: divider included into AAPS, AAPS v2 watchfaces will not be visible
*false*: divider included into AAPS, AAPS v2 watchfaces will be visible
Note: this setting is often combine with dark preference (using `dynPref` key into `dynData`block) to set text color (and background) on the same or opposite color than dark parameter... | +| 键 | 类型 | 备注 | +| --------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `"key_units"` | boolean | *true*: AAPS中选定单位为mgdl时
*false*: AAPS中选定单位为mmol时 | +| `"key_dark"` | boolean | *true*: 使用深色背景
false: 使用浅色背景
注：该参数常见于早期AAPS表盘（AAPS、AAPS V2等）中 | +| `"key_match_divider"` | boolean | *true*: AAPS、AAPS v2表盘中的分隔线将不可见
*false*: AAPS、AAPS v2表盘中的分隔线将可见
注：该设置常与深色偏好结合使用（通过在`dynData`块中使用`dynPref`键），以设置与深色参数相同或相反的文本颜色（及背景）... |