HarmonyOS NEXT开发：辅助功能扩展能力规范-AccessibilityElement​

 AccessibilityExtensionAbility基于ExtensionAbility框架，提供辅助功能业务的能力。

说明

• 本模块首批接口从API version 9开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import { AccessibilityExtensionAbility } from '@kit.AccessibilityKit';

属性

系统能力：SystemCapability.BarrierFree.Accessibility.Core

名称	类型	可读	可写	说明
context	AccessibilityExtensionContextAccessibilityExtensionContextAccessibilityExtensionContext	是	否	表示辅助扩展能力上下文。

AccessibilityEvent

辅助事件信息。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

属性

名称	类型	可读	可写	说明
eventType	accessibility.EventType | accessibility.WindowUpdateType | TouchGuideType | GestureType | PageUpdateType	是	否	具体事件类型。 EventType：无障碍事件类型； WindowUpdateType：窗口变化类型；TouchGuideType：触摸浏览事件类型； GestureType：手势事件类型； PageUpdateType：页面刷新类型。当前版本暂不支持。
target	AccessibilityElement	是	否	发生事件的目标组件。
timeStamp	number	是	否	事件时间戳，单位是毫秒。
elementId12+	number	是	否	主动聚焦的组件ID。
textAnnouncedForAccessibility12+	string	是	否	主动播报的内容。

AccessibilityElement10+

AccessibilityElement二级模块

系统能力：SystemCapability.BarrierFree.Accessibility.Core

示例：

import { AccessibilityElement } from '@kit.AccessibilityKit';

let accessibilityElement: AccessibilityElement;

ElementAttributeValues10+

ElementAttributeValues二级模块

系统能力：SystemCapability.BarrierFree.Accessibility.Core

示例：

import { ElementAttributeValues } from '@kit.AccessibilityKit';

let elementAttributeValues: ElementAttributeValues;

FocusDirection10+

FocusDirection二级模块，表示查询下一焦点元素的方向。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

示例：

import { FocusDirection } from '@kit.AccessibilityKit';

let focusDirection: FocusDirection;

ElementAttributeKeys10+

系统能力：SystemCapability.BarrierFree.Accessibility.Core

名称	类型	可读	可写	说明
ElementAttributeKeys	keyof ElementAttributeValues	是	否	表示ElementAttributeValues的key。

示例：

import { ElementAttributeKeys } from '@kit.AccessibilityKit';

let elementAttributeKeys: ElementAttributeKeys;

FocusType10+

FocusType二级模块，表示查询焦点元素的类型。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

示例：

import { FocusType } from '@kit.AccessibilityKit';

let focusType: FocusType;

WindowType 10+

WindowType二级模块，表示窗口的类型。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

示例：

import { WindowType } from '@kit.AccessibilityKit';

let windowType: WindowType;

Rect10+

Rect二级模块，表示矩形区域。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

示例：

import { Rect } from '@kit.AccessibilityKit';

let rect: Rect;

GestureType

手势事件类型。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

名称	类型	描述
left	string	表示向左的手势。
leftThenRight	string	表示先向左再向右的手势。
leftThenUp	string	表示先向左再向上的手势。
leftThenDown	string	表示先向左再向下的手势。
right	string	表示向右的手势。
rightThenLeft	string	表示先向右再向左的手势。
rightThenUp	string	表示先向右再向上的手势。
rightThenDown	string	表示先向右再向下的手势。
up	string	表示向上的手势。
upThenLeft	string	表示先向上再向左的手势。
upThenRight	string	表示先向上再向右的手势。
upThenDown	string	表示先向上再向下的手势。
down	string	表示向下的手势。
downThenLeft	string	表示先向下再向左的手势。
downThenRight	string	表示先向下再向右的手势。
downThenUp	string	表示先向下再向上的手势。
twoFingerSingleTap11+	string	表示双指单击的手势。
twoFingerDoubleTap11+	string	表示双指双击的手势。
twoFingerDoubleTapAndHold11+	string	表示双指双击长按的手势。
twoFingerTripleTap11+	string	表示双指三击的手势。
twoFingerTripleTapAndHold11+	string	表示双指三击长按的手势。
threeFingerSingleTap11+	string	表示三指单击的手势。
threeFingerDoubleTap11+	string	表示三指双击的手势。
threeFingerDoubleTapAndHold11+	string	表示三指双击长按的手势。
threeFingerTripleTap11+	string	表示三指三击的手势。
threeFingerTripleTapAndHold11+	string	表示三指三击长按的手势。
fourFingerSingleTap11+	string	表示四指单击的手势。
fourFingerDoubleTap11+	string	表示四指双击的手势。
fourFingerDoubleTapAndHold11+	string	表示四指双击长按的手势。
fourFingerTripleTap11+	string	表示四指三击的手势。
fourFingerTripleTapAndHold11+	string	表示四指三击长按的手势。
threeFingerSwipeUp11+	string	表示三指向上滑动的手势。
threeFingerSwipeDown11+	string	表示三指向下滑动的手势。
threeFingerSwipeLeft11+	string	表示三指向左滑动的手势。
threeFingerSwipeRight11+	string	表示三指向右滑动的手势。
fourFingerSwipeUp11+	string	表示四指向上滑动的手势。
fourFingerSwipeDown11+	string	表示四指向下滑动的手势。
fourFingerSwipeLeft11+	string	表示四指向左滑动的手势。
fourFingerSwipeRight11+	string	表示四指向右滑动的手势。

