比较颜色(compareColorEx重载二 )

描述:

同时比较指定的多个坐标点的颜色,支持多色、颜色范围、相似度比较

对应JS API:

Device.compareColorEx(multipleColor, sim);
是否支持多设备:

不支持

请求方式:

GET
http://IP:8090/TotalControl/v1/devices/:device/screen/colors/color

参数:
参数名 类型 必选 描述
token string Y Total Control TOKEN
:device string Y 主控设备对象值 id
color string Y 二维数组,需要对比的点 xy 坐标和 16 进制颜色,格式为[[X 坐标,Y 坐标,16 进制颜色],[X 坐标,Y 坐标,16 进制颜色],...], 多个颜色用"|"号分隔,需要颜色范围用"-"号分隔,比如" 0xffffff|0xaabbcc-0x000000, 0xffffff "。
sim float Y 相似度,仅作用于单个颜色,对颜色范围无用。对于指定的单个颜色,如果屏幕中目标像素的颜色与指定颜色差异在相似范围以内,则认为该颜色与目标颜色相同。相似度取值范围为[0.0, 1.0]
请求示例:

http://localhost:8090/TotalControl/v1/devices/device@1116106541/screen/colors/color?token=270eq7lXQK8bXYsJ&color=[[3,5,"0x000000"], [4,6,"0x000f00"], [9,225,"0xffffff"]]&sim=0.3
返回示例:

注意:
Total Control 的 REST API 的返回值通常由关键字 “status” 和 “value” 组成,
status: 接口执行成功与否 ,value: 执行接口的返回值,
但是,该 API 的返回值没有关键字 “value” ,返回值如下:


{
    "status": true
}
返回字段说明:
字段 类型 描述
status boolean true:成功; false:失败