触动小精灵开发者平台使用手册

rourou • 发表于 2018-09-04 12:19:30 • 更新于 2022-07-07 15:00:32 • 0回复

简介

触动小精灵是触动提供的在线脚本加密打包服务,可以把脚本打包成一个可单独执行的 apk/deb 程序。目的是为了满足广大开发者的定制需求,把脚本包装成个人品牌,同时也使脚本分发更加方便快捷。
触动小精灵支持自定义软件名称、logo、启动图片、Bundle ID(包名)、文件目录等,提供了配套的授权服务和脚本更新服务。
触动小精灵 = 触动精灵 + 脚本,使用触动小精灵无需再安装触动。

注意事项(请先看这一条)

安卓小精灵调用 ts.so 函数,无需打包 ts.so 文件,否则会报错,此文件已内置到小精灵中(iOS 已内置)。

安卓/iOS 小精灵使用 TSLib 相关函数无需打包 TSLib.lua 文件,此文件已内置到小精灵,如果 TSLib.lua 不是最新版本,请下载、打包最新版本的 TSLib.lua 更新小精灵。

安卓/iOS 小精灵使用 ts.so、sz.so 、TSLib  网络相关函数,必须在小精灵平台勾选网络插件,否则会报错。

安卓/iOS 小精灵使用 tsnet.so 函数必须要打包 tsnet.so 文件并在小精灵平台勾选网络插件,否者会报错。

安卓/iOS 小精灵使用 tsimg.so 函数需要打包 tsimg.so文件。

小精灵创建成功后无法修改小精灵类型,需要重新创建小精灵。

安卓新增扣点版小精灵,无需输入小精灵授权码,每台设备每天运行会扣除小精灵开发者的精灵石,其他功能和授权版相同。

触动产品功能对比

产品名称 自定义图标 自定义 Bundle ID 自定义应用名称 运行源码 授权 批量控制 支持平台 开发者平台
触动精灵 × × × iOS 标准版:46 元/台/年,Android:免费 购买API自行开发 iOS/Android 触动分发平台
触动小精灵 × 详见 购买API自行开发 iOS/Android 小精灵平台
触动企业版 × × × 详见 免费 iOS/Android 企业版平台

注意事项

  1. 小精灵开发者平台仅适合具备脚本开发能力的开发者使用。如果您打算学习脚本开发,请使用触动精灵,相关学习文档见开发者指南:https://www.touchsprite.com/helpdoc#/doc?id=1639
  2. tsp 是触动在开发者上传脚本压缩包时将脚本在线加密生成的脚本格式。
  3. iOS 小精灵打包后为 deb 格式安装包(下载显示的是 zip 文件需要解压),安卓为 apk 格式安装包。

小精灵相关信息

整体使用流程说明

创建小精灵

触动小精灵开发者平台使用手册

升级小精灵

触动小精灵开发者平台使用手册

创建小精灵

普通版小精灵

  1. 进入小精灵开发者平台首页(app.touchsprite.com),点击导航栏中的小精灵按钮,进入我的小精灵页面
  2. 在我的小精灵页面,根据需要选择创建 iOS 或者安卓小精灵。目前,iOS 和安卓小精灵(新增扣点版)仅在小精灵类型上有所不同,其他上传小精灵的步骤基本相同。

触动小精灵开发者平台使用手册

在填写小精灵详情页面,依次填写小精灵名称、增值服务、程序唯一标识、试用时间(安卓扣点版无试用时间)、功能介绍、联系方式。

触动小精灵开发者平台使用手册

小精灵名称

  • 小精灵安装到设备后在桌面上显示的名字。
  • 仅支持中文、英文和数字,长度限制为最短 2 个字符,最长 13 个字符,一个中文为 2 个字符。
  • 一旦创建成功后不可更改。

程序唯一标识

  • 必须以英文字母开头,仅支持英文和数字,长度限制为最短 5 个字符,最长 44 个字符。
  • 安卓小精灵为 com.foray/iceflow.程序唯一标识(程序唯一标识:必须以英文字母开头,仅支持英文和数字,长度限制为最短 5 个字符,最长 44 个字符)
  • 一旦创建成功后不可更改。

联系方式

填写正确的联系方式,方便用户联系您购买授权。

