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。

Copyright 北京帮你玩科技有限公司 2023 all right reserved,powered by Gitbook该文章修订时间: 2024-03-06 17:50:18

results matching ""

    No results matching ""