HarmonyOS 6.0 OAID 服务正式支持 TV 设备

权限配置与用户授权的联动

开发者在 module.json5 中配置权限只是第一步，真正决定 OAID 返回值的是用户最终的授权状态。文档给出了三种情况的返回值规则：

关键理解点：

• 全 0 UUID 不是错误，而是设计使然。当用户拒绝或应用未申请权限时，系统返回全 0 值，应用应像处理普通字符串一样对待它，不能因为返回全 0 就重复弹窗或认为系统出错。
• 授权状态是持久的。用户一旦选择'禁止'，除非用户主动去设置中修改，否则后续调用一直返回全 0。这要求应用必须尊重用户的选择，不能频繁诱导授权。

动态请求的时机与方式

官方推荐在需要用到 OAID 时才发起权限请求，而不是在应用启动时一股脑全要。例如，一个视频 App 可以在用户首次点击'个性化推荐'开关时触发授权弹窗。示例代码中使用了 AtManager.requestPermissionsFromUser 并检查结果，这正是符合预期的做法。

// 注意：context 必须是当前 Ability 的上下文
const atManager = abilityAccessCtrl.createAtManager();
const result = await atManager.requestPermissionsFromUser(context, ['ohos.permission.APP_TRACKING_CONSENT']);
const granted = result.authResults[0] === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED;

这段代码需要放在 UI 线程的合适位置，例如按钮的点击回调中，避免在页面启动时无交互弹窗（可能被系统拦截或用户反感）。

TV 设备集成 OAID 的完整实践指南

环境确认

• 设备要求：HarmonyOS 6.0.0（20）及以上版本的智慧屏、TV 盒子。
• IDE 配置：DevEco Studio 中确保 compileSdkVersion 和 targetSdkVersion 不低于 6.0.0（对应 API version 12+，建议使用最新版本）。
• 模块导入：统一使用 import { identifier } from '@kit.AdsKit';，TV、手机、平板代码完全一致。

分步代码详解

下面给出一个更贴近实际场景的代码片段，它包含了权限请求、结果处理、OAID 获取、业务逻辑降级四个部分。

// OaidHelper.ets
import { abilityAccessCtrl, Context } from '@kit.AbilityKit';
import { identifier } from '@kit.AdsKit';
import { BusinessError } from '@kit.BasicServicesKit';

export class OaidHelper {
  /**
   * 尝试获取有效的 OAID
   * @param context 页面或 Ability 的上下文
   * @returns 如果用户授权，返回 OAID 字符串；否则返回 undefined，调用方需处理降级逻辑
   */
  static async tryGetValidOaid(context: Context): Promise<string | undefined> {
    // 1. 检查是否已经授权（可选步骤，避免重复弹窗）
    const atManager = abilityAccessCtrl.createAtManager();
    const isGranted = await atManager.checkPermissions(context, ['ohos.permission.APP_TRACKING_CONSENT']);
    
    if (!isGranted) {
      // 2. 未授权，发起动态请求
      try {
        const result = await atManager.requestPermissionsFromUser(
          context,
          ['ohos.permission.APP_TRACKING_CONSENT']
        );
        const authResult = result.authResults[0];
        if (authResult !== abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
          console.info('User denied tracking permission');
          return undefined; // 用户拒绝，返回 undefined
        }
      } catch (err) {
        console.error(`Request permission failed: ${err.message}`);
        return undefined; // 请求过程异常，返回 undefined
      }
    }

    // 3. 已授权（或刚刚授权成功），获取 OAID
    try {
      const oaid = await identifier.getOAID();
      // 注意：即使授权了，仍可能返回全 0，比如用户在授权后又去设置中关闭了权限
      // 但这种情况不会走到这里，因为上面的 check 会失败。但为了健壮，可以加一个判断
      if (oaid === '00000000-0000-0000-0000-000000000000') {
        console.info('OAID is all-zero, maybe permission turned off later');
        return undefined;
      }
      return oaid;
    } catch (error) {
      let bizErr = error as BusinessError;
      console.error(`getOAID failed, code: ${bizErr.code}, msg: ${bizErr.message}`);
      return undefined;
    }
  }
}

