百分比

以下这些消息类型，以增加或减少百分比的形式设置目标设备的属性。

SetPercentageRequest
SetPercentageConfirmation
IncrementPercentageRequest
IncrementPercentageConfirmation
DecrementPercentageRequest
DecrementPercentageConfirmation

SetPercentageRequest

示例语句：
“小微，设置{设备名}到50%”
目的：请求以指定的百分比调整指定设备的数值设置。从Smart Home Skill API发送到技能适配器。

Header

属性	值
name	SetPercentageRequest
namespace	SmartHome.Control

Payload

属性	描述	是否必需
accessToken	与客户的设备云账户相关的访问令牌。	是
appliance object	执行操作的设备。	是
appliance.applianceID	设备标识符。标识符在技术适配器的域内的最终用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。该值不能超过256个字符。	是
appliance.additionalApplianceDetails	提供关于技能适配器使用的设备的附加信息的字符串名称/值对。该属性的内容不能超过5000字节。而且，Smart Home Skill API即不理解也不使用这些数据。	是，但列表可以为空。
percentageState	设置的百分比，精度可达两位小数。范围从0.00到100.00（含）。	否

SetPercentageRequest示例：

    {
        "header": {
            "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
            "name": " SetPercentageRequest",
            "namespace": "SmartHome.Control",
            "payloadVersion": "2"
        },
        "payload": {
            "accessToken": "[OAuth token here]",
            "appliance": {
                "additionalApplianceDetails": {},
                "applianceId": "[Device ID]"
            },
            "percentageState": {
                "value": 50.0
            }
        }
    }

SetPercentageConfirmation

小微响应示例：“好的”
目的：表示设备已成功调整了指定的百分比。这是对SetPercentageRequest的预期响应，并从技能适配器发送到Smart Home Skill API。

Header

属性	值
name	SetPercentageConfirmation
namespace	SmartHome.Control

Payload

属性	描述	是否必需
status对象	调整了指定的百分比后设备的状态。	是
status.percentageStateValue	表示设置的百分比。	是

SetPercentageConfirmation示例：

    {
        "header": {
            "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
            "name": " SetPercentageConfirmation",
            "namespace": "SmartHome.Control",
            "payloadVersion": "2"
        },
        "payload": {
            "status": {
               "percentageStateValue": 50.0  
            }
        }
    }

IncrementPercentageRequest

示例语句：
“小微，{设备名}调高20%”
目的：以指定增加的百分比调整指定设备的数值设置。从Smart Home Skill API发送到技能适配器。

Header

属性	值
name	IncrementPercentageRequest
namespace	SmartHome.Control

Payload

属性	描述	是否必需
accessToken	与客户的设备云账户相关的访问令牌。	是
appliance object	执行操作的设备。	是
appliance.applianceID	设备标识符。标识符在技术适配器的域内的最终用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。该值不能超过256个字符。	是
appliance.additionalApplianceDetails	提供关于技能适配器使用的设备的附加信息的字符串名称/值对。该属性的内容不能超过5000字节。而且，Smart Home Skill API即不理解也不使用这些数据。	是，但列表可以为空。
deltaPercentage	对于此指令，deltaPercentage将添加到当前百分比设置中。例如，如果设备当前设置为40％，则deltaPercentage值为15表示设备在请求完成后将被设置为55％。是double类型，范围介于0.00和100.00之间（含）。如果deltaPercentage值在允许的范围内，但超出了目标设备允许的最大值，则返回ValueOutOfRangeError，并且不会更改设备设置。	是

重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案，专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发，帮助企业实现从传统行业到互联网的完美转型。截止目前，重庆互联网合作的企业遍布全国各地，20年的开发经验和完善的售后服务体系获得合作客户的高度认可！

关注重庆互联网官方公众号，即可获取粉丝专享福利！

重庆互联网公众号二维码.jpg

网友留言评论

我要评论