更新记录

1.0.3（2026-02-02） 下载此版本

• 新增存储权限
• 修复一些问题

1.0.2（2026-01-14） 下载此版本

• 修改说明文档

1.0.1（2025-12-31） 下载此版本

• 优化了一些问题

平台兼容性

uni-app(3.6.16)

权限 & 系统开关 API 快速指南

1. 引入方式

import {
    PermissionKey,
    ensurePermission,
    getPermissionStatus,
    SystemServiceKey,
    isSystemServiceEnabled
} from '@/uni_modules/s-permission/js_sdk'

2. 权限（Permission）

用于访问用户敏感信息或设备功能，如相机、麦克风、定位等。

示例

• 确保权限（弹窗请求用户授权）

  await ensurePermission(PermissionKey.CAMERA)

• 查询权限状态（不弹窗）

  const status = await getPermissionStatus(PermissionKey.LOCATION_WHEN_IN_USE)

权限列表

权限状态说明（PermissionStatus）

3. 系统开关（System Service）

用于检查设备能力或系统服务状态，例如定位、蓝牙。 ⚠️ 注意：系统开关 ≠ 权限，iOS 上部分状态不保证准确。

示例

const enabled = await isSystemServiceEnabled(SystemServiceKey.LOCATION)

console.log(enabled) // true / false

系统开关列表

4. 推荐使用方式

1. 权限操作 → ensurePermission()
2. 功能能力判断 → 直接尝试功能或用 isSystemServiceEnabled()
3. 失败处理 → 提示用户去系统设置开启权限或服务

示例：检查相机权限并拍照

const status = await ensurePermission(PermissionKey.CAMERA)

if (status === 'authorized') {
    // 调用拍照功能
} else {
    // 提示用户去系统设置开启权限
}