HarmonyOS开发：拍照使用详解

目录

• 前言
• 拍照功能介绍
• 关于拍照功能
• 关于拍照使用详解的应用
• 实现拍照使用详解

• 结束语

  前言

  我们常常使用智能手机和移动设备的摄像头来记录生活中的美好瞬间，然后在社交媒体上分享这些美好。然而随着时间的推移，用户对拍照体验的要求越来越高，从简单的图像捕捉到如今的高清摄影、夜景模式、人像模式等高级功能，手机摄影对开发者来说充满创新和挑战。HarmonyOS，兼具安卓系统的开放性和灵活性，还在此基础上进行了深度优化和功能扩展，特别是在多媒体和摄像头应用方面提供了强大的支持。本文将详细介绍拍照功能在HarmonyOS中的应用开发涉及到多个关键步骤，包括权限申请、相机设备的创建和管理、会话的配置、拍照触发以及图片的保存等。

拍照功能介绍

先来介绍一下拍照的使用，拍照是相机的最重要功能之一，拍照模块基于相机复杂的逻辑，为了保证用户拍出的照片质量，在中间步骤可以设置分辨率、闪光灯、焦距、照片质量及旋转角度等信息。拍照功能涉及相机硬件的访问、图像捕获、图像处理和保存等多个步骤。在HarmonyOS中，可以通过CameraKit提供的能力来实现拍照功能。

关于拍照功能

在HarmonyOS中，拍照一般涉及到下面的几个方面，具体如下所示：
1.权限申请：在应用的配置文件中添加相机权限。
2.相机服务访问：获取相机服务并配置相机参数。
3.预览和捕获：显示相机预览并捕获图像。
4.图像处理：对捕获的图像进行处理，如裁剪、旋转等。
5.保存和分享：保存图像到本地存储或分享到其他应用。

实现拍照功能

步骤1：导入接口

首先导入image接口。创建拍照输出流的SurfaceId以及拍照输出的数据，都需要用到系统提供的image接口能力，导入image接口的方法如下所示：

import { image } from '@kit.ImageKit';
import { camera } from '@kit.CameraKit';
import { fileIo as fs } from '@kit.CoreFileKit';
import { photoAccessHelper } from '@kit.MediaLibraryKit';
import { BusinessError } from '@kit.BasicServicesKit';

步骤2：创建拍照输出流

然后通过CameraOutputCapability类中的photoProfiles属性，可获取当前设备支持的拍照输出流，通过createPhotoOutput方法传入支持的某一个输出流及步骤一获取的SurfaceId创建拍照输出流。具体实现如下所示：

function getPhotoOutput(cameraManager: camera.CameraManager, cameraOutputCapability: camera.CameraOutputCapability): camera.PhotoOutput | undefined {
  let photoProfilesArray: Array<camera.Profile> = cameraOutputCapability.photoProfiles;
  if (!photoProfilesArray) {

  }
  let photoOutput: camera.PhotoOutput | undefined = undefined;
  try {
    photoOutput = cameraManager.createPhotoOutput(photoProfilesArray[0]);
  } catch (error) {
    let err = error as BusinessError;

  }
  return photoOutput;
}

步骤3：预览和捕获

然后设置拍照photoAvailable的回调，并将拍照的buffer保存为图片。如需要在图库中看到所保存的图片、视频资源，需要将其保存到媒体库。还有就是需要在photoOutput.on('photoAvailable')接口获取到buffer时，将buffer在安全控件中保存到媒体库。具体实现如下所示：

let context = getContext(this);

function setPhotoOutputCb(photoOutput: camera.PhotoOutput) {
//设置回调之后，调用photoOutput的capture方法，就会将拍照的buffer回传到回调中
  photoOutput.on('photoAvailable', (errCode: BusinessError, photo: camera.Photo): void => {
    
     if (errCode || photo === undefined) {

       return;
     }
     let imageObj: image.Image = photo.main;
     imageObj.getComponent(image.ComponentType.JPEG, (errCode: BusinessError, component: image.Component): void => {

       if (errCode || component === undefined) {

         return;
       }
       let buffer: ArrayBuffer;
       if (component.byteBuffer) {
         buffer = component.byteBuffer;
       } else {

         return;
       }
       // 如需要在图库中看到所保存的图片、视频资源，请使用用户无感的安全控件创建媒体资源。buffer处理结束后需要释放该资源，如果未正确释放资源会导致后续拍照获取不到buffer
       imageObj.release(); 
     });
   });
}

步骤4：参数配置

然后进行配置相机的参数可以调整拍照的一些功能，包括闪光灯、变焦、焦距等。具体如下所示：

