ガイド
Capacitorでパーミッションを使用する方法
@capgo/capacitor-permissionsを使用する
一つのTypeScript APIで、iOS、Android、Webでパーミッションをチェックおよび要求し、標準化されたステータスコードを使用します。
インストール
bun add @capgo/capacitor-permissions
bunx cap sync
このプラグインが公開するもの
check- 1 つの権限の現在の状態を読み取る。request- ユーザーから 1 つの権限を要求する。checkMultiple- 1 つの権限の許可を確認する。requestMultiple- 1 つの権限をユーザーに要求する。shouldShowRationale- Android が再度要求する前に、ユーザーに説明を表示するかどうかを指定する。openSettings- アクセスがブロックされたときに、設定を開く。requestPreciseLocation- iOS では正確な位置、Android では細かい位置を取得する。getPluginVersion- プラットフォーム実装のバージョンマーカーを取得する。
- Example Usage
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' });
}
});
- Full Reference
- - GitHub: https://github.com/Cap-go/capacitor-permissions/
- ドキュメント: /docs/plugins/permissions/