触动精灵企业版脚本开发手册

已不进行更新，最新版请查看：http://helpdoc.touchsprite.com/dev_docs/2181/2149.html
开发手册 企业版

Windows 平台按 Ctrl + F 打开快捷搜索

Mac 平台按 command + F 打开快捷搜索

※右侧文本列表可以找到全部手册

目录

企业版专用脚本库

函数：TSUserType、TSUserID、TSUserEmail 获取企业产品类型、用户 ID、用户邮箱

函数功能：获取产品类型、用户ID、用户邮箱

函数用例：

local text = (TSUserType == 1 and "云控" or TSUserType == 2 and "中控" or "未知连接方式").."\r\n"..
(TSUserID == nil and "未获取到用户 ID" or "ID : " .. TSUserID).."\r\n"..
(TSUserEmail == nil and "未获取到用户邮箱" or "邮箱 : " .. TSUserEmail)
dialog(text)

注意事项：

获取的是当前运行脚本所在的企业产品类型、用户 ID、用户邮箱

方法： messageBox 在中控器中显示提示框

方法名称：在中控器中显示提示框

方法功能：在中控器中显示提示框

调用方法

ts_enterprise_lib:messageBox(title,text)

脚本实例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
ts_enterprise_lib:messageBox("提示","我是来自脚本的提示!")

方法： timeout 中控设置全局超时时间

方法名称：设置全局超时时间

方法功能：设置全局超时时间，仅中控有效

调用方法

ts_enterprise_lib.timeout = sec

脚本实例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
     ts_enterprise_lib.timeout = 60 -- 设置超时时间为 60 秒

方法： version 获取中控版本号

方法名称：获取中控版本号

方法功能：获取中控版本号，build 号，仅中控有效

调用方法

ret = ts_enterprise_lib:version()

脚本实例：

--取中控版本号和 build 号
--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
if ts_enterprise_lib.version then
    --判断 version 函数是否存在，旧版的中控(build 1080前)没有这个函数
    local ret = ts_enterprise_lib:version()
    -- ret :失败 ret=false
    --      成功 ret 返回table，ret.build build号，ret.version=版本字符串
    if ret then
        toast("中控版本"..ret.version..',build:'..ret.build)
    else
        --
        toast('获取失败')
    end
end

方法： controller_injection 注入中控器运行

方法名称：注入中控器运行

方法功能：注入中控器运行代码

调用方法

ok,msg = ts_enterprise_lib:controller_injection(code)

脚本实例：

--[[
    请注意注入代码的安全,不安全的代码会导致中控器崩溃
        简单的发账号示例
        script/account.txt内保存账号密码
    --]]
    local ok,account =  ts_enterprise_lib:controller_injection(
        [[
        local f = io.open("script/account.txt", "r")
        if f then
            local account_tab = {} 
            local account = f:read()
            while account do 
                table.insert(account_tab,account) 
                account = f:read() 
            end
            f:close()
            if #account_tab > 0 then
                local f = io.open("script/account.txt", "w")
                if f then
                    for i = 2,#account_tab do
                        f:write(account_tab[i].."\n")
                    end
                    f:close()
                end
                return account_tab[1]
            else
                return false
            end     
        end
        return false
    ]]
    )
    assert(ok,account)
    if account then
        nLog("获取账号:"..account)
        toast("获取账号:"..account)
    else
        nLog("获取账号失败")
        toast("获取账号失败")
    end
    mSleep(1000)

• 更多示例代码可参考这里 → 注入中控器简单的发账号示例

方法： controller_ocr 中控端打码

方法名称：中控端打码

方法功能：客户端向中控端发送识别内容，人工值守返回打码结果到设备

调用方法

图片打码：ok,msg = ts_enterprise_lib:controller_ocr(x1,y1,x2,y2,timeout)
文字打码：ok,msg = ts_enterprise_lib:controller_txt(text,timeout)

脚本实例：

• 中控打码需要中控端人工值守打码，非自动打码

-- 中控端打码，发送图片
ts_enterprise_lib = require("ts_enterprise_lib")
assert( ts_enterprise_lib,"无法引入企业专用库")
local x1 = 1            --打码左上角坐标
local y1 = 1            --打码左上角坐标
local x2 = 200          --打码右下角坐标
local y2 = 100          --打码右下角坐标
local timeout = 300     --打码超时,单位秒,缺省60,如果中控器超时没有处理，会返回false,"timeout"
local ok,msg =  ts_enterprise_lib:controller_ocr(x1,y1,x2,y2,timeout)
assert(ok,msg)
nLog("打码成功!"..msg)
toast("打码成功!"..msg)
mSleep(1000)

