Amazon Echo服务

更新时间：2018-08-29 12:57:45

Amazon Echo服务

提供一组对接Amazon Smart Home Skill接口。

• 发现设备列表

• 查询设备状态

• 控制设备

发现设备列表

定义描述

请求参数

返回参数

deviceList列表结构</span>

displayCategories列表结构

displayCategories列表结构

properties结构

supported列表结构

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0"
    },
    "params": {
        "accessToken" : "0bc19fa515354264450105920d45d2",
       "oauthOrigin" : "OPEN_ACCOUNT"
    }
}

正常返回示例

{
    "code": 200,
    "data": [{
        "capabilities": [{
            "type": "AlexaInterface",
            "version": "3",
            "interface": "Alexa.PowerController",
            "properties": {
                "supported": [{
                    "name": "powerState"
                }],
                "retrievable": true
            }
        }, {
            "type": "AlexaInterface",
            "version": "3",
            "interface": "Alexa.EndpointHealth",
            "properties": {
                "supported": [{
                    "name": "connectivity"
                }],
                "retrievable": true
            }
        }, {
            "type": "AlexaInterface",
            "version": "3",
            "interface": "Alexa.ColorTemperatureController",
            "properties": {
                "supported": [{
                    "name": "colorTemperatureInKelvin"
                }],
                "retrievable": true
            }
        }, {
            "type": "AlexaInterface",
            "version": "3",
            "interface": "Alexa.ColorController",
            "properties": {
                "supported": [{
                    "name": "color"
                }],
                "retrievable": true
            }
        }, {
            "type": "AlexaInterface",
            "version": "3",
            "interface": "Alexa.BrightnessController",
            "properties": {
                "supported": [{
                    "name": "brightness"
                }],
                "retrievable": true
            }
        }],
        "description": "BelonLight",
        "displayCategories": ["LIGHT"],
        "endpointId": "xtM6ZXgZeUUZjGCT71gQ001093a710",
        "friendlyName": "Reading light ",
        "manufacturerName": "Smart Home"
    }],
    "message": "success"
}

错误码

查询设备状态

定义描述

请求参数

返回参数

statusList列表结构

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0"
    },
    "params": {
        "accessToken": "0bc19fa515354264450105920d45d2",
        "oauthOrigin": "OPEN_ACCOUNT",
        "endpointId": "xtM6ZXgZeUUZjGCT71gQ001093a710"
    }
}

正常返回示例

{
    "code": 200,
    "data": [{
        "name": "powerState",
        "namespace": "Alexa.PowerController",
        "timeOfSample": "2018-08-27T08:32:13.712Z",
        "uncertaintyInMilliseconds": 0,
        "value": "ON"
    }, {
        "name": "connectivity",
        "namespace": "Alexa.EndpointHealth",
        "timeOfSample": "2018-08-27T08:32:13.712Z",
        "uncertaintyInMilliseconds": 0,
        "value": "OK"
    }, {
        "name": "colorTemperatureInKelvin",
        "namespace": "Alexa.ColorTemperatureController",
        "timeOfSample": "2018-08-27T08:32:13.712Z",
        "uncertaintyInMilliseconds": 0,
        "value": 2000
    }, {
        "name": "color",
        "namespace": "Alexa.ColorController",
        "timeOfSample": "2018-08-27T08:32:13.712Z",
        "uncertaintyInMilliseconds": 0,
        "value": {
            "saturation": 0.5,
            "brightness": 0.5,
            "hue": 50
        }
    }, {
        "name": "brightness",
        "namespace": "Alexa.BrightnessController",
        "timeOfSample": "2018-08-27T08:32:13.712Z",
        "uncertaintyInMilliseconds": 0,
        "value": 73
    }],
    "message": "success"
}

错误码

控制设备

定义描述

请求参数

返回参数

,

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0"
    },

    "params": {
        "payload": {
            "brightness": 3
        },
        "oauthOrigin": "OPEN_ACCOUNT",
        "endpointId": "xtM6ZXgZeUUZjGCT71gQ001093a710",
        "namespace": "Alexa.BrightnessController",
        "name": "SetBrightness",
        "accessToken": "2726233df9ae46c376e1efb186065f3b"
    }
}

正常返回示例

{
    "code": 200,
    "message": "success"
}

错误码