helper

来自于：开发者立即使用

init click longClick paste setText2Clip

论坛示例

为帮助用户更好更快的使用模块，论坛维护了一个示例，示例中包含示例代码、知识点讲解、注意事项等，供您参考。

概述

helper 封装了安卓手机无障碍功能，增强用户界面以帮助残障人士，或者可能暂时无法与设备充分交互的人们使用手机App，使用时需要开通无障碍：手机设置-辅助功能-无障碍开启App的无障碍功能。

注：

  1. 1.由于是被动的方法，所以没有返回值;
  2. 2.要开启后台运行权限，不然服务有可能被杀死；
  3. 3.出现无效的时候重启一下手机试试。

一些常用的包名仅供参考：

  1. // 微信 包名 com.tencent.mm //启动类名：com.tencent.mm.ui.LauncherUI
  2.  //QQ 包名 com.tencent.mobileqq  //启动类名：com.tencent.mobileqq.activity.HomeActivity
  3. //支付宝 包名：com.eg.android.AlipayGphone    //启动类名com.eg.android.AlipayGphone.FastStartActivity
  4. //钉钉 包名：com.alibaba.android.rimet    //启动类名：com.alibaba.android.rimet.biz.home.activity.HomeActivity
  5. //QQ空间 包名：com.qzone
  6. //QQ手机管家 包名：com.tencent.qqpimsecure
  7. //微博 包名：com.sina.weibo   //启动类名：com.sina.weibo.EditActivity
  8. //天天动听 包名：com.sds.android.ttpod
  9. //中华万年历 包名：cn.etouch.ecalendar
  10. //百度地图 包名：com.baidu.BaiduMap
  11. //高德地图 包名：com.autonavi.minimap   //启动类名：com.autonavi.map.activity.SplashActivity
  12. //信息 包名：com.android.mms
  13. //设置 包名：com.android.settings
  14. //浏览器 包名：com.android.browser
  15. //计算器 包名：com.android.calculator2
  16. //时钟 包名：com.android.deskclock
  17. //图库 包名：com.android.gallery3d
  18. //相机 包名：com.android.hwcamera
  19. //音乐 包名：com.android.mediacenter
  20. //收音机 包名：com.huawei.android.FMRadio
  21. //录音机 包名：com.android.soundrecorder
  22. //UC浏览器 包名：com.UCMobile
  23. //美图秀秀 包名：com.mt.mtxx.mtxx
  24. //PPTV 包名：com.pplive.androidphone
  25. //书旗免费小说 包名：com.shuqi.controller
  26. //360手机助手 包名：com.qihoo.appstore
  27. //360卫士 包名：com.qihoo360.mobilesafe
  28. //360清理大师 包名：com.qihoo.cleandroid_cn
  29. //百度手机助手 包名：com.baidu.appsearch
  30. //豌豆荚 包名：com.wandoujia.phoenix2
  31. //小米应用商店 包名：com.xiaomi.market
  32. //华为应用商店 包名：com.huawei.appmarket
  33. //安智应用商店 包名：com.hiapk.marketpho
  34. //R.E.管理器 包名：com.speedsoftware.rootexplorer 
  35. //PP手机助手 包名：com.pp.assistant
  36. //OPPO应用商店 包名：com.oppo.market
  37. //联想应用商店  包名：com.lenovo.leos.appstore
  38. //应用宝 包名：com.tencent.android.qqdownloader

init

初始化参数，将要监听的应用包名传入即可，不传默认监听所有应用。

init({params}，function(ret,err))

params

packages

  • 类型：数组
  • 描述：要监听app的应用包名，[“com.tencent.mm”,”com.tencent.qqmobile”],不传就默认全部应用都监听。

showLog

  • 类型：布尔型
  • 描述：测试阶段传true，方便检测无障碍功能是否在运行，上线后建议请改为false，默认false。

示例代码

  2.     var helper = api.require('helper');
  3.     helper.init({pakages:["com.tencent.mm","com.tencent.qqmobile"],showLog:false});

可用性

Android系统

可提供的1.0.0及更高版本

click

传入需要点击事件的控件id，窗口出现该控件时会自动点击该控件。

click()

params

ids

  • 类型：数组
  • 描述：需要模拟点击的控件的id，不懂怎么查id的可以百度Android开发工具（eclipse 或者as）的UI AutoMator

once

  • 类型：数字
  • 描述：0表示无数次，大于0表示只执行一次

示例代码

  2.     var helper=api.require('helper');
  3.     helper.click({ids:["com.pp.assistant:id/ed","com.pp.assistant:id/ed2"],once:1});

可用性

Android系统

可提供的1.0.0及更高版本

longClick

传入需要长按事件的控件id，窗口出现该控件时会自动长按该控件。

longClick()

params

ids

  • 类型：数组
  • 描述：需要模拟长按的控件的id，不懂怎么查id的可以百度Android开发工具（eclipse 或者as）的UI AutoMator

once

  • 类型：数字
  • 描述：0表示无数次，大于0表示只执行一次

示例代码

  2.     var helper=api.require('helper');
  3.     helper.longClick({ids:["com.pp.assistant:id/ed","com.pp.assistant:id/ed2"],once:1});

可用性

Android系统

可提供的1.0.0及更高版本

paste

传入需要粘贴文本的控件id，窗口出现控件时会自动将粘贴板上的内容粘贴到该控件上。

paste()

params

ids

  • 类型：数组
  • 描述：需要模拟点击的控件的id，不懂怎么查id的可以百度Android开发工具（eclipse 或者as）的UI AutoMator

once

  • 类型：数字
  • 描述：0表示无数次，大于0表示只执行一次

示例代码

  2.     var helper=api.require('helper');
  3.     helper.paste({ids:["com.pp.assistant:id/ed","com.pp.assistant:id/ed2"],once:1});

可用性

Android系统

可提供的1.0.0及更高版本

setText2Clip

设置字符串到粘贴板。

setText2Clip()

params

msg

  • 类型：字符串
  • 描述：要放在粘贴板上的内容。

示例代码

  2.     var helper=api.require('helper');
  3.     helper.setText2Clip({msg:"this is mytext"+Math.random()});

可用性

Android系统

可提供的1.0.0及更高版本