Getting Started
复制一个包含安装步骤和本插件完整 Markdown 指南的配置提示。
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-app-tracking-transparency`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/app-tracking-transparency/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
您可以使用我们的 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-transparencybunx cap syncimport { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';API 概述
Section titled “API 概述”getStatus
Section titled “getStatus”获取当前跟踪授权状态,不会提示用户。
import { AppTrackingTransparency } from '@capgo/capacitor-app-tracking-transparency';
const { status } = await AppTrackingTransparency.getStatus();if (status === 'authorized') { console.log('Tracking is authorized');}requestPermission
Section titled “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时,请重新运行上游。
继续从开始使用中
继续从 Getting Started如果您正在使用 Getting Started 来规划仪表板和API操作,连接它 使用@capgo/capacitor-app-tracking-transparency 为native能力在使用@capgo/capacitor-app-tracking-transparency API概述 为API概述的实现细节 介绍 为介绍的实现细节 API密钥 为API密钥的实现细节 设备 关于设备的实现细节