-- 中控端打码，发送字符串
ts_enterprise_lib = require("ts_enterprise_lib")
assert( ts_enterprise_lib,"无法引入企业专用库")
local text = "test!"
local timeout = 300     --打码超时,单位秒,缺省60,如果中控器超时没有处理，会返回false,"timeout"
local ok,msg = ts_enterprise_lib:controller_txt(text,timeout)
assert(ok,msg)
nLog("打码成功!"..msg)
toast("打码成功!"..msg)
mSleep(1000)

方法： reboot_restart 重启设备后启动脚本

方法名称：重启设备后启动脚本

方法功能：重启设备后启动脚本

调用方法

ret,msg = ts_enterprise_lib:reboot_restart()

脚本实例：

--设备重启期间不要关闭中控器
ts_enterprise_lib = require("ts_enterprise_lib")
local ret,msg =  ts_enterprise_lib:reboot_restart()
if ret then
    toast("设备即将重启")
else
    toast("设备重启失败:"..msg)
end

方法： remote_file_load 读取中控文件

方法名称：读取中控文件

方法功能：读取中控文件

调用方法

ok,data = ts_enterprise_lib:remote_file_load(filepath)

脚本实例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
--文件名:中控器上的文件名,可以是相对中控器文件夹的相对路径,也可以是绝对路径
--如果文件名所在的文件夹不存在,或者没有权限,或者文件名存在非法字符,文件会创建失败
local filename = "abc" --这是相对路径
local filename = "c:\\abc" --这是 win 绝对路径
local filename = "/Users/xxxx/Documents/abc" --这是 mac 绝对路径
-- 读取远程文件
local ok,data =  ts_enterprise_lib:remote_file_load(filename)
if ok then
    toast("读成功:"..data)
else
    toast("读失败:"..data)
end
-- 返回值 ok:调用是否成功,如果 true,第二个参数返回文件数据,如果 false,第二个返回值返回错误原因

方法： remote_file_save 写入中控文件

方法名称：写入中控文件

方法功能：写入中控文件

调用方法

ok,data = ts_enterprise_lib:remote_file_save(filepath,filedata)

脚本实例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
--文件名:中控器上的文件名,可以是相对中控器文件夹的相对路径,也可以是绝对路径
--如果文件名所在的文件夹不存在,或者没有权限,或者文件名存在非法字符,文件会创建失败
local filename = "abc" --这是相对路径
local filename = "c:\\abc" --这是 win 绝对路径
local filename = "/Users/xxxx/Documents/abc" --这是 mac 绝对路径
--文件数据,支持二进制数据
local filedata = [[
1111
2222
3333
]]
-- 写入远程文件
local ok,msg = ts_enterprise_lib:remote_file_save(filename,filedata)
if ok then
   toast("写入成功")
else
    toast("写入失败:"..msg)
end
-- 返回值 ok:调用是否成功,如果 true,没有第二个返回值,如果 false,第二个返回值返回错误原因

• 更多脚本示例代码可参考这里 → 封装中控器读写函数

方法： push_file 上传文件

方法名称：上传文件

方法功能：从设备上传文件到中控

调用方法

ok,err = ts_enterprise_lib:push_file(local_file,remote_file)

脚本实例：

ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
toast("开始测试")
--上传文件到中控器
local local_file = userPath().."/res/aaa/test2.zip"   --本地的文件名(手机上)
local remote_file = 'test2.zip'             --中控的文件名(相对于中控器的根路径)
local ok,err = ts_enterprise_lib:push_file(local_file,remote_file)
-- 返回：ok :true or false
--      error: 失败原因
if ok then
    toast("上传成功")
else
    toast(err)
end
--测试速度结果：80M 文件 11 - 18秒
--此功能需要配合 1069 以上版本中控器方可使用

方法： pull_file 下载文件

方法名称：下载文件

方法功能：从中控下载文件到设备

调用方法

ok,err = ts_enterprise_lib:pull_file(local_file,remote_file)

脚本实例：

ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
toast("开始测试")
--从中控器下载文件
local local_file = userPath().."/res/aaa/test.zip"   --本地的文件名(手机上)
local remote_file = 'test.zip'              --中控的文件名(相对于中控器的根路径)
local ok,err = ts_enterprise_lib:pull_file(local_file,remote_file)
-- 返回：ok :true or false
--      error: 失败原因
if ok then
    toast("下载成功")
