スタートガイド

インストール

AIアシストによるセットアップでプラグインをインストールできます。以下のコマンドを使用して、お使いのAIツールに Capgo のスキルを追加してください：

bunx 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-permissions` plugin in my project.

手動セットアップを希望する場合は、以下のコマンドを実行してプラグインをインストールし、下記のプラットフォーム別の手順に従ってください：

bun add @capgo/capacitor-permissions
bunx cap sync

インポート

import { Permissions } from '@capgo/capacitor-permissions';

クイックスタート

import { Permissions } from '@capgo/capacitor-permissions';

const { status } = await Permissions.check({ permission: 'camera' });

例: request

import { Permissions } from '@capgo/capacitor-permissions';

const { status } = await Permissions.request({ permission: 'notifications' });

例: checkMultiple

import { Permissions } from '@capgo/capacitor-permissions';

const { statuses } = await Permissions.checkMultiple({
  permissions: ['camera', 'microphone'],
});

よくある落とし穴

• ネイティブ同期: 実行 bunx cap sync プラグインのアップグレード後。
• 信頼できる情報源: 信頼 src/definitions.ts GitHub リポジトリ内。

プラットフォームのセットアップ

• iOSの設定 Info.plistの利用目的（usage strings）について PermissionName.
• Androidの設定 を uses-permission エントリおよび minSdk 24。

使い方

import { Permissions } from '@capgo/capacitor-permissions';

export async function ensureCamera(): Promise<boolean> {
  const { status } = await Permissions.check({ permission: 'camera' });
  if (status === 'granted') return true;
  const { status: afterRequest } = await Permissions.request({ permission: 'camera' });
  return afterRequest === 'granted';
}

ステータスが blockedの場合、ユーザーを設定画面へ誘導します：

await Permissions.openSettings({ type: 'application' });