IOSUSB版例子V4.6
# 对接步骤
## 步骤一
**例子下载地址：https://ssdun.cn/home/API/SsdunEcIOS4.6.zip**
1. 解压压缩包
2. 将**plugin**文件夹内文件复制到 **脚本项目** 的**plugin文件夹内**
3. 将js文件夹内文件复制到 **脚本项目** 的**js文件夹内**
## 步骤二
```
**温馨小提示**：要是软件有选择加密模式
1. AES模式 encr yptionMode是1 需要把 平台的AES Key填到 SSDUNSDK第四个参数
Ssdun=new SSDUNSDK("USERKEY","APPSECRET","1","XXXXX");
2. RSA模式 encryptionMode是2 需要把 下载下来的Key文件放到 **脚本项目**内的**res**文件夹内需然后
需要把 文件名填到 SSDUNSDK第四个参数
Ssdun=new SSDUNSDK("USERKEY","APPSECRET","2","XXXXX.pem");
```
## 步骤三
快速入门！根据实际情况调用函数
## 卡密验证(无加密有心跳版本)
```js
let USERKEY="平台(控制台)->复制UserKey"
let APPSECRET="平台(软件列表)->Id"
Ssdun=new SSDUNSDK(USERKEY,APPSECRET,0);
Ssdun.设置卡密("输入卡密")//ui或者其他方式
function main() {
Ssdun.一键运行卡密验证(true,3);//配置完一般调用这个就可以
let data = Ssdun.获取卡密信息();
logd("卡密激活时间：",data.start_time);
logd("卡密到期时间",data.end_time);
logd("卡密剩余时间",data.remaining_days);
logd("心跳token", data.token)
//下面写上你需要运行的代码
}
```
### 卡密验证(无加密无授权或不心跳版本)
```js
let USERKEY="平台(控制台)->复制UserKey"
let APPSECRET="平台(软件列表)->Id"
Ssdun=new SSDUNSDK(USERKEY,APPSECRET,0);
Ssdun.设置卡密("输入卡密")//ui或者其他方式
function main() {
Ssdun.一键运行卡密验证();//配置完一般调用这个就可以
let data = Ssdun.获取卡密信息();
logd("卡密激活时间：",data.start_time);
logd("卡密到期时间",data.end_time);
logd("卡密剩余时间",data.remaining_days);
//下面写上你需要运行的代码
}
```
### 卡密验证(AES加密模式)
```js
let USERKEY="平台(控制台)->复制UserKey"
let APPSECRET="平台(软件列表)->Id"
let ENCRYPTIONMODE=1// 0无加密 1AES加密 2RSA加密
let KEY="平台(软件列表)->KEY文件"
Ssdun=new SSDUNSDK("USERKEY","APPSECRET","1","XXXXXKEY");
Ssdun.设置卡密("输入卡密")//ui或者其他方式
function main() {
Ssdun.一键运行卡密验证(true,3);//配置完一般调用这个就可以
let data = Ssdun.获取卡密信息();
logd("卡密激活时间：",data.start_time);
logd("卡密到期时间",data.end_time);
logd("卡密剩余时间",data.remaining_days);
logd("心跳token", data.token)
//下面写上你需要运行的代码
}
```
### 卡密验证(RSA加密模式)
```js
let USERKEY="平台(控制台)->复制UserKey"
let APPSECRET="平台(软件列表)->Id"
let ENCRYPTIONMODE=2// 0无加密 1AES加密 2RSA加密
let KEY="平台(软件列表)->KEY文件 文件名写到这里如·XXXXX.pem· //下载的rsa文件放在res目录内"
Ssdun=new SSDUNSDK(USERKEY,APPSECRET,ENCRYPTIONMODE,KEY);
Ssdun.设置卡密("输入卡密")//ui或者其他方式
function main() {
Ssdun.一键运行卡密验证(true,3);//配置完一般调用这个就可以
let data = Ssdun.获取卡密信息();
logd("卡密激活时间：",data.start_time);
logd("卡密到期时间",data.end_time);
logd("卡密剩余时间",data.remaining_days);
logd("心跳token", data.token)
//下面写上你需要运行的代码
}
```
# 模块函数
### 读取机器码
```js
/**
*
* @param readConfig true 则优先读取第一次读取后保存在配置内的机器码
* @return {string}
*/
Ssdun.读取机器码(readConfig);
```
### 心跳线程
```js
/**
*
* @param req_interval 请求间隔 单位分,最快10分钟心跳一次 建议10分钟心跳一次.最慢不得超过60分组
* @param Type 1 网络心跳验证，2 卡密心跳验证 3 试用心跳验证
* @param RetryCount 默认一次 重试几次不成功则停止脚本
*/
Ssdun.心跳线程(req_interval, Type, RetryCount);
```
### 一键运行卡密验证
```js
/**
* @param heartbeatVerify 是否开启心跳验证
* @param RetryCount 心跳失败重试几次
*/
Ssdun.一键运行卡密验证(heartbeatVerify,RetryCount);
```
### 一键运行网络验证
```js
/**
* @param heartbeatVerify 是否开启心跳验证
* @param RetryCount 心跳失败重试几次
*/
Ssdun.一键运行网络验证(heartbeatVerify,RetryCount);
```
### 一键运行试用验证
```js
/**
* @param heartbeatVerify 是否开启心跳验证
* @param RetryCount 心跳失败重试几次
*/
Ssdun.一键运行试用验证(heartbeatVerify,RetryCount);
```
### 网络验证
```js
/**
* @appSecret 软件Id
* @return 成功返回心跳Token,失败返回false
*/
Ssdun.网络验证(appSecret);
```
### 网络心跳验证
```js
/**
* @param token 心跳Token
* @return 成功 10100,失败返回 status_code 值
*/
Ssdun.网络心跳验证(token);
```
### 网络退出心跳验证
```js
/**
* @param token 心跳Token
* @return 成功 10101,失败返回 status_code 值
*/
Ssdun.网络退出心跳验证(token);
```
### 卡密验证
```js
/**
*
* @param card 卡密
* @param machineCode 机器码
* @param appSecret 软件Id
* @return 成功返回心跳Token,失败返回false
*/
Ssdun.卡密验证(card, machineCode, appSecret);
```
### 卡密心跳验证
```js
/**
* @param token 心跳Token
* @return 成功 10100,失败返回 status_code 值
*/
Ssdun.卡密心跳验证(token);
```
### 卡密退出心跳验证
```js
/**
* @param token 心跳Token
* @return 成功 10101,失败返回 status_code 值
*/
Ssdun.卡密退出心跳验证(token);
```
### 卡密解绑
```js
/**
*
* @param password 解绑卡密密码 没有则留空
* @param deduct 扣除天数
* @param appSecret 软件Id
* @param card 卡密
* @param machineCode 机器码
* @return 成功返回 treu,失败返回 fasle
*/
Ssdun.卡密解绑(password, deduct, appSecret, card, machineCode);
```
### 充值卡密
```js
/**
*
* @param use_card 充值卡
* @param appSecret 软件Id
* @param card 卡密
* @return 成功返回 treu,失败返回 fasle
*/
Ssdun.充值卡密(use_card, appSecret, card);
```
### 试用验证
```js
/**
*
* @param appSecret 软件Id
* @param machineCode 机器码
* @return 成功返回 心跳Token,失败返回 false
*/
Ssdun.试用验证(appSecret,machineCode);
```
### 试用心跳验证
```js
/**
*
* @param appSecret 软件Id
* @param machineCode 机器码
* @return 成功返回 心跳Token,失败返回 false
*/
Ssdun.试用验证(appSecret,machineCode);
```
### 试用验证效验
```js
/**
*
* @param Token 心跳Token
* @param appSecret 软件Id
* @param machineCode 机器码
* @return 成功返回10010 失败返回 status_code 值
*/
Ssdun.试用心跳验证(Token,appSecret,machineCode);
```
### 试用心跳线程
```js
/**
*
* @Ssdun_试用心跳线程
* @param req_interval 请求间隔 单位分,最快1分钟心跳一次 建议1分钟心跳一次.
* @param Type 1 网络心跳验证，2 卡密心跳验证 3 试用心跳验证
* @param RetryCount 默认一次 重试几次不成功则停止脚本
*/
Ssdun.试用心跳线程(req_interval, Type, RetryCount);
```
### 创建远程变量
```js
/**
*
* @param name 变量昵称
* @param Var 变量内容
* @return 成功返回 变量appSecret，失败返回fasle
*/
Ssdun.创建远程变量(name, Var);
```
### 删除远程变量
```js
/**
*
* @param appSecret 变量列表的ID
* @return 成功返回 true，失败返回fasle
*/
Ssdun.删除远程变量(appSecret);
```
### 设置远程变量
```js
/**
*
* @param appSecret
* @param Var
* @return 成功返回 true，失败返回fasle
*/
Ssdun.设置远程变量(appSecret, Var);
```
### 获取远程变量
```js
/**
*
* @param appSecret 变量列表的ID
* @return 成功返回 变量内容，失败返回fasle
*/
Ssdun.获取远程变量(appSecret);
```
### 获取远程变量V5
```js
/**
*
* @param appSecret 变量列表的ID
* @param token 网络验证心跳或者卡密验证心跳 默认读取优先级 卡密心跳>网络验证心跳
* @return 成功返回 变量内容，失败返回fasle
*/
Ssdun.获取远程变量V5(appSecret,token);
```
### 运行远程函数
```js
/**
*
* @param appSecret 变量列表的ID
* @param funn_name 运行函数名与参数
* @param parameters 运行参数[1,2,3]
* @return 成功返回 运行函数后返回的内容，失败返回fasle
*/
Ssdun.运行远程函数(appSecret,token);
```
### 获取版本号
```js
/**
*
* @return 成功该SDK版本号
*/
Ssdun.getVersion();
```
### 结束脚本
```js
/**
*
* @param delay 延迟结束 单位毫秒
*/
Ssdun.结束脚本(delay);
```
### 获取备用验证地址
```js
Ssdun.updateHost();
```
### 设置验证地址
```js
Ssdun.setBackupHosts(hosts);
```