截屏到手机或者电脑

描述:

截图保存到PC或者设备。

对应JS API:

Device.screenshot(filePath, imageType) 
Device.screenshot(filePath,imageType,x1, y1, x2,y2)
Device.screenshotToDevice(filePath, imageType)
Device.screenshotToDevice(path, imageType, topLeftX, topLeftY, bottomRightX,bottomRightY)
是否支持多设备:

不支持

请求方式:

GET
http://IP:8090/TotalControl/v1/devices/:device/screen/images

参数:
参数名 类型 必选 描述
token string Y Total Control TOKEN
:device string Y 主控设备对象值 id
file string N 截屏文件保存路径(截屏保存到手机必须要)
type string Y 截屏保存文件类型,值可以为:[bmp/png/jpg]
rect string N 格式:[topLeftX,topLeftY,bottomRightX,bottomRightY]
指定截屏区域,具体说明如下:
topLeftX: 屏幕上指定范围左上角 X 坐标
topLeftY: 屏幕上指定范围左上角 Y 坐标
bottomRightX: 屏幕上指定范围右下角 X 坐标
bottomRightY: 屏幕上指定范围右下角 Y 坐标
location int N 截屏保存到设备或者PC:
pc:保存到PC电脑
device:保存到设备
请求示例:

示列1.截图保存到PC 
http://localhost:8090/TotalControl/v1/devices/device@-1303598987/screen/images?token=270eq7lXQK8bXYsJ&type=bmp

示列2.截图保存到PC 
http:/localhost:8090/TotalControl/v1/devices/device@-1303598987/screen/images?token=270eq7lXQK8bXYsJ&type=bmp&rect=[100,100,300,300]

示列3.截图保存到PC
http://localhost:8090/TotalControl/v1/devices/device@-1303598987/screen/images?token=270eq7lXQK8bXYsJ&type=bmp&location=pc&rect=[100,100,300,300]

示列4.截图保存到设备
http://localhost:8090/TotalControl/v1/devices/device@-1303598987/screen/images?token=270eq7lXQK8bXYsJ&file=sdcard/ca7.png&type=png&location=device

示列5.截图保存到设备
http://localhost:8090/TotalControl/v1/devices/device@-1303598987/screen/images?token=270eq7lXQK8bXYsJ&file=sdcard/ca7.png&type=png&location=device&rect=[100,100,300,300]
返回示例:

注意:
Total Control 的 REST API 的返回值通常由关键字 “status” 和 “value” 组成,
status: 接口执行成功与否 ,value: 执行接口的返回值,
但是,截屏保存到设备的返回值没有关键字 “value” 。


截图保存到PC返回值:
{
    "status": true,
    "file_url": "http://localhost:8090/867924024124417/1523049073460.bmp"
}
截屏保存到设备返回值:
{
    "status": true
}
返回字段说明:
字段 类型 描述
status boolean true:成功; false:失败
file_url string 截屏保存到PC,服务器图片的请求地址