else
    toast(err)
    return
end
--测试速度结果：80M 文件 11 - 18 秒
--此功能需要配合 1069 以上版本中控器方可使用

方法： plugin_api_call("VariableMonitor",...) 变量监控

方法名称：变量监控

方法功能：通过上传数据到中控进行变量监控

调用方法

ok,msg = ts_enterprise_lib:plugin_api_call("VariableMonitor",action,
str1,
str2,
str3,...)

脚本实例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
--设置变量监控列信息
local ok,msg = ts_enterprise_lib:plugin_api_call("VariableMonitor","set_column","序号","随机数","序号+随机数","序号*随机数")
toast(ok and "set_column 成功" or "set_column 失败:"..msg)
mSleep(1000)
math.randomseed(os.time())
for i = 1 , 100 do
    local var1 = i
    local var2 = math.random()
    local var3 = var1+var2
    local var4 = var1*var2
    --上传每列数据
    local ok,msg = ts_enterprise_lib:plugin_api_call("VariableMonitor","set_variable",var1,var2,var3,var4)
    toast(ok and "set_variable 成功" or "set_variable 失败:"..msg)
    mSleep(1000)
end

企业版数据中心

当调用企业库 plugin_api_call 方法第一个参数填写"DataCenter"时，可以调用企业版数据中心的相关函数功能，第二个参数为函数名称。

方法：add_category 创建分类

函数名称：创建分类

函数功能：创建分类

函数方法：

local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","add_category",category)

函数用例：

ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local category = "分类"
local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","add_category",category)
if ok then
dialog("创建成功")
else
dialog("创建失败 : " .. ret1)
end

方法： get_data 获取数据

方法名称：获取数据

方法功能：从数据中心获取一条数据

调用方法

ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","get_data",category)

函数用例：

--
-- Date: 16/8/1
-- Time: 下午6:10
-- 本例子为设备脚本调用 api 示例
-- 本例子所调用的api，在中控根目录 plugin/DataCenter/api.lua 中都有实现源码，可根据自己的实际需要做功能调整
--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local category = "测试分类"
-- 取数据操作,每 5 秒取一次数据，取 100 次
for i = 1 , 100 do
    -- 使用中控库的插件 api 调用接口
    -- DataCenter 是插件 id
    -- get_data 是 api name
    -- category api 参数，这个 api 是分类名
    local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","get_data",category)
    -- 返回 ok 表示插件 api 是否调用成功，ret1,ret2 是 api 的返回值
    if ok then
        if ret1 then
            nLog("get_data 成功:"..ret2)
        else
            nLog("get_data 失败:"..ret2)
        end
    else
        nLog("get_data 失败:"..ret1)
    end
    mSleep(5000)
end

方法： batch_data 批量获取数据

方法名称：批量获取数据

方法功能：从数据中心单次获取多条数据

调用方法

ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","batch_data",category,count)

函数用例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local ts = require("ts")--使用扩展库前必须插入这一句
local json = ts.json--使用 JSON 模块前必须插入这一句
--批量取数据
local count = 10 --取数据数量
local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","batch_data",category,count)
if ok then
    if ret1 then
        --返回一个数组table
        nLog("batch_data 成功:"..json.encode(ret2))
    else
        nLog("batch_data 失败:"..ret2)
    end
else
    nLog("batch_data 失败:"..ret1)
end
mSleep(5000)

方法： get_remain_count 获取剩余有效数据数量

方法名称：获取剩余有效数据数量

方法功能：获取剩余有效数据数量，即未使用状态的数据数量

调用方法

ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","get_remain_count",category)

函数用例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
--获取剩余有效数据数量(未使用)
local ok,ret1,ret2 =ts_enterprise_lib:plugin_api_call("DataCenter","get_remain_count",category)
if ok then
    if ret1 then
        nLog("get_remain_count 成功,剩余有效数据数量为:"..ret2)
    else
        nLog("get_remain_count 失败:"..ret2)
    end
else
    nLog("get_remain_count 失败:"..ret1)
end
mSleep(5000)

方法： insert_data 插入数据

方法名称：插入数据

方法功能：在数据中心中插入一条新数据

调用方法

ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","insert_data",category,data)

