求alexa.SmartVision.ObjectDetectionSensor Interface 1.0示例代码及门铃设备问题排查

可能遗漏的关键配置 #

• 设备分类声明：发现响应的displayCategories必须包含DOORBELL，Alexa只会给门铃类设备展示人物/包裹检测选项
• ObjectDetectionSensor 属性配置：在capabilities中必须明确声明支持检测的对象类型（PERSON、PACKAGE），不能只添加接口而不指定检测对象
• DataController 权限配置：确保DataController的retrievable设为true，并且在configuration中关联对应的检测数据权限

完整的发现响应示例 #

{
  "event": {
    "header": {
      "namespace": "Alexa.Discovery",
      "name": "Discover.Response",
      "payloadVersion": "3",
      "messageId": "unique-message-id"
    },
    "payload": {
      "endpoints": [
        {
          "endpointId": "your-doorbell-endpoint-id",
          "friendlyName": "Front Door Doorbell",
          "description": "Smart Doorbell with Object Detection",
          "manufacturerName": "Your Manufacturer",
          "displayCategories": ["DOORBELL"],
          "capabilities": [
            {
              "type": "AlexaInterface",
              "interface": "Alexa.SmartVision.ObjectDetectionSensor",
              "version": "1.0",
              "properties": {
                "supported": [
                  {
                    "name": "detectedObjects"
                  }
                ],
                "proactivelyReported": true,
                "retrievable": true
              },
              "configuration": {
                "supportedObjectTypes": ["PERSON", "PACKAGE"]
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.DataController",
              "version": "3.0",
              "configuration": {
                "dataSchemas": [
                  {
                    "dataSchema": "Alexa.SmartVision.ObjectDetection",
                    "permissionType": "ALEXA_PERSONALIZATION"
                  }
                ]
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa",
              "version": "3.0"
            }
          ]
        }
      ]
    }
  }
}

检测事件上报示例 #

当设备检测到目标对象时，发送如下事件给Alexa：

{
  "event": {
    "header": {
      "namespace": "Alexa.SmartVision.ObjectDetectionSensor",
      "name": "DetectedObjectsChanged",
      "payloadVersion": "1.0",
      "messageId": "unique-message-id",
      "correlationToken": "correlation-token-from-discovery"
    },
    "endpoint": {
      "endpointId": "your-doorbell-endpoint-id"
    },
    "payload": {
      "detectedObjects": [
        {
          "objectType": "PERSON",
          "detectionTimestamp": "2024-05-20T12:34:56Z",
          "confidence": 0.95
        }
      ]
    }
  },
  "context": {
    "properties": []
  }
}

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