Mulai

Copy prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

        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.

Pasang

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

Impor

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

API Pengantar

`getStatus`

Mengambil status otorisasi pelacakan saat ini tanpa meminta pengguna.

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

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

`requestPermission`

Mengajukan otorisasi pengguna untuk mengakses data aplikasi terkait pelacakan. Menampilkan dialog otorisasi iOS native pelacakan.

Catatan: Metode ini hanya akan menampilkan dialog sekali. Panggilan berikutnya akan mengembalikan status otorisasi yang disimpan tanpa menampilkan dialog.

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;
}

Referensi Tipe

`AppTrackingStatusResponse`

Objek respons yang berisi status otorisasi pelacakan.

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

`AppTrackingStatus`

Nilai-nilai yang mungkin untuk status otorisasi pelacakan.

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

Sumber Kebenaran

Halaman ini dihasilkan dari plugin’s. Re-run sync ketika publik __CAPGO_KEEP_0__ berubah di atas. src/definitions.ts. Re-run the sync when the public API changes upstream.