函数用例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
--添加一个数据
local data = "要插入的数据"
local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","insert_data",category,data)
if ok then
    if ret1 then
        nLog("insert_data 成功")
    else
        nLog("insert_data 失败:"..ret2)
    end
else
    nLog("insert_data 失败:"..ret1)
end
mSleep(5000)

方法： revert_data 还原数据

方法名称：还原数据

方法功能：将单条数据还原为未使用状态

调用方法

ok,ret1,ret2 =ts_enterprise_lib:plugin_api_call("DataCenter","revert_data",category,data)

脚本实例：

--注意: 以下函数在中控器 build 1081 及以后的版本才支持
--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
--归还数据操作
local data = "要归还的数据"
local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","revert_data",category,data)
if ok then
    if ret1 then
        nLog("revert_data 成功:")
    else
        nLog("revert_data 失败:"..ret2)
    end
else
    nLog("revert_data 失败:"..ret1)
end

方法： delete_data 删除数据

方法名称：删除数据

方法功能：删除指定分类下的指定数据

调用方法

ok,ret1,ret2= ts_enterprise_lib:plugin_api_call("DataCenter","delete_data",category,data)

脚本实例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
--删除一个分类下的某个数据
local data="13321638994";
local ok,ret1,ret2= ts_enterprise_lib:plugin_api_call("DataCenter","delete_data",category,data)
if ok then
    if ret1 then
        dialog("删除成功", 5)
        return true
    else
        dialog("ret1 失败:"..ret1)
    end
else
    dialog("ok 失败:"..ret1)
end
mSleep(5000)

方法： clear_dataCenterUser 重置数据中心

方法名称：重置数据中心

方法功能：将指定分类下的数据全部重置为未使用状态

调用方法

ok,msg = ts_enterprise_lib:clear_dataCenterUser(category)

脚本实例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
--重置某个分类下的数据
local ok,msg = ts_enterprise_lib:clear_dataCenterUser(category)
assert(ok)
if ok then
    nLog("重置成功!")
    toast("重置成功!")
else
    nLog("重置失败!"..msg)
    toast("重置失败!"..msg)
end
mSleep(1000)

完整脚本示例

ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local category = "insert_data"
local ts = require("ts")--使用扩展库前必须插入这一句
local json = ts.json--使用 JSON 模块前必须插入这一句
toast("创建分类名 测试") 
local category = "分类"
local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","add_category",category)
if ok then
dialog("创建成功")
else
dialog("创建失败 : " .. ret1)
end
toast("插入数据 测试") 
mSleep(1000)
local data = "要插入的数据"
local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","insert_data",category,data..os.date("%H%M%S"))
if ok then
if ret1 then 
dialog("插入数据 insert_data 成功") 
    else 
dialog("插入数据 insert_data 失败:"..ret2)
end
else
dialog("插入数据 insert_data 失败:"..ret1)
end
toast("获取数据 测试") 
mSleep(1000)
local ok,ret1,ret3 = ts_enterprise_lib:plugin_api_call("DataCenter","get_data",category)
if ok then
if ret1 then 
dialog("获取数据 get_data 成功:"..ret3)
    else 
dialog("获取数据 get_data 失败:"..ret3)
end
else
dialog("获取数据 get_data 失败:"..ret1)
end
toast("还原数据 测试") 
mSleep(1000)
local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","revert_data",category,ret3)
if ok then 
if ret1 then 
dialog("还原数据 revert_data 成功:") 
    else 
dialog("还原数据 revert_data 失败:"..ret2) 
end
else
dialog("还原数据 revert_data 失败:"..ret1)
end
toast("批量获取数据 测试") mSleep(1000)
local count = 2 --取数据数量
local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","batch_data",category,count)
if ok then
if ret1 then 
dialog("批量获取数据 batch_data 成功:"..json.encode(ret2)) 
    else 
dialog("批量获取数据 batch_data 失败:"..ret2) 
end
else
dialog("批量获取数据 batch_data 失败:"..ret1)
end
toast("重置数据中心 测试") mSleep(1000)
local ok,msg = ts_enterprise_lib:clear_dataCenterUser(category)
assert(ok)
if ok then 
dialog("重置数据中心 重置成功!") 
else 
dialog("重置数据中心 重置失败!"..msg) 
end
toast("剩余有效数据 测试") 
mSleep(1000)
local ok,ret1,ret2 = ts_enterprise_lib:plugin_api_call("DataCenter","get_remain_count",category)
if ok then
if ret1 then 
dialog("剩余有效数据 get_remain_count 成功,剩余有效数据数量为:"..ret2) 
    else 
