Total Control新增JS脚本API解读

本次Total Control升级到6.7.0版本,增加了大量实用的脚本API接口,本文为大家介绍新增的JS脚本接口。该版本新增6个JS接口:

WaitForImage:增加截屏保存到手机的 API。
       waitForColor:增加等待图片/颜色显示的 API。
       getActivity:增加获取前台运行的 Activity API。
       openActivity:增加打开指定的 Activity API。
       httpRequest:增加网络通信的 API。
       Timer:增加方法定时器 API。
       getClipboardText:增加获取剪切板内容的API

1. waitForImage(path, sim, timeout)

				描述:
					增加截屏保存到手机,等待目标图片显示在屏幕内
					
				参数:
					path:图片路径
					sim:相似度
					timeout:超时时间
					
				返回值:
					成功返回坐标对象,失败返回null
					
				示例:
					var device = Device.getMain();
					var ret = device.waitForImage("d:/1.bmp",1.0,20000);
					if( ret == null ){
						print("未发现目标图片");
					}else{
					print("坐标是:"+ret.x+","+ret.y);
					}
				

2. waitForColor(topLeftX, topLeftY, bottomRightX, bottomRightY, color, dir, sim, timeout)

				描述:
					增加等待颜色显示,等待目标颜色显示在屏幕范围内
					
				参数:
					topLeftX: 屏幕上指定范围左上角 X 坐标
					topLeftY: 屏幕上指定范围左上角 Y 坐标
					bottomRightX: 屏幕上指定范围右下角 X 坐标
					bottomRightY: 屏幕上指定范围右下角 Y 坐标
					color: 要对比的颜色,格式为" RGB ", 多个颜色用"|"号分隔,
					如果需要对比颜色范围则中间用"-"号分隔,比如" 0xffffff|0xaabbcc-0x000000|0x00ff00-0x101010 "
					dir: 整型,查找方向 
						0: 表示从左上向右下
						1: 表示从中心往四周查找
						2: 表示从右下向左上查找
						3: 表示从左下向右上查找
						4:表示从右上向左下查找
				Sim: 相似度,取值范围为[0.0, 1.0]
				timeout:超时时间
				
				返回值:
					成功返回坐标对象,失败返回null
					
				示例:
					var device = Device.getMain();
					var ret = device.waitForImage(0,0,500,500,"0xffffff",1,1.0,20000);
					if( ret == null ){
						print("未发现目标颜色");
					}else{
					print("坐标是:"+ret.x+","+ret.y);
					}
				

3. getActivity()

					描述:
						增加获取前台运行,获取当前前台运行的activity
					返回值:
						成功返回activity值,失败返回null
					示例:
						var device = Device.getMain();
						var ret = device.getActivity();
						print(ret);
				

4. openActivity(activity, Administrator)

					描述:
						增加打开指定的activity
						
					参数:
						activity:activity字符串
						Administrator:是否获取超级权限
						
					返回值:
						成功返回0,失败返回-1
						
					示例:
						var device = Device.getMain();
						var ret = device.openActivity("com.android.settings/.HWSetting",false);
						print(ret);
				

5. httpRequest (url,method,headers,data,timeout)

					描述:
						增加网络通信,请求指定网络
						
					参数:
						url:网站链接字符串
						method:请求方法,缺省为GET
						headers:请求头,缺省为{}
						data:请求正文,缺省为null
						timeout:超时时间,缺省为6000
						
					返回值:
						成功返回网络对象,失败返回null
						
					返回值包含属性:
						connection、content、contentBytes、contentLength、
						contentType、cookies、encoding、headers、message、
						status、url
						
					示例:
						var res = httpRequest("http://tc.sigma-rt.com.cn","GET",{},"",2000);
						print(res.content);
						var res = httpRequest("http://tc.sigma-rt.com.cn");
						print(res.content);
				

6. Timer()

					描述:
						增加方法定时器,间隔执行方法
						
					属性值:
						setCallback(Callback,time)
							描述:
								设置回调方法
							参数:
								Callback:回调方法
								time:间隔时间
						start();
							描述:
							启动定时器
						stop();
							描述:
							销毁定时器
							
					示例:
						function ddd(){
							print(1);
						}
						var t = new Timer();
						t.setCallback(ddd,1000);
						t.start();
						delay(10000);
						t.stop();