更新记录

1.0.6（2024-05-04）

增加长按后拖动接口longPressAndDrag(内测)

1.0.5（2024-05-04）

新增getRootWindows和setRootWindowId接口，实现可操作悬浮窗的布局。

1.0.4（2024-05-03）

新增截屏相关功能

查看更多

平台兼容性

Vue2 Vue3
√ √
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.6.8，Android：4.4，iOS：不支持 × × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

概述

XF-accessibilityUTS封装安卓中无障碍功能。

插件接口

goAliveSetting

开启无障碍设置

uni-app项目中（vue/nvue）调用示例：

import { goAliveSetting } from "@/uni_modules/XF-accessibilityUTS"

goAliveSetting({
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { goAliveSetting } from "@/uni_modules/XF-accessibilityUTS";
import { SettingOptions } from "@/uni_modules/XF-accessibilityUTS/utssdk/interface.uts";

let options = {
  complete: (res : any) => {
    console.log(res)
  }
} as SettingOptions;
goAliveSetting(options);

可用性

Android系统

可提供的1.0.0及更高版本

getServiceState

判断无障碍服务是否开启

uni-app项目中（vue/nvue）调用示例：

import { getServiceState } from "@/uni_modules/XF-accessibilityUTS"

getServiceState();

uni-app x项目（uvue）中调用示例：

import { getServiceState } from "@/uni_modules/XF-accessibilityUTS";

getServiceState();

可用性

Android系统

可提供的1.0.0及更高版本

start

接收页面变动事件

uni-app项目中（vue/nvue）调用示例：

import { start } from "@/uni_modules/XF-accessibilityUTS"

start({
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { start } from "@/uni_modules/XF-accessibilityUTS";
import { StartOptions } from "@/uni_modules/XF-accessibilityUTS/utssdk/interface.uts";

let options = {
  complete: (res : any) => {
    console.log(res)
  }
} as StartOptions;
start(options);

可用性

Android系统

可提供的1.0.0及更高版本

stop

停止接收页面变动事件回调

uni-app项目中（vue/nvue）调用示例：

import { stop } from "@/uni_modules/XF-accessibilityUTS"

stop();

uni-app x项目（uvue）中调用示例：

import { stop } from "@/uni_modules/XF-accessibilityUTS";

stop();

可用性

Android系统

可提供的1.0.0及更高版本

getState

获取事件回调状态

uni-app项目中（vue/nvue）调用示例：

import { getState } from "@/uni_modules/XF-accessibilityUTS"

getState();

uni-app x项目（uvue）中调用示例：

import { getState } from "@/uni_modules/XF-accessibilityUTS";

getState();

可用性

Android系统

可提供的1.0.0及更高版本

getRootWindows

获取屏幕上的所有windowId(含悬浮框)

uni-app项目中（vue/nvue）调用示例：

import { getRootWindows } from "@/uni_modules/XF-accessibilityUTS"

getRootWindows();

uni-app x项目（uvue）中调用示例：

import { getRootWindows } from "@/uni_modules/XF-accessibilityUTS";

getRootWindows();

可用性

Android系统

可提供的1.0.0及更高版本

setRootWindowId

设置要操作的windows的ID(全局生效)

uni-app项目中（vue/nvue）调用示例：

import { setRootWindowId } from "@/uni_modules/XF-accessibilityUTS"

setRootWindowId(-1);

uni-app x项目（uvue）中调用示例：

import { setRootWindowId } from "@/uni_modules/XF-accessibilityUTS";

setRootWindowId(-1);

可用性

Android系统

可提供的1.0.0及更高版本

findFirstNodeByText

查询是否存在文字符合的节点

uni-app项目中（vue/nvue）调用示例：

import { findFirstNodeByText } from "@/uni_modules/XF-accessibilityUTS"

findFirstNodeByText("");

uni-app x项目（uvue）中调用示例：

import { findFirstNodeByText } from "@/uni_modules/XF-accessibilityUTS";

findFirstNodeByText("");

可用性

Android系统

可提供的1.0.0及更高版本

clickFirstNodeByText

点击第一个文字符合的节点

uni-app项目中（vue/nvue）调用示例：

import { clickFirstNodeByText } from "@/uni_modules/XF-accessibilityUTS"

clickFirstNodeByText("");

uni-app x项目（uvue）中调用示例：

import { clickFirstNodeByText } from "@/uni_modules/XF-accessibilityUTS";

clickFirstNodeByText("");

可用性

Android系统

可提供的1.0.0及更高版本

longClickFirstNodeByText

长按第一个文字符合的节点

uni-app项目中（vue/nvue）调用示例：

import { longClickFirstNodeByText } from "@/uni_modules/XF-accessibilityUTS"

longClickFirstNodeByText("");

uni-app x项目（uvue）中调用示例：

import { longClickFirstNodeByText } from "@/uni_modules/XF-accessibilityUTS";

longClickFirstNodeByText("");

可用性

Android系统

可提供的1.0.0及更高版本

getFirstNodeInformByText

获取第一个符合文字的节点信息

uni-app项目中（vue/nvue）调用示例：

import { getFirstNodeInformByText } from "@/uni_modules/XF-accessibilityUTS"

getFirstNodeInformByText("");

uni-app x项目（uvue）中调用示例：

import { getFirstNodeInformByText } from "@/uni_modules/XF-accessibilityUTS";

getFirstNodeInformByText("");

可用性

Android系统

可提供的1.0.0及更高版本

findFirstNodeByNotFullText

查询是否存在文字符合包含的节点

uni-app项目中（vue/nvue）调用示例：

import { findFirstNodeByNotFullText } from "@/uni_modules/XF-accessibilityUTS"

findFirstNodeByNotFullText("");

uni-app x项目（uvue）中调用示例：

import { findFirstNodeByNotFullText } from "@/uni_modules/XF-accessibilityUTS";

findFirstNodeByNotFullText("");

可用性

Android系统

可提供的1.0.0及更高版本

clickFirstNodeByNotFullText

点击第一个文字符合包含的节点

uni-app项目中（vue/nvue）调用示例：

import { clickFirstNodeByNotFullText } from "@/uni_modules/XF-accessibilityUTS"

clickFirstNodeByNotFullText("");

uni-app x项目（uvue）中调用示例：

import { clickFirstNodeByNotFullText } from "@/uni_modules/XF-accessibilityUTS";

clickFirstNodeByNotFullText("");

可用性

Android系统

可提供的1.0.0及更高版本

longClickFirstNodeByNotFullText

长按第一个文字符合包含的节点

uni-app项目中（vue/nvue）调用示例：

import { longClickFirstNodeByNotFullText } from "@/uni_modules/XF-accessibilityUTS"

longClickFirstNodeByNotFullText("");

uni-app x项目（uvue）中调用示例：

import { longClickFirstNodeByNotFullText } from "@/uni_modules/XF-accessibilityUTS";

longClickFirstNodeByNotFullText("");

可用性

Android系统

可提供的1.0.0及更高版本

findFirstNodeByDesc

查询是否存在文字描述符合的节点

uni-app项目中（vue/nvue）调用示例：

import { findFirstNodeByDesc } from "@/uni_modules/XF-accessibilityUTS"

findFirstNodeByDesc("");

uni-app x项目（uvue）中调用示例：

import { findFirstNodeByDesc } from "@/uni_modules/XF-accessibilityUTS";

findFirstNodeByDesc("");

可用性

Android系统

可提供的1.0.0及更高版本

clickFirstNodeByDes

点击第一个文字描述符合的节点

uni-app项目中（vue/nvue）调用示例：

import { clickFirstNodeByDes } from "@/uni_modules/XF-accessibilityUTS"

clickFirstNodeByDes("");

uni-app x项目（uvue）中调用示例：

import { clickFirstNodeByDes } from "@/uni_modules/XF-accessibilityUTS";

clickFirstNodeByDes("");

可用性

Android系统

可提供的1.0.0及更高版本

longClickFirstNodeByDes

长按第一个文字描述符合的节点

uni-app项目中（vue/nvue）调用示例：

import { longClickFirstNodeByDes } from "@/uni_modules/XF-accessibilityUTS"

longClickFirstNodeByDes("");

uni-app x项目（uvue）中调用示例：

import { longClickFirstNodeByDes } from "@/uni_modules/XF-accessibilityUTS";

longClickFirstNodeByDes("");

可用性

Android系统

可提供的1.0.0及更高版本

findFirstNodeByNotFullDesc

查询是否存在文字描述符合包含的节点

uni-app项目中（vue/nvue）调用示例：

import { findFirstNodeByNotFullDesc } from "@/uni_modules/XF-accessibilityUTS"

findFirstNodeByNotFullDesc("");

uni-app x项目（uvue）中调用示例：

import { findFirstNodeByNotFullDesc } from "@/uni_modules/XF-accessibilityUTS";

findFirstNodeByNotFullDesc("");

可用性

Android系统

可提供的1.0.0及更高版本

clickFirstNodeByNotFullDesc

点击第一个文字描述符合包含的节点

uni-app项目中（vue/nvue）调用示例：

import { clickFirstNodeByNotFullDesc } from "@/uni_modules/XF-accessibilityUTS"

clickFirstNodeByNotFullDesc("");

uni-app x项目（uvue）中调用示例：

import { clickFirstNodeByNotFullDesc } from "@/uni_modules/XF-accessibilityUTS";

clickFirstNodeByNotFullDesc("");

可用性

Android系统

可提供的1.0.0及更高版本

longClickFirstNodeByNotFullDesc

长按第一个文字描述符合包含的节点

uni-app项目中（vue/nvue）调用示例：

import { longClickFirstNodeByNotFullDesc } from "@/uni_modules/XF-accessibilityUTS"

longClickFirstNodeByNotFullDesc("");

uni-app x项目（uvue）中调用示例：

import { longClickFirstNodeByNotFullDesc } from "@/uni_modules/XF-accessibilityUTS";

longClickFirstNodeByNotFullDesc("");

可用性

Android系统

可提供的1.0.0及更高版本

clickLocation

点击坐标

uni-app项目中（vue/nvue）调用示例：

import { clickLocation } from "@/uni_modules/XF-accessibilityUTS"

clickLocation({
  x : 100,
  y : 100,
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { clickLocation } from "@/uni_modules/XF-accessibilityUTS";
import { LocationOptions } from "@/uni_modules/XF-accessibilityUTS/utssdk/interface.uts";

let options = {
  x : 100,
  y : 100,
  complete: (res : any) => {
    console.log(res)
  }
} as LocationOptions;
clickLocation(options);

可用性

Android系统

可提供的1.0.0及更高版本

slideScreen

滑动屏幕

uni-app项目中（vue/nvue）调用示例：

import { slideScreen } from "@/uni_modules/XF-accessibilityUTS"

slideScreen({
  start_x : 100,
  start_y : 100,
  end_x : 500,
  end_y : 500,
  duration : 1000,
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { slideScreen } from "@/uni_modules/XF-accessibilityUTS";
import { LocationOptions } from "@/uni_modules/XF-accessibilityUTS/utssdk/interface.uts";

let options = {
  start_x : 100,
  start_y : 100,
  end_x : 500,
  end_y : 500,
  duration : 1000,
  complete: (res : any) => {
    console.log(res)
  }
} as LocationOptions;
slideScreen(options);

可用性

Android系统

可提供的1.0.0及更高版本

goBack

返回

uni-app项目中（vue/nvue）调用示例：

import { goBack } from "@/uni_modules/XF-accessibilityUTS"

goBack();

uni-app x项目（uvue）中调用示例：

import { goBack } from "@/uni_modules/XF-accessibilityUTS";

goBack();

可用性

Android系统

可提供的1.0.0及更高版本

goHome

回到桌面

uni-app项目中（vue/nvue）调用示例：

import { goHome } from "@/uni_modules/XF-accessibilityUTS"

goHome();

uni-app x项目（uvue）中调用示例：

import { goHome } from "@/uni_modules/XF-accessibilityUTS";

goHome();

可用性

Android系统

可提供的1.0.0及更高版本

goRecentTasks

打开最近任务

uni-app项目中（vue/nvue）调用示例：

import { goRecentTasks } from "@/uni_modules/XF-accessibilityUTS"

goRecentTasks();

uni-app x项目（uvue）中调用示例：

import { goRecentTasks } from "@/uni_modules/XF-accessibilityUTS";

goRecentTasks();

可用性

Android系统

可提供的1.0.0及更高版本

moveAppToFront

后台唤起应用程序。需要后台弹出窗口权限

uni-app项目中（vue/nvue）调用示例：

import { moveAppToFront } from "@/uni_modules/XF-accessibilityUTS"

moveAppToFront({
    complete: (res) => {
        console.log(res)
    }
});

uni-app x项目（uvue）中调用示例：

import { moveAppToFront } from "@/uni_modules/XF-accessibilityUTS";
import { SettingOptions } from "@/uni_modules/XF-accessibilityUTS/utssdk/interface.uts";

const options = {
    complete: (res) => {
        console.log(res)
    }
} as SettingOptions

moveAppToFront(options);

可用性

Android系统

可提供的1.0.0及更高版本

getAllNodes

获取 屏幕上的所有节点

uni-app项目中（vue/nvue）调用示例：

import { getAllNodes } from "@/uni_modules/XF-accessibilityUTS"

getAllNodes({
    complete: (res) => {
        console.log(res)
    }
});

uni-app x项目（uvue）中调用示例：

import { getAllNodes } from "@/uni_modules/XF-accessibilityUTS";
import { NodesOptions } from "@/uni_modules/XF-accessibilityUTS/utssdk/interface.uts";

const options = {
    complete: (res) => {
        console.log(res)
    }
} as NodesOptions

getAllNodes(options);

可用性

Android系统

可提供的1.0.0及更高版本

forNodes

遍历 屏幕上的所有节点

uni-app项目中（vue/nvue）调用示例：

import { forNodes } from "@/uni_modules/XF-accessibilityUTS"

forNodes({
    complete: (res) => {
        console.log(res)
    }
});

uni-app x项目（uvue）中调用示例：

import { forNodes } from "@/uni_modules/XF-accessibilityUTS";
import { NodesOptions } from "@/uni_modules/XF-accessibilityUTS/utssdk/interface.uts";

const options = {
    complete: (res) => {
        console.log(res)
    }
} as NodesOptions

forNodes(options);

可用性

Android系统

可提供的1.0.0及更高版本

clickByIndex

点击

uni-app项目中（vue/nvue）调用示例：

import { clickByIndex } from "@/uni_modules/XF-accessibilityUTS"

clickByIndex(0);

uni-app x项目（uvue）中调用示例：

import { clickByIndex } from "@/uni_modules/XF-accessibilityUTS";

clickByIndex(0);

可用性

Android系统

可提供的1.0.0及更高版本

longClickByIndex

长按

uni-app项目中（vue/nvue）调用示例：

import { longClickByIndex } from "@/uni_modules/XF-accessibilityUTS"

longClickByIndex(0);

uni-app x项目（uvue）中调用示例：

import { longClickByIndex } from "@/uni_modules/XF-accessibilityUTS";

longClickByIndex(0);

可用性

Android系统

可提供的1.0.0及更高版本

editByIndex

输入文本

uni-app项目中（vue/nvue）调用示例：

import { editByIndex } from "@/uni_modules/XF-accessibilityUTS"

editByIndex(0,"");

uni-app x项目（uvue）中调用示例：

import { editByIndex } from "@/uni_modules/XF-accessibilityUTS";

editByIndex(0,"");

可用性

Android系统

可提供的1.0.0及更高版本

getNodeSizeById

获取符合id的节点数量

uni-app项目中（vue/nvue）调用示例：

import { getNodeSizeById } from "@/uni_modules/XF-accessibilityUTS"

getNodeSizeById("");

uni-app x项目（uvue）中调用示例：

import { getNodeSizeById } from "@/uni_modules/XF-accessibilityUTS";

getNodeSizeById("");

可用性

Android系统

可提供的1.0.0及更高版本

clickNodeById

点击符合id的节点，可先用getNodeSizeById获取数量

uni-app项目中（vue/nvue）调用示例：

import { clickNodeById } from "@/uni_modules/XF-accessibilityUTS"

clickNodeById("",0);

uni-app x项目（uvue）中调用示例：

import { clickNodeById } from "@/uni_modules/XF-accessibilityUTS";

clickNodeById("",0);

可用性

Android系统

可提供的1.0.0及更高版本

longClickNodeById

长按符合id的节点，可先用getNodeSizeById获取数量

uni-app项目中（vue/nvue）调用示例：

import { longClickNodeById } from "@/uni_modules/XF-accessibilityUTS"

longClickNodeById("",0);

uni-app x项目（uvue）中调用示例：

import { longClickNodeById } from "@/uni_modules/XF-accessibilityUTS";

longClickNodeById("",0);

可用性

Android系统

可提供的1.0.0及更高版本

editNodeById

输入文本

uni-app项目中（vue/nvue）调用示例：

import { editNodeById } from "@/uni_modules/XF-accessibilityUTS"

editNodeById("","");

uni-app x项目（uvue）中调用示例：

import { editNodeById } from "@/uni_modules/XF-accessibilityUTS";

editNodeById("","");

可用性

Android系统

可提供的1.0.0及更高版本

getChildNodeInform

获取第nodeIndex个id符合的节点的第childIndex个节点信息

uni-app项目中（vue/nvue）调用示例：

import { getChildNodeInform } from "@/uni_modules/XF-accessibilityUTS"

getChildNodeInform("",0,0);

uni-app x项目（uvue）中调用示例：

import { getChildNodeInform } from "@/uni_modules/XF-accessibilityUTS";

getChildNodeInform("",0,0);

可用性

Android系统

可提供的1.0.0及更高版本

getFirstNodeInformById

获取第一个符合id的节点信息

uni-app项目中（vue/nvue）调用示例：

import { getFirstNodeInformById } from "@/uni_modules/XF-accessibilityUTS"

getFirstNodeInformById("");

uni-app x项目（uvue）中调用示例：

import { getFirstNodeInformById } from "@/uni_modules/XF-accessibilityUTS";

getFirstNodeInformById("");

可用性

Android系统

可提供的1.0.0及更高版本

getNodeInformById

获取第index个符合id的节点信息

uni-app项目中（vue/nvue）调用示例：

import { getNodeInformById } from "@/uni_modules/XF-accessibilityUTS"

getNodeInformById("",0);

uni-app x项目（uvue）中调用示例：

import { getNodeInformById } from "@/uni_modules/XF-accessibilityUTS";

getNodeInformById("",0);

可用性

Android系统

可提供的1.0.0及更高版本

requestScreenCapture

请求截屏权限

uni-app项目中（vue/nvue）调用示例：

import { requestScreenCapture } from "@/uni_modules/XF-accessibilityUTS"

requestScreenCapture({
    complete: (res) => {
        console.log(res)
    }
});

uni-app x项目（uvue）中调用示例：

import { requestScreenCapture } from "@/uni_modules/XF-accessibilityUTS";
import { ScreenCaptureOptions } from "@/uni_modules/XF-accessibilityUTS/utssdk/interface.uts";

const options = {
    complete: (res) => {
        console.log(res)
    }
} as ScreenCaptureOptions

requestScreenCapture(options);

可用性

Android系统

可提供的1.0.0及更高版本

startCapture

开始截屏

uni-app项目中（vue/nvue）调用示例：

import { startCapture } from "@/uni_modules/XF-accessibilityUTS"

startCapture({
    complete: (res) => {
        console.log(res)
    }
});

uni-app x项目（uvue）中调用示例：

import { startCapture } from "@/uni_modules/XF-accessibilityUTS";
import { ScreenCaptureOptions } from "@/uni_modules/XF-accessibilityUTS/utssdk/interface.uts";

const options = {
    complete: (res) => {
        console.log(res)
    }
} as ScreenCaptureOptions

startCapture(options);

可用性

Android系统

可提供的1.0.0及更高版本

getCaptureBitmap

获取截屏图片

uni-app项目中（vue/nvue）调用示例：

import { getCaptureBitmap } from "@/uni_modules/XF-accessibilityUTS"

getCaptureBitmap({
    complete: (res) => {
        console.log(res)
    }
});

uni-app x项目（uvue）中调用示例：

import { getCaptureBitmap } from "@/uni_modules/XF-accessibilityUTS";
import { ScreenCaptureOptions } from "@/uni_modules/XF-accessibilityUTS/utssdk/interface.uts";

const options = {
    complete: (res) => {
        console.log(res)
    }
} as ScreenCaptureOptions

getCaptureBitmap(options);

可用性

Android系统

可提供的1.0.0及更高版本

stopCapture

停止截屏

uni-app项目中（vue/nvue）调用示例：

import { stopCapture } from "@/uni_modules/XF-accessibilityUTS"

stopCapture({
    complete: (res) => {
        console.log(res)
    }
});

uni-app x项目（uvue）中调用示例：

import { stopCapture } from "@/uni_modules/XF-accessibilityUTS";
import { ScreenCaptureOptions } from "@/uni_modules/XF-accessibilityUTS/utssdk/interface.uts";

const options = {
    complete: (res) => {
        console.log(res)
    }
} as ScreenCaptureOptions

stopCapture(options);

可用性

Android系统

可提供的1.0.0及更高版本

longPressAndDrag

长按后拖动(测试接口)

uni-app项目中（vue/nvue）调用示例：

import { longPressAndDrag } from "@/uni_modules/XF-accessibilityUTS"

longPressAndDrag({
  start_x : 100,
  start_y : 100,
  end_x : 500,
  end_y : 500,
  duration : 1000,
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { longPressAndDrag } from "@/uni_modules/XF-accessibilityUTS";
import { LocationOptions } from "@/uni_modules/XF-accessibilityUTS/utssdk/interface.uts";

let options = {
  start_x : 100,
  start_y : 100,
  end_x : 500,
  end_y : 500,
  duration : 1000,
  complete: (res : any) => {
    console.log(res)
  }
} as LocationOptions;
longPressAndDrag(options);

可用性

Android系统

可提供的1.0.0及更高版本

隐私、权限声明

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

android.permission.REORDER_TASKS android.permission.SYSTEM_ALERT_WINDOW android.permission.SYSTEM_OVERLAY_WINDOW

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

无

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

无

评论列表 撰写评论

暂无用户评论。

插件问答 我要提问

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

加载更多...