You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Alexa无法发现自定义智能家居技能中添加的温控器问题求助

自定义温控器无法被Alexa发现的排查方案

针对你提供的设备发现响应JSON,结合Alexa智能家居技能规范,以下是几个关键排查点:

  • 必填属性不完整
    Alexa的Alexa.ThermostatController接口有明确要求:

    1. targetSetpoint必须补充支持的温度范围(supportedSetpointRange),仅声明name无法通过校验;
    2. description字段不能为空,需填写设备的简要描述(如"儿童房智能温控器")。
      修正后的capabilities示例:
    {
      "configuration": {"supportedModes": ["HEAT","COOL"]},
      "type": "AlexaInterface",
      "interface": "Alexa.ThermostatController",
      "version": "3.2",
      "properties": {
        "retrievable": true,
        "proactivelyReported": true,
        "supported": [
          {
            "name": "targetSetpoint",
            "supportedSetpointRange": {
              "minimumValue": 10.0,
              "maximumValue": 30.0,
              "precision": 0.5
            }
          },
          {"name": "thermostatMode"}
        ]
      }
    }
    
  • Token字段有效性
    event.endpoint.scope.token为空字符串,虽然发现阶段部分场景允许留空,但建议填入技能授权流程中获取的有效Bearer Token,避免Alexa因验证失败忽略设备。

  • 接口版本兼容性
    当前使用的Alexa.ThermostatController版本为3.2,若你的Alexa设备固件版本较旧,可能存在兼容性问题。可尝试将版本降级至3.1后重新测试。

  • 基础字段校验
    确认displayCategories中的THERMOSTAT拼写正确(大小写敏感),endpointId保证全局唯一且未重复注册。

你提供的原始发现响应JSON

{"event": {"endpoint": {"scope": {"type": "BearerToken","token": ""}},"payload": {"endpoints": [{"displayCategories": ["THERMOSTAT"],"modelName": "tdog","capabilities": [{"configuration": {"supportedModes": ["HEAT","COOL"]},"type": "AlexaInterface","interface": "Alexa.ThermostatController","version": "3.2","properties": {"retrievable": true,"proactivelyReported": true,"supported": [{"name": "targetSetpoint"},{"name": "thermostatMode"}]}}],"cookie": {},"endpointId": "tdog_24","manufacturerName": "T-Dog Corporation","description": "","friendlyName": "kinderzimmerThermostat"}}],"header": {"payloadVersion": "3","name": "Discover.Response","namespace": "Alexa.Discovery","messageId": "6cf91703-7450-4daa-954f-812c0083dfa5"}}}

内容的提问来源于stack exchange,提问作者tdog4224

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.06 04:16:34