填写完毕后,点击「下一步」,进入上传小精灵图标页面,按照要求上传应用图标(必填)、启动图像(选填)。

自定义应用图标

  • 有默认图片,上传符合尺寸和格式要求的图片(图片需要为 png 格式),
  • 一旦创建成功后不可更改

启动图像

  • 可以不上传或只上传一种尺寸的图片
  • 生成小精灵时将缺少的启动图像默认设置为空白图片
  • 一旦创建成功后不可更改

触动小精灵开发者平台使用手册

上传完图标和启动图后,点击「下一步」,进入上传小精灵代码页面,填写版本号信息,上传脚本文件,点击提交打包,等待打包完成。

上传脚本压缩包

  • 必须包含一个名为 main.lua 的脚本主文件。
  • 脚本工程所需的资源文件(包括图片、文本、音频、插件、扩展库文件等)。
  • 压缩包必须为 zip 格式。
  • 压缩包大小不能超过 10 M。

触动小精灵开发者平台使用手册

收费说明

小精灵开发者平台在线加密打包服务完全免费。

收费类型分为授权码及扣点版。

授权版:允许开发者设置 0 ~ 8 小时的试用时间,生成授权码免费,当小精灵过期后,需要使用授权码激活,激活小精灵授权码时扣除开发者账户内的精灵石,若精灵石不足,则激活失败。

扣点版:无需输入小精灵授权码,每台设备每天运行会扣除小精灵开发者精灵石。

收费标准

小精灵根据所选择的不同类型,在激活小精灵授权码时扣除不同数量的点数(生成授权码不扣除点数),授权版具体请看下表

扣点版不需要输入小精灵授权码,每台设备每天运行根据选择的增值服务扣除小精灵开发者对应的精灵石。

点数价格

无打折优惠活动的情况下,1 点小精灵为 0.05 元。

小精灵类型

Android  小精灵授权版提供了 3 种增值服务。

类型 系统 功能介绍 日卡(点/张) 周卡(点/张) 月卡(点/张) 季卡(点/张) 年卡(点/张) 永久卡(点/张)
授权版 Android 可以用函数扩展库,内置 TSLib,无网版 ts.so,可以使用如找色、点击等无网络函数 1 7 30 90 366 888
云打码 Android 适合需要使用 cloudOcr 插件的脚本,选择后内置此插件 0 0 0 0 0 0
网络插件 Android 适合需要访问网络(如函数扩展库云打码函数、苏泽库 http 模块)的脚本,内置 TSLib、有网版 ts.so 1 2 5 15 20 45
TS Remote API Android 适合需要使用中控的脚本 限时免费 限时免费 限时免费 限时免费 限时免费 限时免费

iOS 小精灵授权版提供了 4 种增值服务。

类型 系统 功能介绍 日卡(点/张) 周卡(点/张)) 月卡(点/张) 季卡点/张) 年卡(点/张) 永久卡(点/张)
授权版 iOS 可以用函数扩展库,内置 TSLib、无网版 ts.so 4 28 110 330 500 990
云打码 iOS 适合需要使用 cloudOcr 插件的脚本,选择后内置此插件 0 0 0 0 0 0
网络插件 iOS 适合需要访问网络(如函数扩展库云打码函数、苏泽库 http 模块)的脚本,内置 TSLib、有网版 ts.so 1 7 30 90 120 270
自定义扩展库 iOS 适合需要使用自定义扩展库(包含云打码、网络插件和 so 文件)的脚本 3 21 100 300 400 900
TS Remote API iOS 适合需要使用中控的脚本 限时免费 限时免费 限时免费 限时免费 限时免费 限时免费

