目录

获取AAID

AAID(Anonymous Application Identifier):应用匿名标识符,标识运行在移动智能终端设备上的应用实例,只有该应用实例才能访问该标识符,AAID只存在于应用的安装期,总长度36个字符。与无法重置的设备级硬件ID相比,AAID具有更好的隐私属性。

AAID具有以下特性:

场景介绍

AAID会在包括但不限于下述场景中发生变化:

约束与限制

获取AAID能力支持Phone、Tablet、PC/2in1设备。并且从5.1.0(18)版本开始,新增支持Wearable设备;从5.1.1(19)版本开始,新增支持TV设备。

接口说明

接口返回值有两种返回形式:Callback和Promise回调。下表中仅展示Promise回调形式的接口,Promise和Callback只是返回值方式不一样,功能相同。

接口名 描述
getAAID(): Promise<string> 获取AAID,使用Promise异步返回结果。
deleteAAID(): Promise<void> 删除AAID,使用Promise异步返回结果。

获取AAID

  1. 导入AAID模块及相关公共模块。

    import { AAID } from '@kit.PushKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    import { hilog } from '@kit.PerformanceAnalysisKit';
    const DOMAIN = 0x0000;
  2. 调用AAID.getAAID()方法获取AAID信息。

    try {
      // data为获取的应用匿名标识符
      AAID.getAAID((err: BusinessError, data: string) => {
        if (err) {
          hilog.error(DOMAIN, 'testTag', 'Failed to get AAID: %{public}d %{public}s', err.code, err.message);
        } else {
          hilog.info(DOMAIN, 'testTag', 'Succeeded in getting AAID');
        }
      });
    } catch (err) {
      let e: BusinessError = err as BusinessError;
      hilog.error(DOMAIN, 'testTag', 'Failed to get AAID: %{public}d %{public}s', e.code, e.message);
    }