第24篇｜相机权限和设备枚举：先判断能力再打开预览

双镜记忆相机的相机页不能只靠一个"打开相机"按钮。真正稳定的 CameraKit 入口，需要把 CAMERA 权限、Surface 是否就绪、设备列表、前后摄能力和并发能力都串成一条清晰链路。

学习目标

知道 module.json5 与运行时授权分别解决什么问题。
能从 CameraManager 获取设备列表，并区分后摄、前摄和单摄兜底设备。
理解为什么要在预览前先做能力探测，而不是失败后再补救。
把权限失败、设备为空、Surface 未就绪变成用户可理解的状态。

一、先看相机入口应该长什么样

第 24 篇先不急着拍照，而是把相机页打开前的地基铺稳。双镜记忆相机的目标是同时服务"双拍"和"单拍回退"，所以入口处要做三件事：页面上的 Surface 已经创建，用户已经允许 CAMERA 权限，设备侧至少能找到一个可用 CameraDevice。只有这三个条件都满足，后面的 PreviewOutput、PhotoSession、PhotoOutput 才有意义。

如果直接在页面出现时调用 createCameraInput，常见问题是黑屏、权限弹窗还没响应就初始化失败、部分机型只有一个摄像头时双摄逻辑反复重试。训练营的写法是先把能力探测做完整，再决定进入双摄、单摄或提示用户处理权限。

图 1 相机页运行效果与权限、设备探测链路

二、清单权限：module.json5 先声明 CAMERA

HarmonyOS 的相机权限不是只在代码里请求就够了，模块配置里必须先声明需要的权限和使用场景。项目的声明放在 entry/src/main/module.json5 的 requestPermissions 节点中，CAMERA 权限限定在 EntryAbility 的 inuse 场景。这样系统权限弹窗有合法来源，审核时也能看到权限用途。

这一步解决的是"应用有没有资格申请权限"的问题；下一步 requestPermissionsFromUser 解决的是"用户是否同意"。两个层次缺一不可。

图 2 module.json5 中的 CAMERA 权限声明

json 复制代码

