函数:snapshot 截图

函数名称:截图

函数功能:截取屏幕中指定区域的图像并生成指定格式的图片文件

函数方法

snapshot(picname,x1,y1,x2,y2,quality)

必填

参数 类型 说明
picname string 截图保存的文件名
不写默认保存到 screenshot 文件夹下(具体介绍详见下方注意事项)
自建目录请填写绝对路径
x1 number 截图区域左上角顶点屏幕横坐标
y1 number 截图区域左上角顶点屏幕纵坐标
x2 number 截图区域右下角顶点屏幕横坐标
y2 number 截图区域右下角顶点屏幕纵坐标

选填

参数 类型 说明
quality number 仅支持 iOS,
当截图格式选为 jpg 时,
可用此参数控制图片质量,此参数值为大于 0 且小于等于 1 的值

返回值

函数用例

for i=1,5 do
--默认保存到 screenshot 文件夹下
snapshot(i..".png", 0, 0, 639, 1135); 
--snapshot(i..".png", 0, 0, 639, 1135);
end
--全屏截图(iPhone 5, 5S),并以当前日期为文件名保存
--请输入真实存在的路径,路径不存在将截图失效
current_time = os.date("%Y-%m-%d", os.time());
snapshot("C:\\Users\\cce\\Desktop\\1112\\"..current_time..".png", 0, 0, 639, 1135)
--snapshot("C:/Users/cce/Desktop/1112/"..current_time..".png", 0, 0, 639, 1135)

注意事项

  • 只写文件名称默认保存到 screenshot 文件夹下(触动智控客户端右上角头像 - 设置中心中可以打开 screenshot 文件夹)

  • 绝对路径需要输入正确的文件夹路径,并且用 \\ 或者 / 代替文件夹路径。

  • Android 系统保存图片支持 png 及 jpg 格式,不可以设置质量;iOS 系统保存图片的格式可为 bmp, jpg, png,因为 png 是 iOS 中最常见的格式,所以推荐选择 png。

  • 本文 iOS 实例中 os.date 与 os.time 为 Lua 基本库函数,请查阅附录 Lua 操作系统函数库

  • ".." 为字符串连接操作符,可以将字符串变量、常量连接在一起。

  • 本文 iOS 实例中 640*1136 为 iPhone 5,5S 等设备的分辨率,实际使用中请根据运行设备替换为对应值。

Copyright 北京帮你玩科技有限公司 2024 all right reserved,powered by Gitbook该文章修订时间: 2025-03-04 15:43:41

results matching ""

    No results matching ""