Getting Started

설치

AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 기능을 추가하려면 다음 명령어를 사용하세요:

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.

만약 Manual Setup을 선호한다면, 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요:

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

Import

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

Type Reference

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 작업을 연결하세요. Using @capgo/capacitor-앱 추적 투명도 for the native capability in Using @capgo/capacitor-앱 추적 투명도, API 개요 for the implementation detail in API 개요, 소개 for the implementation detail in 소개, API 키 for the implementation detail in API 키, 그리고 장치 for the implementation detail in 장치.