鸿蒙Harmony实战：Accessibility Kit应用开发

ops/2024/11/13 5:32:11/

 前言：

 “Accessibility”译作“信息无障碍”，是指任何人在任何情况下都能平等、方便地获取信息并利用信息。其目的是缩小全社会不同阶层、不同地区、不同年龄、不同健康状况的人群在信息理解、信息交互、信息利用方面的数字鸿沟，使其更加方便地参与社会生活，享受数字发展带来的便利。

Accessibility Kit（无障碍开发服务）提供扩展服务的开放能力，三方可基于此开放能力开发出类似读屏软件的扩展服务，同时也为三方应用提供开放能力，使三方应用可以更好的适配扩展服务，以更好的服务于障碍人群和障碍场景。例如利用读屏软件，用户可以“听见”当前屏幕内容。

能力范围

1、为三方应用提供获取扩展服务列表、扩展服务启用状态、发送无障碍事件等能力。

2、为扩展服务提供扩展服务框架，允许三方开发类似读屏软件的扩展服务。

框架原理

无障碍扩展服务框架提供在三方应用和和扩展服务之间交换信息的标准机制。扩展服务通过AAkit向AAMS发出查询或操作请求，AAMS通过ASACkit向三方应用执行查询或操作请求，并将执行结果返回给扩展服务。

  1. Accessibility App：基于无障碍扩展服务框架开发的扩展服务，如视障用户使用的读屏App。
  2. Tartget App：被Accessibility App辅助的三方应用。
  3. AccessibilityAbilityManagerService（AAMS）：无障碍扩展服务框架主服务，用于对Accessibility App生命周期进行管理，同时为Accessibility App和Target App提供信息交互的桥梁。
  4. AccessibilityAbility（AAkit）：Accessibility App利用AAkit构建扩展服务Ability运行环境，并为Accessibility App提供可查询和操作Target App的接口，如查询节点信息、对节点执行点击/长按操作等。
  5. AccessibilitySystemAbilityClient（ASACkit）：Target App通过ASACkit向AAMS发送无障碍事件，如内容变化事件等，同时响应Accessibility App通过AAMS请求的指令，如查询节点信息、对节点执行点击/长按操作等。

AccessibilityExtensionAbility

Accessibility Kit（无障碍开发服务）通过基于ExtensionAbility框架的AccessibilityExtensionAbility提供无障碍扩展服务，开发者可以基于AccessibilityExtensionAbility模板开发自己的扩展服务，协助用户完成一些快捷的交互过程。

如何创建一个无障碍扩展服务

开发者在创建一个无障碍扩展服务时，如工程满足环境要求，开发者可自主选择是否跳过创建工程步骤，在已有工程中新增无障碍扩展服务。一个工程仅支持创建一个无障碍扩展服务。

本指南以实现以下功能为案例，讲述如何创建无障碍扩展服务，如何调用API接口实现该功能：

启动辅助功能后，在设备屏幕上绘画“右划后再下划”（rightThenDown）的手势，获取当前界面的全部节点；之后再绘画“左划后再下划”（leftThenDown）的手势，打印所有节点。

创建工程

如需新增独立的无障碍扩展服务应用，在DevEco Studio中新建一个API 9以上的Stage工程。

新建无障碍扩展服务ets文件

在已创建工程的ets文件夹下创建AccessibilityExtAbility文件夹，在该文件夹下创建AccessibilityExtAbility.ets文件，可在该文件中实现一些回调函数，并加入业务处理逻辑的调用：