function configuringSession(photoSession: camera.PhotoSession): void {
  // 判断设备是否支持闪光灯
  let flashStatus: boolean = false;
  try {
    flashStatus = photoSession.hasFlash();
  } catch (error) {
    let err = error as BusinessError;

  }

  if (flashStatus) {
    // 判断是否支持自动闪光灯模式
    let flashModeStatus: boolean = false;
    try {
      let status: boolean = photoSession.isFlashModeSupported(camera.FlashMode.FLASH_MODE_AUTO);
      flashModeStatus = status;
    } catch (error) {
      let err = error as BusinessError;

    }
    if (flashModeStatus) {
      // 设置自动闪光灯模式
      try {
        photoSession.setFlashMode(camera.FlashMode.FLASH_MODE_AUTO);
      } catch (error) {
        let err = error as BusinessError;

      }
    }
  }
  // 判断是否支持连续自动变焦模式
  let focusModeStatus: boolean = false;
  try {
    let status: boolean = photoSession.isFocusModeSupported(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO);
    focusModeStatus = status;
  } catch (error) {
    let err = error as BusinessError;

  }
  if (focusModeStatus) {
    // 设置连续自动变焦模式
    try {
      photoSession.setFocusMode(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO);
    } catch (error) {
      let err = error as BusinessError;

    }
  }
  // 获取相机支持的可变焦距比范围
  let zoomRatioRange: Array<number> = [];
  try {
    zoomRatioRange = photoSession.getZoomRatioRange();
  } catch (error) {
    let err = error as BusinessError;

  }
  if (zoomRatioRange.length <= 0 ) {
    return;
  }
  // 设置可变焦距比
  try {
    photoSession.setZoomRatio(zoomRatioRange[0]);
  } catch (error) {
    let err = error as BusinessError;

  }
}

步骤5：触发拍照

最后就是通过photoOutput类的capture方法，执行拍照任务。该方法有两个参数，第一个参数为拍照设置参数的setting，setting中可以设置照片的质量和旋转角度，第二参数为回调函数。获取拍照旋转角度的方法为，通过PhotoOutput类中的getPhotoRotation方法获取rotation实际的值，具体如下所示：

function capture(captureLocation: camera.Location, photoOutput: camera.PhotoOutput): void {
  let settings: camera.PhotoCaptureSetting = {
    quality: camera.QualityLevel.QUALITY_LEVEL_HIGH,  // 设置图片质量高
    rotation: camera.ImageRotation.ROTATION_0,  // 设置图片旋转角度的camera.ImageRotation.ROTATION_0是通过说明中获取拍照角度的getPhotoRotation方法获取的值进行设置
    location: captureLocation,  // 设置图片地理位置
    mirror: false  // 设置镜像使能开关(默认关)
  };
  photoOutput.capture(settings, (err: BusinessError) => {
    if (err) {

      return;
    }

  });
}

状态监听

最后再来简单介绍一下拍照过程中的状态监听相关的内容，在相机应用开发过程中，可以随时监听拍照输出流状态，包括拍照流开始、拍照帧的开始与结束、拍照输出流的错误。具体体现在以下几个方面：

• 通过注册固定的captureStart回调函数获取监听拍照开始结果，photoOutput创建成功时即可监听，相机设备已经准备开始这次拍照时触发，该事件返回此次拍照的captureId。
• 通过注册固定的captureEnd回调函数获取监听拍照结束结果，photoOutput创建成功时即可监听，该事件返回结果为拍照完全结束后的相关信息CaptureEndInfo。
• 通过注册固定的captureReady回调函数获取监听可拍下一张结果，photoOutput创建成功时即可监听，当下一张可拍时触发，该事件返回结果为下一张可拍的相关信息。

• 通过注册固定的error回调函数获取监听拍照输出流的错误结果。回调返回拍照输出接口使用错误时的对应错误码，错误码类型参见Camera错误码。

  结束语

  经过本文的介绍，相信我们对如何在HarmonyOS中实现拍照功能有了全面的了解，也可以看到HarmonyOS中拍照体验高，高质量的图片，更便捷的操作和更智能的功能，精彩的视觉体验。拍照技术在智能手机中的应用已经不再是简单的图像捕捉，它涉及到用户体验、图像处理、硬件优化，人工智能、等多个层面。“ 路漫漫其修远兮，吾将上下而求索”。希望HarmonyOS是开发旅程中的一盏明灯，照亮大家前行的道路，在未来带给我们更多的可能性，共同推动智能设备和应用的发展，在实际开发中构建出功能丰富、且能为为用户提供更加丰富和生动的拍照体验。