【REST API】在全屏或指定區域範圍內尋找指定圖片的座標（找圖）
阿新 • • 發佈：2018-11-09
在全屏或指定區域範圍內尋找指定圖片的座標，支援相似查詢。如找到目標圖，則返回找到位置的左上角座標。該函式有 6 種過載方法，對應不同的引數。
對應JS API:
Device.seekImage(imageName) Device.seekImage(imageName, sim) Device.seekImage(topLeftX, topLeftY, bottomRightX, bottomRightY, imageName) Device.seekImage(topLeftX, topLeftY, bottomRightX, bottomRightY, imageName, sim) Device.seekImage(topLeftX, topLeftY, bottomRightX, bottomRightY, imageName, sim, beGray) Device.seekImage(imageName, sim, beGray)
是否支援多裝置：
不支援
請求方式：
GET
http://IP:8090/TotalControl/v1/devices/:device/screen/images
引數：
| 引數名 | 型別 | 必選 | 描述 |
|---|---|---|---|
| token | string | Y | Total Control TOKEN |
| :device | string | Y | 主控裝置物件值 id |
| name | string | Y | 需要對比圖片路徑 |
| sim | float | N | 相似度，取值範圍為[0.0, 1.0] |
| rect | string | N | 格式：[topLeftX,topLeftY,bottomRightX,bottomRightY] 指定截圖區域，具體說明如下: topLeftX： 螢幕上指定範圍左上角 X 座標 topLeftY： 螢幕上指定範圍左上角 Y 座標 bottomRightX： 螢幕上指定範圍右下角 X 座標 bottomRightY： 螢幕上指定範圍右下角 Y 座標 |
| same | string | N | 當此值為true時，表示要尋找的小圖和大圖取自同一臺手機，因此在找圖時無需縮放，也無需進行相似查詢。對於在同一臺手機上的找圖行為，這兩個函式更加快速準確。Device.seekImage(imageName, sim, same) TC 6.8.0 之前可以使用 |
| beGray | string | N | 當此值為true時(預設為true)，表示圖片要先進行灰度處理，然後再進行找圖。當此值為false時候，表示圖片不進行任何處理就進行找圖，當然灰度處理後找圖速度更快。從 TC 6.8.0 開始可以使用。 |
請求示例：
示列1:
http://localhost:8090/TotalControl/v1/devices/[email protected]/screen/images?token=270eq7lXQK8bXYsJ&name=C:/Users/S/Desktop/360.bmp
示列2:
http://localhost:8090/TotalControl/v1/devices/[email protected]/screen/images?token=270eq7lXQK8bXYsJ&name=C:/Users/S/Desktop/360.bmp&sim=0.1
示列3:
http://localhost:8090/TotalControl/v1/devices/[email protected]/screen/images?token=270eq7lXQK8bXYsJ&name=C:/Users/S/Desktop/360.bmp&rect=[0,0,600,600]
示列4:
http://localhost:8090/TotalControl/v1/devices/[email protected]/screen/images?token=270eq7lXQK8bXYsJ&name=C:/Users/S/Desktop/360.bmp&rect=[0,0,600,600]&sim=0.5
示列5:
http://localhost:8090/TotalControl/v1/devices/[email protected]/screen/images?token=270eq7lXQK8bXYsJ&name=C:/Users/S/Desktop/360.bmp&rect=[0,0,600,600]&same=true&sim=0.5
示列6:
http://localhost:8090/TotalControl/v1/devices/[email protected]/screen/images?token=270eq7lXQK8bXYsJ&name=C:/Users/S/Desktop/360.bmp&same=true&sim=0.5
返回示例：
{
"status": true,
"value":[272,371]
}
返回欄位說明：
| 欄位 | 型別 | 描述 |
|---|---|---|
| status | boolean | true:成功; false:失敗 |
| value | string | 成功找到圖片的座標 |