如何让Google Home应用显示车库门状态并提供控制按钮？

核心调整方案 #

1. 修正SYNC响应的属性配置 #

你的设备基础配置已接近要求，但需调整openDirection参数：车库门属于单方向触发的离散设备，无需同时配置UP和DOWN，多余的方向定义会导致Google Home应用界面识别异常。调整后的attributes配置如下：

"attributes": {
  "discreteOnlyOpenClose": true,
  "commandOnlyOpenClose": false,
  "openDirection": ["UP"]
}

• 保持discreteOnlyOpenClose: true：匹配车库门的开/关离散状态
• 保持commandOnlyOpenClose: false：告知应用设备支持状态反馈，允许显示控制按钮

2. 优化QUERY响应格式 #

你的QUERY响应包含冗余字段，需移除agentUserId和status，Google Home仅需online和openPercent来识别设备状态：

{
  "requestId": "XXX",
  "payload": {
    "devices": {
      "XXX": {
        "online": true,
        "openPercent": 0
      }
    }
  }
}

3. 刷新应用缓存 #

完成配置修改后，强制同步设备信息：

• 清除手机上Google Home应用的缓存与数据
• 在应用中移除当前车库门设备，重新通过你的Action关联
• 等待2-3分钟让应用同步最新配置

验证标准 #

• 确保EXECUTE请求能正确处理action.devices.commands.OpenClose指令，返回成功响应
• 确认设备状态变更后，QUERY响应的openPercent能同步更新（关闭为0，完全打开为100）

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