dialog("剩余有效数据 get_remain_count 失败:"..ret2) 
    end
else
dialog("剩余有效数据 get_remain_count 失败:"..ret1)
end
toast("删除数据 测试") 
mSleep(1000)
local ok,ret1,ret2= ts_enterprise_lib:plugin_api_call("DataCenter","delete_data",category,ret3)
if ok then
if ret1 then 
dialog("删除数据 删除成功", 5)
else 
dialog("删除数据 ret1 失败:"..ret1)
end
else
dialog("删除数据 ok 失败:"..ret1)
end

企业版云盘

此功能模块为云控用户提供云端文件存储、调用服务
云盘访问地址： http://pan.touchsprite.com/

函数：cloud_file_list 获取云盘文件列表

函数名称：获取文件列表

函数功能：获取云盘文件列表。

函数方法

ts_enterprise_lib:cloud_file_list(file)
返回值：table

脚本实例：

local ts = require("ts")
local json = ts.json
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
dialog(json.encode({ts_enterprise_lib:cloud_file_list("/")}))

函数：cloud_file_new 创建文件（夹）

函数名称：创建文件（夹）

函数功能：创建文件（夹）

函数方法

ts_enterprise_lib:cloud_file_list(file)
返回值：table

脚本实例：

local ts = require("ts")
local json = ts.json
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
--创建 a1 文件夹
dialog(json.encode({ts_enterprise_lib:cloud_file_new("/a1/")}))
--在 a1 文件夹下创建 1.txt 文件
dialog(json.encode({ts_enterprise_lib:cloud_file_new("/a1/1.txt")}))

函数：cloud_file_rename 文件(夹)重命名

函数名称：文件(夹)重命名

函数功能：文件(夹)重命名

函数方法

ts_enterprise_lib:cloud_file_list(file,rename)
返回值：table

脚本实例：

local ts = require("ts")
local json = ts.json
ts_enterprise_lib = require("ts_enterprise_lib")
--修改 a1 文件夹下 1.txt 文件名称为 2.txt
dialog(json.encode({ts_enterprise_lib:cloud_file_rename("/a1/1.txt","2")}))
--修改 a1 文件夹下的 1 文件夹名称为 2
dialog(json.encode({ts_enterprise_lib:cloud_file_rename("/a1/1/","2")}))

函数：cloud_file_del(file) 删除文件（夹）

函数名称：删除文件（夹）

函数功能：删除文件（夹）

函数方法

ts_enterprise_lib:cloud_file_del(file)
返回值：table

脚本实例：

local ts = require("ts")
local json = ts.json
ts_enterprise_lib = require("ts_enterprise_lib")
--删除 a1 文件夹下的 2 文件夹
dialog(json.encode({ts_enterprise_lib:cloud_file_del("/a1/2/")}))
--删除 a1 文件夹下的 2.txt 文件
dialog(json.encode({ts_enterprise_lib:cloud_file_del("/a1/2.txt")}))

方法： cloud_file_save 向云盘写入文件

方法名称：向云盘中写入文件

方法功能：向云盘中写入一个文件

调用方法

ok,err = ts_enterprise_lib:cloud_file_save(cloud_file_name,file_data,timeout_seconds)

脚本实例：

ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local cloud_file_name = "/aaa/bbb/脚本2.lua"  --云文件名，包含目录的完整文件名
local file_data = "123"                     --文件数据
local timeout_seconds = 30;                  --超时秒数,数据较大时，适当延长
local ok,err = ts_enterprise_lib:cloud_file_save(cloud_file_name,file_data,timeout_seconds)
if ok then
    dialog("成功")
else
    dialog(err)
end

方法： cloud_file_load 从云盘读取文件

方法名称：从云盘中读取文件

方法功能：从云盘中读取一个文件

调用方法

ok,data = ts_enterprise_lib:cloud_file_load(cloud_file_name,timeout_seconds)

脚本实例：

ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local cloud_file_name = "/aaa/bbb/脚本2.lua"      --云文件名，包含目录的完整文件名
local timeout_seconds = 30;                      --超时秒数,数据较大时，适当延长
local ok,data = ts_enterprise_lib:cloud_file_load(cloud_file_name,timeout_seconds)
if ok then
    dialog("loal success:"..data)
else
    dialog("fail:"..data)
end

