lock/unlock 锁定或解锁 TC 控制界面

函数功能：

在一定时间内锁定该手机的 TC 控制界面，防止用户在执行脚本时误操作手机。该设备的控制窗口会在超过锁定时间后自动解锁。
解锁已经锁定的手机的 TC 控制界面。

对应JS API:

lock(timeout)
unlock()

是否支持多设备：

支持 (如何使用 REST API 同时控制多台设备请看这里 )

请求方式：POST

http://IP:8090/TotalControl/v1/devices/:device?token=:token&lock=:lock&timeout=:timeout

参数说明：

响应参数：

Total Control 提供的 REST API 响应格式都是 JSON ,返回值通常由关键字 "status" 和 "value" 组成，
status: 接口执行成功与否
value: 执行接口的返回信息

（一）执行接口成功的返回字段说明

返回示例:

{
    "status":true,
    "value":""
}

（二）执行接口返回 HTTP 状态码为 200，但是结果有误的返回字段说明

返回示例:

{
    "status":null,
    "value":"......"
}

请求示例：

//示例一
http://127.0.0.1:8090/TotalControl/v1/devices/device@1116106541?token=270eq7lXQK8bXYsJ&lock=true&timeout=60000  

//示例二
http://127.0.0.1:8090/TotalControl/v1/devices/device@1116106541
{
    "token":"270eq7lXQK8bXYsJ",
    "lock":true,
    "timeout":60000
}

示例：锁定 TC 控制界面 60000ms

注意：下列示例是通过本机访问 Total Control 服务器，所以 IP 都是用的 "localhost"。

RingoJS 请求示例：

可以复制下面的代码，在 Total Control 的脚本终端中执行，也可以保存为后缀为 js 的文件, 例如:example.js，在Total Control 执行器中执行。

//导入一些 ringoJS 的包
var {request} = require('ringo/httpclient');
var base64 = require('ringo/base64');
//将用户名密码编码，'sigma:3D391497'是用户名和密码,在Total Control系统设置里面可以看到
var userpass = base64.encode('sigma:3D391497');

//第一步：获取 Total Control 脚本开发所用的开发 token
var gettoken = request({
    method: 'GET',
    url: 'http://localhost:8090/TotalControl/v1/login',
    headers: {'Authorization': userpass}
	});
//将获取的响应内容转换成json对象
var ret_token = eval('(' + gettoken.content + ')'); 
var token = ret_token.value.token; 
print("//获取 token 的值为：" + token);

//第二步：获取当前主控设备 ID 值
var getdevice = request({
    method: 'GET',
    url: 'http://localhost:8090/TotalControl/v1/devices/main?token=' + token
	});
var device = eval('(' + getdevice.content + ')').id; 
print("//获取到设备的 ID："+ device);

//第三步：锁定或解锁 TC 控制界面
var ret = request({
    method: 'POST',
    url: 'http://localhost:8090/TotalControl/v1/devices/'+ device,
    data: {
	"token": token,
	"lock":true,
	"timeout":60000
	}
	});
print(ret.content);

RingoJS 示例运行结果：

成功，则返回:

//获取 token 的值为：m195zZEgY91PMcbo
//获取到设备的 ID：device@230441652
{
    "status":true,
    "value":""
}

易语言请求示例：

温馨提示,关于易语言的更多信息，请看：
如何安装易语言
学写第一个易语言程序
如何使用易语言控制一台设备
如何使用易语言控制多台设备

.版本 2

.程序集 窗口程序集_启动窗口

.子程序 __启动窗口_创建完毕
.局部变量 base64, 文本型
.局部变量 token, 文本型
.局部变量 device, 文本型
.局部变量 j_token, 类_json, , , 用来解析获取 token 的 json
.局部变量 j_dev, 类_json, , , 用来解析获取设备ID 值的 json
.局部变量 j_ret, 类_json, , , 用来解析 REST API 接口的json
.局部变量 bool, 逻辑型
.局部变量 bool_dev, 逻辑型
.局部变量 bool_ret, 逻辑型
.局部变量 status, 文本型


base64 ＝ 到文本 (编码_BASE64编码 (到字节集 (“sigma:3D391497”)))
输出调试文本 (“将用户名和密码组装成 sigma:3D391497 进行 base64 编码生成的字符串为： ” ＋ base64)
bool ＝ j_token.解析 (到文本 (网页_访问_对象 (“http://localhost:8090/TotalControl/v1/login”, 0, , , , “Authorization:” ＋ base64, , , , , , , , , )))
.如果 (bool)
    输出调试文本 (“第一步，获取 token，返回值为：” ＋ j_token.取数据文本 ())
    token ＝ j_token.取通用属性 (“['value'].token”)
    输出调试文本 (“获取的 token 值为： ” ＋ token)
    bool_dev ＝ j_dev.解析 (编码_utf8到gb2312 (到文本 (网页_访问_对象 (“http://localhost:8090/TotalControl/v1/devices/main?token=” ＋ token, 0))))
    .如果 (bool_dev)
        输出调试文本 (“第二步，获取设备 ID 值，返回值为：” ＋ j_dev.取数据文本 ())
        device ＝ j_dev.取通用属性 (“['id']”)
        输出调试文本 (“获取的设备 ID 值为： ” ＋ device)
        bool_ret ＝ j_ret.解析 (编码_utf8到gb2312 (到文本 (网页_访问_对象 (“http://localhost:8090/TotalControl/v1/devices/” ＋ device ＋ “?lock=true&timeout=60000&token=” ＋ token, 1))))
        .如果 (bool_ret)

            输出调试文本 (“第三步，锁定或解锁 TC 控制界面，返回值为： ” ＋ j_ret.取数据文本 ())
            status ＝ j_ret.取属性对象 (“status”)
            .如果 (status ＝ “true”)
                输出调试文本 (“恭喜你，成功了！”)
            .否则
                输出调试文本 (“不好意思，失败了！”)
            .如果结束

        .否则
            输出调试文本 (“该 API 执行失败”)
        .如果结束

    .否则
        输出调试文本 (“获取设备 ID 值失败”)
    .如果结束


.否则
    输出调试文本 (“获取 token 失败”)
.如果结束

易语言代码运行结果：

成功，则返回:

* 将用户名和密码组装成 sigma:3D391497 进行 base64 编码生成的字符串为： c2lnbWE6M0QzOTE0OTc=
* 第一步，获取 token，返回值为：{"status":true,"value":{"token":"U56adwI779838M6F"}}
* 获取的 token 值为： U56adwI779838M6F
* 第二步，获取设备 ID 值，返回值为：{"id":"device@230441652"}
* 获取的设备 ID 值为： device@230441652
* 第三步，锁定或解锁 TC 控制界面，返回值为： {"status":true, "value":""}
* 恭喜你，成功了！