iOS 基础版小精灵月卡授权码单价为 110 点(5.5 元),年卡 500 点(25 元),永久卡为 990 点(49.5元)

  • iOS 小精灵当您选择了云打码+网络插件时,当前生成的小精灵月卡授权码单价则为 140 点(7 元),年卡 620点(31 元),永久卡为 1260 点(63 元)
  • iOS 小精灵增值插件如需调用第三方插件,需要勾选自定义拓展库同时将该插件同脚本一同打包上传。
  • 小精灵如果使用 sz.so 或者 ts.so  的非网络函数不需要勾选网络插件,内置无网络版插件,使用网络函数必须需要勾选网络插件。
  • 安卓/iOS 小精灵使用 TSLib 网络相关的函数需要勾选网络插件。
  • 使用 cloudOcr.so 安卓小精灵可以勾选云打码,iOS 小精灵可以勾选基础版 + 云打码,无需勾选网络插件,TSLib.lua、sz.so、ts.so、cloudocr.so 库已内置无需打包上传
  • 如需打包特定版本的 ts.so,iOS 可直接将 ts.so 打到压缩包中,选择网络插件上传。安卓如需支持真机和模拟器双平台,需要修改 ts.so 的名称,模拟器版本为 ts_x86.so,真机版本为 ts_arm.so;若无需支持两个平台仅打包其中一个无需改名。
  • 如需使用 tsnet.so,小精灵类型需选择网络插件,iOS 需要将 tsnet.so 打包到 zip 包中一并上传。安卓如需支持真机和模拟器双平台,需要修改 tsnet.so 的名称,模拟器版本为 tsnet_x86.so,真机版本为 tsnet_arm.so;若无需支持两个平台仅打包其中一个无需改名。
  • 如需使用 tsimg.so,iOS 需将 tsimg.so 打包到 zip 包中一并上传。安卓如需支持真机和模拟器双平台,需要修改 tsimg.so 的名称,模拟器版本为 tsimg_x86.so,真机版本为 tsimg_arm.so;若无需支持两个平台仅打包其中一个无需改名。
  • 小精灵类型一旦创建成功后不可更改。
  • 试用时间必须为 0 ~ 8 之间的整数,小精灵试用时间到期后将不能再继续使用,需要通过作者购买授权才能继续使用。

安装使用小精灵

触动小精灵同触动其他产品一样,iOS 设备需要越狱,Android 设备获取 root 权限才能使用,Android 小精灵还需要开启系统悬浮窗权限和给小精灵 root 权限才行(如果不想root可以在手机安装大师,在虚拟大师中安装触小精灵)。

下载安装

deb 格式的小精灵有以下几种安装方法:

  • 将 deb 安装包放到任意文件目录,在手机上安装 iFile/Filza(文件管理器),点击进行安装
    图文教程:https://www.touchsprite.com/docs/8028
  • 将 deb 安装包上传到源(如威锋源),添加源在线安装。

apk 格式的小精灵和其他安卓程序一样直接安装即可。

注意事项

小精灵平台下载的 iOS 小精灵为 zip 安装包,需要解压成 deb文件按照手机系统进行安装。

iOS10 及其以上系统请使用 10.3+ 这个安装包(5c/5c 10.3 及其以下系统需要使用 iOS8-iOS10.2 这个安装包)

资源、日志路径

在小精灵程序的授权页面底部可以查看小精灵的资源和日志路径(免费小精灵的路径信息在更多页面)

  • iOS 小精灵的路径是 /private/var/mobile/Media/程序唯一标识/
  • Android 小精灵的路径是 /mnt/sdcard/程序唯一标识/

程序安装路径

  • iOS 小精灵路径:/Applications/小精灵唯一标识.app
  • 安卓路径与设备系统有关,一般是在 data 目录下

启动脚本

运行脚本有三种方式:

  1. 按音量“-”键。
  2. 点击悬浮窗的运行按钮。
  3. 在小精灵详情页面底部点击启动应用按钮。

常见问题

iOS 运行脚本没效果/不点击/没有图标

  • iOS 小精灵的此类问题解决办法与触动精灵 iOS 完全一致。
  • 如果您是使用 AutoInstall 的安装方式安装 iOS 小精灵,请确保您重启设备 2 次以上。由于 AutoInstall 这种安装方式会导致很多问题,比如点击失效、没有图标等,强烈建议您将 iOS 小精灵上传到第三方源使用 Cydia 在线安装。
  • 查看您的 Cydia 变更界面是否有必备插件需要升级,如果有,请升级后重启设备或重新安装小精灵再试。
  • 查看您的 Cydia 已安装列表,是否存在和触动精灵 iOS 冲突的插件(参考附录),如果有,请卸载后重启设备或重新安装小精灵再试。

安卓运行脚本不弹出 showUI/dialog

  • 安卓小精灵的此类问题解决办法与触动精灵安卓版完全一致。
  • 部分安卓系统需要打开系统悬浮窗权限才能显示 showUI/dialog。

