HarmonyOS开发：访问和管理动态照片资源

目录

• 前言
• 访问和管理动态照片简介
• 保存动态照片资源
• 获取动态照片对象
• 读取动态照片资源

• 结束语

  前言

  动态照片，能够展示在一小段时间内的动态画面和声音，兼具图片和视频的特性。无论是拍照还是在创作中，动态照片都会给我们带来更好的体验。HarmonyOS作为华为推出的新一代操作系统，在动态照片资源的访问和管理，为开发者提供了便捷而高效的解决方案。动态照片资源的管理包含资源的创建，保存，以及对这些资源的访问和读取。开发者需要在保证用户体验的同时，确保资源管理的高效性和安全性。HarmonyOS通过Media Library Kit媒体文件管理服务，为开发者提供了一套完整的API，使得动态照片资源的管理变得更加简单和直观。那么本文就来详细介绍如何在HarmonyOS中访问和管理动态照片资源，包括动态照片的创建、保存、获取以及资源的读取。

访问和管理动态照片简介

先来介绍一下访问和管理动态照片相关的简介，动态照片是一种结合了图片和视频的照片形式，可以显示一小段时间的动态画面和声音。帮助用户捕捉精彩的动态瞬间，提升创作者的创作空间，同时令拍照的容错率更高。媒体库提供访问和管理动态照片资源的能力，需要说明的是拍摄动态照片的能力由Camera Kit提供，主要分为下面几个方面：

• 使用安全控件保存动态照片资源
• 获取动态照片对象（MovingPhoto）
• 使用MovingPhotoView播放动态照片

• 读取动态照片资源

  保存动态照片资源

  先来介绍保存动态图片资源的使用，在使用安全控件保存动态照片资源后，可用于获取MovingPhoto对象，从而完成播放动态照片等操作。使用安全控件保存动态照片资源，无需申请相册管理模块权限'ohos.permission.WRITE_IMAGEVIDEO'，允许用户通过点击按钮临时获取存储权限，并将资源直接保存到指定的媒体库路径，使得操作更为便捷。
  1、开发步骤
  具体的开发实现步骤如下所示：
  1.设置安全控件按钮属性。
  2.创建安全控件按钮。
  3.调用MediaAssetChangeRequest.createAssetRequest接口新建一个创建资产的变更请求，指定待创建资产的子类型为动态照片。
  4.调用MediaAssetChangeRequest.addResource接口指定动态照片的图片和视频内容。本文示例以从应用沙箱fileUri指定动态照片的图片和视频内容为例。需要说明的是大家可以根据实际情况，通过ArrayBuffer的方式指定资源内容。
  5.调用PhotoAccessHelper.applyChanges接口提交创建资产的变更请求。
  接下来就来分享一个具体的示例，具体代码如下所示：

import { photoAccessHelper } from '@kit.MediaLibraryKit';

@Entry
@Component
struct Index {
  @State message: string = 'Hello World'
  @State saveButtonOptions: SaveButtonOptions = {
    icon: SaveIconStyle.FULL_FILLED,
    text: SaveDescription.SAVE_IMAGE,
    buttonType: ButtonType.Capsule
  } // 设置安全控件按钮属性

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
        SaveButton(this.saveButtonOptions) // 创建安全控件按钮
          .onClick(async (event, result: SaveButtonOnClickResult) => {
             if (result == SaveButtonOnClickResult.SUCCESS) {
               try {
                 let context = getContext();
                 let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);
                 // 需要确保imageFileUri和videoFileUri对应的资源存在，分别表示待创建到媒体库的动态照片的图片和视频。
                 let imageFileUri = 'file://com.example.temptest/data/storage/el2/base/haps/entry/files/create_moving_photo.jpg';
                 let videoFileUri = 'file://com.example.temptest/data/storage/el2/base/haps/entry/files/create_moving_photo.mp4';
                 let assetChangeRequest: photoAccessHelper.MediaAssetChangeRequest = photoAccessHelper.MediaAssetChangeRequest.createAssetRequest(context, photoAccessHelper.PhotoType.IMAGE, "jpg", {
                  title: "moving_photo",
                  subtype: photoAccessHelper.PhotoSubtype.MOVING_PHOTO
                 });
                 assetChangeRequest.addResource(photoAccessHelper.ResourceType.IMAGE_RESOURCE, imageFileUri);
                 assetChangeRequest.addResource(photoAccessHelper.ResourceType.VIDEO_RESOURCE, videoFileUri);
                 await phAccessHelper.applyChanges(assetChangeRequest);

               } catch (err) {

               }
             } else {

             }
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}

获取动态照片对象

接下来再来分享一下关于获取动态照片对象的操作，具体如下所示：

• 应用可以通过picker的方式获取用户媒体库里的动态照片对象，后续可用于在应用内播放动态照片，或是读取动态照片资源进行其他操作（如上传到应用共享给他人浏览等）。

• 应用也可以通过传入应用沙箱的图片和视频fileUri的方式构造应用本地的动态照片对象。

