当前位置：首页 > news >正文

鸿蒙三方库 | harmony-utils之ImageUtil Base64与PixelMap互转详解

news 2026/7/21 0:50:08

前言

图片的Base64编码和PixelMap转换是图片处理的基础操作，在图片上传、分享、缓存等场景中经常使用。@pura/harmony-utils的ImageUtil封装了Base64与PixelMap互转方法。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解，帮助开发者快速掌握并应用到实际项目中。

一、ImageUtil转换核心API

ImageUtil提供了以下图片转换方法：

方法	说明	返回类型	使用场景
`base64ToPixelMap(base64)`	Base64转PixelMap	PixelMap	图片解码展示
`pixelMapToBase64(pixelMap)`	PixelMap转Base64	string	图片上传/分享
`base64ToArrayBuffer(base64)`	Base64转ArrayBuffer	ArrayBuffer	二进制数据处理

1.1 核心特性

简洁易用：封装复杂API为一行调用，降低使用门槛
类型安全：完整的TypeScript类型定义，编译期即可发现错误
异常处理：内置异常捕获机制，避免运行时崩溃
双向转换：支持Base64和PixelMap的双向转换

1.2 转换流程对照

转换方向	源格式	目标格式	典型场景
解码	Base64	PixelMap	网络图片展示
编码	PixelMap	Base64	图片上传/存储
转换	Base64	ArrayBuffer	二进制处理

二、完整使用步骤

2.1 安装依赖

ohpminstall@pura/harmony-utils

2.2 Base64转PixelMap

import{ImageUtil}from'@pura/harmony-utils';Button('Base64转PixelMap').width('100%').onClick(async()=>{try{letbase64Str='...';// Base64编码的图片字符串letpixelMap=awaitImageUtil.base64ToPixelMap(base64Str);this.result=`转换成功 ✅\nPixelMap尺寸:${pixelMap.getImageInfo().size}`;}catch(e){this.result='异常: '+e;}})

2.3 PixelMap转Base64

Button('PixelMap转Base64').width('100%').onClick(async()=>{try{letbase64=awaitImageUtil.pixelMapToBase64(this.pixelMap);this.result=`转换成功 ✅\nBase64长度:${base64.length}`;}catch(e){this.result='异常: '+e;}})

三、完整页面示例

import{ImageUtil}from'@pura/harmony-utils';@Entry@Componentstruct ImageConvertDemo{@Stateresult:string='';build(){Column({space:12}){Button('Base64转PixelMap').width('100%').onClick(async()=>{try{this.result='Base64与PixelMap互转\n适用于图片上传和缓存';}catch(e){this.result='异常: '+e;}});Text(this.result).fontSize(14).fontColor('#333333')}.padding(16)}}

四、进阶用法

4.1 图片上传封装

import{ImageUtil}from'@pura/harmony-utils';asyncfunctionuploadImage(pixelMap:PixelMap):Promise<void>{letbase64=awaitImageUtil.pixelMapToBase64(pixelMap);letresponse=awaitfetch('https://api.example.com/upload',{method:'POST',body:JSON.stringify({image:base64})});returnresponse.json();}

4.2 图片缓存管理

asyncfunctioncacheImage(pixelMap:PixelMap,key:string):Promise<void>{letbase64=awaitImageUtil.pixelMapToBase64(pixelMap);PreferencesUtil.putString(key,base64);}asyncfunctiongetCachedImage(key:string):Promise<PixelMap|null>{letbase64=PreferencesUtil.getString(key,'');if(base64){returnawaitImageUtil.base64ToPixelMap(base64);}returnnull;}