功能介绍

自定义透传脚本解析功能是为了降低硬件设备的开发成本，提高产品接入效率。主要是在下行链路中，云端调用脚本将标准的json数据转换成二进制数据透传给设备，在上行链路中，云端在收到设备上报的二进制原始数据之后，通过调用解析脚本，将二进制数据解析成标准json数据，方便存储以及展示。目前脚本通过JavaScript语言开发，需要支持以下两个方法即可实现与云端上下行通讯。

1 protocolToRawData:用于在下行链路中，将云端的标准json数据转换成设备能够识别的二进制数据。方法返回byte数组

2 rawDataToProtocol:用于在上行链路中，将设备主动上报或是响应云端请求的数据解析成云端能够识别的标准json数据，方便存储以及展示。

脚本定义

1.语言定义

目前脚本仅支持符合ECMAScript5.1的JavaScript语法，暂不支持ECMA6以上语法

2.脚本格式

/**
  *  将下行数据转换为设备能识别的格式数据
  *  入参：jsonObj 对象       不能为空
  *  出参：rawData byte[]数组 不能为空
  */
 function protocolToRawData(jsonObj) {
       return rawdata;
 }

/**
 * 设备上行数据解析
 * 入参：rawData byte[]数组   不能为空
 * 出参：jsonObj 对象         不能为空   
 */
 function rawDataToProtocol(rawData) {
       return jsonObj;
}

3.脚本方法

3.1.protocolToRawData

用途：用于将云端的下行标准json协议数据转换成设备底层二进制原始数据，开发者需要重写该方法

参数：json，里面封装了method,id以及设备的属性数据

返回：字节数据

function protocolToRawData(json){}

json参数举例

云端请求获取设备数据（Get)

{
    "method":"thing.attribute.get",           
    "id":"",                           
    "params":["powerstate","windspeed"]      
}

云端请求设置设备属性（Set）

{
    "method":"thing.attribute.set",         
    "id":"",                          
    "params":{
        "powerstate":1                
    }                                                            
}

服务调用

{
    "method":"thing.service.invoke",         
    "id":"",                      
    "serviceName":""                       
    "params":{
        "powerstate":1                    
    }                                                             
}

3.2.rawDataToProtocol

用于解析设备上行原始二进制数据解析成云端标准json数据，便于云端存储跟查询。

参数：二进制字节数组

返回：json数组

json数据模型

响应云端get请求

{
    "method":"thing.attribute.get",             
    "id":"",                               
    "params": {
        "powerstate":                         
    }     
}

响应云端set请求

{
    "method":"thing.attribute.set",            
    "id":"",                           
    "params": {
        "powerstate":                      
    }     
}

设备主动上报属性数据

{
    "method":"thing.attribute.post",          
    "id":"",                         
    "params": {
        "powerstate":                  
    }    
}

设备上报事件

{
    "method":"thing.event.post",       
    "id":"",                            
    "eventName":                         
    "params": {
        "powerstate":                
    }    
}

设备响应服务请求

{
    "method":"thing.service.invoke",         
    "id":"",                        
    "serviceName":""                       
    "params":{
        "powerstate":1                
    }
}

method方法

取值	含义
thing.attribute.get	云端请求获取设备属性以及设备响应get请求返回响应
thing.attribute.set	云端设置设备属性以及设备响应set请求返回响应
thing.attribute.post	设备上报属性数据
thing.event.post	设备事件上报
thing.service.invoke	设备端服务调用
thing.service.response	设备端响应服务调用
thing.attribute.adjust	调整设备端属性以及设备端响应属性调整