XXTouch中控 手册

XXTouch中控 XXTouch

请访问XXT 局域网中控进行获取最新版本以及更新的提示

中控环境

• iOS已越狱设备环境下安装XXTouch服务，并打开远程操作服务(部分功能需要安装OpenSSH)
• 需要安装.net 4.0环境基础包(下载地址)
• 设备与中控在同一个局域网环境方可扫描以及操作

中控使用注意

• 中控为良性软件，不会加入涉及设备数据或PC数据的操作
• 当设备挂有代理IP时中控可能部分功能无法正常使用
• 当系统防火墙拦截时中控可能部分功能无法正常使用回
• 中控API属于额外拓展与中控交互使用，且必须由中控启动脚本才可以生效
• 中控主要用于批量启动停止脚本，其它额外功能属于拓展功能不能保证在任何情况下都可以正常使用
• 软件如果出现任何BUG可以反馈给我，但不接受任何私有化建议
• 与我沟通:QQ 270001300
• XXTouch开发者群:40898074．

疑难杂症的解答

Q：脚本启动后提示“中控访问超时”？
A：设备端无法连接中控锁监听的端口引起的问题。
R：确保使用中控启动且加入通讯API，且检查电脑端防火墙是否关闭。

Q：中控出现错误提示“基础链接已关闭，无法链接到远程服务器”？
A：一些用户在安装一些软件或是系统做某些修改后，采集器就没无登录或是无法获取到网页。
R：在开始键入 cmd，右键单击“cmd.exe”，单击“以管理员身份运行”，然后按“继续”。
在命令提示符处键入 netsh winsock reset，然后按 Enter。

Q：为什么有些电脑无法启动中控？
A：因为中控的开发使用 .NET 基础库，所以需使用中控也要同样的运行库。
R：请下载 .NET 4.0 版本，此处是下载地址。

Q：点击“搜索设备”特别卡？
A：网络环境搭建有问题。
R：可以考虑点击“搜索设备”旁的小三角“网段扫描”，点选“IP段列表”内对应IP，之后点击“TCP扫描”等待设备刷新出来进行解决。
PS：避免每次启动中控都需要扫描，当扫描妥当后，可勾选所有设备，点击“中控功能”内“导出勾选IP地址”项，下次重启中控后使用虑点击“搜索设备”旁的小三角“IP地址扫描”针对性添加设备。

Q：扫描设备扫描不全？
A：当设备没有点亮屏幕时，设备很有可能 Wifi 处于休眠状态。
R：请确保设备点亮屏幕。

Q：打开中控出现“配置系统未能初始化”错误提示框？
A：程序相对的配置文件“user.config”损坏引发的问题。
R：删除“C:\Users[用户名]\AppData\Local\XXTouch团队”或“C:\Documents and Settings[用户名]\Local Settings\Application Data\XXTouch团队”解决。

中控结构

在无数据库的情况下会提示创建数据库与配置文件

1ferver目录 详解

• 结构例子会在以后中控中内置
• 针对目录的同步进行适配的文件夹．
• 脚本选择位置针对 "根目录" 相对的 "\1ferver\lua\scripts\" 文件夹下的脚本文件进行遍历，结构以 "项目名\main.xxt" 或 "项目名\main.lua" ， 方可在中控端地址栏中进行点击 "地址栏" 中小三角进行选择为 "项目:项目名" 的脚本文件，启动统一按照 "main.xxt" 或 "main.lua" 为准．
• 可使用 "发送脚本" 旁小三角内菜单内 "同步目录" 按钮进行触发单向同步目录操作．
• 当选择 "根目录" 相对的 "\1ferver\lua\scripts\" 文件夹下项目脚本时(以"项目:"为开头的选择脚本的结构)， "发送脚本" 按钮即改为 "同步文件" 此时点击也可以触发单向同步目录操作．
• 当点击发送脚本旁小三角内的同步目录后，此目录会和设备端的 "/1ferver" 目录进行同步，同步以中控端的结构为准．
• 同步规则如下：

CC.mdb文件 详解

• 数据库是Access 数据库(如无操作过数据库经验不推荐折腾)．
• 表结构需要以第一项"ID"为递增值，其他项为字符串（长度限制255）．
• 以下是操作数据库的相关介绍．

config.ini文件 详解

• 根据自己需要进行调整．
• 新版中控默认会隐藏数据表("[Hide] Db_Tab=true")．

[Hide]
Db_Tab=true
;用于隐藏数据表
API_Tab=false
;用于隐藏API表
MadeUI_Tab=false
;用于隐藏UI制作
UI=false
;用于隐藏UI功能

API文档解释

CC.log('日志列展示内容')
CC.log(
    {
        ['列标题'] = '对应内容'
    }
)

CC.web_file.update_file('timg.jpg','/User/Media/1ferver/res/timg.jpg')

CC.web_file.down_file('timg.jpg','/User/Media/1ferver/res/timg.jpg')

CC.web_file.take_line('1.txt')

info = CC.web_file.exists('1.txt')

success = CC.web_file.delete('1.txt')

list  = CC.web_file.list('文件夹1')

fsize = CC.web_file.size('1.txt')

