更新记录

1.0.0（2025-04-08） 下载此版本

平台兼容性

XL-Device-Info 设备信息增强插件

在线演示地址：在线demo

一个功能强大的设备信息获取插件，支持获取详细的设备参数、网络状态、传感器数据，并提供模拟器检测功能。

功能特点

• 📱 全面的设备信息获取
• 🌐 实时网络状态监测
• 🎮 传感器数据采集
• 🔍 模拟器检测
• 🔒 安全防护
• 📦 开箱即用
• 🚀 高性能实现

安装说明

方式一：通过 easycom 自动引入（推荐）

在 pages.json 中配置 easycom 规则：

{
  "easycom": {
    "autoscan": true,
    "custom": {
      "^xl-device-info(.*)": "@/components/xl-device-info/index.js"
    }
  }
}

方式二：手动引入

import { getDeviceInfo } from '@/components/xl-device-info/index.js';

使用说明

基础用法

import { getDeviceInfo } from '@/components/xl-device-info';

// 获取设备信息
const deviceInfo = await getDeviceInfo();
console.log(deviceInfo);

获取网络状态

import { getNetworkInfo } from '@/components/xl-device-info';

// 获取网络信息
const networkInfo = await getNetworkInfo();
console.log(networkInfo);

获取传感器数据

import { getSensorData } from '@/components/xl-device-info';

// 获取传感器数据
const sensorData = await getSensorData();
console.log(sensorData);

检测模拟器

import { checkEmulator } from '@/components/xl-device-info';

// 检测是否在模拟器中运行
const isEmulator = await checkEmulator();
console.log(isEmulator);

API 说明

getDeviceInfo()

获取设备详细信息。

返回值：

{
  platform: 'android', // 平台：android/ios
  model: 'iPhone 12', // 设备型号
  brand: 'Apple', // 设备品牌
  system: 'iOS 14.0', // 系统版本
  version: '1.0.0', // 应用版本
  language: 'zh-CN', // 系统语言
  screenWidth: 375, // 屏幕宽度
  screenHeight: 812, // 屏幕高度
  pixelRatio: 3, // 设备像素比
  statusBarHeight: 44, // 状态栏高度
  safeArea: { // 安全区域
    top: 44,
    bottom: 34,
    left: 0,
    right: 0
  }
}

getNetworkInfo()

获取网络状态信息。

返回值：

{
  networkType: 'wifi', // 网络类型：wifi/2g/3g/4g/5g/none/unknown
  isConnected: true, // 是否联网
  signalStrength: 80, // 信号强度（0-100）
  ipAddress: '192.168.1.1', // IP地址
  ssid: 'MyWiFi', // WiFi名称（仅WiFi网络）
  bssid: '00:11:22:33:44:55' // WiFi BSSID（仅WiFi网络）
}

getSensorData()

获取传感器数据。

返回值：

{
  accelerometer: { // 加速度传感器
    x: 0.1,
    y: 0.2,
    z: 9.8
  },
  gyroscope: { // 陀螺仪
    x: 0.1,
    y: 0.2,
    z: 0.3
  },
  magnetometer: { // 磁力计
    x: 0.1,
    y: 0.2,
    z: 0.3
  },
  light: 100, // 光线传感器（lux）
  proximity: false, // 距离传感器
  orientation: { // 方向传感器
    alpha: 0,
    beta: 0,
    gamma: 0
  }
}

checkEmulator()

检测是否在模拟器中运行。

返回值：

{
  isEmulator: true, // 是否为模拟器
  confidence: 0.95, // 检测置信度（0-1）
  indicators: [ // 检测指标
    'cpuInfo',
    'buildInfo',
    'sensorInfo'
  ]
}

注意事项

1. 部分功能需要相应的权限，请确保在 manifest.json 中配置了必要的权限
2. 传感器数据获取需要设备支持相应的传感器
3. 网络状态监测在部分平台可能受限
4. 模拟器检测的准确性取决于设备特征

更新日志

v1.0.0 (2024-05-01)

• 初始版本发布
• 支持基础设备信息获取
• 支持网络状态监测
• 支持传感器数据获取
• 支持模拟器检测

问题反馈

如果您在使用过程中遇到任何问题，请：

1. 查看 常见问题
2. 在插件市场评论区留言
3. 提交 Issue

许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

联系方式

• 项目维护者：[npcxl]
• 邮箱：[2966898893@qq.com]
• 插件市场主页：XL-Device-Info