模块与脚本开发教程一、模块管理器打开模块管理，进入模块管理器：
1、功能区划分：
2、主要功能：
新模块：新建新的群控模块。
删除：删除一个已有的群控模块，包含该模块中的所有脚本。
新脚本：在选定的模块下新建一个新的脚本。
编辑：对选定模块里的指定脚本进行编辑。
删除：删除选定模块里指定的已有脚本。
保存：保存模块文件。
' E$ f7 Q* o! `+ o& f& w' ?" w
3、新建模块：
新建模块名称：新的模块的名称，可以是APP应用名称，也可以是功能名称。
6 H5 o7 [ D; E; Y) G
4、脚本区右键菜单：
编辑：对选定的脚本进行编辑。
向上移动：对指定的脚本顺序向上移动一格。
向下移动：对指定的脚本顺序向下移动一格。
重命名：对脚本名称与按钮颜色进行修改。
删除：删除选定的脚本。
" Z$ l) `9 }' a. s' W/ F& ~9 ^) |
5、新建脚本：
新建脚本名称：新脚本的名称，以功能名称为好。
脚本按钮颜色：设置脚本在手机控制面板上的按钮背景颜色。
显示窗体类型：共有十二种类型供选择。
' S3 Z# I' j: S- K7 c
6、窗体类型：
, M& T) H5 [: Y6 F, P5 K8 V
（1）无窗口：此类窗口的脚本一般用于一些简单的功能，如打开APP及打开指定的功能窗口。
（2）文本文件类：此类窗口用于从文本文件中导入账号或号码来添加好友。
（3）关注与点赞类：
（4）无限循环类：
（5）群发消息类：
（6）文字列表类：
（7）文字列表加验证类：
（8）发布作品类：
（9）素材库中发布类：
（10）搜索加人类：
（11）导入二维码类：
（12）新闻阅读类：
Z* j3 x3 L, A" M/ P
二、脚本编辑器新建脚本或选择脚本进行编辑可进入脚本编辑器，脚本编辑器必须在已有手机连接时才能打开。
2 w6 j; R( j+ O m
（一）功能区划分：- T2 ~" p7 q# i& B" R3 W" B
（二）主要功能：添加录制与结束录制：添加一段手动操作片段到动作编辑器中。
复制脚本：从一个已有的脚本中复制所有动作（指令）集到此脚本中，此脚本的所有动作集将被覆盖。
编辑：对选定的动作（指令）进行修改，部分动作（指令）不支持修改。
删除：删除选定的动作（指令）。
保存：保存当前脚本，编辑完成后一定要进行保存，否则新修改的动作（指令）会被丢失。
测试：测试当前脚本，以检查是否达到设想的要求。
. {) |4 Q2 a- J4 d& @5 T- }& B
附录：复制脚本功能操作
第一步点击功能区“复制”按钮，第二步选择一个已完成的目标脚本，第三步点击“确定”按钮，复制完成。复制脚本只能用于同类的脚本类型之间进行复制。
+ q1 y# v& X4 g
（三）信息显示：2 d0 m3 v; T+ l5 X( I. t: g
1、脚本常规信息：
（1、脚本的名称；2、脚本编辑时屏幕的分辨率；3、查看脚本窗口）
注：屏幕分辨率是脚本执行坐标点击或长按的基础，脚本里所有的坐标都是基于它，修改它可能会引起相关指令的失效或坐标转换后出现偏差。
- ]8 U U$ I6 s' X% i& p: V% k. A+ C, m
2、点击坐标/页面标识信息：
（1）点击坐标：这里显示在屏幕上点击后的坐标参数，脚本所有需要以坐标进行点击或长按的坐标以此为准。
（2）页面标识：查看手机界面实时的页面标识，脚本所有需要判断页面的操作可以从这里获取页面标识。
（3）复制：复制标识输入框内的标识内容。
0 S/ B: b! w4 ?$ Y$ j
（四）编辑区右键菜单：编辑动作：对选定的动作（指令）进行修改，部分动作（指令）不支持修改。
向上移动：对指定的动作（指令）顺序向上移动一格。
向下移动：对指定的动作（指令）顺序向下移动一格。
删除动作：删除选定的动作（指令）。
) Q% i3 P7 Y/ X1 Q- V
（五）脚本编辑一个脚本有多个动作集组成，一个动作集由多个指令（动作）组成。
) c& x7 X- g, h! f
1、手机参数获取：
（1、获取手机界面所有元素；2、获取手机页面标识；3、在屏幕上获取一个坐标；4、修改屏幕分辨率）
6 s) ~2 S3 B$ `, L
（1）获取手机界面所有元素：
（查找或点击对象可以根据这里的ID、文字、描述或控件来查找或点击对象）
1 `! q3 i# y# [) Q8 {' j2 ]6 z
注意：由于安卓系统的机制问题，手机在播放视频时可能获取不了数据（视频播放时，手机系统无法处于idle，致使群控系统获取不了屏幕界面数据，所有通过对象来操作的指令都会失效），在进行编写指令时解决的方式有两种，一种是想办法暂停视频播放；另一种是通过页面的标识来判断页面位置，然后以坐标的方式来编写指令，这要求所有手机的分辨率的横纵比要相同，手机界面要相同，最好是采用同型号手机。
/ D4 W* O6 k8 [1 K2 l8 a$ w
（2）获取手机页面标识：
（有关页面指令所需要的标识的都可从这里获取）
$ c3 \, C; o2 R$ d3 S
（3）在屏幕上获取一个坐标：
点击此按钮后，面板上的手机屏幕上提示在屏幕上点击一个坐标
点击屏幕后，点击坐标上将会显示出点击的实际坐标，此坐标是相对于屏幕分辨率的，不是手机的实际分辨率。脚本里所有的有关坐标的指令，都是以这里给出的坐标来进行操作，不是手机的实际坐标。
9 o5 O4 ^# m$ m [1 u
（4）修改屏幕分辨率：
在面板上的手机屏幕大小发生改变后，此按钮将会被激活，系统提示修改屏幕分辨率，此分辨率是脚本的全局参数，修改可能会影响基于坐标的点击或长按指令的执行。
/ G5 K& r* p/ E3 I
2、脚本执行流程：
（1）单动作（指令）集脚本执行类：
无窗口类、无限循环类窗口属于此执行类。此类执行类只有一个主指令集，执行流程如下：
（2）通用脚本执行类：
文本文件类、关注与点赞类、群发消息类、文字列表类、文字列表加验证类、搜索加人类、导入二维码类、新闻阅读类窗口属于此执行类。此类执行类包含头指令集、主循环体与尾指令集，执行流程如下：
（3）素材脚本执行类：
发布作品类、素材库中发布类窗口属于此执行类。此类执行类包含图片指令集、分享指令集、视频指令集与文字指令集，执行流程如下：
（4）导入二维码类执行流程：
（5）无限循环类执行流程：
（6）新闻阅读：
脚本的执行流程同通用脚本执行类，只是增加了有关于新闻过滤的设置。
广告页标识：设置广告页面的标识，如果过滤广告被选中，则系统不会浏览所有该标识的页面。
图片页标识：设置图片页面的标识，如果过滤图片被选中，则系统不会浏览所有该标识的页面。
视频页标识：设置视频页面的标识，如果过滤视频被选中，则系统不会浏览所有该标识的页面。
1 [" f; A9 M, i6 q C: G5 Y
! a9 h! M. }; |& |7 h, u* J
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应用，影响后面的指令。
: A4 O0 D" J/ R6 a0 L; e
显示状态：
内容：将要在手机控制面板的手机屏幕上显示的提示内容。
描述：对此指令的说明。
注：为了以后脚本的维护方便，建议在所有有“描述”的地方，都输入相关的功能信息描述或说明。
@( U: f. f0 M5 U' n
查找对象并点击：
关键词：可以是对象的ID、文字、描述或控件名，有多个关键字时使用英文的括号括起来，并用"|"分隔开，如：(关键词1|关键词2)。
位置：选择目标对象在所有通过关键词查找到所列表中的排列位置，可以点击“查看”按钮来查看列表。
查看：必须将手机转到目标页面才能查看到所有包含关键词的对象。
坐标：如果没有找到目标对象，如在视频播放时，获取不了手机界面数据，则可以设置目标对象所处的坐标进行点击。
坐标的获取请查阅上面的“获取坐标”的介绍。
描述：对此指令的说明。
* A; L# B1 A/ j& j* X
查找对象并返回：
类型：系统支持以对象或者页面标识的方式来查找。
关键词：通过对象查找时可以是对象的ID、文字、描述或控件名，有多个关键字时使用英文的括号括起来，并用"|"分隔开，如：(关键词1|关键词2)。通过页面标识查找时，先获取页面的标识，然后拷贝过来。
判断：选择查找的结果存在或不存在时执行返回上页的操作。
描述：对此指令的说明。
! j$ Q6 I" c, m! A9 W( n
点击（坐标）：
坐标：如果没有找到目标对象，如在视频播放时，获取不了手机界面数据，则可以设置目标对象所处的坐标进行点击。
描述：对此指令的说明。
H& H) y: m4 O
点击（对象）：
关键词：可以是对象的ID、文字、描述或控件名，有多个关键字时使用英文的括号括起来，并用"|"分隔开，如：(关键词1|关键词2)。
位置：选择目标对象在所有通过关键词查找到所列表中的排列位置，可以点击“查看”按钮来查看列表。
查看：必须将手机转到目标页面才能查看到所有包含关键词的对象。
描述：对此指令的说明。
' U7 U7 P' | ~: q
输入文字：
请保证前面的指令已将页面转至了包含有输入框的页面上。
* b5 U/ N5 O% {1 h
输入文字（随机）：
此指令仅支持“文字列表类”窗口，如果脚本是通过复制“文字列表类”，并且当前脚本不是“文字列表类”的时候，必须将脚本中的“输入文字（随机）”转为“输入文字”指令。
9 }2 x, g2 F$ a3 |( `6 v
回车：
文本输入页面没有提交按钮，或按钮找不到，可以使用此指令直接提交。
# ~6 K' u" Z. h7 I9 e
停顿：
设置一个指定时间的停顿，建议每个指令后面都设置一个停顿时间，让新打开的页面有时间加载完成，方便后面的指令执行。
! l1 h1 p! Q/ ?" I8 W
返回上一页：
该指令模拟手机的“返回”键。
; B; o5 [& h# ^" D* E9 D% a# b
HOME：
该指令模拟手机的“HOME”键。
' e; W: Y" j. K+ N
7 Y Q/ F5 P j
（2）流程控制：
循环点击对象：
此指令多用于有列表的页面，指令会从上向下点击列表中的对象，每一次点击后，在循环指令集中要确保最后返回到这个列表的页面上，否则影响后面的点击。
关键词：可以是对象的ID、文字、描述或控件名，有多个关键字时使用英文的括号括起来，并用"|"分隔开，如：(关键词1|关键词2)。
点击区参数设置可以让指令只点击指定区域中的对象，以屏幕的百分比来计算区域，确保上边距参数不能大于下边距参数，左边距参数不能大于右边距参数。
创建新的“循环点击对象”指令后，在指令编辑区选择此指令后，“循环体”按钮将被点亮，点击此按钮后，对循环指令集进行编辑。
进入循环指令集进行编辑后，导航栏上将显示“返回”按钮，点击该按钮将退出循环指令集进行编辑，文字导航也出现“循环体”及层次。
8 a0 U% d4 @( s4 G
条件判断：
a、新增条件：新增一个条件，如果已存在“无”类型条件，将不能继续添加条件。
类型：可以通过查找对象，或查找页面标识来操作，如果选择“无”，下面的各参数不需要填写。
关键词：如果选择“查找对象”则填写对象的ID、文字、描述或控件名，如果选择“查找页面标识”则填写页面的标识，如果选择“无”则不需要填写。
判断：选择存在时执行，或不存时执行。
b、修改条件：修改选择的条件，“无”类型条件不支持修改。
c、删除条件：删除选择的条件，如果存在“无”类型条件时，最后一个有条件的条件不能被删除，除非将“无”类型条件先行删除。
d、描述：对此指令的说明。
创建新的“条件判断”指令后，在指令编辑区选择此指令后，“条件判断”按钮将被点亮，点击此按钮后，将打开所有条件列表。点击条件列表中的某个条件，则可进入该条件的指令集进行编辑。
点击条件列表中的某个条件，则可进入该条件的指令集进行编辑。
进入条件的指令集进行编辑后，导航栏上将显示“返回”按钮，点击该按钮将退出条件的指令集返回上一层的指令集，文字导航也出现“条件”及层次。
注：有多个条件时，系统会从上向下依次判断是否符合条件，如果符合则执行该条件的指令集，并且退出条件判断，如果不符合则执行下一个条件；如果有“无”类型时，所有条件都不符合时，默认将执行该条件的指令集。
2 i, W$ \: ~0 h
自动计数：
自动计数器，记录脚本执行的次数，控制主循环体的执行，如果在通用脚本执行类、导入二维码类脚本中不添加该指令，主循环体将一直执行，不会自动停止。
; Z* o; H% {8 R2 r9 U: ]& i0 W
冷却时间：
执行在窗口中“冷却时间”输入框中的参数，通用脚本执行类、导入二维码类、无限循环类脚本中不添加该指令，则不会执行冷却。
5 @3 l; ~) @: d$ T, L4 n7 s7 B
0 a+ P# h, f* f0 z* e9 h- w
" D6 g- Y5 g7 Y* x0 l
) d* i7 |6 M2 V) n' _2 c（3）屏幕：
上滑：
向上滑动手机屏幕。
# O& H+ e, c5 U; F0 {
下滑：
向下滑动手机屏幕。
& J! U$ e( R, o: D
左滑：
向左滑动手机屏幕。
$ @* J9 _- }" U! {9 ~! C j' c
右滑：
向右滑动手机屏幕。
/ J: y r* s0 ]: z4 O6 u$ y! ?
长按（对象）：
关键词：可以是对象的ID、文字、描述或控件名，有多个关键字时使用英文的括号括起来，并用"|"分隔开，如：(关键词1|关键词2)。
位置：选择目标对象在所有通过关键词查找到所列表中的排列位置，可以点击“查看”按钮来查看列表。
查看：必须将手机转到目标页面才能查看到所有包含关键词的对象。
描述：对此指令的说明。
位置参考查看对象列表中的序号，内容中最后的一组数字是对象在手机上的坐标，可以参考坐标在手机上的位置来判断哪个是目标对象，在序号中的位置号码。
6 ~) F: X! W* w ^! h7 x
长按（坐标）：
坐标：如果没有找到目标对象，如在视频播放时，获取不了手机界面数据，则可以设置目标对象所处的坐标进行点击。
描述：对此指令的说明。
+ G; k3 }1 Y. p! r/ r6 r7 ]/ l. A
0 L: m: q! q! O
D% b* z2 m- v（4）文件：
此类指令仅用于发布作品类、素材库中发布类、导入二维码类窗口的脚本上。
/ j) R. n' |9 d$ P) i
选择图片/视频（对象）：
关键词：可以是（图片或者视频）对象的ID、文字、描述或控件名。
描述：对此指令的说明。
$ {! ^4 \+ b4 b( j( A0 G& s
选择图片（坐标）：
需要按顺序选择9张图片，系统将记录这9张图片的坐标位置。
选择9张图片完成后，系统会自动在指令集中生成指令。
! K2 w* E$ d& F! l) ]
选择分享图片/视频（坐标）：
选择图片列表中的第一张图片或视频，系统将记录这人坐标位置。
a; \% x! ]! Z0 R& b7 R6 C
- A# w( e" l6 ]
: {6 o4 [5 I- A) f
- O+ e# ?$ C* B% \9 {（5）其它：
判断停止运行：
该指令将会在出现指定关键字后，终止该手机的脚本执行。
关键词：可以是对象的ID、文字、描述。
描述：对此指令的说明。
判断数字：如果“启用”，则可通过关键字查找一个数字用来判断是否大于“限定值”，如果小于则停止脚本执行。
0 M2 h& s. U: q% P9 ?
执行ADB命令：
该指令执行一段自定义的"Adb Shell"命令。
命令：只支持"Adb Shell"命令，输入框中不要输"Adb Shell"，直接输入命令及命令选项。
描述：对此指令的说明。
; Q7 g- f) z7 t' `
摇一摇：
模拟人工触发摇一摇动作。
+ w( g" I* R; E% g% [
修改IMEI串号/修改网卡MAC地址/修改SID码/修改SIN码：
该指令为该手机随机生成一个新的有效数据（包含串号、网卡地址、SID、SIM信息）。
o- q4 q( m+ t7 l5 ^
7 o0 k3 c' x+ x" \
4 ^4 }4 Z E+ V- u3 ^
7 s1 i6 M6 W/ O6 y! R9 w（6）用户：
在当前模块下，用户所有创建的无窗口类脚本都显示在这里，供当前脚本进行调用，以减少指令编辑的工作量。
% F S0 l" s4 Z& A
-------------------- 开发教程完 ----------------------
9 s0 D Z% P/ M, F5 G- b
系统生成的模块文件：Xiake.Modules.db。
窥视卡
雷达卡
发表于 2020-1-11 14:56:09
提升卡
置顶卡
沉默卡
喧嚣卡
变色卡
千斤顶
显身卡