PageUpdateType

页面刷新类型。当前版本暂不支持。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

名称	类型	描述
pageContentUpdate	string	表示页面内容刷新。
pageStateUpdate	string	表示页面状态刷新。

TouchGuideType

触摸浏览事件类型。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

名称	类型	描述
touchBegin	string	表示触摸浏览时开始触摸。
touchEnd	string	表示触摸浏览时结束触摸。

AccessibilityExtensionAbility.onConnect

onConnect(): void;

用户启用AccessibilityExtensionAbility时，系统服务完成连接后，回调此接口，可以该方法中执行初始化业务逻辑操作。该方法可以选择性重写。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

示例：

import { AccessibilityExtensionAbility } from '@kit.AccessibilityKit';

class MyAccessibilityExtensionAbility extends AccessibilityExtensionAbility {
  onConnect(): void {
    console.log('AxExtensionAbility onConnect');
  }
}

AccessibilityExtensionAbility.onDisconnect

onDisconnect(): void;

用户停用AccessibilityExtensionAbility时，系统服务完成断开连接后，回调此接口，可以该方法中执行资源回收退出业务逻辑操作。该方法可以选择性重写。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

示例：

import { AccessibilityExtensionAbility } from '@kit.AccessibilityKit';

class MyAccessibilityExtensionAbility extends AccessibilityExtensionAbility {
  onDisconnect(): void {
    console.log('AxExtensionAbility onDisconnect');
  }
}

AccessibilityExtensionAbility.onAccessibilityEvent

onAccessibilityEvent(event: AccessibilityEvent): void;

在关注的应用及事件类型对应的事件发生时回调此接口，可以在该方法中根据事件信息进行业务逻辑处理。一般情况下需要重写该方法完成业务。（目前暂不支持UIExtension组件和onTouch事件）

系统能力：SystemCapability.BarrierFree.Accessibility.Core

参数：

参数名	类型	必填	说明
event	AccessibilityEvent	是	无障碍事件回调函数。无返回值。 目前暂不支持UIExtension组件和onTouch事件

示例：

import { AccessibilityExtensionAbility, AccessibilityEvent } from '@kit.AccessibilityKit';

class MyAccessibilityExtensionAbility extends AccessibilityExtensionAbility {
  onAccessibilityEvent(event: AccessibilityEvent): void {
    console.log('AxExtensionAbility onAccessibilityEvent');
    if (event.eventType === 'click') {
      console.log('AxExtensionAbility onAccessibilityEvent: click');
    }
  }
}

AccessibilityExtensionAbility.onKeyEvent

onKeyEvent(keyEvent: KeyEvent): boolean;

在物理按键按下时回调此方法，可以在该方法中根据业务判断是否对事件进行拦截。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

参数：

参数名	类型	必填	说明
keyEvent	KeyEvent	是	按键事件回调函数。返回true表示拦截此按键。

示例：

import { AccessibilityExtensionAbility } from '@kit.AccessibilityKit';
import { KeyEvent } from '@kit.InputKit';

class MyAccessibilityExtensionAbility extends AccessibilityExtensionAbility {
  onKeyEvent(keyEvent: KeyEvent): boolean {
    console.log('AxExtensionAbility onKeyEvent');
    if (keyEvent.key.code === 16) {
      console.log('AxExtensionAbility onKeyEvent: intercept 16');
      return true;
    }
    return false;
  }
}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

点击领取→【纯血版鸿蒙全套最新学习资料】（安全链接，放心点击）希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取~限时开源！！

---

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

​

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

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

HarmonyOS Next 最新全套视频教程

​

 《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

​

《鸿蒙开发基础》

• ArkTS语言
• 安装DevEco Studio
• 运用你的第一个ArkTS应用
• ArkUI声明式UI开发
• .……​

《鸿蒙开发进阶》

• Stage模型入门
• 网络管理
• 数据管理
• 电话服务
• 分布式应用开发
• 通知与窗口管理
• 多媒体技术
• 安全技能
• 任务管理
• WebGL
• 国际化开发
• 应用测试
• DFX面向未来设计
• 鸿蒙系统移植和裁剪定制
• ……

​

《鸿蒙进阶实战》

• ArkTS实践
• UIAbility应用
• 网络案例
• ……

​

大厂面试必问面试题

​

鸿蒙南向开发技术

​

鸿蒙APP开发必备

​
请点击→纯血版全套鸿蒙HarmonyOS学习资料

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，才能在这个变革的时代中立于不败之地。