Alexa 自定义技能设备发现

Question

我是 Alexa 技能集的新手，我有一个需要由 Alexa 发现的设备。我对 Alexa SMART HOME SKILL API 的设备发现功能感到困惑。我需要一些有关如何连接您构建的设备（使用树莓派）以让 Alexa 通过自定义技能发现的详细信息。

需要示例代码或良好的指南。

我知道负载应该从设备云返回（产品制造商拥有它）。您如何确保客户的设备和设备是正确的客户？

示例负载如下..

"discoveredAppliances": [{
    "applianceId": "sample-1",
    "manufacturerName": "Sample Manufacturer",
    "modelName": "Sample Thermostat",
    "version": "1",
    "friendlyName": "Sample Thermostat",
    "friendlyDescription": "Thermostat by Sample Manufacturer",
    "isReachable": true,
     "actions": [
        "setTargetTemperature",
        "incrementTargetTemperature",
        "decrementTargetTemperature"
     ],
     "additionalApplianceDetails": {
     "extraDetail1": "This is a thermostat that is reachable"
    }
 }]

你能详细解释一下discoveredAppliances json 对象吗？在设备云中为客户生成这些详细信息背后的逻辑？

Answer 1

有效载荷中的所有信息都是为​​了让您告诉 Alexa 关于您的设备，并且可以是您想要的任何信息。真正重要的领域是：

• applianceId：不得包含空格，并将与每个控制消息一起传递给您的技能。因此，让它为您识别特定设备。

• friendlyName：包含用户识别该设备时需要说出的确切字词；例如，“车库灯”。

  • friendlyDescription：将在 Alexa 应用程序中显示的有关此设备的文本。

  • actions：列出您可以处理的控制事件。您列出的示例包含恒温器类型控件。灯可能支持 turnOn、turnOff 和 setPercentage 进行调光。

您如何检测和识别您的设备完全取决于您。

我希望这个解释会有所帮助。请注意，您还可以创建自定义技能来控制您的设备。还有更多创建自定义技能的示例。我在Github上发布了更多自定义技能信息和代码