欢迎使用 Google Home 开发者中心,您可以在这里学习有关如何开发智能家居 Action 的新平台。注意:你将继续在 Actions 控制台中构建操作。
使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

智能家居填充特征架构

action.devices.traits.Fill - 此特征适用于支持浴缸加水的设备,例如浴缸。

设备属性

具有此特征的设备可能会在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent,请参阅 intent 执行方式

属性 类型 说明
availableFillLevels 对象

描述填充设备的不同级别。

levels 数组

必填。

级别名称和特定语言的同义词列表。

[item, ...] 对象

级别名称及其特定语言的同义词。

level_name String

必填。

级别的内部名称。这种做法可能不太方便用户使用,将在所有语言之间共享。

level_values 数组

必填。

每种受支持语言的等级同义词。

[item, ...] 对象

指定语言级别的同义词。

level_synonym 数组

必填。

层级的含义。该列表的第一个字符串将用作该语言的层级规范名称。

[item, ...] String

同义词名称。

lang String

必填。

语言代码 (ISO 639-1)。请参阅支持的语言

ordered Boolean

必填。

如果为 true,设备会处理增加或减少逻辑的额外语法,如 levels 数组所示。

supportsFillPercent Boolean

(默认值:false

如果为 true,请接受用于将级别调整为百分比的命令。

示例

设备具有基本的填充或排空功能,不支持独立的填充水平。

{}

支持离散填充级别的设备。

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

设备状态

具有此特征的实体可能会在 QUERY 操作中报告以下状态。如需详细了解如何处理 QUERY intent,请参阅 intent 执行方式

类型 说明
isFilled Boolean

必填。

如果设备填充到任何级别,则返回 true。如果设备完全排空,则返回 false。

currentFillLevel String

如果设置了 availableFillLevels 属性,则必须提供此属性。指示填充设备的 availableFillLevels 属性中的当前 level_name

currentFillPercent 编号

如果设置了 supportsFillPercent 属性,则必须提供此属性。指明当前的填充率。

示例

浴缸里装满了吗?

{
  "isFilled": true
}

浴缸里装满了吗?(包含层级)。

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

设备命令

具有此特征的设备可能会在 EXECUTE 操作中响应以下命令。如需详细了解如何处理 EXECUTE intent,请参阅 intent 执行方式

action.devices.commands.Fill

加水或放下设备。

参数

参数 类型 说明
fill Boolean

必填。

true 表示填满,false 表示排空。

fillLevel String

指示要设置的 availableFillLevels 属性中的 level_name。如果未指定,则填写到默认级别。

fillPercent 编号

指示请求的级别百分比。

示例

把浴缸加满

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

放掉浴缸里的水。

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

把浴缸的水加到一半。

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

将浴缸的水位增加 1(要求 ordered 属性为 true)。

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

设备出错

查看错误和异常的完整列表。