メインコンテンツへスキップ
@capgo/capacitor-permissions デバイス API オープンソース

権限 Capacitor プラグイン

1つの PermissionName enum と正規化されたステータスコードで、iOS、Android、Web の実行時権限を確認・リクエストできます

インストール

bun add @capgo/capacitor-permissions bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-permissions
  • pnpm add @capgo/capacitor-permissions
  • yarn add @capgo/capacitor-permissions

ガイド

Capacitor で Permissions を使う方法

@capgo/capacitor-permissions の使い方

iOS、Android、Web で実行時の権限を確認・リクエストできる、正規化されたステータスコード付きの TypeScript API。

インストール

bun add @capgo/capacitor-permissions
bunx cap sync

このプラグインで利用可能な機能

  • check - プロンプトを表示せずに、1つの権限の現在のステータスを取得します。
  • request - ユーザーに1つの権限をリクエストします。
  • checkMultiple - プロンプトを表示せずに、複数の権限を確認します。
  • requestMultiple - 複数の権限を順番にリクエストします。
  • shouldShowRationale - Androidで再リクエストする前に説明(rationale)を表示するかどうか。
  • openSettings - アクセスがブロックされている場合に、アプリまたは通知の設定画面を開きます。
  • requestPreciseLocation - iOSでは正確な位置情報、Androidではfine locationにアップグレードします。
  • getPluginVersion - プラットフォーム実装のバージョンマーカーを返します。

使用例

check と request

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

openSettings

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

document.getElementById('camera-settings')?.addEventListener('click', async () => {
  const { status } = await Permissions.check({ permission: 'camera' });
  if (status === 'blocked') {
    await Permissions.openSettings({ type: 'application' });
  }
});

リファレンス全文

よくある質問

Permissions プラグイン FAQ

Capacitor アプリに Permissions プラグインをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-permissions"(または "npm install @capgo/capacitor-permissions")を実行した後、"bunx cap sync" を実行して、iOS および Android プロジェクトにネイティブの code を反映させてください。その後、アプリの code から "@capgo/capacitor-permissions" をインポートします。

@capgo/capacitor-permissions は React、Vue、Angular で動作しますか?

はい。Permissions は Capacitor パッケージなので、Ionic、React、Vue、Angular、Svelte、およびプレーンな JavaScript を含む、Capacitor 内で動作するあらゆる Web フレームワークで使用できます。

@capgo/capacitor-permissions はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-permissions は無料でオープンソースですか?

はい。code のソースコードは GitHub の https://github.com/Cap-go/capacitor-permissions/ で公開されており、パッケージは npm から無料でインストールできます。バグ報告やプルリクエストも歓迎しています。

App Store の審査なしで、Permissions を使用している code をアップデートできますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリの審査を待たずに、権限設定の変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める