PuGoing场景接口

PuGoing 场景接口

一.添加场景

示例：

{
    "op":"scene",
    "act":"add",
    "uid":"XXXXXXX",
    "did":"XXXXXXX",
    "token":"XXXXXXX",
    "date":{
        "sna":"回家场景",
        "timearea":"00:00-23：59",
        "svc":"0,我回来了",
        "sev":"0,yid+eva",
        "timedo":"repeat:1;mode:2;date:1,2,3,4,5;time:00:00:00",
        "evindp":"1",
        "sevc":"1",
        "action":"1,tts欢迎主人回家","0,打开客厅灯光",
        "stype":"1",
        "slogo":"cj.svg",
      }
 }

正常响应：

{
    "ack":"1",
 }

参数协议

参数名 参数类型 参数说明 是否必传
op String 方法类别 是
act String 方法名 是
uid String 获取的微信uid 是
did String 主机的did 是
token String 见二.获取token 是

协议中的date列表

参数名 参数类型 参数说明 是否必传
sna String 场景名称：回家场景 是
timearea String 场景执行的时间段 是
svc String 我回来啦，场景语音触发命令，可以有很多条语句；格式：0，我回来了，1，我到家了，0，回家模式；(0为满足单独执行，1为与其他条件一起满足时执行) 是
sevc String 事件触发场景的时候，是否需要语音口头确认，选择是，这里置位1，选择否可以为0或者空“” 是
sev String 事件触发场景的时候，是否需要语音口头确认，选择是，这里置位1，选择否可以为0或者空“” 是
timedo String 单次定时触发 （repeat:0; mode:1; date:2018-05-29; time:18:57:00） 周期定时触发 （repeat:1; mode:2; date:1,3,4,5; time:18:57:00） 是
evindp String 场景事件之间依赖关系 是
action String 场景执行的动作，每个动作之间有时间延时，通过逗号实现分隔 格式：1,yid_eva(数字代表延迟时间（s/秒），yid是设备的yid拼接"_"后接设备动作eva【如门磁open，close】) 加上tts主机播放文字内容 是
stype String 1开启场景 0 关闭场景 2快捷方式 是
slogo String cj.svg非定时场景 cjds.svg 定时场景 是

二.查看场景列表

示例：

{
    "op":"scene",
    "act":"list",
    "uid":"XXXXXXXX",
    "did":"XXXXXXXX",
    "token":"XXXXXXXX",
 }

正常响应：

{
    "ack":"1",
    "msg":"{[
        {
            "action":"1,tts欢迎主人回家",
            "env":"",
            "evindp":"1",
            "id":"2311",
            "scres1":"",
            "scres2":"",
            "sev":"",
            "sevc":"1",
            "sid":"XXXXXXXXXX",
            "sinfo":"",
            "slogo":"cj.svg",
            "sna":"回家场景",
            "stype":"1",
            "svc":"",
            "svcack":"",
            "timearea":"00:00-23:59",
            "timedo":"repeat:1;mode:2;date:1,2,3,4,5;time:00:00:00",
            "voevdp":"",
        },{
            "action":"1,tts欢迎主人回家",
            "env":"",
            "evindp":"1",
            "id":"2311",
            "scres1":"",
            "scres2":"",
            "sev":"",
            "sevc":"1",
            "sid":"XXXXXXXXXX",
            "sinfo":"",
            "slogo":"cj.svg",
            "sna":"回家场景",
            "stype":"1",
            "svc":"",
            "svcack":"",
            "timearea":"00:00-23:59",
            "timedo":"repeat:1;mode:2;date:1,2,3,4,5;time:00:00:00",
            "voevdp":"",
        },
    ]}"

 }

参数协议

参数名 参数类型 参数说明 是否必传
op String 方法类别 是
act String 方法名 是
uid String 获取的微信uid 是
did String 主机的did 是
token String 见二.获取token 是

返回参数说明

参数名 参数类型 参数说明
action String 场景执行的动作，每个动作之间有时间延时，通过逗号实现分隔 格式：1,yid_eva(数字代表延迟时间（s/秒），yid是设备的yid拼接"_"后接设备动作eva【如门磁open，close】) 加上tts主机播放文字内容
env String 场景环境参数（预留）
evindp String 场景事件之间依赖关系
id String 前端暂无使用
scres1 String 场景预留字段1
scres2 String 场景预留字段2
sev String 事件触发场景的时候，是否需要语音口头确认，选择是，这里置位1，选择否可以为0或者空“”
sevc String 事件触发场景的时候，是否需要语音口头确认，选择是，这里置位1，选择否可以为0或者空“”
sid String 场景的sid
sinfo String 场景执行最后一条记录
slogo String cj.svg非定时场景 cjds.svg 定时场景
sna String 场景名称：回家场景
stype String 1开启场景 0 关闭场景 2快捷方式
svc String 我回来啦，场景语音触发命令，可以有很多条语句；格式：0，我回来了，1，我到家了，0，回家模式；
svcack String 暂无使用
timearea String 场景执行的时间段
timedo String 单次定时触发 （repeat:0; mode:1; date:2018-05-29; time:18:57:00） 周期定时触发 （repeat:1; mode:2; date:1,3,4,5; time:18:57:00）
voevdp String 场景语音和事件关系
xqid String 前端暂无使用

