使用ImagePacker完成图片编码
===================

图片编码指将PixelMap压缩成不同格式的图片文件，用于保存和传输。

支持使用[PackToData](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-imagepacker#packtodata13-1)和[PackToFile](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-imagepacker#packtofile11-2)将[PixelMap](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-pixelmap)编码为JPEG、WebP、PNG和HEIC格式。

从API version 18开始，支持使用[PackToDataFromPixelmapSequence](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-imagepacker#packtodatafrompixelmapsequence18)和[PackToFileFromPixelmapSequence](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-imagepacker#packtofilefrompixelmapsequence18)将多个PixelMap编码为GIF格式。

#### 开发步骤

图片编码相关API的详细介绍请参见[ImagePacker](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-imagepacker)。

#### \[h2\]图片编码进文件流

1.  导入相关模块包。
    
    // 导入相关模块。
    import { image } from '@kit.ImageKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    import { common } from '@kit.AbilityKit';
    import { fileIo } from '@kit.CoreFileKit';
    import { resourceManager } from '@kit.LocalizationKit';
    
2.  设置编码选项[PackingOption](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-i#packingoption)。
    
    2.1 这里以编码成jpeg图片为例。编码的目标格式format遵循MIME标准定义，因此PackingOption.format应设置为image/jpeg，编码后的文件扩展名可设为.jpg或.jpeg。
    
    let packOpts : image.PackingOption = { format: 'image/jpeg', quality: 95 };
    
    2.2 当图片源是HDR，且希望编码为HDR图片文件时，需要额外配置desiredDynamicRange。
    
    // 资源本身为hdr且设备支持HDR编码则会编码为hdr内容(需要资源本身为hdr且设备支持HDR编码，支持jpeg格式)。
    packOpts.desiredDynamicRange = image.PackingDynamicRange.AUTO;
    
3.  封装函数，传入imageSource或pixelMap，使用[packToData](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-imagepacker#packtodata13)接口编码到ArrayBuffer，或使用[packToFile](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-imagepacker#packtofile11)接口编码到文件。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/89/v3/Q2PVF25GR_q_A8ypj0oNAw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073518Z&HW-CC-Expire=86400&HW-CC-Sign=5564A2D45CCF8047E7C6BE00B061C8E0EE54DDB513E0FBC1AB25131267E809C3)
    
    在进行编码前，需要先获取imageSource或pixelMap，可参考[使用ImageSource完成图片解码](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/image-decoding)。
    
    *   定义copyData，获取编码后的文件流，方便后续保存为图片或者用于解码显示。
        
        let copyData: ArrayBuffer = new ArrayBuffer(0);
        
    *   pixelMap编码到ArrayBuffer。
        
        async function packToDataFromPixelMap(pixelMap : image.PixelMap) {
          const imagePackerApi = image.createImagePacker();
          let packOpts : image.PackingOption = { format: 'image/jpeg', quality: 95 };
          // 资源本身为hdr且设备支持HDR编码则会编码为hdr内容(需要资源本身为hdr且设备支持HDR编码，支持jpeg格式)。
          packOpts.desiredDynamicRange = image.PackingDynamicRange.AUTO;
          try{
            let data = await imagePackerApi.packToData(pixelMap, packOpts);
            // data 为编码获取到的文件流，写入文件保存即可得到一张图片。
            copyData = new ArrayBuffer(0);
            copyData = data;
          } catch (error) {
            console.error('Failed to pack the pixelMap to data. And the error is: ' + error);
          }
        }
        
    *   imageSource编码到ArrayBuffer。
        
        async function packToDataFromImageSource(imageSource : image.ImageSource) {
          const imagePackerApi = image.createImagePacker();
          let packOpts : image.PackingOption = { format: 'image/jpeg', quality: 95 };
          try {
            let data = await imagePackerApi.packToData(imageSource, packOpts);
            // data 为编码获取到的文件流，写入文件保存即可得到一张图片。
            copyData = new ArrayBuffer(0);
            copyData = data;
          } catch (error) {
            console.error('Failed to pack the imageSource to data. And the error is: ' + error);
          }
        }
        
    *   pixelMap编码到文件。
        
        async function packToFileFromPixelMap(context : Context, pixelMap : image.PixelMap) {
          const imagePackerApi = image.createImagePacker();
          let packOpts : image.PackingOption = { format: 'image/jpeg', quality: 95 };
          const path : string = context.cacheDir + '/pixel\_map.jpg';
          let file: fileIo.File | undefined = undefined;
          try {
            file = fileIo.openSync(path, fileIo.OpenMode.CREATE | fileIo.OpenMode.READ\_WRITE);
            await imagePackerApi.packToFile(pixelMap, file.fd, packOpts);
          } catch (error) {
            console.error('Failed to pack the pixelMap to file. And the error is: ' + error);
          } finally {
            if (file) {
              fileIo.closeSync(file.fd);
            }
          }
        }
        
    *   imageSource编码到文件。
        
        async function packToFileFromImageSource(context : Context, imageSource : image.ImageSource) {
          const imagePackerApi = image.createImagePacker();
          let packOpts : image.PackingOption = { format: 'image/jpeg', quality: 95 };
          const filePath : string = context.cacheDir + '/image\_source.jpg';
          let file: fileIo.File | undefined = undefined;
          try {
            file = fileIo.openSync(filePath, fileIo.OpenMode.CREATE | fileIo.OpenMode.READ\_WRITE);
            await imagePackerApi.packToFile(imageSource, file.fd, packOpts);
          } catch (error) {
            console.error('Failed to pack the imageSource to file. And the error is: ' + error);
          } finally {
            if (file) {
              fileIo.closeSync(file.fd);
            }
          }
        }
        
4.  将图片保存进图库。
    

将图片编码到ArrayBuffer或文件后，可使用[Media Library Kit](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/photoaccesshelper-overview)的相关接口[保存媒体库资源](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/photoaccesshelper-savebutton)保存进图库。

#### 示例代码

*   [图片压缩](https://gitcode.com/HarmonyOS_Samples/image-compression)