匹配颜色点

在设备屏幕截图的指定区域内检查是否包含所有指定的颜色点，支持相似度阈值设置。如果所有颜色都找到则返回 true。

接口说明

接口类型

matchColorPoint

参数

参数名	类型	必填	说明
deviceId	string	是	设备ID
colors	array	是	颜色数组，格式：[颜色|阈值, ...]
rect	array	否	搜索区域 [x1, y1, x2, y2]，默认全屏

返回值

成功时：

true  // 所有颜色都在指定区域内找到

失败时：

null

功能说明

颜色格式

颜色数组中的每个元素格式为："颜色|阈值"

• 颜色：6位十六进制颜色值，如 "FFFFFF"
• 阈值：相似度阈值，范围 0-1，相似度 = round((1 - threshold) * 255)，三通道一致

搜索区域

rect 参数定义搜索区域：

• 格式：[x1, y1, x2, y2]

使用场景

场景1：验证UI状态

检查是否有系统弹窗：

const _hasSysModal = await apiInvoke('matchColorPoint', {
    deviceId: 'P72578581E07',
    colors: ["FFFFFF|0.8", "222222|0.9", "1074EC|0.9"],
    rect: [200, 300, 400, 350]
});

💡 提示

• 与 findMultiColor 不同，matchColorPoint 不返回具体坐标，只验证颜色是否存在
• 适合用于UI状态验证、条件判断等场景