三.更新场景

示例：

{
    "op":"scene",
    "act":"update",
    "uid":"XXXXXXX",
    "did":"XXXXXXX",
    "token":"XXXXXXX",
    "date":{
        "sid":"XXXXXXX",
        "sna":"回家场景",
        "timearea":"00:00-23：59",
        "svc":"0,我回来了",
        "sev":"0,yid+eva",
        "timedo":"repeat:1;mode:2;date:1,2,3,4,5;time:00:00:00",
        "evindp":"1",
        "sevc":"1",
        "action":"1,tts欢迎主人回家","0,打开客厅灯光",
        "stype":"1",
        "slogo":"cj.svg"
      }
 }

正常响应：

{
    "ack":"1",
 }

参数协议

参数名 参数类型 参数说明 是否必传
op String 方法类别 是
act String 方法名 是
uid String 获取的微信uid 是
did String 主机的did 是
token String 见二.获取token 是

协议中的date列表

参数名 参数类型 参数说明 是否必传
sid String 场景的sid 是
sna String 场景名称：回家场景 是
timearea String 场景执行的时间段 是
svc String 我回来啦，场景语音触发命令，可以有很多条语句；格式：0，我回来了，1，我到家了，0，回家模式；(0为满足单独执行，1为与其他条件一起满足时执行) 是
sevc String 事件触发场景的时候，是否需要语音口头确认，选择是，这里置位1，选择否可以为0或者空“” 是
sev String 事件触发场景的时候，是否需要语音口头确认，选择是，这里置位1，选择否可以为0或者空“” 是
timedo String 单次定时触发 （repeat:0; mode:1; date:2018-05-29; time:18:57:00） 周期定时触发 （repeat:1; mode:2; date:1,3,4,5; time:18:57:00） 是
evindp String 场景事件之间依赖关系 是
action String 场景执行的动作，每个动作之间有时间延时，通过逗号实现分隔 格式：1,yid_eva(数字代表延迟时间（s/秒），yid是设备的yid拼接"_"后接设备动作eva【如门磁open，close】) 加上tts主机播放文字内容 是
stype String 1开启场景 0 关闭场景 2快捷方式 是
slogo String cj.svg非定时场景 cjds.svg 定时场景 是

四.检查场景执行条件是否重复

示例：

{
    "op":"scene",
    "act":"listsvc",
    "uid":"XXXXXXX",
    "did":"XXXXXXX",
    "token":"XXXXXXX",
    "date":{
       "svc":"我回来了"
      }
 }

正常响应：

{
    "ack":"1",
 }

参数协议

参数名 参数类型 参数说明 是否必传
op String 方法类别 是
act String 方法名 是
uid String 获取的微信uid 是
did String 主机的did 是
token String 见二.获取token 是

协议中的date列表

参数名 参数类型 参数说明 是否必传
svc String 我回来啦，场景语音触发命令，可以有很多条语句；格式：0，我回来了，1，我到家了，0，回家模式； 是

五.添加场景到快速执行列表

示例：

{
    "op":"scene",
    "act":"cfg",
    "uid":"XXXXXXX",
    "did":"XXXXXXX",
    "token":"XXXXXXX",
    "date":{
       "sid":"XXXXX"
       "stype":"2"
      }
 }

正常响应：

{
    "ack":"1"
 }

参数协议

参数名 参数类型 参数说明 是否必传
op String 方法类别 是
act String 方法名 是
uid String 获取的微信uid 是
did String 主机的did 是
token String 见二.获取token 是

协议中的date列表

参数名 参数类型 参数说明 是否必传
sid String 我回来啦，场景语音触发命令，可以有很多条语句；格式：0，我回来了，1，我到家了，0，回家模式； 是
stype String 0 关闭 ； 1 开启 ；2 快捷方式； 是

六.快速执行场景

示例：

{
    "op":"scene",
    "act":"run",
    "uid":"XXXXXXX",
    "did":"XXXXXXX",
    "token":"XXXXXXX",
    "date":{
       "sid":"XXXXX"
      }
 }

正常响应：

{
    "ack":"1"
 }

参数协议

参数名 参数类型 参数说明 是否必传
op String 方法类别 是
act String 方法名 是
uid String 获取的微信uid 是
did String 主机的did 是
token String 见二.获取token 是

协议中的date列表

参数名 参数类型 参数说明 是否必传
sid String 我回来啦，场景语音触发命令，可以有很多条语句；格式：0，我回来了，1，我到家了，0，回家模式； 是

七.删除场景

示例：

{
    "op":"scene",
    "act":"del",
    "uid":"XXXXXXX",
    "did":"XXXXXXX",
    "token":"XXXXXXX",
    "date":{
       "sid":"XXXXX"
      }
 }

正常响应：

{
    "ack":"1"
 }

参数协议

参数名 参数类型 参数说明 是否必传
op String 方法类别 是
act String 方法名 是
uid String 获取的微信uid 是
did String 主机的did 是
token String 见二.获取token 是

协议中的date列表

参数名 参数类型 参数说明 是否必传
sid String 我回来啦，场景语音触发命令，可以有很多条语句；格式：0，我回来了，1，我到家了，0，回家模式； 是