更新记录

1.0.0（2025-12-11） 下载此版本

参考了https://ext.dcloud.net.cn/plugin?id=18195 和https://ext.dcloud.net.cn/plugin?id=22205

平台兼容性

uni-app(4.83)

uni-app x(4.83)

wzq-LAN-IP UTS组件

这是一个基于UTS开发的局域网IP管理组件，提供了Ping操作、WiFi IP获取和局域网IP扫描等功能，适用于Android平台。

功能特性

• ✅ 异步Ping操作（支持自定义参数）
• ✅ 同步Ping操作
• ✅ 获取当前设备WiFi的IP地址
• ✅ 扫描局域网内所有IP列表
• ✅ 扫描局域网内可Ping通的IP列表
• ✅ 扫描指定端口可访问的IP列表

安装与导入

安装方式

通过UniApp插件市场安装，或直接将组件复制到项目的uni_modules目录下。

导入组件

// 导入组件
import { ping, pingSync, getWifiIp, getLanIpList, getLanIpListWithPort, getLanIpListPing } from '@/uni_modules/wzq-LAN-IP';

API 文档

1. ping - 异步Ping操作

类型定义

type Ping = (options: PingOptions) => void;

参数说明

返回结果（success回调）

{
    errCode: number,          // 错误码，0表示成功
    errSubject: string,       // 错误主题
    errMsg: string,           // 错误信息
    time?: number,            // 平均时延，单位为毫秒
    packetLoss?: number       // 丢包率，百分比
}

使用示例

ping({
    addr: '192.168.1.1',
    time: 3,
    count: 3,
    packetSize: 64,
    success(res) {
        if (res.errCode === 0) {
            console.log('Ping成功，平均时延:', res.time, 'ms');
            console.log('丢包率:', res.packetLoss, '%');
        } else {
            console.log('Ping失败:', res.errMsg);
        }
    },
    fail(err) {
        console.error('Ping操作失败:', err);
    },
    complete(res) {
        console.log('Ping操作完成:', res);
    }
});

2. pingSync - 同步Ping操作

类型定义

type PingSync = (options: PingOptions) => PingResult;

参数说明：同ping函数

返回结果：同ping函数的success回调结果

使用示例

const result = pingSync({
    addr: '192.168.1.1',
    time: 3,
    count: 3
});

if (result.errCode === 0) {
    console.log('Ping成功，平均时延:', result.time, 'ms');
    console.log('丢包率:', result.packetLoss, '%');
} else {
    console.error('Ping失败:', result.errMsg);
}

3. getWifiIp - 获取当前设备WiFi的IP地址

类型定义

type GetWifiIp = () => string;

返回结果：当前设备的WiFi IP地址字符串

使用示例

const wifiIp = getWifiIp();
console.log('当前设备WiFi IP:', wifiIp);

4. getLanIpList - 获取局域网内所有IP列表

类型定义

type GetLanIpList = (options: GetLanIpListOptions) => void;

参数说明

返回结果（success回调）

{
    ipList: string[]  // 局域网IP地址列表
}

使用示例

getLanIpList({
    success(res) {
        console.log('局域网内所有IP列表:', res.ipList);
    },
    fail(err) {
        console.error('获取IP列表失败:', err);
    }
});

5. getLanIpListWithPort - 获取可Ping通且指定端口可访问的IP列表

类型定义

type GetLanIpListWithPort = (options: GetLanIpListWithPortOptions) => void;

参数说明

返回结果（success回调）：同getLanIpList

使用示例

getLanIpListWithPort({
    port: 80,
    time: 2,
    count: 2,
    success(res) {
        console.log('局域网内80端口可访问的IP列表:', res.ipList);
    },
    fail(err) {
        console.error('扫描失败:', err);
    }
});

6. getLanIpListPing - 获取可Ping通的IP列表

类型定义

type GetLanIpListPing = (options: GetLanIpListPingOptions) => void;

参数说明

返回结果（success回调）：同getLanIpList

使用示例

getLanIpListPing({
    time: 3,
    count: 3,
    success(res) {
        console.log('局域网内可Ping通的IP列表:', res.ipList);
    },
    fail(err) {
        console.error('扫描失败:', err);
    }
});

错误码说明

注意事项

1. 平台兼容性：该组件仅支持Android平台
2. 权限要求：需要网络权限和WiFi连接权限
3. 性能建议：
   • 扫描操作可能需要较长时间，建议在后台线程执行
   • 合理设置超时时间和Ping次数，避免影响用户体验
4. 网络环境：扫描结果受网络环境和防火墙设置影响
5. 错误处理：请务必处理fail回调，以确保应用稳定性

版本更新日志

v1.0.0

• 初始版本发布
• 实现ping和pingSync功能
• 实现获取WiFi IP功能
• 实现局域网IP扫描功能

许可证

MIT License

贡献

欢迎提交Issue和Pull Request来帮助改进这个组件！