安卓小精灵开启系统悬浮窗权限

手机 方法
小米 1.设置 - (界面底部)其他应用管理 - 触动精灵 - 应用详情界面上滑 - (底部)权限管理 - 悬浮窗管理 - (弹出的底部菜单)选择允许
2. 安全中心 - 授权管理 - 应用权限管理 - 小精灵名称 - 显示悬浮窗 - 开启
华为 1.设置 - 全部设置 - 隐私和安全- 通知管理 - 悬浮窗管理 - 小精灵名称 - 打开开关
2. 手机管家 - 悬浮窗管理 - 小精灵名称 - 开启悬浮窗
魅族、魅蓝 1.设置 - (左侧栏)应用管理 - 小精灵名称 - 权限管理- 弹框消息一览 - 点击右侧按钮 - 按钮为绿色时为打开状态
2. 安全中心 - 授权管理 - 小精灵名称 - 悬浮窗 - 开启
oppo 安全中心 - 权限隐私 - 应用权限管理 - 悬浮窗管理 - 小精灵名称 - 打开开关
乐视 管家 - 权限管理 - 应用权限管理 - 权限管理 - 小精灵名称 - 显示悬浮窗 - 开启
锤子、坚果 安全中心 - 应用程序权限管理 - 其他 - 桌面悬浮窗 - 小精灵名称 - 打开开关
三星 默认开启悬浮窗权限
vivo 默认开启悬浮窗权限
酷派 默认开启悬浮窗权限
金立 默认开启悬浮窗权限

安装多个小精灵

  • 同时安装多个小精灵不会互相冲突
  • 默认音量键和悬浮窗运行的是最后安装或打开的那一个

小精灵管理

登录触动小精灵开发者平台,点击「小精灵管理」,可查看到您已创建的小精灵列表,对小精灵进行相关操作

小精灵版本升级

未更新打包服务或引擎版本

  1. 可直接点击升级按钮,进入升级版本页面,填写版本号、更新日志,上传升级的脚本文件,点击提交打包。
  2. 等待打包成功后,已安装了该小精灵的用户再次打开应用时会看到升级日志和通知。
  3. 如果用户不小心关掉了提示,也可以在设置页面点击检测更新检查是否有新版本进行更新。

打包服务或引擎版本已更新

仍然可以直接点击升级按钮上传新版本,但用户不可立即在小精灵客户端直接检测更新,需要您将安装包下载到本地,并更新到您的源,用户即可直接更新。

设备数量上限

仅支持安卓扣点版小精灵,可设置当前小精灵每天运行的设备数量最大数量(1~99999),第二天 0 点重新计算数量上限。

版本列表

小精灵版本列表可查看对应小精灵的所有版本,并可设置某一版本为缺省版本,且可删除非缺省版本。

触动小精灵开发者平台使用手册

下载

下载小精灵到本地,进行安装。

iOS 下载的是 zip 文件,需要自行解压成 deb 文件。

安卓下载的是 apk 文件。

详细信息

点击「详细信息」按钮,进入小精灵详情页面,可查看小精灵的详细信息(包名、类型、试用时间等),并可修改小精灵或者删除小精灵.

Bundle ID/package name

触动小精灵开发者平台使用手册

删除小精灵

小精灵一旦删除,所有的授权和设备记录都会被清空,已经生成尚未激活的授权码会自动回收到开发者账户余额。

勾选小精灵点击下方的删除按钮。

查看设备

查看下载过该小精灵的设备信息,具体操作见“设备管理”。

查看授权码

查看该小精灵的授权码,具体操作见“授权管理”。

授权管理

小精灵客户端就相当于定制版触动精灵客户端,其中的脚本相当于 TSP 脚本,小精灵授权与触动精灵 TSP 授权机制相同,不同设备需要分别授权(安卓免费小精灵除外),在试用时间到期后需要用户输入授权码进行激活。

生成授权码

进入授权管理页面后,点击「生成授权码」,进入授权码生成页面,选择要生成授权码的小精灵、依次输入要生成授权码的类型以及张数,目前有三种授权码类型:月卡、年卡和终生卡。

