侠客群控助手模块与脚本开发教程

admin · 发表于 2020-1-11 14:56:09

模块与脚本开发教程一、模块管理器打开模块管理，进入模块管理器： 1、功能区划分： 2、主要功能：新模块：新建新的群控模块。删除：删除一个已有的群控模块，包含该模块中的所有脚本。新脚本：在选定的模块下新建一个新的脚本。编辑：对选定模块里的指定脚本进行…

模块与脚本开发教程一、模块管理器

打开模块管理，进入模块管理器：

1、功能区划分：

2、主要功能：

新模块：新建新的群控模块。

删除：删除一个已有的群控模块，包含该模块中的所有脚本。

新脚本：在选定的模块下新建一个新的脚本。

编辑：对选定模块里的指定脚本进行编辑。

删除：删除选定模块里指定的已有脚本。

保存：保存模块文件。

3、新建模块：

新建模块名称：新的模块的名称，可以是APP应用名称，也可以是功能名称。

4、脚本区右键菜单：

编辑：对选定的脚本进行编辑。

向上移动：对指定的脚本顺序向上移动一格。

向下移动：对指定的脚本顺序向下移动一格。

重命名：对脚本名称与按钮颜色进行修改。

删除：删除选定的脚本。

5、新建脚本：

新建脚本名称：新脚本的名称，以功能名称为好。

脚本按钮颜色：设置脚本在手机控制面板上的按钮背景颜色。

显示窗体类型：共有十二种类型供选择。

6、窗体类型：

（1）无窗口：此类窗口的脚本一般用于一些简单的功能，如打开APP及打开指定的功能窗口。

（2）文本文件类：此类窗口用于从文本文件中导入账号或号码来添加好友。

（3）关注与点赞类：

（4）无限循环类：

（5）群发消息类：

（6）文字列表类：

（7）文字列表加验证类：

（8）发布作品类：

（9）素材库中发布类：

（10）搜索加人类：

（11）导入二维码类：

（12）新闻阅读类：

二、脚本编辑器

新建脚本或选择脚本进行编辑可进入脚本编辑器，脚本编辑器必须在已有手机连接时才能打开。

（一）功能区划分：

（二）主要功能：

添加录制与结束录制：添加一段手动操作片段到动作编辑器中。

复制脚本：从一个已有的脚本中复制所有动作（指令）集到此脚本中，此脚本的所有动作集将被覆盖。

编辑：对选定的动作（指令）进行修改，部分动作（指令）不支持修改。

删除：删除选定的动作（指令）。

保存：保存当前脚本，编辑完成后一定要进行保存，否则新修改的动作（指令）会被丢失。

测试：测试当前脚本，以检查是否达到设想的要求。

附录：复制脚本功能操作

第一步点击功能区“复制”按钮，第二步选择一个已完成的目标脚本，第三步点击“确定”按钮，复制完成。复制脚本只能用于同类的脚本类型之间进行复制。

（三）信息显示：

1、脚本常规信息：

（1、脚本的名称；2、脚本编辑时屏幕的分辨率；3、查看脚本窗口）

注：屏幕分辨率是脚本执行坐标点击或长按的基础，脚本里所有的坐标都是基于它，修改它可能会引起相关指令的失效或坐标转换后出现偏差。

2、点击坐标/页面标识信息：

（1）点击坐标：这里显示在屏幕上点击后的坐标参数，脚本所有需要以坐标进行点击或长按的坐标以此为准。

（2）页面标识：查看手机界面实时的页面标识，脚本所有需要判断页面的操作可以从这里获取页面标识。

（3）复制：复制标识输入框内的标识内容。

（四）编辑区右键菜单：

编辑动作：对选定的动作（指令）进行修改，部分动作（指令）不支持修改。

向上移动：对指定的动作（指令）顺序向上移动一格。

向下移动：对指定的动作（指令）顺序向下移动一格。

删除动作：删除选定的动作（指令）。

（五）脚本编辑

一个脚本有多个动作集组成，一个动作集由多个指令（动作）组成。

1、手机参数获取：

（1、获取手机界面所有元素；2、获取手机页面标识；3、在屏幕上获取一个坐标；4、修改屏幕分辨率）

（1）获取手机界面所有元素：

（查找或点击对象可以根据这里的ID、文字、描述或控件来查找或点击对象）

注意：由于安卓系统的机制问题，手机在播放视频时可能获取不了数据（视频播放时，手机系统无法处于idle，致使群控系统获取不了屏幕界面数据，所有通过对象来操作的指令都会失效），在进行编写指令时解决的方式有两种，一种是想办法暂停视频播放；另一种是通过页面的标识来判断页面位置，然后以坐标的方式来编写指令，这要求所有手机的分辨率的横纵比要相同，手机界面要相同，最好是采用同型号手机。

（2）获取手机页面标识：

（有关页面指令所需要的标识的都可从这里获取）

（3）在屏幕上获取一个坐标：

点击此按钮后，面板上的手机屏幕上提示在屏幕上点击一个坐标

