Auto.js 接入 | 泡椒云网络验证系统文档
# Auto.js 接入
泡椒云网络验证提供了官方的 Autojs 封装库,方便 Autojs 开发者接入。
# 接入须知
# 获取方式
下载地址:https://paojiaoyun.lanzous.com/b015bkd1c
或者加群1018871394在群文件下载SDK,有问题也可在此群交流。
# 使用方式
先将下载到的PJYSDK.js文件用编辑器打开,选中所有复制粘贴到你自己的main.js代码文件中。
一个示例:
/* 将PJYSDK.js文件中的代码复制粘贴到上面 */ // 初始化 // AppKey 和 AppSecret 在泡椒云开发者后台获取 let pjysdk = new PJYSDK('bnsekoso6itblafodqe6', 'm3p0lkODcCUpyf3o6DkktAQSJqqLygeV'); pjysdk.debug = true; // 开发时建议开启debug,有详细输出 pjysdk.SetCard('IWPSJKeEeMaHb7dXZVVSb42SLUUWIPAMBHaAWKLO'); // 监听心跳失败事件 pjysdk.event.on('heartbeat_failed', function(hret) { log('心跳失败,尝试重登...') sleep(2000); let login_ret = pjysdk.CardLogin(); if (login_ret.code == 0) { log('重登成功'); } else { toastLog(login_ret.message); // 重登失败 sleep(200); exit(); // 退出脚本 } }); // 当脚本正常或者异常退出时会触发exit事件 events.on('exit', function(){ pjysdk.CardLogout(); // 调用退出登录 log('结束运行'); }); // 卡密登录 // 登录成功后将自动启动一个线程发送心跳包,开发者只需监听心跳失败事件做处理就行了 let login_ret = pjysdk.CardLogin(); if (login_ret.code == 0) { // 登录成功,后面写你的业务代码 } else { toast(login_ret.message); // 登录失败的提示信息 }2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
# 可更改变量
pjysdk.debug: bool型,默认为true,开启后会在控制台输出每次请求的详细信息,方便调试pjysdk._device_id: string型,设备号默认会自动获取,不建议修改。如果你有更好的一机一码的生成方案,可在初始化后修改该值
# 可获取变量
注意
以下变量都为登录成功后才能取到值的。
pjysdk.login_result.card_type: 卡密类型,例如:年卡pjysdk.login_result.expires: 过期时间,例如:2020-10-16 00:47:58pjysdk.login_result.expires_ts: 过期时间戳,例如:1602780478pjysdk.login_result.config: 卡密或用户配置,开发者可通过接口自定义的pjysdk.is_trial: 是否是试用登录
# 初始化
# 初始化卡密
# 语法
pjysdk.SetCard(card)
# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| card | 是 | string | 用户填写的卡密(长度不超过45位) |
# 初始化用户账号
# 语法
pjysdk.SetUser(username, password)# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| username | 是 | string | 用户名(长度不能超过20位) |
| password | 是 | string | 用户密码(长度6-30位) |
# 获取时间戳(网络时间)
# 语法
let ret = pjysdk.getTimestamp()
# 参数
无
# 返回值
数字类型,例:1602780478
# 获取心跳结果
# 语法
let ret = pjysdk.GetHeartbeatResult()# 参数
无
# 返回值
Object类型,例:{'code': 0, 'message': 'ok'}
# 获取剩余时长
# 语法
let ret = pjysdk.GetTimeRemaining()
# 参数
无
# 返回值
数字类型,剩余多少秒,例:1024
# 卡密登录
注意
调用此接口前需调用 pjysdk.SetCard(card) 初始化卡密
登录成功后将自动启动一个线程发送心跳包,开发者就无需关注发送心跳包的细节。
开发者只需在自己的脚本中通过调用 pjysdk.GetHeartbeatResult() 获取当前心跳结果。
# 语法
let ret = pjysdk.CardLogin()# 参数
无
# 返回值
Object类型,例:参考接口返回
# 卡密退出登录
# 语法
let ret = pjysdk.CardLogout()
# 参数
无
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 卡密解绑设备
说明
请先进入开发者后台软件管理页面,配置软件开启设备绑定且可解除绑定。
该接口只能在卡密登录成功后调用。
# 语法
let ret = pjysdk.CardUnbindDevice()# 参数
无
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 卡密充值(以卡充卡)
# 语法
let ret = pjysdk.CardRecharge(card, use_card)
# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| card | 是 | string | 被充值的卡密(长度不超过45位) |
| use_card | 是 | string | 充值使用的卡密(长度不超过45位) |
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 用户注册(通过卡密)
# 语法
let ret = pjysdk.UserRegister(username, password, card)# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| username | 是 | string | 用户名(长度不能超过20位) |
| password | 是 | string | 用户密码(长度6-30位) |
| card | 是 | string | 注册使用的卡密(长度不超过45位) |
# 返回值
Object类型,例:{'code': 0, 'message': 'ok'}
# 用户登录
注意
调用此接口前需调用 pjysdk.SetUser(username, password) 初始化用户账号密码
登录成功后将自动启动一个线程发送心跳包,开发者就无需关注发送心跳包的细节。
开发者只需在自己的脚本中通过调用 pjysdk.GetHeartbeatResult() 获取当前心跳结果。
# 语法
let ret = pjysdk.UserLogin()
# 参数
无
# 返回值
Object类型,例:参考接口返回
# 用户退出登录
# 语法
let ret = pjysdk.UserLogout()# 参数
无
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 用户修改密码
# 语法
let ret = pjysdk.UserChangePassword(username, password, new_password)
# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| username | 是 | string | 用户名(长度不能超过20位) |
| password | 是 | string | 当前密码(长度6-30位) |
| new_password | 是 | string | 新密码(长度6-30位) |
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 用户充值(通过卡密)
# 语法
let ret = pjysdk.UserRecharge(username, card)# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| username | 是 | string | 用户名(长度不能超过20位) |
| card | 是 | string | 充值使用的卡密(长度不超过45位) |
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 获取卡密配置
# 语法
let ret = pjysdk.GetCardConfig()
# 参数
无
# 返回值
Object类型,例:参考接口返回
# 更改卡密配置
# 语法
let ret = pjysdk.UpdateCardConfig(config)# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| config | 是 | string | 自定义配置(长度不能超过512位) |
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 获取用户配置
# 语法
let ret = pjysdk.GetUserConfig()
# 参数
无
# 返回值
Object类型,例:参考接口返回
# 更改用户配置
# 语法
let ret = pjysdk.UpdateUserConfig(config)# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| config | 是 | string | 自定义配置(长度不能超过512位) |
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 获取软件配置
# 语法
let ret = pjysdk.GetSoftwareConfig()
# 参数
无
# 返回值
Object类型,例:参考接口返回
# 获取软件公告
# 语法
let ret = pjysdk.GetSoftwareNotice()# 参数
无
# 返回值
Object类型,例:参考接口返回
# 获取软件最新版本
# 语法
let ret = pjysdk.GetSoftwareLatestVersion(current_ver)
# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| current_ver | 是 | string | 当前本地的版本(长度不能超过30位) |
# 返回值
Object类型,例:参考接口返回
# 试用登录
注意
登录成功后将自动启动一个线程发送心跳包,开发者就无需关注发送心跳包的细节。
只需在自己的脚本中通过调用 pjysdk.GetHeartbeatResult() 获取当前心跳结果。
# 语法
let ret = pjysdk.TrialLogin()# 参数
无
# 返回值
Object类型,例:参考接口返回
# 试用退出登录
# 语法
let ret = pjysdk.TrialLogout()
# 参数
无
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 卡密解绑设备
注意
只能在卡密登录后调用。更多说明
# 语法
let ret = pjysdk.CardUnbindDevice()# 参数
无
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 卡密设置解绑密码
说明
请先进入开发者后台软件管理页面,配置软件开启设备绑定且可解除绑定。
该密码用于绑定设备丢失或者其它原因导致无法在老设备登录时解绑设备。
# 语法
let ret = pjysdk.SetCardUnbindPassword(password)
# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| password | 是 | string | 解绑密码(6-10位数字和字母组合的字符串) |
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 卡密通过密码解绑设备
说明
请先进入开发者后台软件管理页面,配置软件开启设备绑定且可解除绑定。
该接口用于绑定设备丢失或者其它原因导致无法在老设备登录时,通过解绑密码解绑设备。
# 语法
let ret = pjysdk.CardUnbindDeviceByPassword(password)# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| password | 是 | string | 解绑密码(6-10位数字和字母组合的字符串) |
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 用户解绑设备
注意
只能在用户登录后调用。更多说明
# 语法
let ret = pjysdk.UserUnbindDevice()
# 参数
无
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 获取远程变量
# 语法
let ret = pjysdk.GetRemoteVar(key)# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| key | 是 | string | 远程变量名(长度不能超过64位) |
# 返回值
Object类型,例:参考接口返回
# 获取远程数据
# 语法
let ret = pjysdk.GetRemoteData(key)
# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| key | 是 | string | 远程数据key(长度不能超过64位) |
# 返回值
Object类型,例:参考接口返回
# 操作远程数据
# 新增远程数据
# 语法
let ret = pjysdk.CreateRemoteData(key, value)# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| key | 是 | string | 远程数据key(长度不能超过64位) |
| value | 是 | string | 远程数据值(长度不能超过256位) |
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 修改远程数据
# 语法
let ret = pjysdk.UpdateRemoteData(key, value)
# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| key | 是 | string | 远程数据key(长度不能超过64位) |
| value | 是 | string | 远程数据值(长度不能超过256位) |
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 删除远程数据
# 语法
let ret = pjysdk.DeleteRemoteData(key)# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| key | 是 | string | 远程数据key(长度不能超过64位) |
# 返回值
Object类型,例:{'code': 0, 'message': 'OK'}
# 调用远程函数
# 语法
let ret = pjysdk.CallRemoteFunc(func_name, params)
# 示例
远程函数为:
function add(a, b) { return a + b; }2
3
脚本中调用:
let ret = pjysdk.CallRemoteFunc('add', [1, 2])
if (ret.code == 0) {
log(ret.result.return);
} else {
log(ret.message);
}
2
3
4
5
6
# 参数
| 参数名 | 必传 | 类型 | 参数说明 |
|---|---|---|---|
| func_name | 是 | string | 远程函数名(长度不能超过64位) |
| params | 是 | array | 参数列表,例:Array(1, 2) |
# 返回值
Object类型,例:{'code': 0, 'message': 'OK', 'result': {'return': 3}}
