更新记录

1.0.7（2025-08-04）

更新设备号获取方式

1.0.6（2025-08-01）

修复已知 bug

1.0.5（2025-07-25）

代码优化

平台兼容性

uni-app x

native-device

UniApp UTS 原生设备信息插件

使用方法

import { 
  getDeviceId, getBundleId, getFirebaseToken, getApplePushToken,
  getVideoThumbnail, captureScreen, screenshotStop,
  vpnConnected, proxyOpened, carrierInfo,
  imageCacheByUrl, imageCached, cacheLocalImage
} from '@/uni_modules/native-device'

// 设备信息
const device = getDeviceId()
console.log(device.value)

const bundle = getBundleId()
console.log(bundle.value)

// 推送令牌
getFirebaseToken((success, key, value) => {
  console.log(value)  // Android Firebase Token
})

getApplePushToken((token) => {
  console.log(token)  // iOS APNS Token
})

// 视频缩略图
getVideoThumbnail({ videoPath: "/path/to/video.mp4" }, (result) => {
  console.log(result.base64Data)
})

// 屏幕截图
captureScreen((success, filePath) => {
  console.log(filePath)
})

// 截图防护
screenshotStop(true)  // 开启防护

// 网络检测
console.log(vpnConnected())    // VPN状态
console.log(proxyOpened())     // 代理状态

// 运营商信息
const carrier = carrierInfo()
console.log(carrier.value)

// 图片缓存（Android）
const cachePath = imageCacheByUrl('https://example.com/image.jpg')
console.log(imageCached('https://example.com/image.jpg'))

cacheLocalImage('key', '/path/image.jpg', (success) => {
  console.log(success)
})

主要功能

• 设备信息获取（设备ID、应用包名）
• 推送令牌获取（Firebase、APNS）
• 视频缩略图生成
• 屏幕截图功能
• VPN/代理检测
• 运营商信息获取
• 图片缓存管理

平台支持

• Android: 完整功能支持
• iOS: 部分功能支持

技术规格

• 最低 Android SDK: 21 (Android 5.0)
• 最低 iOS 版本: 12.0
• 开发框架: UTS (TypeScript for UniApp)
• 插件类型: 原生API插件
• 权限要求:
  • 网络访问权限（Firebase Token、网络视频缩略图、图片缓存）
  • 存储读写权限（缩略图、截图文件保存）
  • 电话状态权限（运营商信息获取）
  • 推送通知权限（iOS推送令牌）

版本历史

• v1.0.5 (2025-07-25):
  • 代码优化，提升稳定性
• v1.0.4 (2025-07-24):
  • iOS 平台适配完善
  • 新增苹果推送令牌获取功能（iOS）
  • 完善跨平台兼容性
• v1.0.3 (2025-07-11):
  • 优化用户体验，修复已知问题
• v1.0.2 (2025-07-10):
  • 移除toast方法，新增应用包名获取功能
  • 完善Android平台功能
• v1.0.1:
  • 新增视频缩略图生成功能（支持本地和网络视频）
  • 新增屏幕截图功能（PixelCopy + 传统方法兼容）
  • 新增截图防护功能（FLAG_SECURE）
  • 新增VPN连接检测功能
  • 新增代理连接检测功能
  • 新增运营商信息获取功能
  • 新增图片缓存功能（Fresco框架）
  • Firebase Token功能增强（自动创建通知渠道）
• v1.0.0: 初始版本，支持 Android 和 iOS 设备ID获取