方法： cloud_file_pull 从云盘下载文件

方法名称：从云盘下载文件

方法功能：从云盘中下载一个文件到本地

调用方法

ok,err = ts_enterprise_lib:cloud_file_pull(local_file,cloud_file_name,timeout_seconds)

脚本实例：

ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local local_file = userPath().."/1.lua"        --本地文件名
local cloud_file_name = "/aaa/bbb/脚本2.lua"      --云文件名，包含目录的完整文件名
local timeout_seconds = 30;                      --超时秒数,数据较大时，适当延长
local ok,err = ts_enterprise_lib:cloud_file_pull(local_file,cloud_file_name,timeout_seconds)
if ok then
    dialog("成功")
else
    dialog(err)
end

方法： cloud_file_push 上传文件到云盘

方法名称：上传文件到云盘

方法功能：从本地上传一个文件到云盘

调用方法

ok,err = ts_enterprise_lib:cloud_file_push(local_file,cloud_file_name,timeout_seconds)

脚本实例：

ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local local_file = userPath().."/1.lua"        --本地文件名
local cloud_file_name = "push.lua"              --云文件名，包含目录的完整文件名
local timeout_seconds = 30;                      --超时秒数,数据较大时，适当延长
local ok,err = ts_enterprise_lib:cloud_file_push(local_file,cloud_file_name,timeout_seconds)
if ok then
    dialog("成功")
else
    dialog(err)
end

• 此功能模块需配合触动精灵企业版使用

企业版云数据库

此功能模块为云控用户提供云端数据存储、查询等功能
云数据库访问地址： http://cloud-db.touchsprite.com/
云数据库开发教程：http://v.youku.com/v_show/id_XMzE4MTY4MTc1Mg==.html?qq-pf-to=pcqq.c2c

用户操作

1. 用户可在数据库管理平台中对已经有操作权限的表进行导入、添加、修改、删除等操作（导入数据大小限制为5m，仅支持 txt 格式文件导入，文件中数据需以空格进行列分割、以回车进行行分割）
2. 用户可在数据库管理平台为已经有操作权限的表添加视图，可针对视图设置权限（公开、私有）

开发者操作

1. 开发者可在数据库管理平台建立表结构供脚本用户使用
2. 开发者需设置数据库中每条记录的大小（单位：kb）
3. 开发者需设置允许访问表的用户列表（关联企业用户账号至该表）
4. 添加列名（用于在脚本中访问，必须为英文）
5. 添加列显示名（用于在用户视图中展示数据时使用，仅限使用中英文）

方法： cloud_db_add 插入数据

方法名称：插入数据

方法功能：插入数据到云数据库表内

调用方法

ok,err = ts_enterprise_lib:cloud_db_add(table_id,data,timeout_seconds)

脚本实例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
--添加数据
local table_id = '58b7968986d4e24f4a0cf4e5' --可在数据库管理平台查看
local data = {a=1,b=1}                      --需要写入的数据
local timeout_seconds = 30                   --超时设置，单位：秒
local ok,err = ts_enterprise_lib:cloud_db_add(table_id,data,timeout_seconds)
if ok then
    dialog("成功")
else
    dialog(err)
end

方法： cloud_db_delete 删除数据

方法名称：删除数据

方法功能：删除指定数据

调用方法

ok,err = ts_enterprise_lib:cloud_db_delete(table_id,where,timeout_seconds)

脚本实例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
--删除数据
local table_id = '58b7968986d4e24f4a0cf4e5' --表id
local where = {a=3}                      --条件（可多个条件）
local timeout_seconds = 30                --超时
local ok,err = ts_enterprise_lib:cloud_db_delete(table_id,where,timeout_seconds)
if ok then
    dialog("成功")
else
    dialog(err)
end

方法： cloud_db_update 修改数据

方法名称：修改数据

方法功能：修改指定数据

调用方法

ok,err = ts_enterprise_lib:cloud_db_update(table_id,where,data,timeout_seconds)

脚本实例：

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
--修改数据
local table_id = '58b7968986d4e24f4a0cf4e5'         --表id
local where = {a=2}                                --条件
local data= {a=5}
local timeout_seconds = 30                           --超时
local ok,err = ts_enterprise_lib:cloud_db_update(table_id,where,data,timeout_seconds)
if ok then
    dialog("成功")
else
    dialog(err)
end

方法： cloud_db_query 查询数据

方法名称：查询数据

方法功能：查询数据