代码中的思考：

• 为什么先 checkPermissions？避免每次都弹出系统弹窗，如果用户之前已经拒绝，我们不应再次骚扰，而是直接走降级逻辑。
• 为什么返回 undefined 而非全 0？全 0 在业务上代表'无有效标识'，但调用方可能需要区分'用户拒绝'和'系统错误'。此处用 undefined 表示'不可用'，调用方可以展示非个性化广告或使用备用标识（如会话 ID）。
• 错误码处理：BusinessError 包含 code 和 message，应至少记录日志，方便排查。

TV 特有场景的注意事项

• 遥控器交互：权限弹窗必须适配焦点移动。确保弹窗上的'允许'和'禁止'按钮可以被方向键选中并确认。
• 无屏设备？ 部分 TV 盒子可能连接的是传统电视，没有触摸屏，但系统 UI 仍然会渲染，所以弹窗仍然会显示在屏幕上，用户可用遥控器操作，无特殊处理。
• 多用户切换：TV 设备常有多用户（家庭成员），OAID 是设备级，与用户账号无关。切换用户不会重置 OAID，除非恢复出厂设置。
• 性能考虑：getOAID() 是轻量级调用，但权限请求涉及跨进程通信，应避免在 UI 渲染关键路径上同步等待。

对开发者与广告生态的深远影响

开发者的收益：少写代码，多份保障

过去，TV 应用若要实现广告归因，往往需要：

• 自己生成设备指纹（易冲突、易被清理）。
• 集成第三方 SDK（增加包体积、隐私合规风险）。

现在，系统级 OAID 提供了官方背书的能力：

• 稳定：不会因为应用被卸载而改变。
• 合规：权限模型与鸿蒙隐私框架深度整合，开发者无需自行设计隐私弹窗逻辑。
• 统一：手机和 TV 代码复用，降低维护成本。

广告监测的升级：跨屏归因不再是梦

对于广告平台和监测公司，TV 端 OAID 的加入补齐了最后一块拼图。一个典型的跨屏路径可能是：

1. 用户在智慧屏上观看爱奇艺，看到某汽车广告（TV 端记录 OAID_A）。
2. 用户随后在手机上打开淘宝（手机端记录 OAID_B）。
3. 监测平台通过某种映射关系（如同一个鸿蒙账号、同 WiFi 下的设备聚类）将 OAID_A 与 OAID_B 关联，从而得出'该 TV 广告带来了手机端转化'的结论。

虽然这需要额外的技术方案（如 Device Mapping），但 OAID 提供了最基础的稳定锚点，让跨屏归因从'玄学'变成'可工程化实现'。

用户隐私的再思考：大屏更需要'看得见的控制'

大屏通常摆放在家庭公共区域，隐私问题容易被忽视。OAID 的权限机制将控制权交还给用户：家庭成员可以清楚知道哪些应用在申请跟踪权限，并随时在设置中关闭。这种设计不仅符合 GDPR 等法规精神，也有助于培养用户对大屏应用的信任感。

总结与展望

开放匿名设备标识服务新增支持 TV 设备，是 HarmonyOS 6.0 广告服务的一次低调但重要的升级。它没有炫酷的 UI 变化，却为整个鸿蒙生态的广告技术基础设施补齐了关键一环。

• 对技术人而言，它意味着多端开发体验的进一步统一，以及跨屏技术探索的更多可能性。
• 对产品经理而言，TV 端的用户行为终于有了一个可与手机联动的标识，未来可以设计更连贯的跨屏体验。
• 对用户而言，大屏应用的行为将变得更加透明，隐私控制权不再缺席。

随着越来越多的 TV 应用适配 OAID，我们有望看到更精准的大屏广告投放、更科学的跨屏归因报告，以及一个更健康、更可持续的大屏应用生态。而这一切，都始于开发者的一次 identifier.getOAID() 调用。