更新记录
1.0.0(2026-11-18)
Android / iOS / 鸿蒙三端统一的设备标识 UTS 插件。聚合 OAID、AAID、AndroidID、IDFV、ODID、UUID,一套 API 跨平台调用,兼容 uni-app 与 uni-app x。
平台兼容性
uni-app(4.87)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | - | - | √ | - | √ | √ | √ |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| - | - | - | - | - | - | - | - | - | - | - | - |
uni-app x(4.87)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| - | - | 16.0 | 15 | API 14 | - |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| × | × | × | √ |
DC-DeviceID · 三端设备唯一标识 UTS 插件
一套 API,同时覆盖 Android / iOS / 鸿蒙 HarmonyOS NEXT 的设备标识获取,兼容 uni-app (Vue2/Vue3) 与 uni-app x。
为什么选它
- 真正的三端统一:同类老插件多为仅 Android 的 App 原生插件,不支持鸿蒙,也无法在 uni-app x 中使用。本插件基于 UTS 重写,一套接口打通三端。
- 零依赖开箱即用:ANDROID_ID / IDFV / 本地 UUID 三条底座链路无需任何三方 SDK,装上就能跑。
- 隐私合规优先:提供
allowAdId/allowAndroidId开关,用户未同意隐私政策时可一键关闭广告标识与敏感 ID 读取。 - 稳定兜底:任何链路失败都会回退到本地持久化 UUID,
deviceId永不为空。
平台与标识支持
| 平台 | 统一 ID 优先级 | OAID | AndroidID | IDFV | ODID | UUID |
|---|---|---|---|---|---|---|
| Android | OAID → AAID → AndroidID → UUID | 需适配器 | ✅ | — | — | ✅ |
| iOS | IDFV → UUID | — | — | ✅ | — | ✅ |
| 鸿蒙 | ODID → UUID | — | — | — | 需权限 | ✅ |
安装
将 uni_modules/dc-device-id 放到项目的 uni_modules 目录下即可(HBuilderX 中也可从插件市场一键导入)。
UTS 插件需用 HBuilderX 开发,不支持 cli 方式。涉及原生能力的插件需打包自定义基座后运行。
快速开始
1. 同步获取(最简单)
import { getDeviceIdSync, getDeviceIdInfoSync } from '@/uni_modules/dc-device-id'
// 直接拿统一设备 ID
const deviceId = getDeviceIdSync()
console.log('deviceId:', deviceId)
// 拿完整信息,判断来源
const info = getDeviceIdInfoSync()
console.log(info.platform) // android / ios / harmony
console.log(info.deviceIdType) // oaid / androidId / idfv / uuid ...
console.log(info.oaid, info.androidId, info.uuid)
2. 隐私合规初始化(推荐)
import { init, getDeviceId } from '@/uni_modules/dc-device-id'
// 用户同意隐私政策后调用
init({
allowAdId: true, // 是否允许读取 OAID/AAID
allowAndroidId: true, // 是否允许读取 AndroidID
success(res) {
console.log('初始化成功', res.deviceId)
}
})
// 异步获取
getDeviceId({
success(res) {
console.log(res.deviceId, res.deviceIdType)
},
fail(res) {
console.log('获取失败', res.msg)
}
})
API
init(options)
初始化并采集,设置隐私开关。
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| allowAdId | boolean | true | 是否允许读取 OAID/AAID,未同意隐私政策应传 false |
| allowAndroidId | boolean | true | 是否允许读取 AndroidID(仅 Android) |
| success | Function | — | 成功回调,返回 DeviceIdResult |
| fail | Function | — | 失败回调 |
| complete | Function | — | 结束回调 |
getDeviceId(options)
异步获取设备标识,回调返回 DeviceIdResult。
getDeviceIdSync(): string
同步返回统一设备 ID(字符串)。
getDeviceIdInfoSync(): DeviceIdResult
同步返回完整聚合结果。
DeviceIdResult 结构
| 字段 | 类型 | 说明 |
|---|---|---|
| success | boolean | 是否成功 |
| msg | string | 描述 |
| platform | string | android / ios / harmony |
| deviceId | string | 统一设备 ID |
| deviceIdType | string | ID 来源类型 |
| oaid | string | Android 匿名设备标识 |
| aaid | string | 广告标识 |
| androidId | string | AndroidID |
| idfv | string | iOS 厂商标识 |
| odid | string | 鸿蒙开放设备标识 |
| uuid | string | 本地持久化 UUID |
高级:OAID 适配器接入(Android)
Android 的 OAID 由移动安全联盟(MSA)及各厂商 SDK 提供,无法零依赖获取。本插件预留了可插拔适配器:
- 在宿主工程中集成 MSA 的 OAID SDK(或厂商 SDK);
- 实现
com.dc.deviceid.OaidAdapter类,提供单例getInstance()、getOAID(Context)、getAAID(Context)方法; - 插件通过反射调用,未集成时自动降级到 AndroidID/UUID,不影响基础功能。
源码版用户可获得适配器示例工程与完整集成说明。
高级:鸿蒙 ODID 接入
鸿蒙的 ODID 需在 module.json5 声明相应权限(如 ohos.permission.ACCESS_ODID 或厂商对应权限),并在真机上申请授权。readODID() 已预留接入点,默认安全降级为 UUID。源码版提供接入示例。
隐私与合规
- 本插件不上传任何数据,所有标识仅在本地生成与读取;
- 调用前请确保 App 已取得用户对隐私政策的同意;
- iOS 若需 IDFA(aaid),需自行接入 AppTrackingTransparency 并在 Info.plist 填写
NSUserTrackingUsageDescription; - 各平台对设备标识的获取政策可能调整,请以平台最新规定为准。
更新日志
见 changelog.md。
许可
普通授权版:按 appid + 包名 绑定使用。源码授权版:见购买页面说明。

收藏人数:
购买源码授权版(
试用
赞赏(0)
下载 61
赞赏 0
下载 12773692
赞赏 1960
赞赏
京公网安备:11010802035340号