snapshot 截图
是否需要验证:是
控制客户端发送
GET /snapshot?ext=[jpg|png]&compress=[0.1-1]&orient=[0|1|2|3] HTTP/1.1
Host: 服务端 IP
auth: 验证串--触动专业版 iOS 无需写入验证串
属性 | 说明 |
---|---|
HTTP 方法 | GET /截图参数 HTTP/1.1 |
Host | 服务端 IP |
Port | 端口号,触动精灵端口号为 50005,小精灵端口号为 50015(安卓 10 及以上系统端口号为 50055) |
auth | 验证串(触动专业版 iOS 无需写入验证串) |
截图参数
属性 | 说明 |
---|---|
ext | 截图格式,支持两种格式:jpg 和 png |
compress | 当格式为 JPG 时有效,范围为 0.1 - 1,仅支持 iOS |
orient | 图片方向,对应移动设备的四种方向,0 - Home 键在底部,1 - Home 键在右侧,2 - Home 键在左侧,3 - Home 键在顶部 |
服务返回
HTTP/1.0 200 OK
Content-Length: 图片长度
Content-Type: image/png
图片数据
属性 | 说明 |
---|---|
HTTP 返回代码 | HTTP/1.0 200 OK |
Content-Length | 图片长度 |
Content-Type | image/png |
Width | 图片宽度 |
Height | 图片高度 |
webdata | 图片数据 |
示例代码
local ts = require("ts")
header_send = {["ext"]="png"}
body_send = {["compress"]=1,["orient"]="1"}
ts.setHttpsTimeOut(60)
--10.0.0.224 为设备 IP 并且需要是局域网,触动精灵端口为 50005,小精灵请修改端口号为 50015,安卓 10 及以上系统小精灵端口号为 50055
--此示例及下方图片仅支持 iOS 专业版,其他产品请增加参数 auth
status_resp,header_resp,webdata = ts.httpGet("http://10.0.0.224:50005/snapshot", header_send, body_send)
if status_resp == 200 then
--header_resp 中包含 Content-Length、Content-Type、Width、Height 数据
dialog(header_resp,5)
--webdata 为图片数据,无法正常显示,需要自行转成图片
else
dialog("获取失败")
end
注意事项
安卓系统不同设备初始的截图方向有所不同,请用截图函数确认设备的默认方向。
安卓系统没有实体按键的按照初始方向确认其他方向,0 - 初始方向,1 - 初始方向向左旋转 90°,2 - 初始方向向右旋转 90°,3 - 初始方向旋转 180°。
安卓标准版、iOS 标准版及 iOS 专业版必须有授权,授权为试用状态无法调用。
安卓 10 及其以上系统小精灵需要修改端口号为 50055。