指南
如何在 Capacitor 中使用 Permissions
使用 @capgo/capacitor-permissions
一个 TypeScript API,用统一的状态码在 iOS、Android 和 Web 上检查和请求运行时权限。
安装
bun add @capgo/capacitor-permissions
bunx cap sync
插件暴露的内容
check- 无需弹窗即可读取当前权限状态。request- 向用户请求单一权限。checkMultiple- 无需弹窗即可检查多项权限。requestMultiple- 按顺序请求多个权限。shouldShowRationale- 设置 Android 在再次请求前是否显示说明。openSettings- 当访问被拦截时,跳转至应用或通知设置。requestPreciseLocation- 在 iOS 上升级为精确位置,在 Android 上升级为精细位置。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/