点击屏幕后，点击坐标上将会显示出点击的实际坐标，此坐标是相对于屏幕分辨率的，不是手机的实际分辨率。脚本里所有的有关坐标的指令，都是以这里给出的坐标来进行操作，不是手机的实际坐标。

（4）修改屏幕分辨率：

在面板上的手机屏幕大小发生改变后，此按钮将会被激活，系统提示修改屏幕分辨率，此分辨率是脚本的全局参数，修改可能会影响基于坐标的点击或长按指令的执行。

2、脚本执行流程：

（1）单动作（指令）集脚本执行类：

无窗口类、无限循环类窗口属于此执行类。此类执行类只有一个主指令集，执行流程如下：

（2）通用脚本执行类：

文本文件类、关注与点赞类、群发消息类、文字列表类、文字列表加验证类、搜索加人类、导入二维码类、新闻阅读类窗口属于此执行类。此类执行类包含头指令集、主循环体与尾指令集，执行流程如下：

（3）素材脚本执行类：

发布作品类、素材库中发布类窗口属于此执行类。此类执行类包含图片指令集、分享指令集、视频指令集与文字指令集，执行流程如下：

（4）导入二维码类执行流程：

（5）无限循环类执行流程：

（6）新闻阅读：

脚本的执行流程同通用脚本执行类，只是增加了有关于新闻过滤的设置。

广告页标识：设置广告页面的标识，如果过滤广告被选中，则系统不会浏览所有该标识的页面。

图片页标识：设置图片页面的标识，如果过滤图片被选中，则系统不会浏览所有该标识的页面。

视频页标识：设置视频页面的标识，如果过滤视频被选中，则系统不会浏览所有该标识的页面。

3、指令集：

（1）常用：

转到APP首页：

APP入口标识：App应用的入口函数，如（快手）：com.smile.gifmaker/com.yxcorp.gifshow.HomeActivity。

APP包名：App应用的包名称，如（快手）：com.smile.gifmaker。

APP主页标识：App应用的主页标识，如（快手）：.HomeActivity。

是否指定版本：如果选择“启用”后，该脚本只运行在指定的APP版本上，其它版本将不会正常运行。

获取参数：将手机转到App应用的主页后，可以点击此按钮，自动获取App的包名与主页标识。

注：需要填写正确的App应用的入口函数，否则将打不开APP应用，影响后面的指令。

显示状态：

内容：将要在手机控制面板的手机屏幕上显示的提示内容。

描述：对此指令的说明。

注：为了以后脚本的维护方便，建议在所有有“描述”的地方，都输入相关的功能信息描述或说明。

查找对象并点击：

关键词：可以是对象的ID、文字、描述或控件名，有多个关键字时使用英文的括号括起来，并用"|"分隔开，如：(关键词1|关键词2)。

位置：选择目标对象在所有通过关键词查找到所列表中的排列位置，可以点击“查看”按钮来查看列表。

查看：必须将手机转到目标页面才能查看到所有包含关键词的对象。

坐标：如果没有找到目标对象，如在视频播放时，获取不了手机界面数据，则可以设置目标对象所处的坐标进行点击。

坐标的获取请查阅上面的“获取坐标”的介绍。

描述：对此指令的说明。

查找对象并返回：

类型：系统支持以对象或者页面标识的方式来查找。

关键词：通过对象查找时可以是对象的ID、文字、描述或控件名，有多个关键字时使用英文的括号括起来，并用"|"分隔开，如：(关键词1|关键词2)。通过页面标识查找时，先获取页面的标识，然后拷贝过来。

判断：选择查找的结果存在或不存在时执行返回上页的操作。

描述：对此指令的说明。

点击（坐标）：

坐标：如果没有找到目标对象，如在视频播放时，获取不了手机界面数据，则可以设置目标对象所处的坐标进行点击。

描述：对此指令的说明。

点击（对象）：

关键词：可以是对象的ID、文字、描述或控件名，有多个关键字时使用英文的括号括起来，并用"|"分隔开，如：(关键词1|关键词2)。

位置：选择目标对象在所有通过关键词查找到所列表中的排列位置，可以点击“查看”按钮来查看列表。

查看：必须将手机转到目标页面才能查看到所有包含关键词的对象。

描述：对此指令的说明。

输入文字：

请保证前面的指令已将页面转至了包含有输入框的页面上。

输入文字（随机）：

此指令仅支持“文字列表类”窗口，如果脚本是通过复制“文字列表类”，并且当前脚本不是“文字列表类”的时候，必须将脚本中的“输入文字（随机）”转为“输入文字”指令。

回车：

文本输入页面没有提交按钮，或按钮找不到，可以使用此指令直接提交。

停顿：

设置一个指定时间的停顿，建议每个指令后面都设置一个停顿时间，让新打开的页面有时间加载完成，方便后面的指令执行。

返回上一页：

该指令模拟手机的“返回”键。

HOME：

该指令模拟手机的“HOME”键。

（2）流程控制：

循环点击对象：

此指令多用于有列表的页面，指令会从上向下点击列表中的对象，每一次点击后，在循环指令集中要确保最后返回到这个列表的页面上，否则影响后面的点击。

关键词：可以是对象的ID、文字、描述或控件名，有多个关键字时使用英文的括号括起来，并用"|"分隔开，如：(关键词1|关键词2)。

