Getting Started

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함하는 설정 지시를 복사하세요.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-recaptcha`
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/recaptcha/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-assisted 설치를 사용하여 플러그인을 설치할 수 있습니다. 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-recaptcha` plugin in my project.

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

npm install @capgo/capacitor-recaptcha
npx cap sync

사이트 키를 구성하세요

Google Cloud reCAPTCHA에서 플랫폼 키를 생성한 다음 __CAPGO_KEEP_0__에 추가하세요: capacitor.config.ts.

import type { CapacitorConfig } from '@capacitor/cli';
import '@capgo/capacitor-recaptcha';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example',
  webDir: 'dist',
  plugins: {
    Recaptcha: {
      androidSiteKey: 'ANDROID_SITE_KEY',
      iosSiteKey: 'IOS_SITE_KEY',
      webSiteKey: 'WEB_SITE_KEY',
      enterprise: true,
    },
  },
};

export default config;

androidSiteKey, iosSiteKey그리고 webSiteKey 공유된 것을 덮어쓰세요. siteKey. 또한 다음을 전달할 수 있습니다. siteKey 직접 load() 으로 execute() 또는

Capacitor live-update 대안 비교 페이지에서 HTML 텍스트 조각입니다.

import { Recaptcha } from '@capgo/capacitor-recaptcha';

const { token } = await Recaptcha.execute({
  action: 'login',
});

await fetch('/api/recaptcha-assessment', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ token, action: 'login' }),
});

execute() Appflow 비교/이동 마케팅 복사본에서 역할: 장기 마케팅 또는 법률 문단. 페이지: page ionic-appflow.astro. Capgo 제품/브랜드 및 개발자 용어를 정확히 유지합니다. load() Capawesome 비교 페이지에서 HTML 텍스트 조각입니다.

Capawesome 비교 페이지에서 역할: 장기 마케팅 또는 법률 문단. 페이지: page capwesome.astro. Capgo 제품/브랜드 및 개발자 용어를 정확히 유지합니다. 메시지 키: capwesome_cta_questions (Capwesome CTA Questions). | Consulting 서비스 페이지에서 HTML 텍스트 조각입니다. 역할: 섹션 서브 타이틀 또는 태그 라인. 페이지: page consulting.astro. Capgo 제품/브랜드 및 개발자 용어를 정확히 유지합니다. 메시지 키: consulting_faq_subtitle (Consulting FAQ Subtitle). | Appflow 비교/이동 마케팅 복사본에서 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 페이지: page ionic-appflow.astro, page ionic-enterprise-plugins.astro, page solutions/ionic-enterprise-plugins.astro. 메시지 키: appflow_plugins_or (Appflow Plugins Or).

설정 enterprise: false Google의 표준 Web reCAPTCHA v3 스크립트를 로드합니다.

const { token } = await Recaptcha.execute({
  siteKey: 'WEB_V3_SITE_KEY',
  enterprise: false,
  action: 'signup',
});

Android 및 iOS에서 Google의 네이티브 모바일 SDK 경로는 Enterprise/mobile 전용입니다. native 플랫폼에서 SDK를 전달하면 표준 Web v3 키가 의도치 않게 사용되지 않습니다. enterprise: false 이동 노트

이동 노트

그리고 sitekeyAndroid 콜 옵션 및 __CAPGO_KEEP_0__ 구성에서 구버전을 지원합니다. 또한 sitekeyWeb in call options and Capacitor config. It also accepts sitekeyIos 콜 옵션 및 __CAPGO_KEEP_0__ 구성에서 구버전을 지원합니다. sitekeyIOS iOS 마이그레이션 별칭으로 사용하세요. 새로운 code에 대해 Capacitor 설정 이름을 선호하세요.

시작하기에서 계속

이러한 기능을 사용 중이라면 시작하기 인증 및 계정 흐름을 계획하고, 시작하기와 연결하세요. Using @capgo/capacitor-recaptcha Using @capgo/capacitor-recaptcha Using @capgo/capacitor-social-login Using @capgo/capacitor-passkey Using @capgo/capacitor-passkey Using @capgo/capacitor-recaptcha @capgo/capacitor-native-생체인증 for the implementation detail in @capgo/capacitor-native-생체인증, and 두 단계 인증 for the implementation detail in 두 단계 인증.