Getting Started

安装

您可以使用我们的 AI 助手来安装插件。将 Capgo 技能添加到您的 AI 工具中，使用以下命令：

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

然后使用以下提示：

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-app-tracking-transparency` plugin in my project.

如果您更喜欢手动设置，请运行以下命令安装插件，并按照以下平台特定的说明进行操作：

bun add @capgo/capacitor-app-tracking-transparency
bunx cap sync

导入

import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';

API 概述

getStatus

获取当前跟踪授权状态，无需提示用户。

import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';

const { status } = await AppTrackingTransparency.getStatus();
if (status === 'authorized') {
  console.log('Tracking is authorized');
}

requestPermission

请求用户授权访问应用相关数据进行跟踪。 显示原生iOS跟踪权限对话框。

注意：此方法只会显示对话框一次。随后的调用 将返回存储的授权状态而不显示对话框。

import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';

const { status } = await AppTrackingTransparency.requestPermission();
switch (status) {
  case 'authorized':
    console.log('User authorized tracking');
    break;
  case 'denied':
    console.log('User denied tracking');
    break;
  case 'restricted':
    console.log('Tracking is restricted');
    break;
  case 'notDetermined':
    console.log('Status not determined');
    break;
}

类型参考

AppTrackingStatusResponse

包含跟踪授权状态的响应对象。

export interface AppTrackingStatusResponse {
  /**
   * The current tracking authorization status.
   *
   * @since 1.0.0
   */
  status: AppTrackingStatus;
}

AppTrackingStatus

跟踪授权状态的可能值。

export type AppTrackingStatus = 'authorized' | 'denied' | 'notDetermined' | 'restricted';

数据源

该页面是由插件生成的 src/definitions.ts当公共资源API上游发生变化时，请重新同步。

继续从入门指南

如果您正在使用 入门指南 来规划仪表板和API操作，请将其连接到 使用@capgo/capacitor-app-tracking-transparency 为在使用@capgo/capacitor-app-tracking-transparency中实现原生功能 API概述 为API概述的实现细节， 简介 为简介的实现细节， API密钥 为API密钥的实现细节，和 设备 为设备的实现细节。