华为HarmonyOS灵活高效的消息推送服务(Push Kit) - 3 获取AAID

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

AAID具有以下特性:

  • 匿名化、无隐私风险:AAID和已有的任何标识符都不关联,并且每个应用只能访问自己的AAID。
  • 同一个设备上,同一个开发者的多个应用,AAID取值不同。
  • 同一个设备上,不同开发者的应用,AAID取值不同。
  • 不同设备上,同一个开发者的应用,AAID取值不同。
  • 不同设备上,不同开发者的应用,AAID取值不同。

场景介绍

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

  • 应用卸载重装。
  • 应用调用删除AAID接口。
  • 用户恢复出厂设置。
  • 用户清除应用数据。

接口说明

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

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

获取AAID

  1. 导入AAID模块。

    TypeScript 复制代码
    import { AAID } from '@kit.PushKit';
  2. 调用AAID.getAAID()方法获取AAID信息。

    TypeScript 复制代码
    import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
    import { AAID } from '@kit.PushKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    import { hilog } from '@kit.PerformanceAnalysisKit';
    export default class EntryAbility extends UIAbility {
    // 入参want与launchParam并未使用,为初始化项目时自带参数
    async onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): Promise<void> {
    // 获取AAID
    try {
    const aaid: string = await AAID.getAAID();
    hilog.info(0x0000, 'testTag', 'Succeeded in getting AAID.');
    } catch (err) {
    let e: BusinessError = err as BusinessError;
    hilog.error(0x0000, 'testTag', 'Failed to get AAID: %{public}d %{public}s', e.code, e.message);
    }
    }
    }
相关推荐
高心星15 小时前
鸿蒙5.0应用开发——V2装饰器@Provider和@Consumer的使用
harmonyos
ChinaDragon19 小时前
HarmonyOS:ArkTS卡片页面刷新
harmonyos
HMSCore19 小时前
通知语音播报功能,解锁全新体验
harmonyos
HarmonyOS_SDK19 小时前
通知语音播报功能,解锁全新体验
harmonyos
高心星20 小时前
鸿蒙5.0应用开发——V2装饰器@ObservedV2和@Trace的使用
harmonyos
城中的雾20 小时前
HarmonyOS应用拉起系列(三):如何直接拉起腾讯/百度/高德地图进行导航
前端·javascript·harmonyos
程序员潘Sir1 天前
鸿蒙应用开发从入门到实战(七):ArkTS组件声明语法
harmonyos·鸿蒙
高心星2 天前
鸿蒙5.0项目开发——V2装饰器@Event的使用
harmonyos
ChinaDragon2 天前
HarmonyOS:创建ArkTS卡片
harmonyos