调用方法

ok,ret = ts_enterprise_lib:cloud_db_query(table_id,where,timeout_seconds)

脚本实例1：普通查询

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local ts = require("ts")--使用扩展库前必须插入这一句
local json = ts.json--使用 JSON 模块前必须插入这一句
--查询数据
local table_id = '58b7968986d4e24f4a0cf4e5'         --表id
local where = {a=5 }                                --条件
local timeout_seconds = 30                           --超时
local ok,ret = ts_enterprise_lib:cloud_db_query(table_id,where,timeout_seconds)
if ok then
    dialog("成功:"..ts_enterprise_lib.json.encode(ret))
else
    dialog(ret)
end

脚本实例2：分页查询

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local ts = require("ts")--使用扩展库前必须插入这一句
local json = ts.json--使用 JSON 模块前必须插入这一句
--分页查询数据
local table_id = '58b7968986d4e24f4a0cf4e5'         --表id
local where = {a=5 }                                --条件
local option = {pageSize=1,pageIndex=0}             --pageSize分页大小(<1000,default:50),pageIndex分页序号(default:0),
local timeout_seconds = 30                           --超时
local ok,ret = ts_enterprise_lib:cloud_db_query(table_id,where,option,timeout_seconds)
if ok then
    dialog("成功:"..ts_enterprise_lib.json.encode(ret))
else
    dialog(ret)
end

脚本实例3：排序查询

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local ts = require("ts")--使用扩展库前必须插入这一句
local json = ts.json--使用 JSON 模块前必须插入这一句
--排序查询数据
local table_id = '58b7968986d4e24f4a0cf4e5'         --表id
local where = {}                                --条件
local option = {
    sort={
        a=-1            -- -1：从大到小、1：从小到大
    }
}
local timeout_seconds = 30                           --超时
local ok,ret = ts_enterprise_lib:cloud_db_query(table_id,where,option,timeout_seconds)
if ok then
    dialog("成功:"..ts_enterprise_lib.json.encode(ret))
else
    dialog(ret)
end

脚本实例4：模糊条件查询

--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local ts = require("ts")--使用扩展库前必须插入这一句
local json = ts.json--使用 JSON 模块前必须插入这一句
--表id
local table_id = '58a522d7f502b1263083b74b'         
local where = {a={lt=2},b={lte=1},c={gt=1},d={gte=1},e={ne=1},f={regex = "b", type="first" } }--条件
--说明
--小于：lt，小于或等于：lte，大于：gt，大于或等于：gte，不等于：ne
--模糊: regex="b" type="first" 开头匹配 type="all" 任意匹配
local timeout_seconds = 30                           --超时
local ok,ret = ts_enterprise_lib:cloud_db_query(table_id,where,timeout_seconds)
if ok then
    dialog("成功:"..ts_enterprise_lib.json.encode(ret))
else
    dialog(ret)
end

方法： cloud_db_query_update 获取数据

方法名称：查询数据

方法功能：查询数据

调用方法

ok,ret = ts_enterprise_lib:cloud_db_query_update(
table_id,
where,
data,
timeout
)

脚本实例

--获取数据
--引入中控库
ts_enterprise_lib = require("ts_enterprise_lib")
assert(ts_enterprise_lib,"无法引入企业专用库")
local ts = require("ts")--使用扩展库前必须插入这一句
local json = ts.json--使用 JSON 模块前必须插入这一句
--表id
local table_id = '58a522d7f502b1263083b74b'  
--表中包括两个字段，data字段为取号的内容，used_device 为使用号的设备，如果为空，表示此号未使用
--取号可以通过以下代码完成
if ts_enterprise_lib.build and ts_enterprise_lib.build >=100 then       
    local ok,ret = ts_enterprise_lib:cloud_db_query_update(
        table_id,   --table id
        {used_device=""},               --未使用的号的条件
        {used_device=getDeviceID()},    --修改used_device为当前设备号，给该记录设置了使用标记
        60                             
    )
    if ok then
        if #ret > 0 then
            dialog("成功取号:"..ts_enterprise_lib.json.encode(ret))
            --nLog(ts_enterprise_lib.json.encode(ret))
        else
            dialog("没号了") 
        end
    else
         dialog(ret)
    end
else
     dialog('ts_enterprise_lib版本太低')
end

脚本参数配置

使用说明

启动参数有两种设置方式：
1. 在开发者平台的脚本参数设置内设置
2. 使用script.json文件配置
script.json文件放到脚本文件夹下即可生效

