# EasyClick 快速接入

泡椒云网络验证提供了官方的 EasyClick 封装库,方便 EasyClick 开发者接入。

# 接入须知

# 获取方式

下载地址:https://paojiaoyun.lanzoui.com/b01695eta 密码:cxu5
或者加群1018871394在群文件下载SDK,有问题也可在此群交流。

# 使用方式

将下载到的PJYSDK.js放在你的工程目录下,也就是main.js同目录。

# 视频教程

一个main.js示例:

// AppKey 和 AppSecret 在泡椒云开发者后台获取
let pjysdk = new PJYSDK("AppKey", "AppSecret");
pjysdk.debug = true;
pjysdk.SetCard("卡密");

// 心跳失败回调
pjysdk.onHeartbeatFailed(function(hret) {
    logd(hret.message)
    if (hret.code === 10214) {
        sleep(200);
        exit();  // 退出脚本
    }
    logd("心跳失败,2s后尝试重登...");
    sleep(2000);
    let login_ret = pjysdk.CardLogin();
    if (login_ret.code === 0) {
        logd("重登成功");
    } else {
        logd(login_ret.message);  // 重登失败
        sleep(200);
        exit();  // 退出脚本
    }
});

setStopCallback(function() {
    pjysdk.CardLogout(); // 调用退出登录
    logd("结束运行");
});
setExceptionCallback(function(msg) {
    pjysdk.CardLogout(); // 调用退出登录
    logd(" 异常停止消息: "+msg);
});

function main() {
    let login_ret = pjysdk.CardLogin();
    if (login_ret.code !== 0) {
        // 登录失败提示
        toast(login_ret.message);
    }
    // 登录成功,后面写你的业务代码
    logd(JSON.stringify(pjysdk.login_result, null, "    "))

    // 测试用,hold住主线程不要退出,记得删除,后面应该是你的代码了
    while (true) {
        let ret = pjysdk.GetHeartbeatResult();
        logd("心跳结果: " + ret.code + " " + ret.message);
        // toast(ret.code + " " + ret.message);
        sleep(2000);
    }
}

main();
1
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
43
44
45
46
47
48
49
50
51
52

# 可更改变量

  • pjysdk.debug : bool型,默认为true,开启后会在控制台输出每次请求的详细信息,方便调试
  • pjysdk._device_id : string型,设备号默认会自动获取,不建议修改。如果你有更好的一机一码的生成方案,可在初始化后修改该值
  • pjysdk._auto_heartbeat : bool型,是否自动开启心跳,默认true,不建议修改。

# 可获取变量

注意

以下变量都为登录成功后才能取到值的。

  • pjysdk.login_result.card_type : 卡密类型,例如:年卡
  • pjysdk.login_result.expires : 过期时间,例如:2020-10-16 00:47:58
  • pjysdk.login_result.expires_ts : 过期时间戳,例如:1602780478
  • pjysdk.login_result.config : 卡密或用户配置,开发者可通过接口自定义的
  • pjysdk.is_trial : 是否是试用登录

# 初始化

# 初始化卡密

# 语法

pjysdk.SetCard(card)
1

# 参数

参数名 必传 类型 参数说明
card string 用户填写的卡密(长度不超过45位)

# 初始化用户账号

# 语法

pjysdk.SetUser(username, password)
1

# 参数

参数名 必传 类型 参数说明
username string 用户名(长度不能超过20位)
password string 用户密码(长度6-30位)

# 获取时间戳(网络时间)

# 语法

let ret = pjysdk.getTimestamp()
1

# 参数

# 返回值

数字类型,例:1602780478

# 获取心跳结果

# 语法

let ret = pjysdk.GetHeartbeatResult()
1

# 参数

# 返回值

Object类型,例:{"code": 0, "message": "ok"}

# 获取剩余时长

# 语法

let ret = pjysdk.GetTimeRemaining()
1

# 参数

# 返回值

