更新记录

1.0.0（2026-01-07）

• 新版本发布

平台兼容性

uni-app(4.07)

平台兼容性

插件介绍

1. 该插件可获取鸿蒙设备标识符，OAID、ODID、AAID，及自动权限处理。试用无问题后再购买哦！

API接口

• OAID获取：requestOAID()
• AAID获取：requestAAID()
• ODID获取：requestODID()
• 申请APP_TRACKING_CONSENT 权限：requestTrackingPermission()
• 检查APP_TRACKING_CONSENT 权限：checkTrackingPermission()

使用指南

1. 在 harmony-configs/entry/src/main/module.json5 中添加权限声明：

{
  "requestPermissions": [
    {
      "name": "ohos.permission.APP_TRACKING_CONSENT",
      "reason": "$string:tracking_reason",
      "usedScene": {
        "abilities": ["EntryAbility"],
        "when": "inuse"
      }
    }
  ]
}

2. 在 harmony-configs\entry\src\main\resources\base\element\string.json 中添加tracking_reason定义，value值可自定义：

{
  "string": [
    {
      "name": "tracking_reason",
      "value": "为了向您提供个性化推荐并减少无关广告的干扰，我们需要获取您的广告标识符。"
    }
  ]
}

3. 插件示例代码：

// 1.申请权限，在用户同意隐私政策后调用
import { requestTrackingPermission } from '@/uni_modules/hm-device-id';
// true权限申请成功、false权限申请失败
const isPermissionGranted= await requestTrackingPermission()

// 2.检查权限状态
import { checkTrackingPermission} from '@/uni_modules/hm-device-id';
// true拥有权限、false无权限
const isPermissionGranted = await checkTrackingPermission()

// 3.获取OAID，内部会自动检查并申请权限，无需手动调用requestTrackingPermission
import { requestOAID } from '@/uni_modules/hm-device-id';
const  oaid = await requestOAID();

// 4.获取ODID
import { requestODID } from '@/uni_modules/hm-device-id';
const  odid = requestODID();

// 5.获取AAID
import { requestAAID } from '@/uni_modules/hm-device-id';
const aaid = await requestAAID()