"requestPermissions": [
      {
        "name": "ohos.permission.CAMERA",
        "reason": "$string:camera_permission_reason",
        "usedScene": {
          "abilities": [
            "EntryAbility"
          ],
          "when": "inuse"
        }
      },

三、运行时授权：先查状态，再触发请求

进入相机页后，项目先通过 checkPermissionGrant 判断当前是否已经授权。如果已经授权，直接返回 true；如果还没有授权，再调用 requestPermissionsFromUser。这里还有一个细节：权限请求和短超时用 Promise.race 包住，避免用户停留在系统弹窗或系统返回异常时，页面一直处于"正在申请权限"的等待态。

这段逻辑的价值不只是拿到布尔值，而是让相机入口具备可恢复能力。权限已经给过时，不重复打扰用户；权限没有给时，页面能给出可见提示；授权结果回来后，再继续初始化 CameraKit。

图 3 Index.ets 中运行时 CAMERA 权限请求逻辑

ts 复制代码

private async requestCameraPermission(): Promise<boolean> {
    const atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
    const hostContext = this.getUIContext().getHostContext() as common.UIAbilityContext;
    try {
      const currentGrant = await this.checkPermissionGrant('ohos.permission.CAMERA');
      if (currentGrant === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
        console.info('[superImage][capture] camera permission already granted');
        return true;
      }

      console.info('[superImage][capture] request camera permission from user');
      const requestPromise: Promise<PermissionRequestResult> = atManager.requestPermissionsFromUser(
        hostContext,
        this.cameraPermissionList
      );
      const timeoutPromise: Promise<PermissionRequestResult | undefined> = new Promise((resolve) => {
        setTimeout(() => {
          resolve(undefined);
        }, 1800);
      });
      const result = await Promise.race([requestPromise, timeoutPromise]);
      if (!result) {

四、设备枚举：从 CameraManager 推导可用路线

权限通过后，项目创建 CameraManager，并调用 getSupportedCameras 获取设备列表。这个列表不是拿来展示数字的，而是整个相机模式的决策输入：能找到后摄和前摄，就继续探测官方并发能力；只找到一个设备，就进入单摄预览；设备为空，就不要创建会话，直接结束探测并保持页面可重试。

注意这里没有把"双摄支持"当成默认成立。项目会先拿官方推荐的前后摄组合，再看 getCameraConcurrentInfos 是否返回内容。返回为空并不代表应用坏了，而是当前设备不支持前后摄同时工作，这时应该优雅回退到单摄。

图 4 权限通过后初始化 CameraKit 并枚举设备

ts 复制代码

this.cameraStatusText = '正在初始化 CameraKit...';
      const hostContext = this.getUIContext().getHostContext() as common.UIAbilityContext;
      const cameraManager: camera.CameraManager = camera.getCameraManager(hostContext);
      const cameras: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
      console.info(`[superImage][capture] camera devices=${cameras.length}`);
      this.cameraDeviceCount = cameras.length;
      this.cameraProbeResultText = this.buildConcurrentProbeReport(cameraManager, cameras);
      if (cameras.length === 0) {
        this.cameraCapabilityChecked = true;
        this.cameraStatusText = '';
        return;
      }

      const officialPair = this.getOfficialConcurrentCameraPair(cameraManager);
      const backDevice = officialPair.backDevice ??
        this.findCameraDeviceByPosition(cameras, camera.CameraPosition.CAMERA_POSITION_BACK);
      const frontDevice = officialPair.frontDevice ??
        this.findCameraDeviceByPosition(cameras, camera.CameraPosition.CAMERA_POSITION_FRONT);
      const fallbackSingleDevice = backDevice ?? frontDevice ?? cameras[0];
      this.cameraManager = cameraManager;
      this.backCameraDevice = backDevice;
      this.frontCameraDevice = frontDevice;
      this.preferredBackSingleCameraDevice = backDevice;
      this.singleCameraDevice = fallbackSingleDevice;
      this.singleCameraRole = this.getCameraRole(fallbackSingleDevice);
      this.singleCameraSupported = true;
      this.refreshBackLensOptions(cameras, backDevice);

      if (!backDevice || !frontDevice) {
        this.cameraCapabilityChecked = true;
        this.cameraStatusText = '';
        await this.ensureCameraPreview();
        return;
      }
      const concurrentInfos = officialPair.concurrentInfos;
      this.concurrentInfos = concurrentInfos;
      this.cameraCapabilityChecked = true;
      this.cameraConcurrentProfileCount = concurrentInfos.length;
      this.dualCameraSupported = concurrentInfos.length > 0;
      if (this.dualCameraSupported) {
        this.cameraStatusText = '';
        await this.ensureCameraPreview();
      } else {
        this.cameraStatusText = '';
        await this.ensureCameraPreview();

五、把入口状态设计成可解释，而不是只看异常

相机入口最容易被忽略的是"半成功状态"。例如 Surface 还没创建，但权限已经允许；设备列表有后摄没有前摄；并发能力为空但单摄可用；权限弹窗超时但用户稍后又打开系统设置授权。项目没有把这些都归成一个 catch，而是拆成 cameraPermissionReady、cameraCapabilityChecked、dualCameraSupported、singleCameraSupported、cameraStatusText 等状态。

这么做的好处是页面能知道下一步应该做什么。Surface 未就绪就稍后 scheduleCameraCapabilityPrepare；权限未通过就展示提示；双摄不支持就调用 ensureCameraPreview 进入单摄；能力探测完成后不再重复请求。相机页由此从"碰运气打开"变成"按条件推进"。

训练营后续的双摄、镜头、闪光灯和失败态，都会复用这条入口链路。第 24 篇要记住的核心不是某一个 API，而是顺序：声明权限、请求授权、等待 Surface、枚举设备、探测并发、选择模式。

本篇检查清单

权限声明位于 module.json5，并且 CAMERA 的 usedScene 指向 EntryAbility。
requestCameraPermission 先查已有授权，再请求用户授权。
prepareCameraCapability 在 Surface 未就绪时不会强行创建相机会话。
设备为空、只有单摄、双摄并发为空都能走到明确分支。
正文配图包含运行截图、权限声明截图、运行时权限代码截图和 CameraKit 初始化截图。

今日练习

在真机上清除应用权限后重新进入相机页，观察权限弹窗和页面提示。
给 prepareCameraCapability 增加一条日志，记录 cameras.length 与 concurrentInfos.length。
把设备为空分支写成一条用户可读文案，再验证不会继续创建 PhotoSession。