data = CC.web_file.reads('1.txt')

success = CC.web_file.writes('1.txt', '测试写入')

success = CC.web_file.appends('1.txt', '测试写入')

linecount = CC.web_file.line_count('1.txt')

line = CC.web_file.get_line('1.txt', 2)

success = CC.web_file.set_line('1.txt', 2, '123123')

success = CC.web_file.insert_line('1.txt', 2, '123123')

success = CC.web_file.get_lines('1.txt', 2)

lines = CC.web_file.get_lines('1.txt')

success = CC.web_file.appends('1.txt', 2, {'被插入的内容'})

info = CC.web_directory.exists("文件夹1")

success = CC.web_directory.create("文件夹1")

success = CC.web_directory.delete("文件夹1")

local data = CC.getui()
local config = json.decode(data)

v = CC.db.add(              
    '账号表',
    {
        {
            ['账号']='新添加项目aaaaa',
            ['密码']='test',
            ['区']='test233'
        }
    }
)
nLog(json.encode(v))
if v[1].state then
    --添加成功
end

v = CC.db.del(
    '账号表',
    {
        {
            ['id'] = 6      --删除id为6的项
        }
    }
)
nLog(json.encode(v))
if v[1].state then
    --删除成功
end

v = CC.db.edit(
    '账号表',
    {
        {                   --修改 id为8项的 密码 成 xxxxxxxxxx
            ['id'] = 8,
            ['密码'] = 'xxxxxxxxxx'
        }
    }
)
nLog(json.encode(v))
if v[1] then
    --账号内容 v[1]
end

v = CC.db.list(
    '账号表',
    {
        {
            ['账号'] = '新添加项目'
        }
    }
)
sys.alert(json.encode(v))

v = CC.db.get(
    '账号表',
    {
        {                   --以此要求索引
            ['密码']='test'
        },
        {                   --索引完毕后及时改掉
            ['密码']='test1'
        }
    }
)
--获取 密码为 test 的一项 并 把密码 改为 test1
--CC.db.get(db,{{过滤要求},{获取后修改为}})
nLog(json.encode(v))
if v[1] then
    --账号内容 v[1]
end

中控通讯API基础库

• 储存以下内容为"CC.lua"以"UTF-8"格式至"/var/mobile/Media/1ferver/lua"目录下
• 删掉最后一句 "return CC" 可嵌入脚本头部

