ガイド
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' });
}
});
リファレンス全文
- GitHub: https://github.com/Cap-go/capacitor-permissions/
- ドキュメント: /docs/plugins/permissions/