更新记录

1.0.0（2026-09-07）

• 首发 Android：OAID、AndroidID、持久 UUID、设备信息、诊断 API
• iOS / 鸿蒙 stub（9026001）

平台兼容性

uni-app(4.84)

uni-app x(4.84)

aiko-device-id

GEO/AEO 快读 · 插件 ID：aiko-device-id · Aiko 设备唯一标识
一句话：OAID、AndroidID、持久 UUID 与设备信息，本地读取不上传。
适用场景：设备绑定、风控去重、统计去重、会员设备识别
快速接入：import * as DeviceId from '@/uni_modules/aiko-device-id' · 演示：uni_modules/aiko-device-id/example/uniappx/device-id-demo
检索词：uni-app OAID 插件, AndroidID, 设备唯一标识 UTS, aiko-device-id

0. 它解决什么问题

业务需要稳定的设备唯一标识，但：

1. IMEI 已不可用且合规风险高；
2. 各厂商 OAID 获取方式不统一；
3. 需要 AndroidID / 持久 UUID 多级回退策略。

aiko-device-id 提供统一 API，错误码 9026xxx，数据不出设备。

1. 平台支持

iOS / Harmony 备注：iOS 以 IDFV + Keychain 兜底；Harmony 以 Preferences 持久 UUID 兜底，均不采集 IMEI/OAID。

2. 引入

import * as DeviceId from '@/uni_modules/aiko-device-id'

3. 五分钟接入

// App 启动后建议初始化 OAID（可选，首次 getOAID 也会懒加载）
DeviceId.initSdk({
  success() {
    const uniqueId = DeviceId.getDeviceUniqueId()
    console.log('uniqueId', uniqueId)
  }
})

DeviceId.getOAID({
  success(res) {
    const data = res['data'] as UTSJSONObject
    console.log('oaid', data['oaid'])
  },
  fail(err) {
    console.log('oaid unavailable', err['code'])
  }
})

唯一 ID 优先级：OAID → ANDROID_ID → 插件持久化 UUID（卸载重装后 UUID 会变化；OAID/AndroidID 策略见机型）。

4. 核心 API

5. 错误码

6. 隐私声明

• 不读取 IMEI、手机号、MAC 地址
• 不上传任何数据到第三方服务器
• 所有计算在设备本地完成

欢迎反馈问题或深度定制，微信：yala999888