@ohos.application.AccessibilityExtensionAbility (辅助功能扩展能力)

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

说明：

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

导入模块

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

属性

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

AccessibilityEvent

辅助事件信息。

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

属性

AccessibilityElement¹⁰⁺

表示无障碍节点元素，请参考AccessibilityElement。

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

示例：

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

let accessibilityElement: AccessibilityElement;

ElementAttributeValues¹⁰⁺

表示节点元素具备的属性名称及属性值类型信息，请参考ElementAttributeValues。

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

示例：

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

let elementAttributeValues: ElementAttributeValues;

FocusDirection¹⁰⁺

表示查询下一焦点元素的方向，请参考FocusDirection。

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

示例：

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

let focusDirection: FocusDirection;

ElementAttributeKeys¹⁰⁺

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

示例：

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

let elementAttributeKeys: ElementAttributeKeys;

FocusType¹⁰⁺

表示查询焦点元素的类型，请参考FocusType。

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

示例：

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

let focusType: FocusType;

WindowType ¹⁰⁺

表示窗口的类型，请参考WindowType。

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

示例：

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

let windowType: WindowType;

Rect¹⁰⁺

表示矩形区域，请参考Rect。

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

示例：

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

let rect: Rect;

GestureType

手势事件类型。

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

PageUpdateType

type PageUpdateType = ‘pageContentUpdate’|‘pageStateUpdate’

页面刷新类型。

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

TouchGuideType

TouchGuideType = ‘touchBegin’|‘touchEnd’

触摸浏览事件类型。

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

AccessibilityExtensionAbility.onConnect^(deprecated)

onConnect(): void;

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

说明：

从API version 12开始废弃。替代接口仅面向系统应用开放。

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

示例：

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

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

AccessibilityExtensionAbility.onDisconnect^(deprecated)

onDisconnect(): void;

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

说明：

从API version 12开始废弃。替代接口仅面向系统应用开放。

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

示例：

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

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

AccessibilityExtensionAbility.onAccessibilityEvent^(deprecated)

onAccessibilityEvent(event: AccessibilityEvent): void;

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

说明：

从API version 12开始废弃。替代接口仅面向系统应用开放。

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

参数：

示例：

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^(deprecated)

onKeyEvent(keyEvent: KeyEvent): boolean;

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

说明：

从API version 12开始废弃。替代接口仅面向系统应用开放。

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

参数：

示例：

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;
  }
}

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Accessibility Kit（无障碍开发服务）

harmony 鸿蒙无障碍子系统错误码

harmony 鸿蒙@ohos.accessibility.GesturePath (手势路径)

harmony 鸿蒙@ohos.accessibility.GesturePoint (手势触摸点)

harmony 鸿蒙@ohos.accessibility.config (系统辅助功能配置)(系统接口)

harmony 鸿蒙@ohos.accessibility (辅助功能)

harmony 鸿蒙AccessibilityExtensionContext (辅助功能扩展上下文)(系统接口)

harmony 鸿蒙AccessibilityExtensionContext (辅助功能扩展上下文)