更新记录

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 提供,无法零依赖获取。本插件预留了可插拔适配器:

  1. 在宿主工程中集成 MSA 的 OAID SDK(或厂商 SDK);
  2. 实现 com.dc.deviceid.OaidAdapter 类,提供单例 getInstance()、getOAID(Context)、getAAID(Context) 方法;
  3. 插件通过反射调用,未集成时自动降级到 AndroidID/UUID,不影响基础功能。

源码版用户可获得适配器示例工程与完整集成说明。

高级:鸿蒙 ODID 接入

鸿蒙的 ODID 需在 module.json5 声明相应权限(如 ohos.permission.ACCESS_ODID 或厂商对应权限),并在真机上申请授权。readODID() 已预留接入点,默认安全降级为 UUID。源码版提供接入示例。

隐私与合规

  • 本插件不上传任何数据,所有标识仅在本地生成与读取;
  • 调用前请确保 App 已取得用户对隐私政策的同意;
  • iOS 若需 IDFA(aaid),需自行接入 AppTrackingTransparency 并在 Info.plist 填写 NSUserTrackingUsageDescription;
  • 各平台对设备标识的获取政策可能调整,请以平台最新规定为准。

更新日志

见 changelog.md。

许可

普通授权版:按 appid + 包名 绑定使用。源码授权版:见购买页面说明。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

- **采集的数据(均在本地生成/读取)**:AndroidID(SSAID)、IDFV、本地持久化 UUID,以及由它们聚合出的统一 `deviceId` 和来源类型、平台标识。字段 `oaid` / `aaid` / `odid` 为预留字段,当前版本返回空字符串。 - **发送的服务器地址**:**无**。本插件不包含任何网络请求代码,不上传、不缓存任何数据到远端服务器,所有数据仅存在于宿主 App 本地。 - **数据用途**:仅供宿主 App 在本地生成/读取设备标识,用于设备识别、风控、统计归因等业务场景;插件不将标识用于任何广告或用户画像目的。 - **合规开关**:提供 `allowAdId` / `allowAndroidId` 开关,宿主可在用户未同意隐私政策时关闭敏感标识读取。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。