Google智能家居Dispense trait配置与语音查询问题咨询

1. Dispense Trait 配置遗漏检查点 #

• 确认设备类型兼容性：你使用的洗衣机设备类型（action.devices.types.WASHER）需支持Dispense trait，若设备类型与trait不兼容，Google Home会直接忽略该trait的状态数据。
• 检查状态上报格式：必须严格遵循Google Home规范上报amountRemaining，结构需符合如下要求：

  {
    "states": {
      "dispense": {
        "amountRemaining": {
          "amount": 3.5,
          "unit": "CUPS"
        }
      }
    },
    "attributes": {
      "supportedDispenseItems": [
        {
          "itemName": "water",
          "itemUnit": "CUPS"
        }
      ]
    }
  }
  

  需保证supportedDispenseItems中的itemName（如water）和itemUnit（如CUPS）与上报的amountRemaining完全匹配，且itemName为Google认可的枚举值。
• 验证状态同步逻辑：ESP32更新水量数据后，你的REST服务器需主动向Google Home同步状态——要么推送更新，要么在Google发起QUERY请求时返回最新数值。Google Home不会主动读取Firebase数据，必须由你的服务主动提供。
• 核对SYNC响应配置：在设备同步（SYNC）响应中，需明确将Dispense trait加入设备的traits列表，同时正确配置supportedDispenseItems，示例如下：

  {
    "requestId": "xxx",
    "payload": {
      "devices": [
        {
          "id": "你的洗衣机设备ID",
          "type": "action.devices.types.WASHER",
          "traits": [
            "action.devices.traits.OnOff",
            "action.devices.traits.Dispense"
          ],
          "name": {
            "name": "洗衣机"
          },
          "attributes": {
            "supportedDispenseItems": [
              {
                "itemName": "water",
                "itemUnit": "CUPS"
              }
            ]
          }
        }
      ]
    }
  }
  

2. 查询剩余水量的语音命令 #

中文环境下可使用以下命令：

• "我的洗衣机还有多少杯水？"
• "洗衣机里的水剩几杯了？"
• "问问洗衣机剩下多少杯水"
• "查询洗衣机的剩余水量杯数"

注意：命令需同时包含设备名（洗衣机）、物品（水）和单位（杯），这样Google Assistant才能精准定位到Dispense trait的amountRemaining数据。

内容的提问来源于stack exchange，提问作者MKneisel