IoT Platform：編寫自訂指令碼

JavaScript指令碼樣本

指令碼模板

/**
 * 將裝置自訂Topic資料轉換為JSON格式資料，裝置上報資料到物聯網平台時調用。
 * 入參：data，byte[]數組，不可為空。
 * 出參：jsonObj，對象，不可為空。
 */
function executeScript(data) {
    var jsonObj = {};
    return jsonObj;
}

指令碼樣本

/*
  樣本資料：
  自訂Topic：
     /user/update，上報資料。
  輸入參數：
     data: 0x000000000100320100000000
  輸出參數：
    {
        "prop_float": 0,
        "prop_int16": 50,
        "prop_bool": 1
    }
 */
function executeScript(data) {
    var uint8Array = new Uint8Array(data.length);
    for (var i = 0; i < data.length; i++) {
        uint8Array[i] = data[i] & 0xff;
    }
    var dataView = new DataView(uint8Array.buffer, 0);
    var jsonMap = {};
    jsonMap['prop_int16'] = dataView.getInt16(5);
    jsonMap['prop_bool'] = uint8Array[7];
    jsonMap['prop_float'] = dataView.getFloat32(8);

    return jsonMap;
}

Python指令碼樣本

指令碼模板

# 將裝置自訂Topic資料轉換為JSON格式資料，裝置上報資料到物聯網平台時調用。  
# 入參: data，列表，列表元素取值為int類型，不可為空。
# 出參: jsonObj，字典。    
def execute_script(data):
   jsonObj = {}
   return jsonObj

指令碼樣本

# coding=UTF-8

#  樣本資料：
#  自訂Topic：/user/update，上報資料。
#  輸入參數：
#     data: 0x000000000100320100000000
#  輸出參數：
#  {
#     "prop_float": 0,
#     "prop_int16": 50,
#     "prop_bool": 1
#   }
def execute_script(data):
    uint8Array = []
    for byteValue in data:
        uint8Array.append(byteValue & 0xff)

    jsonMap = {}
    jsonMap['prop_int16'] = bytes_to_int(uint8Array[5:7])
    jsonMap['prop_bool'] = bytes_to_int(uint8Array[7: 8])
    jsonMap['prop_float'] = bytes_to_int(uint8Array[8:])

    return jsonMap

# byte數群組轉換為整型。
def bytes_to_int(bytes):
    data = ['%02X' % i for i in bytes]
    return int(''.join(data), 16)

PHP指令碼樣本

指令碼模板

<?php
/**
 * 將裝置自訂Topic資料轉換為JSON格式資料，裝置上報資料到物聯網平台時調用。
 * 入參：$data，普通數組，數組元素為整數。
 * 出參：$jsonObj，關聯陣列，關聯陣列key取值為英文字串不能是字元的數字如"10"，不可為空。
 */
function executeScript($data)
{
    $jsonObj = array();
    return $jsonObj;
}

重要

請避免使用全域變數或者static變數，否則會造成執行結果不一致。

指令碼中，處理資料採用補碼的方式， [-128, 127]補碼範圍為[0, 255]。例如：-1對應的補碼為255（10進位表示）。

自訂協議解析的函數（executeScript）的入參為整型數組，需要通過0xFF進行與操作，擷取其對應的補碼。返回結果為關聯陣列，要求key取值包含非數組字元（例如：數組key為“10”，PHP數組中會擷取到整數10）。

PHP執行環境對於異常處理要求嚴格，例如：發生錯誤會直接拋出異常，後續代碼不會執行。為保證代碼的健壯性，對於異常需要捕獲並進行處理。

指令碼樣本

<?php
/*
  樣本資料
  自訂Topic：
     /user/update，上報資料。
  輸入參數：
     data: 0x000000000100320100000000。
  輸出參數：
  {
     "prop_float": 0,
     "prop_int16": 50,
     "prop_bool": 1
   }
 */
function executeScript($bytes)
{
    $data = array();
    $length = count($bytes);
    for ($i = 0; $i < $length; $i++) {
        $data[$i] = $bytes[$i] & 0xff;
    }

    $jsonMap = array();
    $jsonMap['prop_int16'] = getInt16($data, 5);
    $jsonMap['prop_bool'] = $data[7];


    return $jsonMap;
}


function getInt16($bytes, $index)
{
    $array = array($bytes[$index], $bytes[$index + 1]);

    return hexdec(byteArrayToHexString($array));
}

function byteArrayToHexString($data)
{
    $hexStr = '';
    for ($i = 0; $i < count($data); $i++) {
        $hexValue = dechex($data[$i]);

        $tempHexStr = strval($hexValue);

        if (strlen($tempHexStr) === 1) {
            $hexStr = $hexStr . '0' . $tempHexStr;
        } else {
            $hexStr = $hexStr . $tempHexStr;
        }
    }

    return $hexStr;
}