一、天意发卡介绍：

天意发卡是一款AI型游戏伴玩平台，拥有全终端（安卓、IOS、PC等）多种接入方式（程序或机械臂）的游戏伴玩机器人，针对中高端游戏爱好者（如主播等）提供游戏伴玩或代练服务。 随着玩家越来越多丰富代玩需求的产生，一批专业的伴玩服务商加入了我们，他们可以利用“灵溪伴玩”产品创造出更加丰富多样的玩法，例如：每日自动日常、定期帮好友刷刷本之类。 天意发卡平台拥有4个部分组成：

灵溪伴玩主要由帮玩、场景、动作组成，他们分别的关系是：一款游戏可以有多个帮玩，每个帮玩就是一种类型的代练任务，帮玩又是由多个场景组成的，场景是一套动作组合形成的，比如可以有“游戏登录”或者“领取日常奖励”这样的场景，最后就是动作了，灵溪伴玩里面的动作比较丰富，但是也比较简单，大多数动作只用拖动相应的位置坐标就可以完成，例如点击哪里之类的。下图是一张简单的说明，这些终端都将按照这样的执行顺序去完成每个动作和场景。

二、新建游戏和帮玩

新建游戏目前为所有用户均可创建，未来将进行审核制，已经创建的游戏则无法再次创建：

创建好游戏后，点击进入灵溪伴玩即可新建帮玩，未来将对帮玩进行授权或销售等功能的开发。

新建完成以后，选择对应的帮玩任务，即可进行场景和动作的添加了。

三、新建场景

在新建场景之前我们可以对任务所需的游戏截图进行录制，以苹果终端为例，下载好触动经理（目前IOS的终端）发布相应的终端控制（ios控制端 、 ios控制端（航海王） 、 安卓控制端 、 电脑控制端 ）之后启动，输入游戏ID，机器ID，选择“截图模式“。 帮玩运行启动之后，会看到计时提醒，当显示数字“2”时，即会完成对应的截图动作，截图会自动传输到游戏下，之后即可选择截图完成对应动作编写。 在之前的描述中说明过，步骤（场景）即每个游戏的一套动作组合，我们可以根据自身需要完成。

步骤是一个接一个完成的，当执行到最后一个之后就会结束整个帮玩任务，如果需要有反复执行的情况，一般我们采用分支去完成，分支可以在第一层步骤下方添加，点击“添加分支”按钮，按以下格式输入分支的执行步骤和执行条件即可。

特别说明：分支里面的步骤名称必须用双引号包裹，紧接一个逗号和数字，数字代表了执行的次数。 添加的分支条件中，第一个输入框需要输入条件名称，条件名称是在动作中通过“数字赋值”去设置的，第二个输入框代表条件的执行逻辑，有“==”等于、“>=”大于等于、”<=”小于等于这几种。 最后是通过“编辑步骤”按钮，进入步骤（场景）的编辑画面。

四、动作条和动作

在步骤（场景）编辑画面中，首先我们通过添加动作条的方式增加第一个动作条：

选择第一个动作之后点击修改动作，即可看到动作编辑面板：

面板下方是动作类型控制面板，其中绿色的动作是只能修改到第一排动作的，蓝色的动作是只能改到后排动作的，注意每列动作不能超过10个。 步骤（场景）中的动作条执行逻辑是这样的，动作条的第一个动作是判断型的，如果满足的话则会将该动作条下面的动作全部执行完成，当所有动作条都判断一遍后，会从左到右作为优先级进行执行，每次判断仅执行一个动作条（直接执行除外）。 下面具体解释每个动作的含义和操作：

1、 固定按钮 含义：固定按钮代表着如果出现了该按钮则进行后续动作，固定按钮的位置不能发生变化。 添加：点击该按钮后，再点击截图的按钮（如果没有自动识别，则需要根据左侧的学习型按钮框出按钮的位置，再选择） 注意：会自动生产3个坐标，坐标不能放置在背景上。

2、 移动按钮 含义：当画面的一个范围内出现了可能发生位置变化的按钮，则执行后续的动作。 添加：点击该移动按钮后，再点击画面中的移动按钮，最后两个坐标代表查找范围，同时还需要在控制文本中输入模糊范围（1-100）。 注意：除开范围坐标，其他坐标不要放在背景处，避免判断失效，同时建议多次判断，可以通过重复次数设置大于1的数字来完成。

3、 非固定按钮 含义：和固定按钮刚好相反，当画面中没有固定按钮的时候，则执行后续动作。 添加：操作和固定按钮一样。 注意：注意不要将坐标放置在背景上

4、 非移动按钮 含义：和移动按钮刚好相反，当画面中没有移动按钮的时候，则执行后续动作。 添加：操作和移动按钮一样。 注意：注意不要将坐标放置在背景上，同时建议多次判断，可以通过重复次数设置大于1的数字来完成。

5、 直接执行 含义：每轮判断都一定会执行的动作，一般是做一个固定动作，比如打开应用使用的。 添加：直接点击即可 注意：每轮判断时间大概1-2秒左右，所以如果有其他点击类动作，则会经常被执行，导致无法控制的问题。

