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

鸿蒙开发-想在多线程间共享色彩配置？sendableColorSpaceManager怎么用

news 2026/6/1 3:16:56

多线程处理图片？色彩管理器也要能"共享"

上一篇我们聊了colorSpaceManager，它能帮你创建和管理色彩空间。但有一个问题：如果你的照片编辑 APP 需要在后台线程处理大量图片（比如批量滤镜、批量导出），普通的colorSpaceManager创建出来的对象是不能跨线程传递的。

为什么呢？因为在 ArkTS 的并发模型里，不同线程之间的对象默认是隔离的，你不能直接把一个线程里创建的对象传给另一个线程用。如果你尝试这么做，运行时会报错。

HarmonyOS 提供了sendableColorSpaceManager这个模块来解决这个问题。它创建出来的色彩管理器实现了ISendable接口，可以在主线程、TaskPool、Worker 等并发实例之间传递，而且传递的方式是引用传递——也就是说，多个线程共享同一个对象，修改会互相影响。

导入模块

import{colorSpaceManager,sendableColorSpaceManager}from'@kit.ArkGraphics2D';

注意这里同时导入了两个模块。因为sendableColorSpaceManager的参数类型（比如ColorSpace枚举、ColorSpacePrimaries接口）都定义在colorSpaceManager里，所以两个都要导入。

普通版与可共享版对比

下面是两种色彩管理器的使用场景对比：

创建标准可共享色彩空间

跟普通版本的用法几乎一样，只是把colorSpaceManager.create换成了sendableColorSpaceManager.create：

import{colorSpaceManager,sendableColorSpaceManager}from'@kit.ArkGraphics2D';letcolorSpace:sendableColorSpaceManager.ColorSpaceManager;colorSpace=sendableColorSpaceManager.create(colorSpaceManager.ColorSpace.SRGB);

这里有几个细节值得注意：

返回类型不同：普通版返回的是colorSpaceManager.ColorSpaceManager，而这里返回的是sendableColorSpaceManager.ColorSpaceManager。虽然名字一样，但它们是不同的类型。可共享版本实现了ISendable接口，所以能跨线程传递。
参数来源相同：色彩空间的枚举值ColorSpace还是来自colorSpaceManager，可共享版本并没有重新定义一套枚举。
UNKNOWN 和 CUSTOM 同样不能直接创建：跟普通版一样，这两个枚举值不能传给create方法。

创建自定义可共享色彩空间

如果你需要处理自定义色彩空间的照片，也可以创建自定义的可共享色彩管理器：

import{colorSpaceManager,sendableColorSpaceManager}from'@kit.ArkGraphics2D';letcolorSpace:sendableColorSpaceManager.ColorSpaceManager;letprimaries:colorSpaceManager.ColorSpacePrimaries={redX:0.1,redY:0.1,greenX:0.2,greenY:0.2,blueX:0.3,blueY:0.3,whitePointX:0.4,whitePointY:0.4};letgamma:number=2.2;colorSpace=sendableColorSpaceManager.create(primaries,gamma);

跟普通版完全一样的参数，只是调用的是sendableColorSpaceManager.create。创建出来的对象同样继承了ISendable，可以在多线程间共享。

查询属性：跟普通版一样的方法

可共享版本的ColorSpaceManager实例提供了跟普通版一样的属性查询方法，但 API 签名稍有不同。

获取色彩空间类型：

letspaceName:colorSpaceManager.ColorSpace=colorSpace.getColorSpaceName();

注意返回类型直接用了colorSpaceManager.ColorSpace，没有 try-catch 的示例。在实际使用中，建议你还是加上错误处理。

获取白点值：

import{collections}from'@kit.ArkTS';letpoint:collections.Array<number>=colorSpace.getWhitePoint();

这里有个小区别：可共享版本返回的是collections.Array<number>，而不是普通的Array<number>。collections.Array是 ArkTS 提供的可共享数组类型，同样能在多线程间传递。使用时你需要额外导入collections模块。

获取 gamma 值：

letgamma:number=colorSpace.getGamma();

这个跟普通版完全一样，返回一个浮点数。

多线程批量处理流程

下面是使用 sendableColorSpaceManager 进行批量图片处理的典型流程：

实际场景：后台批量处理图片的色彩管理

想象一下这个场景：你的照片编辑 APP 有一个"批量导出"功能，用户选了 100 张照片，要全部转换成 SRGB 色彩空间后导出。这个过程如果在主线程做，UI 会卡死。所以你要用 TaskPool 来做。

使用sendableColorSpaceManager的流程是这样的：

在主线程创建可共享的色彩空间对象：

import{colorSpaceManager,sendableColorSpaceManager}from'@kit.ArkGraphics2D';// 创建一个 SRGB 色彩空间，用于批量导出lettargetColorSpace=sendableColorSpaceManager.create(colorSpaceManager.ColorSpace.SRGB);