生成授权码是免费的,在激活授权码时扣精灵石,但是需要保证账号中有充足的精灵石以保证用户可以正常激活授权码,开发者可在触动商城购买充值卡增加开发者账户内的点数,具体充值方法请看“充值卡充值”。

 触动小精灵开发者平台使用手册

激活授权

点击「授权码管理」->点击「激活」,将会弹出授权码二维码。

激活小精灵授权有两种方式:

1.把生成的授权码直接发送给用户,用户直接在小精灵内激活授权。

  1. 将二维码图片发送给用户,用户可用小精灵扫码激活授权。

 

批量回收

选择要回收的授权码,点击批量回收,即可回收授权码。

注意事项

  • 月卡、年卡、永久卡授权,您可以在开发者平台的授权管理页面回收授权码。
  • 授权码的剩余点数会自动加入您的余额。

48 小时内回收扣点计算公式

以基础版月卡为例
激活 24 小时内:回收点数 = 110 - 110 点/30×1
激活时间超过 24 小时,不超过 48 小时:回收点数 = 110 - 110 点/30×2

查询结果导出

将查询结果导出为 excel 文件。

设备管理

关于设备号

iOS 小精灵的设备号没有计算电池序列号,与触动精灵/企业版设备号不一致的情况是正常的。

设备管理

查看下载过小精灵的所有设备信息,在操作列中可进行「授权换绑」、「激活/续费」、「加入黑名单」等操作。

触动小精灵开发者平台使用手册

加入黑名单

将指定设备加入黑名单,黑名单中的设备将不能再使用该开发者账号下的任何小精灵。

更换绑定

点击更换绑定按钮,在弹出框输入用户的新设备号,将授权码与新设备绑定,旧设备的授权码失效,不能再继续运行小精灵。

注意事项

  • 所有类型的授权都支持换绑。
  • 每个授权码 30 天内仅可进行一次换绑操作。

黑名单列表

查看已加入黑名单的设备列表,并可把设备移出黑名单。

触动小精灵开发者平台使用手册

订单管理

查看生成授权码的订单列表,可复制订单号、导出授权码、查看授权码详细信息等。

充值卡充值

  1. 触动商城购买充值卡,收到充值卡号
  2. 打开小精灵开发者平台,进入充值页面
  3. 在页面内粘贴输入从旺旺或者触动商城复制的充值卡号,确认无误后确定即可

其他问题

为什么我修改了小精灵描述,小精灵客户端没有更新?

由于服务刷新机制问题,客户端上的小精灵详情不会立即刷新,请耐心等待半个小时左右再试。

打包时显示的触动精灵引擎版本是什么?和小精灵的版本一样吗?

不一样。引擎版本是指小精灵打包时使用的触动精灵服务版本号,即使用 getTSVersion 函数获取到的版本号。
而小精灵版本号是您创建或升级小精灵脚本时设置的版本号。

打包页面报错“打包失败”,怎么办?

首先,请检查您的开发者名字中是否包含空格,如果包含空格,请在小精灵反馈群中联系管理员为您修改用户名。
如果您的开发者名字中不包含空格,请在 触动小精灵用户群 内留言反馈。

小精灵和触动精灵、触动企业版、帮你玩可以同时安装吗?

可以。如果您觉得音量键弹出多个窗口不太方便,可以在使用其中一个软件时将其他软件的服务关掉。

运行 iOS 小精灵提示 TSP 脚本验证失败(0)!

出现这样问题的解决方案如下
网络问题。请确保设备处于联网状态, 查看 /Applications/小精灵名.app/ 路径下是否存在文件 desc2_bk.png,如果不存在,说明与脚本验证服务器通讯失败。

  1. 请尝试更换网络。
  2. 请尝试修改 DNS 为 223.5.5.5 和 223.6.6.6
  3. 请尝试重启服务(音量+)
    时间设置问题。可能是由于时间与当前不匹配,请尝试设置-通用-日期与时间-将自动设置时间打开。

    小精灵内容包含违法内容,该如何举报?

    对于包含赌博等违法内容的脚本,触动一旦核实,会对开发者账号进行封禁处理。请将涉嫌违规的小精灵截图(包含运行界面、设置界面开发者名字和联系方式)、小精灵安装包,发送到 support@touchsprite.com。

7 人觉得有帮助 有帮助