import AccessibilityExtensionAbility, { AccessibilityEvent } from '@ohos.application.AccessibilityExtensionAbility';
import AccessibilityManager from './AccessibilityManager';class AccessibilityExtAbility extends AccessibilityExtensionAbility {onConnect() {console.info(`AccessibilityExtAbility onConnect`);// 执行初始化业务逻辑的操作AccessibilityManager.getInstance().onStart(this.context);}onDisconnect() {console.info(`AccessibilityExtAbility onDisconnect`);// 执行资源回收退出业务逻辑的操作AccessibilityManager.getInstance().onStop();}onAccessibilityEvent(accessibilityEvent: AccessibilityEvent) {console.info(`AccessibilityExtAbility onAccessibilityEvent: ${JSON.stringify(accessibilityEvent)}`);// 根据事件信息进行业务逻辑处理AccessibilityManager.getInstance().onEvent(accessibilityEvent);}
}export default AccessibilityExtAbility;

其中，主要定义了以下接口：

接口描述
onConnect(): void当扩展服务连接时回调。
onDisconnect(): void当扩展服务断开时回调。
onAccessibilityEvent(event: AccessibilityEvent): void当无障碍事件发生时回调。

创建AccessibilityManager.ets文件，用于存放业务逻辑代码：

import {AccessibilityElement,AccessibilityEvent,AccessibilityExtensionContext,ElementAttributeKeys
} from '@ohos.application.AccessibilityExtensionAbility';interface Rect {left: number,top: number,width: number,height: number,
}// 想要查询的属性信息
let wantedAttribute: ElementAttributeKeys[] = ['bundleName', 'text', 'description', 'windowId'];
type attributeValues = string | number | boolean | AccessibilityElement | AccessibilityElement[] | string[] | Rect;export default class AccessibilityManager {private static instance: AccessibilityManager;accessibleContext?: AccessibilityExtensionContext;currentPageElementArray: Array<AccessibilityElement> | null = null;static getInstance(): AccessibilityManager {if (!AccessibilityManager.instance) {AccessibilityManager.instance = new AccessibilityManager();}return AccessibilityManager.instance;}onStart(context: AccessibilityExtensionContext) {console.info(`AccessibilityManager onStart`);this.accessibleContext = context;}onStop() {console.info(`AccessibilityManager onStop`);this.accessibleContext = undefined;}onEvent(accessibilityEvent: AccessibilityEvent): void {console.info(`AccessibilityManager onEvent`);switch (accessibilityEvent.eventType) {case 'rightThenDown':// 获取当前页面的所有节点this.getCurrentPageAllElement();break;case 'leftThenDown':// 打印所有节点this.printAllElementInfo();break;default:break;}}async getCurrentPageAllElement(): Promise<void> {console.info(`AccessibilityManager getCurrentPageAllElement`);let rootElement: AccessibilityElement;if(!this.accessibleContext){console.error(`AccessibilityManager accessibleContext undefined`);return;}try {rootElement = await this.accessibleContext?.getWindowRootElement();this.currentPageElementArray = await this.getAttributeValue(rootElement, 'children') as AccessibilityElement[];} catch (error) {console.error(`AccessibilityExtAbility Failed to getWindowRootElement. Cause:${JSON.stringify(error)}`);}}async getElementWantedInfo(accessibilityElement: AccessibilityElement, wantedAttribute: ElementAttributeKeys[]):Promise<string | null> {console.info(`AccessibilityUtils getElementAllInfo`);if (accessibilityElement === null) {console.error(`AccessibilityUtils accessibilityElement is null`);return null;}let info = '';let value: attributeValues | null;for (let name of wantedAttribute) {value = await this.getAttributeValue(accessibilityElement, name);info = info.concat(name + ': ' + value + ' ');}return info;}async getAttributeValue(accessibilityElement: AccessibilityElement, key: ElementAttributeKeys):Promise<attributeValues | null> {console.info(`AccessibilityUtils getAttributeValue`);let value: attributeValues;let keys = await accessibilityElement.attributeNames();let isExit = false;for (let keyString of keys) {if (key == keyString) {isExit = true;}}if (isExit) {try {value = await accessibilityElement.attributeValue(key);return value;} catch (error) {console.error(`AccessibilityUtils Failed to get attributeValue of ${key} . Cause:  ${JSON.stringify(error)}`);}}return null;}async printAllElementInfo(): Promise<void> {console.info(`AccessibilityManager printAllElementInfo`);if (this.currentPageElementArray === null || this.currentPageElementArray.length === 0) {console.error(`AccessibilityManager currentPageElementArray is null`);return;}let info: string | null = null;for (let index = 0; index < this.currentPageElementArray.length; index++) {info = await this.getElementWantedInfo(this.currentPageElementArray[index], wantedAttribute);console.info(`AccessibilityManager element information: ${info}`);}}
}

如何处理一个无障碍事件

相关无障碍事件可以在onAccessibilityEvent()方法中进行业务逻辑处理，此处以手势事件rightThenDown为例：

onAccessibilityEvent(accessibilityEvent: AccessibilityEvent) {console.info('AccessibilityExtAbility onAccessibilityEvent: ' + JSON.stringify(accessibilityEvent));if (accessibilityEvent.eventType === 'rightThenDown') {console.info('AccessibilityExtAbility onAccessibilityEvent: rightThenDown');// TODO: 自定义相关逻辑开发}
}

在相应的无障碍事件中，可以使用辅助功能扩展上下文（AccessibilityExtensionContext）提供的接口进行扩展开发，包括允许配置辅助应用关注信息类型、查询节点信息、手势注入等。

此外，还可在无障碍扩展服务中对物理按键事件进行处理

如何声明无障碍扩展服务具备的能力

在完成自定义无障碍扩展服务的逻辑开发后，还需要在工程中Module对应的module.json5文件中加入新增扩展服务的配置信息。

srcEntry标签为extensionAbility对应的路径。

label标签为extensionAbility在已安装扩展服务列表中显示的名称。

description标签为extensionAbility在已安装扩展服务详情页的帮助信息。

type标签要按照与无障碍子系统的约定进行配置，需要注意的是该值固定为accessibility，否则将无法正常连接。

"extensionAbilities": [{"name": "AccessibilityExtAbility","srcEntry": "./ets/AccessibilityExtAbility/AccessibilityExtAbility.ets","label": "$string:MainAbility_label","description": "$string:MainAbility_desc","type": "accessibility","metadata": [{"name": "ohos.accessibleability","resource": "$profile:accessibility_config"}]}
]

另外，配置信息中的accessibility_config为无障碍扩展服务的具体配置，需要在resources/base/profile/下新建accessibility_config.json文件，在该文件中声明此无障碍扩展服务具备的能力类型，根据业务功能合理声明能力类型，本案例中，需要如下声明:

{"accessibilityCapabilities": ["retrieve","gesture","touchGuide"]
}

如何开启自定义的无障碍扩展服务

当前提供设备-设置中的扩展服务管理页的开关按钮来开启/关闭选择的无障碍扩展服务：

1、打开设备设置页面，进入“辅助功能”，“扩展服务”小标题下的“已安装的服务”显示当前安装的扩展服务个数，点击进入，展示安装的扩展服务列表；未安装扩展服务时，“已安装的扩展服务”不可点击，并显示“无服务”。

2、选择需要开启/关闭的扩展服务，通过开关按钮进行扩展服务的开启/关闭。

3、开启时，弹出安全提醒，在倒计时结束后，勾选“我已知晓如上风险，并自愿承担可能导致的后果。”后，可选择“开启”/“不开启”按钮； 关闭时，将开启的开关关闭，即可关闭已开启的扩展服务。

最后

小编在之前的鸿蒙系统扫盲中，有很多朋友给我留言，不同的角度的问了一些问题，我明显感觉到一点，那就是许多人参与鸿蒙开发，但是又不知道从哪里下手，因为资料太多，太杂，教授的人也多，无从选择。有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

为了确保高效学习，建议规划清晰的学习路线，涵盖以下关键阶段：

 鸿蒙（HarmonyOS NEXT）最新学习路线

​

该路线图包含基础技能、就业必备技能、多媒体技术、六大电商APP、进阶高级技能、实战就业级设备开发，不仅补充了华为官网未涉及的解决方案

路线图适合人群：

IT开发人员：想要拓展职业边界
零基础小白：鸿蒙爱好者，希望从0到1学习，增加一项技能。
技术提升/进阶跳槽：发展瓶颈期，提升职场竞争力，快速掌握鸿蒙技术

2.视频学习资料+学习PDF文档

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、（南向驱动、嵌入式等）鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

HarmonyOS Next 最新全套视频教程

  纯血版鸿蒙全套学习资料（面试、文档、全套视频等）              

​​

总结

参与鸿蒙开发，你要先认清适合你的方向，如果是想从事鸿蒙应用开发方向的话，可以参考本文的学习路径，简单来说就是：为了确保高效学习，建议规划清晰的学习路线


http://www.ppmy.cn/ops/98277.html

相关文章

EDI 866生产顺序

EDI 866生产顺序

EDI 866报文介绍 EDI 866是一种电子数据交换&#xff08;EDI&#xff09;报文&#xff0c;通常用于订单装运的重新排序和组织。它主要用于供应链管理中&#xff0c;允许供应商和客户在运输过程中重新组织装运数据&#xff0c;而不必重新生成新的发货通知或订单。通过EDI 866&a…
阅读更多...
Vue3通信方式 插槽

Vue3通信方式 插槽

插槽就是子组件中的提供给父组件使用的一个占位符&#xff0c;用 表示&#xff0c;父组件可以在这个占位符中填充任何模板代码&#xff0c;如 HTML、组件等&#xff0c;填充的内容会替换子组件的标签&#xff0c;父组件填充的内容称为插槽内容。 子组件不提供插槽时&#xff0…
阅读更多...
问答泛单页目录站群通用程序——码山侠

问答泛单页目录站群通用程序——码山侠

功能特性&#xff1a; 内置ASCII码转换功能&#xff1a; 可通过简易开关控制文章中ASCII码的添加。 内置缓存管理功能&#xff1a; 提供程序缓存开关&#xff0c;以优化性能和响应速度。 打开&#xff1a;i5i.net 使用指南&#xff1a;本程序无需依赖数据库&#xff0c;仅需…
阅读更多...
数据仓库ETL开发

数据仓库ETL开发

在企业数字化转型的过程中&#xff0c;数据仓库已经成为了企业管理和决策的重要工具。数据仓库ETL开发是构建数据仓库的关键步骤之一&#xff0c;它可以帮助企业从源系统中抽取、清洗、转换和整合数据&#xff0c;方便企业进行管理和分析。本文将介绍如何高效实现数据仓库ETL开…
阅读更多...
回归预测|基于北方苍鹰优化NGO-Transformer-BiLSTM组合模型的数据预测Matlab程序多特征输入单输出

回归预测|基于北方苍鹰优化NGO-Transformer-BiLSTM组合模型的数据预测Matlab程序多特征输入单输出

回归预测|基于北方苍鹰优化NGO-Transformer-BiLSTM组合模型的数据预测Matlab程序多特征输入单输出 文章目录 前言回归预测|基于北方苍鹰优化NGO-Transformer-BiLSTM组合模型的数据预测Matlab程序多特征输入单输出 一、NGO-Transformer-BiLSTM模型回归预测&#xff1a;NGO-Trans…
阅读更多...
【精选】基于大数据的___银行信用卡用户的数仓系统的设计与实现（全网独一无二，最新定制）

【精选】基于大数据的___银行信用卡用户的数仓系统的设计与实现（全网独一无二，最新定制）

目录&#xff1a; 关键技术介绍 PYTHON语言简介 大数据介绍 MySql数据库 DJANGO框架 Hadoop介绍 Scrapy介绍 B/S架构 系统的设计 系统总功能模块设计 系统测试 系统测试的目的 软件测试过程 6.3测试用例 参考代码&#xff1a; 为什么选择我&#xff1a; 博主介绍&am…
阅读更多...
大数据-90 Spark 集群 RDD 编程-高阶 RDD容错机制、RDD的分区、自定义分区器（Scala编写）、RDD创建方式

大数据-90 Spark 集群 RDD 编程-高阶 RDD容错机制、RDD的分区、自定义分区器（Scala编写）、RDD创建方式

点一下关注吧&#xff01;&#xff01;&#xff01;非常感谢&#xff01;&#xff01;持续更新&#xff01;&#xff01;&#xff01; 目前已经更新到了&#xff1a; Hadoop&#xff08;已更完&#xff09;HDFS&#xff08;已更完&#xff09;MapReduce&#xff08;已更完&am…
阅读更多...
JVM虚拟机（二）如何定位垃圾、判断对象是否死亡？垃圾回收算法、垃圾回收器、CMS、G1垃圾回收器

JVM虚拟机（二）如何定位垃圾、判断对象是否死亡？垃圾回收算法、垃圾回收器、CMS、G1垃圾回收器

一、GC基本信息 1.1 什么是GC&#xff0c;垃圾回收&#xff1f; JVM的垃圾回收&#xff08;Garbage Collection&#xff0c;GC&#xff09;是一种自动内存管理机制&#xff0c;其主要目的是识别并清除不再使用的对象&#xff0c;释放内存空间以供应用程序中的其他部分使用。G…
阅读更多...
最新文章

Copyright @ 2022~2023