数字类型,剩余多少秒,例:1024

# 卡密登录

注意

调用此接口前需调用 pjysdk.SetCard(card) 初始化卡密
登录成功后将自动启动一个线程发送心跳包,开发者就无需关注发送心跳包的细节。
开发者只需在自己的脚本中通过调用 pjysdk.GetHeartbeatResult() 获取当前心跳结果。

# 语法

let ret = pjysdk.CardLogin()
1

# 参数

# 返回值

Object类型,例:参考接口返回

# 卡密退出登录

# 语法

let ret = pjysdk.CardLogout()
1

# 参数

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 卡密解绑设备

注意

请先进入开发者后台软件管理页面,配置软件开启设备绑定且可解除绑定。
该接口只能在卡密登录后调用。更多说明

# 语法

let ret = pjysdk.CardUnbindDevice()
1

# 参数

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 卡密设置解绑密码

说明

请先进入开发者后台软件管理页面,配置软件开启设备绑定且可解除绑定。
该密码用于绑定设备丢失或者其它原因导致无法在老设备登录时解绑设备。

# 语法

let ret = pjysdk.SetCardUnbindPassword(password)
1

# 参数

参数名 必传 类型 参数说明
password string 解绑密码(6-10位数字和字母组合的字符串)

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 卡密通过密码解绑设备

说明

请先进入开发者后台软件管理页面,配置软件开启设备绑定且可解除绑定。
该接口用于绑定设备丢失或者其它原因导致无法在老设备登录时,通过解绑密码解绑设备。

# 语法

let ret = pjysdk.CardUnbindDeviceByPassword(password)
1

# 参数

参数名 必传 类型 参数说明
password string 解绑密码(6-10位数字和字母组合的字符串)

# 返回值

Object类型,例:{"code": 0, "message": "OK"}
只能在卡密登录后调用。更多说明 :::

# 语法

let ret = pjysdk.CardUnbindDevice()
1

# 参数

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 卡密设置解绑密码

说明

请先进入开发者后台软件管理页面,配置软件开启设备绑定且可解除绑定。
该密码用于绑定设备丢失或者其它原因导致无法在老设备登录时解绑设备。

# 语法

let ret = pjysdk.SetCardUnbindPassword(password)
1

# 参数

参数名 必传 类型 参数说明
password string 解绑密码(6-10位数字和字母组合的字符串)

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 卡密通过密码解绑设备

说明

请先进入开发者后台软件管理页面,配置软件开启设备绑定且可解除绑定。
该接口用于绑定设备丢失或者其它原因导致无法在老设备登录时,通过解绑密码解绑设备。

# 语法

let ret = pjysdk.CardUnbindDeviceByPassword(password)
1

# 参数

参数名 必传 类型 参数说明
password string 解绑密码(6-10位数字和字母组合的字符串)

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 卡密充值(以卡充卡)

# 语法

let ret = pjysdk.CardRecharge(card, use_card)
1

# 参数

参数名 必传 类型 参数说明
card string 被充值的卡密(长度不超过45位)
use_card string 充值使用的卡密(长度不超过45位)

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 用户注册(通过卡密)

# 语法

let ret = pjysdk.UserRegister(username, password, card)
1

# 参数

参数名 必传 类型 参数说明
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()
1

# 参数

# 返回值

Object类型,例:参考接口返回

# 用户退出登录

# 语法

let ret = pjysdk.UserLogout()
1

# 参数

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 用户修改密码

# 语法

let ret = pjysdk.UserChangePassword(username, password, new_password)
1

# 参数

参数名 必传 类型 参数说明
username string 用户名(长度不能超过20位)
password string 当前密码(长度6-30位)
new_password string 新密码(长度6-30位)

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 用户充值(通过卡密)

# 语法

let ret = pjysdk.UserRecharge(username, card)
1

# 参数

参数名 必传 类型 参数说明
username string 用户名(长度不能超过20位)
card string 充值使用的卡密(长度不超过45位)

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 用户解绑设备

