harmony 鸿蒙图形子系统变更说明

2025-06-16
浏览 (3)

图形子系统变更说明

cl.graphic.1 effectkit getPixelMap 同步接口替换为 getEffectPixelMap 异步接口

访问级别

公开接口

废弃原因

getPixelMap 耗时较长，在主线程调用会阻塞其余代码执行，故废弃，用异步接口替代

废弃影响

该变更为非兼容性变更，需要开发者适配。

API Level 9

废弃发生版本

从OpenHarmony SDK 4.1.5.5开始。

废弃的接口

接口声明	废弃说明	替代接口
getPixelMap():image.PixelMap;	该接口耗时长，废弃后统一替换成异步接口	getEffectPixelMap():Promise;

适配指导 类似以下调用方式

import image from "@ohos.multimedia.image";
import effectKit from "@ohos.effectKit";

const color = new ArrayBuffer(96);
let opts : image.InitializationOptions = {
  editable: true,
  pixelFormat: 3,
  size: {
    height: 4,
    width: 6
  }
};
image.createPixelMap(color, opts).then((pixelMap) => {
  let pixel = effectKit.createEffect(pixelMap).grayscale().getPixelMap();
  console.log('getPixelBytesNumber = ', pixel.getPixelBytesNumber());
})

将

let pixel = effectKit.createEffect(pixelMap).grayscale().getPixelMap();

替换为

effectKit.createEffect(pixelMap).grayscale().getEffectPixelMap().then(data => {
    let pixel = data;
}).catch(ex => console.log("getEffectPixelMap error: " + ex.toString()));

即将 getPixelMap 替换为 getEffectPixelMap ，用 promise 的方式接收回调回来的 pixelMap 对象