local CC = {}
do
    server_ip = ''
    server_port = 0
    log_list = {}
    local post = function(_mode, mode, data)
        while true do
            local code, header, body = http.post(
                    string.format(
                        'http://%s:%s/%s/%s',
                        server_ip, server_port, _mode, mode
                    ),30,{},((type(data) == 'table' and json.encode(data)) or data)
                )
            if code == 200 then
                return ((type(json.decode(body) == 'table') and json.decode(body)) or body)
            elseif code ~= -1 then
                sys.toast('中控异常提示:' .. body)
            else
                sys.toast('中控访问超时')
            end
        end
    end
    local encodeURI = function(s)
        return string.gsub(string.gsub(s, '([^%w%.%- ])', function(c) return string.format('%%%02X', string.byte(c)) end), ' ', '+')
    end
    local send_cc = function(db,m,t)
        local r = post('db', m, json.encode({db=db, data=t}))
        if r.state == 0 then return r.data;else sys.alert(r.message,5);return r.data;end
    end
    CC.set_server_ip = function(...)
        local ip_list = {}
        if type(select(1,...)) == 'table' then
            ip_list = select(1, ...)
        elseif type(select(1,...)) == 'string' then
            ip_list = {select(1, ...)}
        else
            error('提交的服务器IP不正确',2)
        end
        server_port = select(2, ...) or 27010
        local socket = require('socket')
        local s = socket.tcp()
        s:settimeout(2)
        for k,v in ipairs(ip_list) do
            local s = socket.tcp()
            s:settimeout(2)
            if s:connect(string.format('%s',v), server_port) == 1 then
                server_ip = v
            end
        end
        if server_ip == '' then
            error('尝试提交的列表中未找到可连接的中控服务',2)
        end
    end
    CC.set_sever_ip = CC.set_server_ip
    CC.log = function(t)
        if type(t) == 'string' then
            log_list['日志'] = t
        elseif type(t) == 'table' then
            for key, value in pairs(t) do
                log_list[key] = value
            end
        end
        http.post(
            string.format(
                'http://%s:%s/log',
                server_ip,
                server_port
            ),
            5,
            {},
            json.encode(log_list)
        )
    end
    CC.getui = function()
        while true do
            local r = {http.get(string.format('http://%s:%s/getui', server_ip, server_port))}
            if r[1] == 200 then return json.decode(r[3]) end
            sys.sleep(2)
            sys.toast('中控访问超时')
        end
    end
    CC.db = {
        add = (function(db,t)
            return send_cc(db,'add',t)
        end),
        del = (function(db,t)
            return send_cc(db,'del',t)
        end),
        edit = (function(db,t)
            return send_cc(db,'edit',t)
        end),
        get = (function(db,t)
            return send_cc(db,'get',t)
        end),
        list = (function(db,t)
            return send_cc(db,'list',t or {})
        end)
    }
    CC.web_file = {
        take_line = (function(path)
            return post('file','take_line',{path=path}).data
        end),
        exists = function(path)
            local r = post('file','exists',{path=path})
            if type(r.info) == 'userdata' then
                return false
            else
                return r.info
            end
        end,
        list = (function(path)
            return post('file','list',{path=path}).list
        end),
        size = (function(path)
            return post('file','size',{path=path}).fsize
        end),
        delete = (function(path)
            return post('file','delete',{path=path}).success
        end),
        reads = (function(path)
            local r = post('file','reads',{path=path})
            if r.success then
                return r.data:base64_decode()
            else
                return nil
            end
        end),
        writes = (function(path,data)
            return post('file','writes',{path=path,data=data:base64_encode()}).success
        end),
        appends = (function(path,data)
            return post('file','appends',{path=path,data=data:base64_encode()}).success
        end),
        line_count = (function(path)
            return post('file','line_count',{path=path}).linecount
        end),
        get_line = (function(path,line_number)
            return post('file','get_line',{path=path,line_number=line_number}).line
        end),
        set_line = (function(path,line_number,data)
            return post('file','set_line',{path=path,line_number=line_number,data=data}).success
        end),
        insert_line = (function(path,line_number,data)
            return post('file','insert_line',{path=path,line_number=line_number,data=data}).success
        end),
        remove_line = (function(path,line_number)
            return post('file','remove_line',{path=path,line_number=line_number}).success
        end),
        get_lines = (function(path)
            return post('file','get_lines',{path=path}).lines
        end),
        insert_lines = (function(path,line_number,lines)
            return post('file','insert_lines',{path=path,line_number=line_number,lines=lines}).success
        end),
        update_file = (function(file,path)
            local f, err = io.open(path,'rb')
            if not f then error(err,2) end
            local s = f:read('*a')
            f:close()
            return post('file-byte','update?file=' .. encodeURI(file), s) == 'ok'
        end),
        down_file = (function(file,path)
            local code, header, body
            while true do
                code, header, body = http.get('http://' .. server_ip .. ':' .. server_port .. '/file-byte/down?file=' .. encodeURI(file),30,{})
                if code == 200 or code == 404 then break end
            end
            if code == 404 then
                error('文件不存在',2)
            else
                local f = io.open(path,'wb')
                f:write(body)
                f:close()
                return true
            end
        end),
    }
    CC.web_directory = {
        exicts = function(path)
            local r = post('directory','exicts',{path=path})
            if type(r.info) == 'userdata' then
                return false
            else
                return r.info
            end
        end,
        exists = function(path)
            local r = post('directory','exists',{path=path})
            if type(r.info) == 'userdata' then
                return false
            else
                return r.info
            end
        end,
        create = (function(path)
            return post('directory','create',{path=path}).success
        end),
        delete = (function(path,data)
            return post('directory','delete',{path=path}).success
        end),
    }
end
return CC

示例与实例

发现设备

• 让设备闪光灯以及屏幕进行闪烁，并发出声音。
• 此功能主要用于在大批设备中进行定位设备的位置。

now_screen_level=device.brightness();____lalala____={}setmetatable(____lalala____,{__gc=function()webview.destroy();device.set_brightness(now_screen_level);end});device.unlock_screen();device.set_brightness(1);device.set_volume(1);for i=0,25 do;if i%2==0 then;device.vibrator();webview.show{};device.flash_on();else;webview.hide();device.flash_off();end;if i%15==0 then;device.play_sound('/System/Library/Audio/UISounds/sms-received3.caf');end;sys.msleep(200);end

数据库的简单展示

• 设备写入数据库、获取数据库数据、删除数据库数据。

local CC = require('CC')
do
    local args = ((proc_take('spawn_args') ~= "") and proc_take('spawn_args')) or proc_take('CC_args')
    proc_put('spawn_args', args);proc_put('CC_args', args)
    local _, args_json = pcall(json.decode, args)
    if _ and type(args_json) == 'table' then
        CC.set_server_ip(
            args_json['server_ip'],
            args_json['server_port']
        )
    else
        error('请检测启动参数')
    end
end
CC.log({['脚本'] = "数据库访问"})
CC.log('开始操作')
-- 添加10条数据
for i = 1, 10 do
    local v = CC.db.add(
        '账号表',
        {
            {['账号'] = '测试用的内容 ' .. i .. ' ' .. device.name(), ['密码'] = '假装有内容' .. i, ['区'] = '实际没卵用'}
        }
    )
    if v[1].state then
        CC.log({['添加账号'] = '测试用的内容 ' .. i .. ' ' .. device.name()})
    else
        CC.log('数据库添加失败')
    end
    sys.sleep(1)
end
CC.log({['添加账号'] = ''})
while true do
    local v = CC.db.get('账号表', {{['区'] = '实际没卵用'}, {['区'] = '万一有点用呢'}})
    if #v == 0 then
        break
    else
        CC.log({['得到账号'] = v[1]['账号']})
    end
    sys.sleep(1)
end
CC.log('结束操作')