鸿蒙5.0版开发：图片开发(ArkTS)-使用ImagePacker完成图片编码

 往期鸿蒙全套实战文章必看：

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

使用ImagePacker完成图片编码

图片编码指将PixelMap编码成不同格式的存档图片，当前支持打包为JPEG、WebP、png和 HEIF(不同硬件设备支持情况不同) 格式，用于后续处理，如保存、传输等。

开发步骤

图片编码相关API的详细。

图片编码进文件流

1. 创建图像编码ImagePacker对象。

   // 导入相关模块包
   import { image } from '@kit.ImageKit';
   
   const imagePackerApi = image.createImagePacker();

2. 设置编码输出流和编码参数。

   • format为图像的编码格式；quality为图像质量，范围从0-100，100为最佳质量。

     说明

     根据MIME标准，标准编码格式为image/jpeg。当使用image编码时，PackingOption.format设置为image/jpeg，image编码后的文件扩展名可设为.jpg或.jpeg，可在支持image/jpeg解码的平台上使用。

     let packOpts : image.PackingOption = { format:"image/jpeg", quality:98 };

   • 编码为hdr内容(需要资源本身为hdr，支持jpeg格式)。

     packOpts.desiredDynamicRange = image.PackingDynamicRange.AUTO;

3. 创建PixelMap对象或创建ImageSource对象。

4. 进行图片编码，并保存编码后的图片。

   方法一：通过PixelMap进行编码。

   import { BusinessError } from '@kit.BasicServicesKit';
   imagePackerApi.packing(pixelMap, packOpts).then( (data : ArrayBuffer) => {
     // data 为打包获取到的文件流，写入文件保存即可得到一张图片
   }).catch((error : BusinessError) => { 
     console.error('Failed to pack the image. And the error is: ' + error); 
   })

   方法二：通过imageSource进行编码。

   import { BusinessError } from '@kit.BasicServicesKit';
   imagePackerApi.packing(imageSource, packOpts).then( (data : ArrayBuffer) => {
       // data 为打包获取到的文件流，写入文件保存即可得到一张图片
   }).catch((error : BusinessError) => { 
     console.error('Failed to pack the image. And the error is: ' + error); 
   })

图片编码进文件

在编码时，开发者可以传入对应的文件路径，编码后的内存数据将直接写入文件。

方法一：通过PixelMap编码进文件。

import { BusinessError } from '@kit.BasicServicesKit';
import { fileIo as fs } from '@kit.CoreFileKit';
const context : Context = getContext(this);
const path : string = context.cacheDir + "/pixel_map.jpg";
let file = fs.openSync(path, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE);
imagePackerApi.packToFile(pixelMap, file.fd, packOpts).then(() => {
    // 直接打包进文件
}).catch((error : BusinessError) => { 
  console.error('Failed to pack the image. And the error is: ' + error); 
})

方法二：通过imageSource编码进文件。

import { BusinessError } from '@kit.BasicServicesKit';
import { fileIo as fs } from '@kit.CoreFileKit';
const context : Context = getContext(this);
const filePath : string = context.cacheDir + "/image_source.jpg";
let file = fs.openSync(filePath, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE);
imagePackerApi.packToFile(imageSource, file.fd, packOpts).then(() => {
    // 直接打包进文件
}).catch((error : BusinessError) => { 
  console.error('Failed to pack the image. And the error is: ' + error); 
})