XXTouch 官方网站
首页
使用入门
更新日志
常见问题答疑 (FAQ)
XXTouch 是什么？
哪些设备可运行 XXTouch？
如何安装 XXTouch 到设备上？
XXTouch 收费么？哪些部分收费？
我购买了 XXTouch 授权码后会获得哪些权利？
没有授权的 XXTouch 有什么限制？
我电脑上有个脚本，如何使用 USB 连接导入到设备上？
电脑端如何通过 USB 访问到完全文件系统？
XXTouch 的脚本及相关资源存在设备的哪个位置？
如何在电脑上给 XXTouch 开发脚本？
作为开发者，我编写了一个脚本想收费怎么办？
从 Cydia 添加 XXTouch 源出现“此服务器的证书无效。”怎么办？
从 Cydia 安装或更新 XXTouch 失败（出现红字/黄字）怎么办？
在 Cydia 添加 XXTouch 官方源失败怎么办？
在 Cydia 的 XXTouch 官方源中找不到任何软件包怎么办？
安装 XXTouch 后闪退或桌面没有图标怎么办？
安装 XXTouch 后无限提示同步失败怎么解决？
安装 XXTouch 后无限提示需要注销、与服务器或守护进程通讯失败？
使用一段时间突然出现“XXTouch 版本需要更新才能继续获得稳定的生产力”无限弹出并且无法操作？
打开 X.X.T. 后弹窗提示 ‘“X.X.T.” 可能使 iPhone 变慢’ 怎么办？
授权没有到期却弹出授权无效的提示？
进入授权界面提示“无法连接到授权服务器。”或“阿里云网关错误：Timestamp Expired”怎么办？
iOS 系统时间在哪里调整？
取色器/编辑器/局域网控制器 扫描不到设备怎么办？
为何我扫一扫下载会出现 “帧框加载已失败”？
如何录制脚本？
如何运行脚本？
如何选择脚本？
如何在设备上编辑脚本？
如何加密脚本？
脚本可以做什么？
加密的脚本可以被解密么？
XXTouch 可以在电脑上运行么？
XXTouch 可以在安卓系统上运行么？
XXTouch 可以在没有越狱的 iOS 设备上运行么？
已知的与 XXTouch 一定会产生冲突的插件参考
XXTouch iOS 开发手册
关于 XXTouch
如何阅读本手册
如何使用 XXTouch
保护脚本，正确接受 require
基本控制函数
结束脚本 (os.exit)
重启脚本 (os.restart)
脚本被终止时执行一些代码的方法
开发辅助函数
打印内容到缓冲区 (print)
将打印缓冲区的内容提出来 (print.out)
网络日志 (nLog)
屏幕模块
初始化旋转坐标系 (screen.init)
坐标旋转转换 (screen.rotate_xy)
获取屏幕尺寸 (screen.size)
保持屏幕 (screen.keep)
取消保持屏幕 (screen.unkeep)
获取屏幕上某点颜色 (screen.get_color)
获取屏幕上某点颜色 RGB (screen.get_color_rgb)
屏幕多点颜色匹配 (screen.is_colors)
多点相似度模式找色 (screen.find_color)
多点色偏模式找色 (screen.find_color)
获取屏幕图像 (screen.image)
屏幕区域文字识别 (screen.ocr_text)
屏幕找图 (screen.find_image)
模拟触摸模块
! 模拟手指轻触一次屏幕 (touch.tap)
模拟手指接触屏幕 (touch.on)
! 模拟手指在屏幕上移动 (:move)
! 模拟手指在屏幕上施加压力 (:press)
模拟手指离开屏幕 (:off)
设置触摸事件对象移动步长 (:step_len)
设置触摸事件对象移动每步延迟 (:step_delay)
! 毫秒级延迟 (:msleep)
设置触摸圆点显示 (touch.show_pose)
touch 示例代码
模拟按键模块
模拟按一下物理按键 (key.press)
模拟按下物理按键 (key.down)
松开按下的物理按键 (key.up)
模拟键入文本 (key.send_text)
示例及支持的键码列表
模拟重力加速计模块
模拟加速计数据 (accelerometer.simulate)
模拟摇一摇 (accelerometer.shake)
改变当前重力方向为 home 在左 (accelerometer.rotate_home_on_left)
改变当前重力方向为 home 在右 (accelerometer.rotate_home_on_right)
改变当前重力方向为 home 在上 (accelerometer.rotate_home_on_top)
改变当前重力方向为 home 在下 (accelerometer.rotate_home_on_bottom)
系统模块
显示提示文字 (sys.toast)
弹出系统提示 (sys.alert)
弹出输入提示 (sys.input_box)
输入文字 (sys.input_text)
! 毫秒级延迟 (sys.msleep)
获取当前毫秒级时间戳 (sys.mtime)
! 获取网络时间 (sys.net_time)
产生一个随机数 (sys.rnd)
获取设备当前内存状态信息 (sys.memory_info)
获取设备当前可用内存值 (sys.available_memory)
获取设备当前未使用的存储空间值 (sys.free_disk_space)
输出标准系统日志 (sys.log)
问系统一个问题 (sys.mgcopyanswer)
获取系统版本 (sys.version)
获取 XXTouch 版本 (sys.xtversion)
剪贴板模块
写内容进剪贴板 (pasteboard.write)
获取剪贴板中的数据 (pasteboard.read)
对话框模块
! 建立一个对话框对象 (dialog)
配置对话框配置保存文件名 (:config)
配置对话框配置保存文件名 (:set_config)
配置对话框自动消失时间 (:timeout)
配置对话框自动消失时间 (:set_timeout)
配置对话框的标题 (:title)
配置对话框的标题 (:set_title)
配置对话框的尺寸 (:set_size)
配置对话框的位置及尺寸 (:set_frame)
配置对话框的圆角半径 (:set_corner_radius)
给对话框加上一个文本标签 (:add_label)
给对话框加上一个文本输入框 (:add_input)
给对话框加上一个图片 (:add_image)
给对话框加上一个开关 (:add_switch)
给对话框加上一个选择器 (:add_picker)
给对话框加上一个单选组 (:add_radio)
给对话框加上一个多选组 (:add_checkbox)
给对话框加上一个数值选择器 (:add_range)
! 将对话框弹出来并返回用户的选择 (:show)
! 在不弹出对话框的情况下获得对话框配置 (:load)
清理模块
清理某个或某组钥匙串信息 (clear.keychain)
清理所有应用程序钥匙串信息 (clear.all_keychain)
清理剪贴板 (clear.pasteboard)
清理浏览器Cookies (clear.cookies)
清理系统缓存 (clear.caches)
清除相册中所有本地照片 (clear.all_photos)
清理某个应用的存档数据 (clear.app_data)
清理 IDFA/V (clear.idfav)
应用程序模块
获取 App 的应用程序包路径 (app.bundle_path)
获取 App 的应用存档路径 (app.data_path)
获取 App 的应用分组信息 (app.group_info)
弹出一个应用通知 (app.pop_banner)
运行应用程序 (app.run)
关闭应用程序 (app.close)
模拟使用上划退出应用程序 (app.quit)
检测应用程序是否正在运行 (app.is_running)
输入文字 (app.input_text)
通过应用程序 bid 获取应用的本地化名字 (app.localized_name)
通过应用程序 bid 获取应用的图标数据 (app.png_data_for_bid)
通过应用程序 bid 获取其 pid (app.pid_for_bid)
获取应用程序当前内存消耗 (app.used_memory)
获取前台应用的 Bundle Identifier (app.front_bid)
获取前台应用的 Process Identifier (app.front_pid)
前台打开一个 URL (app.open_url)
获取设备所有的应用的 Bundle Identifier 列表 (app.bundles)
获取当前设备的进程列表 (app.all_procs)
设置前台应用程序加速齿轮 (app.set_speed_add)
安装IPA安装包 (app.install)
卸载一个应用 (app.uninstall)
备注
设备相关模块
重置自动锁屏倒计时 (device.reset_idle)
锁定屏幕 (device.lock_screen)
解锁屏幕 (device.unlock_screen)
获取屏幕锁定状态 (device.is_screen_locked)
获取前台应用的画面方向 (device.front_orien)
锁定设备屏幕旋转 (device.lock_orien)
解锁设备屏幕旋转锁 (device.unlock_orien)
获取屏幕旋转锁锁定状态 (device.is_orien_locked)
振动设备 (device.vibrator)
后台播放声音 (device.play_sound)
获取设备类型 (device.type)
获取设备名 (device.name)
设置设备名 (device.set_name)
获取设备UDID (device.udid)
获取设备的序列号 (device.serial_number)
获取设备的 WiFi MAC 地址 (device.wifi_mac)
获取设备所有的接口 IP (device.ifaddrs)
获取当前设备电池剩余电量 (device.battery_level)
获取当前设备充电状态 (device.battery_state)
打开设备 WiFi (device.turn_on_wifi)
关闭设备 WiFi (device.turn_off_wifi)
打开设备蜂窝数据 (device.turn_on_data)
关闭设备蜂窝数据 (device.turn_off_data)
打开设备蓝牙 (device.turn_on_bluetooth)
关闭设备蓝牙 (device.turn_off_bluetooth)
打开设备飞行模式 (device.turn_on_airplane)
关闭设备飞行模式 (device.turn_off_airplane)
连接到当前设置所选 VPN (device.turn_on_vpn)
断开已有的 VPN 连接 (device.turn_off_vpn)
判断当前是否打开了 VPN 开关 (device.is_vpn_on)
打开设备闪光灯 (device.flash_on)
关闭设备闪光灯 (device.flash_off)
打开“减少动态效果”开关 (device.reduce_motion_on)
关闭“减少动态效果”开关 (device.reduce_motion_off)
打开 AssistiveTouch (device.assistive_touch_on)
关闭 AssistiveTouch (device.assistive_touch_off)
获取背光亮度值 (device.brightness)
设置背光亮度 (device.set_brightness)
设置自动锁屏分钟数 (device.set_autolock_time)
设置设备音量 (device.set_volume)
加入到一个无线局域网 (device.join_wifi)
图片对象模块
判断一个值是否是图片对象 (image.is)
创建指定尺寸空白图片对象 (image.new)
图像合并 (image.oper_merge)
新建一个文本图片对象 (image.new_text_image)
从文件创建图片对象 (image.load_file)
从数据创建图片对象 (image.load_data)
从图片对象创建拷贝图片对象 (:copy)
从图片对象截取部分新建拷贝图片对象 (:crop)
保存图片对象到相册 (:save_to_album)
输出图片对象到一个 PNG 格式的文件 (:save_to_png_file)
输出图片对象到一个 JPEG 格式的文件 (:save_to_jpeg_file)
获取图片对象的 PNG 格式数据 (:png_data)
获取图片对象的 JPEG 格式数据 (:jpeg_data)
90度左旋图片对象 (:turn_left)
90度右旋图片对象 (:turn_right)
180度旋转图片对象 (:turn_upondown)
获取图片对象的尺寸 (:size)
获取图片对象某点颜色 (:get_color)
设置图片对象某点颜色 (:set_color)
颜色替换 (:replace_color)
图中贴图 (:draw_image)
二值化处理图片对象 (:binaryzation)
在图上找色 (:find_color)
图片多点颜色匹配 (:is_colors)
解码一个二维码图片 (:qr_decode)
销毁一个图片对象 (:destroy)
cv - 图中找图 (:cv_find_image)
cv - 图片自动二值化 (:cv_binaryzation)
cv - 从图片创建一个拉伸的另外尺寸的图片 (:cv_resize)
tesseract - 对图片进行 ocr 识别 (:tess_ocr)
进程字典
存储值到进程字典 (proc_put)
查看进程字典存储的值 (proc_get)
向进程队列词典中压入一个值 (proc_queue_push)
从进程队列词典中弹出一个值 (proc_queue_pop)
从进程队列词典中弹出所有值 (proc_queue_clear)
获取进程队列词典的尺寸 (proc_queue_size)
向进程队列词典头部压入一个值 (proc_queue_push_front)
向进程队列词典尾部压入一个值 (proc_queue_push_back)
从进程队列词典头部弹出一个值 (proc_queue_pop_front)
从进程队列词典尾部弹出一个值 (proc_queue_pop_back)
线程模块
前言
派发一个任务 (thread.dispatch)
获取当前任务的 ID (thread.current_id)
从队列中移除一项任务 (thread.kill)
阻塞等待一个任务完成 (thread.wait)
注册监听一个事件 (thread.register_event)
反注册监听一个事件 (thread.unregister_event)
thread 示例代码
Web 视图模块
展现一个 webview (webview.show)
隐藏一个 webview (webview.hide)
在一个 webview 上执行一段 JS (webview.eval)
获取一个 webview 的区域及层级信息 (webview.frame)
销毁一个 webview (webview.destroy)
webview 使用示例
XPP 脚本包模块
前言
获取当前脚本包的元信息 (xpp.info)
获取当前脚本包的包路径 (xpp.bundle_path)
获取当前脚本包中的资源路径 (xpp.resource_path)
XUI 脚本配置界面模块
前言
展示一个配置界面 (xui.show)
收起正在展示的配置界面 (xui.dismiss)
校验配置界面的配置 (xui.setup)
重新加载当前正在展示的配置界面 (xui.reload)
获取配置界面的配置值 (xui.get)
设置配置界面上的某个控件的值 (xui.set)
读取某个配置分区所有配置 (xui.read)
覆盖写入配置表到某个配置分区 (xui.write)
清除某个配置分区所有的配置 (xui.clear)
扩展 table 模块
前言
深拷贝一个表 (table.deep_copy)
深打印一个表 (table.deep_print)
从字符串加载一个表 (table.load_string)
扩展 string 模块
前言
转成 16 进制文本 (string.to_hex)
从 16 进制文本转回 (string.from_hex)
将 GBK 编码的文本转成 UTF-8 编码的文本 (string.from_gbk)
计算字符串的 md5 哈希值 (string.md5)
计算字符串的 sha1 哈希值 (string.sha1)
对字符串进行 base64 编码 (string.base64_encode)
对 base64 编码的文本进行解码 (string.base64_decode)
对字符串进行加密 (string.aes128_encrypt)
解密一段已加密的字符串 (string.aes128_decrypt)
用分隔符规则分割一个字符串 (string.split)
去除文本左边空白字符 (string.ltrim)
去除文本右边空白字符 (string.rtrim)
去除文本左右两边空白字符 (string.trim)
去除文本中所有的空白字符 (string.atrim)
去除掉文本前的 UTF8-BOM (string.strip_utf8_bom)
生成随机字符串 (string.random)
比较两个版本号大小 (string.compare_version)
扩展 string 示例代码
! HTTP 模块
前言
发起 GET 请求 (http.get)
发起 POST 请求 (http.post)
HTTP 文件下载 (http.download)
发起 HEAD 请求 (http.head)
发起 DELETE 请求 (http.delete)
发起 PUT 请求 (http.put)
! FTP 模块
FTP 文件下载 (ftp.download)
FTP 文件上传 (ftp.upload)
JSON 模块
前言
将 Lua 值转成 JSON 字符串 (json.encode)
将 JSON 字符串转换成 Lua 值 (json.decode)
JSON 中的 NULL 常量 (json.null)
PLIST 文件读写模块
读取 plist 文件 (plist.read)
写入 plist 文件 (plist.write)
读取属性表数据 (plist.load)
取 Lua 表的属性表数据 (plist.dump)
小工具模块
给通讯录添加一个或多个联系人 (utils.add_contacts)
删除通讯录所有联系人 (utils.remove_all_contacts)
打开扫码器 (utils.open_code_scanner)
关闭扫码器 (utils.close_code_scanner)
将文本编码成二维码图片 (utils.qr_encode)
获得当前脚本的启动参数 (utils.launch_args)
判断当前脚本是否从 App 内启动 (utils.is_launch_via_app)
导入一个视频文件到相册 (utils.video_to_album)
文件操作模块
判断一个文件或目录是否存在 (file.exists)
获取目录所有文件名列表 (file.list)
获得一个文件的尺寸 (file.size)
读取一个文件中的所有数据 (file.reads)
将数据覆盖写入到文件 (file.writes)
将数据追加到文件末尾 (file.appends)
统计一个文本文件的总行数 (file.line_count)
获取一个文本文件指定行的数据 (file.get_line)
设置文本文件指定行的内容 (file.set_line)
在文本文件指定行前插入内容 (file.insert_line)
移除文件中指定行 (file.remove_line)
获取一个文本文件的所有行 (file.get_lines)
将一个顺序表转换逐行覆盖写入到文件中 (file.set_lines)
将一个顺序表转换逐行插入到文件指定行前 (file.insert_lines)
VPN 配置模块
创建一个 VPN 配置 (vpnconf.create)
获取当前系统 VPN 的列表 (vpnconf.list)
选择一个 VPN 配置 (vpnconf.select)
删除一个 VPN 配置 (vpnconf.delete)
以当前选择的 VPN 建立连接 (vpnconf.connect)
断开当前的 VPN 连接 (vpnconf.disconnect)
获取当前选择的 VPN 的状态 (vpnconf.status)
云打码模块
初始化一个云打码平台 (cloud_ocr.ocr)
识别屏幕上的范围 (plat.ocr_screen)
识别图片文件 (plat.ocr_image)
识别图片对象 (plat.ocr_obj)
提交错误的识别 (plat.report_error)
cloud_ocr 示例代码
系统回调消息
前言
电话呼入呼出回调消息
扫码结果回调消息
Activator 事件回调消息
HID 事件消息
地理位置伪装
伪装GPS位置 (gps.fake)
清除GPS伪装信息 (gps.clear)
外部扩展
大漠找字/文字识别 模块
已集成的开源扩展库
LuaCJSON 扩展库
LuaSocket 扩展库
luaiconv 编码转换扩展库
lpeg 扩展库
LuaFileSystem 扩展库
LuaSQLite3 模块
lcurl 模块
更多的编译好的开源扩展库
附录
开发及周边工具下载
扩展库及远程扩展接口
脚本守护模式是什么？
开机启动的时机说明
"URL Scheme" 的相关应用
日期格式化相关 (os.date)
命令执行相关示例代码 (os.execute)
string 库的相关应用
math 库的相关应用
学习 Lua 注意避开的坑
开发常见运行期错误参考
XPP 脚本包
简介
XPP 格式
元信息
BundleIdentifier (包标识符)
BundleVersion (脚本应用包的版本号)
BundleName (短名称)
BundleDisplayName (显示名称)
BundleIconFile (图标文件)
Executable (可执行入口脚本文件)
MainInterfaceFile (主界面配置入口文件)
MinimumSystemVersion/MaximumSystemVersion (最低/最高 iOS 版本要求)
MinimumXXTVersion (最低 XXTouch 服务版本要求)
SupportedResolutions (支持的设备屏幕物理尺寸数组)
PackageControl (附加信息)
本地化
XPA 打包格式
XUI 界面库使用手册
前言
示例
创建
根
主题
通用属性
读取配置
组件
Group 分组
Link 链接子界面
Switch 开关
Button 动作按钮
TextField 单行文本框
Radio / Checkbox 单选框 / 复选框组
Segment 适合少量选项的单项选择
Option 单项选择列表
MultipleOption 多项选择列表
OrderedOption 多项有序选择列表
EditableList 可编辑列表
Slider 数值拖拽滑块
Stepper 数值调节按钮
DateTime 时间日期选择器
TitleValue 键值对显示; 代码片段选择器
StaticText 静态文本框
Textarea 多行文本域
Image / AnimatedImage 图片 / 动态图片
File 文件选择器
About 关于
XUI 支持的 API
代码片段
前言
创建
应用程序选择器
虚拟按键选择器
地理位置选择器
图像位置与颜色选择器
图像区域选择器
OpenAPI 使用手册
开始之前
示例
文件相关
获取文件列表
选择一个脚本文件
获取当前已经选择的脚本文件
运行已经选择的脚本
删除一个脚本文件
新建一个脚本文件
写入内容到脚本文件
新建一个目录
删除一个目录
读取脚本文件
重命名一个文件或目录（RAW）
删除一个文件或空目录（RAW）
读取一个文件（RAW）
写入一个文件（RAW）
跳转下载一个文件
状态相关
对明文脚本内容进行语法检测
获得脚本运行状态
获得前台应用画面旋转方向
设置相关
获取录制设置
录制设置开关
获取音量键事件设置
音量键事件设置开关
获取开机启动设置
开机启动设置开关
选择开机启动脚本
获得用户偏好配置
设置用户偏好配置
禁弹出 “无 SIM 卡” 弹窗开关
禁弹出 “低电量” 弹窗开关
禁弹出 “使用推送通知来连接 iTunes” 弹窗开关
设置设备名
设置设备的屏幕背光度
设置设备全局音量
系统相关
获取设备已安装应用程序信息
获取设备信息
锁定屏幕
解锁屏幕
重启服务
注销设备
重启设备
关机
清理 UI 缓存
清理 GPS 伪装信息
全清设备
清理应用程序存档
导入一张照片到系统相册
更新自己
打开远程访问
关闭远程访问
获取远程服务开启状态
加密脚本相关
加密一个设备上的脚本文件
加密一段明文脚本
加密一段明文脚本并返回下载 URI
授权相关
绑定一个授权码
获得当前设备的授权信息
控制相关
UDP 扫描局域网的设备
远程启动脚本接口
停止脚本接口
暂停脚本接口
继续脚本接口
远程截图接口
设置进程词典条目的值
查看进程词典条目的值
推入条目到进程词典队列
从进程词典队列弹出条目
弹出进程词典队列所有条目
URL Scheme 与二维码协议
简介
打开扫一扫
运行脚本
停止脚本
绑定授权
XUI 相关
下载相关
恢复工作区
软猫云
本书使用 GitBook 发布
如何选择脚本？
如何选择脚本？
启动 XXTouch 的 App 后可以看到 “我的脚本” 界面
点一下需要选择的脚本文件名
results matching "
"
No results matching "
"