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-privacy-screen`
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/privacy-screen/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 セットアップを使用してプラグインをインストールできます。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-privacy-screen` plugin in my project.

マニュアルセットアップを使用する場合は、以下のコマンドを実行してプラットフォーム固有の指示に従ってください:

プラグインをインストール
ターミナルウィンドウ
```
bun add @capgo/capacitor-privacy-screen
```
ネイティブプラットフォームを同期
ターミナルウィンドウ
```
bunx cap sync
```
プラットフォームの動作を確認
- 「{__CAPGO_KEEP_0__}スタイルガイド」を参照してください iOSの注意事項アプリSwitcherの動作について。
- Capgoのスタイルガイドを参照してください。 Androidの注意事項スクリーンショットとレコーディングの動作について。

デフォルトの動作

プラグインは、ネイティブ実装が読み込まれると、プライバシー保護を自動的に有効にします。

Androidでは、安全モードはスクリーンショット、スクリーンレコーディングのキャプチャ、そして最近のアプリのプレビューをブロックします。
iOSでは、アプリSwitcherのスナップショット生成中にアプリを非表示にします。
Webでは、プラグインはAPIのパリティのために、メモリ内に有効なフラグを保持します。

基本的な使用方法

import { PrivacyScreen } from '@capgo/capacitor-privacy-screen';

await PrivacyScreen.disable();

// Run a flow where screenshots or previews are temporarily allowed.

await PrivacyScreen.enable();

const { enabled } = await PrivacyScreen.isEnabled();
console.log('Privacy screen enabled:', enabled);

一時的に無効にするタイミング

使用 disable() システムプレビューで現在の画面が表示されるか、ユーザーがキャプチャできるようにする場合のみ使用してください。例えば、以下のシナリオがあります。

サポートのためにスクリーンショットが必要なアカウント検証手順
アプリSwitcherプレビューが必要な決済またはIDプロバイダーフロー
信頼できるデバイスで制御されたデバッグセッション

保護を即座に復元するには enable().

続けてGetting Started

Capgoを使用している場合 Getting Started セキュリティとコンプライアンスを計画するには Capgoの@capgo/capacitor-プライバシースクリーンを使用 Capgoの@capgo/capacitor-プライバシースクリーン暗号化暗号化の実装詳細コンプライアンスコンプライアンスの実装詳細 Capgo セキュリティスキャナー Capgo セキュリティスキャナー Capgo セキュリティ製品ワークフローにおけるCapgo セキュリティのため