※json需要按照规范编写，不可以添加注释，否则会导致解析错误

※文件编码方式选择UTF-8，其他模式会导致中文乱码

※当两种方式都设置的时候，以json文件配置为准

参数调用方法

每个参数需定义 name 以做标识，在脚本中以name字段值为变量名调用即可
调用示例：
每个参数需定义 name 以做标识，在脚本中以 name 字段值为变量名调用即可
调用示例：

json:

{
    "params": [{
        "display_name": "选项",
        "default": "1",
        "name": "mode",
        "type": 2
    }],
    "name": "lua 脚本测试变量监控"
}

lua:

        dialog(mode,time)

script.json 格式规范

json示例1：

{
  "params":[
    {
      "display_name": "1游戏模式(1:升级模式,2:打怪模式)", 
      "default": "1",   
      "name": "mode",   
      "type": 2 
    },
    {
      "display_name": "登录用户名",
      "default": "test",
      "name": "user",
      "type": 2
    },
    {
      "display_name": "登录密码",
      "default": "123456",
      "name": "password",
      "type": 2
    }
  ],
  "name":"lua脚本测试变量监控" --修改脚本名称为 lua脚本测试变量监控 
}

json示例2：

{
    "params": [
        {
            "display_name": "数字",
            "name": "number",
            "type": 1,
            "default": "1"
        },
        {
            "display_name": "字符串",
            "name": "string",
            "type": 2,
            "default": "string"
        },
        {
            "display_name": "单选",
            "name": "radio",
            "type": 3,
            "options": [
                {
                    "name": "1",
                    "value": 0
                },
                {
                    "name": "2",
                    "value": 1
                },
                {
                    "name": "3",
                    "value": 2
                },
                {
                    "name": "4",
                    "value": 3
                }
            ],
            "default": "0"
        },
        {
            "display_name": "多选",
            "name": "checkbox",
            "type": 4,
            "options": [
                {
                    "name": "1",
                    "value": 0
                },
                {
                    "name": "2",
                    "value": 1
                },
                {
                    "name": "3",
                    "value": 2
                },
                {
                    "name": "4",
                    "value": 3
                },
                {
                    "name": "5",
                    "value": 4
                }
            ],
            "default": "0@1@2"
        },
        {
            "name": "4m7yf7FJVxBPnlqY9ZFKyKLtrYoCduhc",
            "type": 5,
            "value": "<p>这是文字说明<br></p>",
            "default": "<p>这是文字说明<br></p>"
        }
    ]
}

控件： switches 开关控件

json示例：

{
"params": [{
                    "id": "kg",
                    "type": "switches",
                    "list": "开关1,开关2,开关3",
                    "select": "0@2"
            }]
}

控件： RadioGroup 单选框

json示例：

{
"params": [{
                    "id": "dx",
                    "type": "RadioGroup",
                    "list": "选项1,选项2,选项3",
                    "select": "1"
            }]
}

控件： CheckBoxGroup 多选框

json示例：

{
"params": [{
                    "id": "ceshi9",
                    "type": "CheckBoxGroup",
                    "list": "选项1,选项2,选项3,选项4",
                    "select": "0@3"
            }]
}

控件： Label 文本标签

json示例：

{
"params": [{
                    "type": "Label",
                    "text": "文字标签",
                    "size": 18,
                    "align": "center",
                    "color": "0,168,233"
                },
                {
                    "id": "ceshi9",
                    "type": "CheckBoxGroup",
                    "list": "选项1,选项2,选项3,选项4",
                    "select": "0@3"
            }]
}

• 注意：当json中只有label时无法显示，需要和其他控件一起使用

控件： Edit 普通编辑框

json示例：

{
"params": [{
                    "id": "input",
                    "type": "Edit",
                    "prompt": "请输入一个字母",
                    "text": "默认值",
                    "row": "5",
                    "kbtype": "ascii"
            }]
}

控件： Edit 密码编辑框

json示例：

{
"params": [{
                    "id": "ceshi8",
                    "type": "Edit",
                    "prompt": "请输入密码",
                    "text": "hhkjkjh",
                    "kbtype": "password"
            }]
}

控件： Edit 数字编辑框

json示例：

{
"params": [{
                    "id": "num",
                    "type": "Edit",
                    "prompt": "请输入一个数字",
                    "text": "2",
                    "kbtype": "number"
            }]
}