【鸿蒙5.0】向用户申请麦克风授权

news2025/5/31 20:28:07

#效果图

步骤

在 config.json 里声明权限：在项目的 config.json 文件中添加麦克风权限的声明，告知系统应用需要使用该权限。
检查权限状态：在代码里检查应用是否已经获得了麦克风权限。
请求权限：若应用未获得麦克风权限，就向用户请求该权限。
处理权限请求结果：根据用户对权限请求的响应进行相应处理。

1. 申请录音权限

为什么申请原因是？（规避法律风险）

首先需要在应用的`config.json`文件中声明需要使用的权限：

{
 "module": {
    "reqPermissions": [
      {
        "name": "ohos.permission.MICROPHONE",
        "reason": "需要麦克风权限以实现语音录制功能",
        "usedScene": {
          "ability": [
            "com.example.myapplication.MainAbility"
          ],
          "when": "inuse"
        }
      }
    ]
  }
}

2. 动态权限申请代码

在需要使用麦克风的地方，添加以下动态权限申请代码：

import abilityAccessCtrl from '@ohos.abilityAccessCtrl';
import common from '@ohos.app.ability.common';

async function requestMicrophonePermission(context: common.Context) {
  // 1. 创建AtManager实例
  let atManager = abilityAccessCtrl.createAtManager();
  
  try {
    // 2. 检查是否已有权限
    let grantStatus = await atManager.checkAccessToken('ohos.permission.MICROPHONE');
    
    if (grantStatus === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
      console.log('已获得麦克风权限');
      return true;
    } else {
      // 3. 请求权限
      console.log('开始请求麦克风权限');
      let requestPermissions: Array<string> = ['ohos.permission.MICROPHONE'];
      let result = await atManager.requestPermissionsFromUser(context, requestPermissions);
      
      if (result.authResults[0] === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
        console.log('用户授予了麦克风权限');
        return true;
      } else {
        console.log('用户拒绝了麦克风权限');
        return false;
      }
    }
  } catch (err) {
    console.error(`请求麦克风权限出错: ${err.code}, ${err.message}`);
    return false;
  }
}

3. 在Ability中使用

在Ability的onWindowStageCreate或其他需要的地方调用权限申请：

import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';

export default class MainAbility extends UIAbility {
  onWindowStageCreate(windowStage: window.WindowStage) {
    // 申请麦克风权限
    requestMicrophonePermission(this.context).then((granted) => {
      if (granted) {
        // 权限已授予，可以开始使用麦克风
        this.startRecording();
      } else {
        // 权限被拒绝，显示提示信息
        console.log('无法使用麦克风功能，因为权限被拒绝');
      }
    });
  }
  
  startRecording() {
    // 实现录音逻辑
  }
}

4. 处理权限拒绝情况

如果用户拒绝了权限，可以提供引导：

function showPermissionGuide() {
  // 显示如何手动开启权限的指引
  promptAction.showToast({
    message: '请在设置-应用-权限中开启麦克风权限',
    duration: 3000
  });
  
  // 或者跳转到应用设置页面
  // ...
}