权限状态 | AIUI | Rokid

使用 navigator.permissions.query() 读取定位、摄像头和麦克风的当前权限状态,并监听后续变化。查询只读本地状态,不弹出授权界面,也不会开始采集。

权限状态

使用 navigator.permissions.query() 读取定位、摄像头和麦克风的当前权限状态,并监听后续变化。查询只读本地状态,不弹出授权界面,也不会开始采集。

在使用麦克风前检查状态

完整应用先在 app.json.permissions 中声明 RECORD_AUDIO,再在用户操作中查询并使用麦克风:

async function openMicrophone() {
  const status = await navigator.permissions.query({ name: 'microphone' });
  if (status.state === 'denied') {
    console.log('麦克风权限已拒绝');
    return null;
  }
  return navigator.mediaDevices.getUserMedia({ audio: true });
}

prompt 表示尚未决定,只有调用 getUserMedia() 等敏感 API 才可能进入授权流程。即使状态为 granted,设备不可用或系统权限被拒绝时,采集仍会失败;调用方应处理 Promise 拒绝。使用完毕后停止返回流的所有轨道。

跟随权限变化更新界面

保留返回的状态对象,读取最新的 state。页面卸载时可以通过 signal 一起注销监听器:

export default {
  data: { microphonePermission: 'prompt' },
  async onLoad() {
    const lifetime = new AbortController();
    this.permissionLifetime = lifetime;
    const status = await navigator.permissions.query({ name: 'microphone' });
    if (lifetime.signal.aborted) return;
    const update = () => this.setData({ microphonePermission: status.state });
    status.addEventListener('change', update, { signal: lifetime.signal });
    update();
  },
  onUnload() {
    this.permissionLifetime?.abort();
  },
};

声明与授权

能力app.json.permissions 声明查询名称
定位GEOLOCATIONgeolocation
摄像头CAMERAcamera
麦克风RECORD_AUDIOmicrophone

清单声明不等于系统授权。应用应声明实际需要的权限。权限状态按应用会话保存,重新打开应用会建立新会话;运行中修改 app.json 不会更新当前权限。

同一次采集同时需要相机和麦克风时,两项都获准才能继续。当前没有通用的 navigator.permissions.request() 方法;权限查询也不支持媒体库或蓝牙等其他名称。

API Reference

Permissions

navigator.permissions

只读权限查询对象,通过现有 navigator 获取;不能通过 new Permissions() 创建。

query(descriptor)

返回 Promise<PermissionStatus>。

字段类型必填说明
descriptor.name'geolocation' | 'camera' | 'microphone'是权限查询名称,区分大小写。
descriptor.panTiltZoomfalse否仅适用于相机;当前不支持 true。

缺少或无效的描述对象、未知名称,以及相机 panTiltZoom: true 都以 TypeError 拒绝。查询不触发授权请求,也不代表对应设备一定可用。

PermissionStatus

name

只读权限名称,与查询的 descriptor.name 一致。

state

实时只读状态:granted 表示当前会话允许,denied 表示拒绝,prompt 表示尚未决定。状态来自当前会话的权限记录,不是操作系统权限的独立探测结果。

change

该权限状态变化时触发的 Event。在回调中读取 status.state 获取新值,使用标准事件方法添加和移除监听器。

onchange

可赋值的事件处理函数,默认 null;设为 null 可清除此处理函数。不能通过 new PermissionStatus() 创建状态对象。