按键精灵安卓版网络插件

按键精灵安卓版网络插件详解

网络插件功能

按键精灵安卓版网络插件主要用于扩展脚本的联网能力,支持以下核心功能：
| 功能类型 | 说明 |
|—————-|———————————————————————-|
| HTTP请求 | 支持GET/POST/PUT/DELETE等请求方式，可自定义请求头、参数、超时时间 |
| 数据解析 | 内置JSON/XML解析器，支持正则表达式匹配 |
| SSL证书处理 | 支持忽略SSL验证（非安全模式）或加载自签名证书 |
| 文件上传 | 支持多文件/多字段的表单上传，兼容multipart/form-data格式 |
| WebSocket通信 | 支持长连接双向通信，可设置心跳包和重连机制 |

安装与配置流程

插件获取途径

• 官方插件库：通过「插件市场」搜索”NetworkPlugin”下载安装
• 手动安装：将.apk文件传输到设备后直接安装

权限配置
需在安卓系统设置中授权以下权限：

android.permission.INTERNET
android.permission.ACCESS_NETWORK_STATE
android.permission.WRITE_EXTERNAL_STORAGE（可选，用于缓存数据）

基础配置参数
| 参数名称 | 默认值 | 说明 |
|—————-|————-|—————————————-|
| RequestTimeout | 30000ms | 请求超时时间（毫秒） |
| Charset | UTF-8 | 请求/响应编码格式 |
| UserAgent | AndroidApp | HTTP请求头中的User-Agent标识 |
| CookiePolicy | Session | 会话级/持久化Cookie策略 |

脚本编写示例

基础GET请求

// 初始化网络对象
var net = new Network();
// 设置全局参数
net.setHeader("Accept","application/json");
net.setRetryCount(3); // 失败重试次数
// 发起GET请求
var response = net.get("https://api.example.com/data");
if(response.status == 200){
    var data = JSON.parse(response.body);
    toast("获取成功：" + data.name);
}else{
    toast("请求失败：" + response.statusText);
}

带参数的POST请求

// 创建表单数据
var formData = {
    username: "testuser",
    password: "123456",
    remember: true
};
// 配置请求参数
net.setUrl("https://login.example.com/api/auth");
net.setMethod("POST");
net.setHeader("Content-Type","application/x-www-form-urlencoded");
// 发送请求
var result = net.post(formData);
if(result.isSuccess()){
    var token = result.json().token;
    // 后续使用token的操作
}

文件上传示例

// 准备上传文件
var files = [
    {fieldName:"image", filePath:"/sdcard/pic.jpg", mimeType:"image/jpeg"},
    {fieldName:"doc", filePath:"/download/report.pdf"}
];
// 配置上传参数
net.setUrl("https://upload.example.com/submit");
net.setMethod("POST");
net.setHeader("Authorization","Bearer " + accessToken);
// 执行上传
var uploadResult = net.upload(files);
if(uploadResult.progress == 100){
    toast("上传完成：" + uploadResult.serverResponse);
}

高级功能配置

证书管理

// 加载自签名证书
net.loadCertificate("/sdcard/cert.pem");
net.setVerifySSL(true); // 开启SSL验证

WebSocket通信

// 建立连接
var ws = net.connectWebSocket("wss://chat.example.com/socket");
// 注册事件
ws.onOpen(function(){
    ws.send("Hello Server!");
});
ws.onMessage(function(msg){
    toast("收到消息：" + msg);
});
ws.onClose(function(code){
    log("连接关闭，代码：" + code);
});

常见问题解决方案

相关问题与解答

Q1：如何测试网络插件是否安装成功？
A1：可通过以下步骤验证：

1. 在脚本中添加net.ping("https://www.google.com")
2. 执行脚本查看返回结果,成功时应显示类似Ping成功：时间=35ms
3. 尝试访问不存在的域名（如https://invalid.domain），应返回连接错误

Q2：如何处理需要OAuth认证的API接口？
A2：典型处理流程：

1. 首次请求获取授权码：var code = net.get("https://api.example.com/auth?client_id=XXX")
2. 交换授权码获取Token：

   var tokenResponse = net.post({
    grant_type:"authorization_code",
    code:code,
    client_id:"XXX",
    client_secret:"XXX"
   }, "https://api.example.com/token");
   var accessToken = tokenResponse.json().access_token;

3. 在后续请求中添加Token：`net.setHeader(“Authorization”,”Bearer ” + access