更新记录

1.0.4(2023-09-04)

增加moveAppToFront方法。用于后台唤起APP。需要后台弹窗权限

1.0.3(2023-09-01)

增加全屏悬浮窗功能

  • initFloatView(boolean can_touch,String color) -> boolean 初始化全屏悬浮窗

  • can_touch:是否允许用户点击悬浮窗

  • showFloatView() -> boolean 显示全屏悬浮窗

  • hideFloatView() -> boolean 隐藏全屏悬浮窗

  • start方法新增monitor_all_event参数,用户判断是否接收所有事件

  • 新增getTagState方法,传入文字数组,获取匹配的节点,对应findFirstNodeByText方法

  • 更新demo示例

1.0.2(2023-08-14)

新增以下3个方法,demo更新

  • global_back() -> boolean 返回
  • global_home() -> boolean 回到桌面
  • global_recents() -> boolean 打开最近任务
查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:6.0 - 12.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 ×

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


安卓无障碍


接收事件回调

  • this.BaseAccessibility.start(this.appId,this.packageNames,this.notificationTimeout,({event_type,package_name,class_name})=>{

})

  • event_type值说明

  • 32 切换了页面

  • 64 通知栏状态变化

  • 2048 窗口内容变化

    调用方法

  • go_alive_setting 打开无障碍设置页面

  • start(applicationId,String[] packageNames,notificationTimeout,monitor_all_event,callback) -> boolean 初始化无障碍服务

  • applicationId->无障碍应用的包名

  • packageNames->需要监听变化的应用包名

  • monitor_all_event->是否监听所有事件

  • getServiceState(applicationId) -> boolean 判断无障碍服务是否开启

  • findFirstNodeByText(text) -> boolean 查询是否存在文字符合的节点

  • clickFirstNodeByText(String text) -> boolean 点击第一个文字符合的节点

  • getNodesizeById(String id) -> int 获取id符合的节点数量

  • clickById(String id,int index) -> boolean 点击符合id的节点,可以先用getNodesizeById获取数量

  • findFirstNodeByNotFullText(String text) -> boolean 查询是否存在 文字符合 包含 的节点

  • clickFirstNodeByNotFullText(String text) -> boolean 点击第一个文字符合 包含 的节点

  • findFirstNodeByContenDesc(text) -> boolean 查询是否存在文字描述符合的节点

  • clickFirstNodeByDesc(String text) -> boolean 点击第一个文字描述符合的节点

  • findFirstNodeByNotFullDesc(String text) -> boolean 查询是否存在文字描述符合 包含 的节点

  • clickFirstNodeByNotFullDesc(String text) -> boolean 点击第一个文字描述符合 包含 的节点

  • edit(String id,String text) -> boolean 输入text

  • editByIndex(String id,int index,String text) -> boolean 输入text

  • getFirstNodeInformByText(String text,String[] fields) -> json 获取第一个符合文字的节点信息,fields包含如下字段 className,text,packageName,contentDesc,checkable,checked,clickable,enable, focusable,focused,scrollable,longClickable,password,selected,bounds,childCount

  • getNodeInformById(String id,int index,String[] fields) -> json 获取第index个id符合的节点信息

  • getFirstNodeInformById(String id,String[] fields) -> json 获取第一个id符合的节点信息

  • getChildNodeInform(String id,int nodeIndex,int childIndex,String[] fields) -> json 获取第nodeIndex个id符合的节点的第childIndex个节点信息,最大childIndex可以从childCount获取

  • clickLocation(int X, int Y) -> 无返回值 点击坐标

  • slideScreen(int s_x, int s_y,int e_x, int e_y,int duration) -> 无返回值 滑动屏幕

  • (s_x,s_y):起点坐标 (e_x,e_y):终点坐标 duration: 滑动时间(毫秒),一般取300-500

  • 从起点坐标滑动到终点坐标

  • global_back() -> boolean 返回

  • global_home() -> boolean 回到桌面

  • global_recents() -> boolean 打开最近任务

  • initFloatView(boolean can_touch,String color) -> boolean 初始化全屏悬浮窗

  • can_touch:是否允许用户点击悬浮窗

  • showFloatView() -> boolean 显示全屏悬浮窗

  • hideFloatView() -> boolean 隐藏全屏悬浮窗

  • getTagState(texts,callback) -> 用法看test_floatview示例

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问