使用ImagePacker完成多图对象编码
=====================

图片编码指将[Picture](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-picture)对象编码成不同格式的图片文件（当前仅支持编码为JPEG 和 HEIF 格式），用于后续处理，如保存、传输等。

#### 开发步骤

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

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)。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0c/v3/3r1tGFouRraYz69dB3L5EQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073518Z&HW-CC-Expire=86400&HW-CC-Sign=8A52FBF792F1EBE1DA320A11E5DC04C68AEF2FAC39B9DE409F101ECAC450FAA3)
    
    这里以编码成jpeg图片为例。编码的目标格式format遵循MIME标准定义，因此PackingOption.format应设置为image/jpeg，编码后的文件扩展名可设为.jpg或.jpeg。
    
    let packOpts: image.PackingOption = {
      format: 'image/jpeg',
      quality: 95,
      needsPackProperties: true
    };
    
3.  封装函数，传入picture，使用[packing](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-imagepacker#packing13)接口编码到ArrayBuffer，或使用[packToFile](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-imagepacker#packtofile11-2)接口编码到文件。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/42/v3/zxiPsjrcQ9uF3lpUK2pGQQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073518Z&HW-CC-Expire=86400&HW-CC-Sign=D723B48F779BC31131330BD0F756D684FC67EBDAFECB7ED912272C58FDA5D472)
    
    在进行编码前，需要先通过解码获取picture，可参考[使用ImageSource完成多图对象解码](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/image-picture-decoding)。
    
    *   picture编码到ArrayBuffer。
        
        async function packing(picture: image.Picture, packOpts: image.PackingOption) {
          const imagePackerApi = image.createImagePacker();
          try {
            let data = await imagePackerApi.packing(picture, packOpts);
            copyData = data;
            console.info('Succeeded in packing the image.');
          } catch (error) {
            console.error('Failed to pack the picture to data. And the error is: ' + error);
          } finally {
            await imagePackerApi.release();
          }
        }
        
    *   picture编码到文件。
        
        async function packToFile(picture: image.Picture, packOpts: image.PackingOption, context: Context) {
          let imagePackerApi: image.ImagePacker | undefined = undefined;
          let file: fileIo.File | undefined = undefined;
          try {
            const path : string = context.cacheDir + '/picture.jpg';
            file = fileIo.openSync(path, fileIo.OpenMode.CREATE | fileIo.OpenMode.READ\_WRITE);
            imagePackerApi = image.createImagePacker();
            await imagePackerApi.packToFile(picture, file.fd, packOpts);
          } catch (error) {
            console.error('Failed to pack the picture to file. And the error is: ' + error);
          } finally {
            if (file) {
              fileIo.closeSync(file.fd);
            }
            if (imagePackerApi) {
              await imagePackerApi.release();
            }
          }
        }