对比屏幕上指定坐标点的颜色

描述:

根对比屏幕上指定坐标点的颜色是否为指定的颜色。

对应JS API:

Device.compareColor(coordX, coordY, colors, sim);
是否支持多设备:

不支持

请求方式:

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

参数:
参数名 类型 必选 描述
token string Y Total Control TOKEN
:device string Y 主控设备对象值 id
x int Y 整型,指定像素的 x 坐标
y int Y 整型,指定像素的 y 坐标
color string Y 字符串,待比较的 16 进制颜色,格式为"RGB",多个颜色用"|"号分隔, 支持颜色范围,如" 0xffffff-0xaabbcc|0x001122 "
sim float Y 相似度,仅作用于单个颜色,对颜色范围无用。对于指定的单个颜色,如果屏幕中目标像素的颜色与指定颜色差异在相似范围以内,则认为该颜色与目标颜色相同。相似度取值范围为[0.0, 1.0]
请求示例:

http://localhost:8090/TotalControl/v1/devices/device@1116106541/screen/colors/color?token=270eq7lXQK8bXYsJ&x=566&y=729&color=0xffffff&sim=0.3
返回示例:

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


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