点击区参数设置可以让指令只点击指定区域中的对象，以屏幕的百分比来计算区域，确保上边距参数不能大于下边距参数，左边距参数不能大于右边距参数。

创建新的“循环点击对象”指令后，在指令编辑区选择此指令后，“循环体”按钮将被点亮，点击此按钮后，对循环指令集进行编辑。

进入循环指令集进行编辑后，导航栏上将显示“返回”按钮，点击该按钮将退出循环指令集进行编辑，文字导航也出现“循环体”及层次。

条件判断：

a、新增条件：新增一个条件，如果已存在“无”类型条件，将不能继续添加条件。

类型：可以通过查找对象，或查找页面标识来操作，如果选择“无”，下面的各参数不需要填写。

关键词：如果选择“查找对象”则填写对象的ID、文字、描述或控件名，如果选择“查找页面标识”则填写页面的标识，如果选择“无”则不需要填写。

判断：选择存在时执行，或不存时执行。

b、修改条件：修改选择的条件，“无”类型条件不支持修改。

c、删除条件：删除选择的条件，如果存在“无”类型条件时，最后一个有条件的条件不能被删除，除非将“无”类型条件先行删除。

d、描述：对此指令的说明。

创建新的“条件判断”指令后，在指令编辑区选择此指令后，“条件判断”按钮将被点亮，点击此按钮后，将打开所有条件列表。点击条件列表中的某个条件，则可进入该条件的指令集进行编辑。

点击条件列表中的某个条件，则可进入该条件的指令集进行编辑。

进入条件的指令集进行编辑后，导航栏上将显示“返回”按钮，点击该按钮将退出条件的指令集返回上一层的指令集，文字导航也出现“条件”及层次。

注：有多个条件时，系统会从上向下依次判断是否符合条件，如果符合则执行该条件的指令集，并且退出条件判断，如果不符合则执行下一个条件；如果有“无”类型时，所有条件都不符合时，默认将执行该条件的指令集。

自动计数：

自动计数器，记录脚本执行的次数，控制主循环体的执行，如果在通用脚本执行类、导入二维码类脚本中不添加该指令，主循环体将一直执行，不会自动停止。

冷却时间：

执行在窗口中“冷却时间”输入框中的参数，通用脚本执行类、导入二维码类、无限循环类脚本中不添加该指令，则不会执行冷却。

（3）屏幕：

上滑：

向上滑动手机屏幕。

下滑：

向下滑动手机屏幕。

左滑：

向左滑动手机屏幕。

右滑：

向右滑动手机屏幕。

长按（对象）：

关键词：可以是对象的ID、文字、描述或控件名，有多个关键字时使用英文的括号括起来，并用"|"分隔开，如：(关键词1|关键词2)。

位置：选择目标对象在所有通过关键词查找到所列表中的排列位置，可以点击“查看”按钮来查看列表。

查看：必须将手机转到目标页面才能查看到所有包含关键词的对象。

描述：对此指令的说明。

位置参考查看对象列表中的序号，内容中最后的一组数字是对象在手机上的坐标，可以参考坐标在手机上的位置来判断哪个是目标对象，在序号中的位置号码。

9 Q( l+ F7 T2 R3 m7 v

长按（坐标）：

坐标：如果没有找到目标对象，如在视频播放时，获取不了手机界面数据，则可以设置目标对象所处的坐标进行点击。

描述：对此指令的说明。

（4）文件：

此类指令仅用于发布作品类、素材库中发布类、导入二维码类窗口的脚本上。

选择图片/视频（对象）：

关键词：可以是（图片或者视频）对象的ID、文字、描述或控件名。

描述：对此指令的说明。

选择图片（坐标）：

需要按顺序选择9张图片，系统将记录这9张图片的坐标位置。

选择9张图片完成后，系统会自动在指令集中生成指令。

选择分享图片/视频（坐标）：

选择图片列表中的第一张图片或视频，系统将记录这人坐标位置。

（5）其它：

判断停止运行：

该指令将会在出现指定关键字后，终止该手机的脚本执行。

关键词：可以是对象的ID、文字、描述。

描述：对此指令的说明。

判断数字：如果“启用”，则可通过关键字查找一个数字用来判断是否大于“限定值”，如果小于则停止脚本执行。

执行ADB命令：

该指令执行一段自定义的"Adb Shell"命令。

命令：只支持"Adb Shell"命令，输入框中不要输"Adb Shell"，直接输入命令及命令选项。

描述：对此指令的说明。

摇一摇：

模拟人工触发摇一摇动作。

修改IMEI串号/修改网卡MAC地址/修改SID码/修改SIN码：

该指令为该手机随机生成一个新的有效数据（包含串号、网卡地址、SID、SIM信息）。

（6）用户：

在当前模块下，用户所有创建的无窗口类脚本都显示在这里，供当前脚本进行调用，以减少指令编辑的工作量。

-------------------- 开发教程完 ----------------------

) ^5 i2 |* f/ r& r

系统生成的模块文件：Xiake.Modules.db。

		自动登录	找回密码
密码			立即注册