openharmony 鸿蒙 changelogs-accessibility

2025-06-16 浏览 (1)

无障碍子系统Changelog

cl.accessibility.1 Accessibility扩展服务相关API废弃

访问级别

公开接口

变更原因

为提升系统安全性,无障碍不再开放扩展服务接口能力。

变更影响

  1. 该变更为不兼容变更;

  2. Accessibility模块扩展服务接口废弃;

  3. 设置-辅助功能下,不再提供已安装的服务查询和管理功能。

变更发生版本

从OpenHarmony SDK 5.0.0.35开始。

变更的接口/组件

  1. 以下接口废弃:
所属包名方法声明起始API Level
AccessibilityExtensionContextsetTargetBundleName(targetNames: Array<string>, callback: AsyncCallback<void>): void;9
AccessibilityExtensionContextsetTargetBundleName(targetNames: Array<string>): Promise<void>;9
AccessibilityExtensionContextgetFocusElement(isAccessibilityFocus: boolean, callback: AsyncCallback<AccessibilityElement>): void;9
AccessibilityExtensionContextgetFocusElement(isAccessibilityFocus?: boolean): Promise<AccessibilityElement>;9
AccessibilityExtensionContextgetFocusElement(callback: AsyncCallback<AccessibilityElement>): void;9
AccessibilityExtensionContextgetWindowRootElement(windowId: number, callback: AsyncCallback<AccessibilityElement>): void;9
AccessibilityExtensionContextgetWindowRootElement(windowId?: number): Promise<AccessibilityElement>;9
AccessibilityExtensionContextgetWindowRootElement(callback: AsyncCallback<AccessibilityElement>): void;9
AccessibilityExtensionContextgetWindows(displayId: number, callback: AsyncCallback<Array<AccessibilityElement>>): void;9
AccessibilityExtensionContextgetWindows(displayId?: number): Promise<Array<AccessibilityElement>>;9
AccessibilityExtensionContextgetWindows(callback: AsyncCallback<Array<AccessibilityElement>>): void;9
AccessibilityExtensionContextinjectGestureSync(gesturePath: GesturePath): void;10
AccessibilityExtensionContextattributeNames<T extends keyof ElementAttributeValues>(callback: AsyncCallback<Array<T>>): void;9
AccessibilityExtensionContextattributeNames<T extends keyof ElementAttributeValues>(): Promise<Array<T>>;9
AccessibilityExtensionContextattributeValue<T extends keyof ElementAttributeValues>(attributeName: T, callback: AsyncCallback<ElementAttributeValues[T]>): void;9
AccessibilityExtensionContextattributeValue<T extends keyof ElementAttributeValues>(attributeName: T): Promise<ElementAttributeValues[T]>;9
AccessibilityExtensionContextactionNames(callback: AsyncCallback<Array<string>>): void;9
AccessibilityExtensionContextactionNames(): Promise<Array<string>>;9
AccessibilityExtensionContextperformAction(actionName: string, parameters: object, callback: AsyncCallback<void>): void;9
AccessibilityExtensionContextperformAction(actionName: string, parameters?: object): Promise<void>;9
AccessibilityExtensionContextperformAction(actionName: string, callback: AsyncCallback<void>): void;9
AccessibilityExtensionContextfindElement(type: 'content', condition: string, callback: AsyncCallback<Array<AccessibilityElement>>): void;9
AccessibilityExtensionContextfindElement(type: 'content', condition: string): Promise<Array<AccessibilityElement>>;9
AccessibilityExtensionContextfindElement(type: 'focusType', condition: FocusType, callback: AsyncCallback<AccessibilityElement>): void;9
AccessibilityExtensionContextfindElement(type: 'focusType', condition: FocusType): Promise<AccessibilityElement>;9
AccessibilityExtensionContextfindElement(type: 'focusDirection', condition: FocusDirection, callback: AsyncCallback<AccessibilityElement>): void;9
AccessibilityExtensionContextfindElement(type: 'focusDirection', condition: FocusDirection): Promise<AccessibilityElement>;9
ohos.accessibilityfunction on(type: 'accessibilityStateChange', callback: Callback<boolean>): void;7
ohos.accessibilityfunction on(type: 'touchGuideStateChange', callback: Callback<boolean>): void;7
ohos.accessibilityfunction off(type: 'accessibilityStateChange', callback?: Callback<boolean>): void;7
ohos.accessibilityfunction off(type: 'touchGuideStateChange', callback?: Callback<boolean>): void;7
ohos.accessibilityfunction getCaptionsManager(): CaptionsManager;8
ohos.application.AccessibilityExtensionAbilityonConnect(): void;9
ohos.application.AccessibilityExtensionAbilityonDisconnect(): void;9
ohos.application.AccessibilityExtensionAbilityonAccessibilityEvent(event: AccessibilityEvent): void;9
ohos.application.AccessibilityExtensionAbilityonKeyEvent(keyEvent: KeyEvent): boolean;9
ohos.accessibility.GesturePathconstructor(durationTime: number);9
ohos.accessibility.GesturePointconstructor(positionX: number, positionY: number);9
  1. 以下接口删除:
所属包名方法声明起始API Level
AccessibilityExtensionContextgetCursorPosition(callback: AsyncCallback<number>): void;12
AccessibilityExtensionContextgetCursorPosition(): Promise<number>;12
AccessibilityExtensionContextfindElement(type: 'textType', condition: string): Promise<Array<AccessibilityElement>>;12
AccessibilityExtensionContextfindElement(type: 'elementId', condition: number): Promise<AccessibilityElement>;12
  1. 设置-辅助功能下,不再提供已安装的服务查询和管理功能。

适配指导

此变更开发者无需适配。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkCompiler子系统Changelog

harmony 鸿蒙ArkTS子系统变更说明

harmony 鸿蒙cl.arkui.1 Menu组件箭头离宿主节点默认安全边距变更

harmony 鸿蒙包管理子系统变更说明

harmony 鸿蒙窗口子系统变更说明

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/PsgPJ2