6、 条件初始 含义：对于跨机设备的互动脚本使用，比如A机器需要等待B机器将条件修改为其他值的时候才能开始执行。 添加：点击该按钮，条件名和条件值填入自己想要的值 注意：需要跨机执行才能出现

7、 点击 含义：终端（软件或机械臂）去点击一下屏幕 添加：选择该按钮，然后将左上角的坐标拖到要点击的位置。 注意：无

8、 拖动 含义：终端拖动一次屏幕 添加：选择该按钮，拖动第一个坐标到起始位置，拖动第二个坐标到结束位置。控制文本可以设置拖动时间（毫秒为单位） 注意：拖动时间是毫秒为单位的

9、 打开应用 含义：软件控制终端可以通过应用ID打开应用 添加：选择该按钮，在控制文本输入应用ID 注意：一般需要多次打开，所以可以放置在直接执行下面

10、 关闭应用 含义：软件控制终端可以通过应用ID关闭应用 添加：选择该按钮，在控制文本输入应用ID 注意：默认在任务开始前最好先关闭应用，从头开始执行该任务

11、 移动点击 含义：在移动按钮被找到以后，通过移动点击进行点击操作。 添加：选择该按钮，会自动生成两个坐标，坐标二相对坐标一之间的位置就代表了移动按钮（第一排必须是移动按钮才有效）第一个坐标与要点击位置的相对位差 注意：如果就想点击移动按钮，则两个坐标位置相同即可。

12、 中文输入 含义：在需要输入中文的地方，通过该动作输入中文文字 添加：选择该按钮，在控制文本中填写输入内容，如果需要输入用户名或密码，可以填写”用户(loginuser)” 或者”用户(psd)” 注意：如果无法成功输入可以使用英文输入测试。

13、 英文输入 含义：在需要输入英文或数字的地方，通过该动作输入英文或数字文字 添加：选择该按钮，在控制文本中填写输入内容，如果需要输入用户名或密码，可以填写”用户(loginuser)” 或者”用户(psd)” 注意：如果无法成功输入可以使用循环英文输入测试。

14、 循环英文输入 含义：在需要输入英文或数字的地方，通过该动作输入英文或数字文字 添加：选择该按钮，在控制文本中填写输入内容，如果需要输入用户名或密码，可以填写”用户(loginuser)” 或者”用户(psd)” 注意：如果无法成功输入可以使用英文输入测试。

15、 按下 含义：在需要按下的地方进行该动作 添加：选择该按钮，选择第一个坐标进行按下位置的确定 注意：该动作不会抬起，需要配合抬起和等待时间

16、 抬起 含义：在需要抬起的地方进行该动作 添加：选择该按钮即可 注意：需要配合按下和等待时间

17、 提示 含义：通过小型提示框提示消息 添加：在控制文本内输入提示内容，加上逗号以后填写时间（秒） 注意：提示消息不会影响其他操作

18、 警告 含义：通过弹出警告框提示消息 添加：在控制文本内输入提示内容，加上逗号以后填写时间（秒），填0就是一直提示 注意：警告消息会影响其他操作

19、 等待时间 含义：不做任何操作的时间（毫秒为单位） 添加：选择该动作，填写控制文本（毫秒为单位） 注意：无

20、 返回主线 含义：一个步骤（场景）的结束动作 添加：选择该动作，在控制文本里填写结束值（1是正常结束，可以进行下一个场景；2是异常结束，将不执行后续场景，并且开始下一个任务） 注意：一定要填写控制文本

21、 数字赋值 含义：可以通过该动作增加条件的值，例如将关卡赋值成23之类的 添加：选择该动作，填写控制文本，格式：条件名称,值 注意：赋值后即可通过分支条件的判断，进行分支步骤的执行

22、 更新状态 含义：状态是每个任务（账号）的一个属性，我们可以通过该动作对每次任务进行的状态进行更新 添加：选择该动作，填写控制文本（目前仅支持signature），格式: signature,2 注意：更新后，可以在控制台进行筛选和任务（账号）的导出。

23、 条件等待 含义：和条件初始一样，是一种跨设备的互动动作，当条件还未达到某个值的时候一直等待 添加：选择该动作，填写控制文本，格式：条件名称,判断条件,值（例如：需要实名,==,1） 注意：需要配合条件初始进行动作

24、 输验证码 含义：通过判定一个区域内是否有验证码，如有则智能识别后进行输入 添加：选择该动作，前2个坐标为识别的区域，后1个坐标为输入的区域 注意：可识别数字、文字等验证码

25、 创建手机号 含义：通过外部平台获取手机号，并自动创建任务（账号） 添加：选择该动作，如有余额，则将获取到手机号并创建任务 注意：平台一般需要定期更新

26、 获取手机号 含义：对signature不为8的任务进行逐一获取，执行到8未终止 添加：选择该任务即可获取下一个任务的手机号 注意：无

27、 手机验证码 含义：通过该动作等待获取创建好的手机号获取到的验证码（收费），并进行输入 添加：选择该动作，将坐标拖至要输入验证码的位置。 注意：该动作将输入最后的验证码，如未获取到将重启任务。

五、过场场景

对于在分支下的每个步骤（场景）的执行间隔，由于各种原因可能会出现某些特殊界面，我们可以通过编辑过场场景关闭这些动作，当出现我们想要的界面后才开始执行下一个场景。