注意

只能在用户登录后调用。更多说明

# 语法

let ret = pjysdk.UserUnbindDevice()
1

# 参数

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 试用登录

注意

登录成功后将自动启动一个线程发送心跳包,开发者就无需关注发送心跳包的细节。
只需在自己的脚本中通过调用 pjysdk.GetHeartbeatResult() 获取当前心跳结果。

# 语法

let ret = pjysdk.TrialLogin()
1

# 参数

# 返回值

Object类型,例:参考接口返回

# 试用退出登录

# 语法

let ret = pjysdk.TrialLogout()
1

# 参数

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 获取卡密配置

# 语法

let ret = pjysdk.GetCardConfig()
1

# 参数

# 返回值

Object类型,例:参考接口返回

# 更改卡密配置

# 语法

let ret = pjysdk.UpdateCardConfig(config)
1

# 参数

参数名 必传 类型 参数说明
config string 自定义配置(长度不能超过512位)

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 获取用户配置

# 语法

let ret = pjysdk.GetUserConfig()
1

# 参数

# 返回值

Object类型,例:参考接口返回

# 更改用户配置

# 语法

let ret = pjysdk.UpdateUserConfig(config)
1

# 参数

参数名 必传 类型 参数说明
config string 自定义配置(长度不能超过512位)

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 获取软件配置

# 语法

let ret = pjysdk.GetSoftwareConfig()
1

# 参数

# 返回值

Object类型,例:参考接口返回

# 获取软件公告

# 语法

let ret = pjysdk.GetSoftwareNotice()
1

# 参数

# 返回值

Object类型,例:参考接口返回

# 获取软件最新版本

# 语法

let ret = pjysdk.GetSoftwareLatestVersion(current_ver)
1

# 参数

参数名 必传 类型 参数说明
current_ver string 当前本地的版本(长度不能超过30位)

# 返回值

Object类型,例:参考接口返回

# 获取远程变量

# 语法

let ret = pjysdk.GetRemoteVar(key)
1

# 参数

参数名 必传 类型 参数说明
key string 远程变量名(长度不能超过64位)

# 返回值

Object类型,例:参考接口返回

# 获取远程数据

# 语法

let ret = pjysdk.GetRemoteData(key)
1

# 参数

参数名 必传 类型 参数说明
key string 远程数据key(长度不能超过64位)

# 返回值

Object类型,例:参考接口返回

# 操作远程数据

# 新增远程数据

# 语法

let ret = pjysdk.CreateRemoteData(key, value)
1

# 参数

参数名 必传 类型 参数说明
key string 远程数据key(长度不能超过64位)
value string 远程数据值(长度不能超过256位)

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 修改远程数据

# 语法

let ret = pjysdk.UpdateRemoteData(key, value)
1

# 参数

参数名 必传 类型 参数说明
key string 远程数据key(长度不能超过64位)
value string 远程数据值(长度不能超过256位)

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 删除远程数据

# 语法

let ret = pjysdk.DeleteRemoteData(key)
1

# 参数

参数名 必传 类型 参数说明
key string 远程数据key(长度不能超过64位)

# 返回值

Object类型,例:{"code": 0, "message": "OK"}

# 调用远程函数

# 语法

let ret = pjysdk.CallRemoteFunc(func_name, params)
1

# 示例

远程函数为

function add(a, b) {
  return a + b;
}
1
2
3

脚本中调用

let ret = pjysdk.CallRemoteFunc("add", [1, 2])
if (ret.code == 0) {
  log(ret.result.return);
} else {
  log(ret.message);
}
1
2
3
4
5
6

# 参数

参数名 必传 类型 参数说明
func_name string 远程函数名(长度不能超过64位)
params array 参数列表,例:Array(1, 2)

# 返回值

Object类型,例:{"code": 0, "message": "OK", "result": {"return": 3}}