  1、获取媒体库动态照片对象

  先来介绍一下获取媒体库动态照片对象的步骤，具体如下所示：

• 首先，通过Picker选择动态照片uri。
• 然后，调用PhotoAccessHelper.getAssets和FetchResult.getFirstObject接口获取uri对应的PhotoAsset资产。
• 最后，调用MediaAssetManager.requestMovingPhoto获取PhotoAsset对应的动态照片对象（MovingPhoto）。
  具体的实现步骤如下所示：

import { photoAccessHelper } from '@kit.MediaLibraryKit';
import { dataSharePredicates } from '@kit.ArkData';
let context = getContext(this);
let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);

async function example() {
  try {
    // picker选择动态照片uri
    let photoSelectOptions = new photoAccessHelper.PhotoSelectOptions();
    photoSelectOptions.MIMEType = photoAccessHelper.PhotoViewMIMETypes.MOVING_PHOTO_IMAGE_TYPE;
    photoSelectOptions.maxSelectNumber = 9;
    let photoViewPicker = new photoAccessHelper.PhotoViewPicker();
    let photoSelectResult = await photoViewPicker.select(photoSelectOptions);
    let uris = photoSelectResult.photoUris;
    for (let i = 0; i < uris.length; i++) {
      // 获取uri对应的PhotoAsset资产
      let predicates: dataSharePredicates.DataSharePredicates = new dataSharePredicates.DataSharePredicates();
      predicates.equalTo(photoAccessHelper.PhotoKeys.URI, uris[i]);
      let fetchOption: photoAccessHelper.FetchOptions = {
        fetchColumns: [],
        predicates: predicates
      };
      let fetchResult: photoAccessHelper.FetchResult<photoAccessHelper.PhotoAsset> = await phAccessHelper.getAssets(fetchOption);
      let photoAsset: photoAccessHelper.PhotoAsset = await fetchResult.getFirstObject();
      // 获取PhotoAsset对应的动态照片对象
      await photoAccessHelper.MediaAssetManager.requestMovingPhoto(context, photoAsset, {
        deliveryMode: photoAccessHelper.DeliveryMode.FAST_MODE
      }, {
        async onDataPrepared(movingPhoto: photoAccessHelper.MovingPhoto) {
          if (movingPhoto !== undefined) {
            // 应用可自定义对movingPhoto的处理逻辑

          }
        }
      })
    }
  } catch (err) {

  }
}

2、获取应用沙箱动态照片对象

接着介绍调用MediaAssetManager.loadMovingPhoto加载应用沙箱的动态照片对象（MovingPhoto），具体操作如下：

import { photoAccessHelper } from '@kit.MediaLibraryKit';
let context = getContext(this);

async function example() {
  try {
    let imageFileUri = 'file://com.example.temptest/data/storage/el2/base/haps/entry/files/local_moving_photo.jpg';
    let videoFileUri = 'file://com.example.temptest/data/storage/el2/base/haps/entry/files/local_moving_photo.mp4';
    let movingPhoto = await photoAccessHelper.MediaAssetManager.loadMovingPhoto(context, imageFileUri, videoFileUri);

  } catch (err) {

  }
}

读取动态照片资源

最后再来介绍一下读取动态照片资源的操作步骤，对于一个动态照片对象，应用可以通过MovingPhoto.requestContent的接口导出图片和视频到应用沙箱，或者读取图片或视频的ArrayBuffer内容。具体操作如下：

import { photoAccessHelper } from '@kit.MediaLibraryKit';

async function example(movingPhoto: photoAccessHelper.MovingPhoto) {
  try {
    let imageFileUri = 'file://com.example.temptest/data/storage/el2/base/haps/entry/files/request_moving_photo.jpg';
    let videoFileUri = 'file://com.example.temptest/data/storage/el2/base/haps/entry/files/request_moving_photo.mp4';
    await movingPhoto.requestContent(imageFileUri, videoFileUri); // 将动态照片导出到应用沙箱
    let imageData = await movingPhoto.requestContent(photoAccessHelper.ResourceType.IMAGE_RESOURCE); // 读取图片的ArrayBuffer内容
    let videoData = await movingPhoto.requestContent(photoAccessHelper.ResourceType.VIDEO_RESOURCE); // 读取视频的ArrayBuffer内容
  } catch (err) {

  }
}

结束语

通过本文对访问和管理动态照片资源的详细介绍，不难看出动态照片是一种新兴的多媒体形式，无论是生活中还是在开发者的创作中，运用率都非常高，而且在实际开发中也是常用的场景。上面对如何在HarmonyOS中实现对动态照片资源的访问和管理作了全面的介绍，大家应该也有了详细的了解。个人觉得，作为开发者利用好这些步骤和技术细节，将会在提高应用的性能地同时给用户带来更好的体验。