无障碍子系统Changelog
cl.accessibility.1 Accessibility扩展服务相关API废弃
访问级别
公开接口
变更原因
为提升系统安全性,无障碍不再开放扩展服务接口能力。
变更影响
-
该变更为不兼容变更;
-
Accessibility模块扩展服务接口废弃;
-
设置-辅助功能下,不再提供已安装的服务查询和管理功能。
变更发生版本
从OpenHarmony SDK 5.0.0.35开始。
变更的接口/组件
- 以下接口废弃:
| 所属包名 | 方法声明 | 起始API Level |
|---|---|---|
| AccessibilityExtensionContext | setTargetBundleName(targetNames: Array<string>, callback: AsyncCallback<void>): void; | 9 |
| AccessibilityExtensionContext | setTargetBundleName(targetNames: Array<string>): Promise<void>; | 9 |
| AccessibilityExtensionContext | getFocusElement(isAccessibilityFocus: boolean, callback: AsyncCallback<AccessibilityElement>): void; | 9 |
| AccessibilityExtensionContext | getFocusElement(isAccessibilityFocus?: boolean): Promise<AccessibilityElement>; | 9 |
| AccessibilityExtensionContext | getFocusElement(callback: AsyncCallback<AccessibilityElement>): void; | 9 |
| AccessibilityExtensionContext | getWindowRootElement(windowId: number, callback: AsyncCallback<AccessibilityElement>): void; | 9 |
| AccessibilityExtensionContext | getWindowRootElement(windowId?: number): Promise<AccessibilityElement>; | 9 |
| AccessibilityExtensionContext | getWindowRootElement(callback: AsyncCallback<AccessibilityElement>): void; | 9 |
| AccessibilityExtensionContext | getWindows(displayId: number, callback: AsyncCallback<Array<AccessibilityElement>>): void; | 9 |
| AccessibilityExtensionContext | getWindows(displayId?: number): Promise<Array<AccessibilityElement>>; | 9 |
| AccessibilityExtensionContext | getWindows(callback: AsyncCallback<Array<AccessibilityElement>>): void; | 9 |
| AccessibilityExtensionContext | injectGestureSync(gesturePath: GesturePath): void; | 10 |
| AccessibilityExtensionContext | attributeNames<T extends keyof ElementAttributeValues>(callback: AsyncCallback<Array<T>>): void; | 9 |
| AccessibilityExtensionContext | attributeNames<T extends keyof ElementAttributeValues>(): Promise<Array<T>>; | 9 |
| AccessibilityExtensionContext | attributeValue<T extends keyof ElementAttributeValues>(attributeName: T, callback: AsyncCallback<ElementAttributeValues[T]>): void; | 9 |
| AccessibilityExtensionContext | attributeValue<T extends keyof ElementAttributeValues>(attributeName: T): Promise<ElementAttributeValues[T]>; | 9 |
| AccessibilityExtensionContext | actionNames(callback: AsyncCallback<Array<string>>): void; | 9 |
| AccessibilityExtensionContext | actionNames(): Promise<Array<string>>; | 9 |
| AccessibilityExtensionContext | performAction(actionName: string, parameters: object, callback: AsyncCallback<void>): void; | 9 |
| AccessibilityExtensionContext | performAction(actionName: string, parameters?: object): Promise<void>; | 9 |
| AccessibilityExtensionContext | performAction(actionName: string, callback: AsyncCallback<void>): void; | 9 |
| AccessibilityExtensionContext | findElement(type: 'content', condition: string, callback: AsyncCallback<Array<AccessibilityElement>>): void; | 9 |
| AccessibilityExtensionContext | findElement(type: 'content', condition: string): Promise<Array<AccessibilityElement>>; | 9 |
| AccessibilityExtensionContext | findElement(type: 'focusType', condition: FocusType, callback: AsyncCallback<AccessibilityElement>): void; | 9 |
| AccessibilityExtensionContext | findElement(type: 'focusType', condition: FocusType): Promise<AccessibilityElement>; | 9 |
| AccessibilityExtensionContext | findElement(type: 'focusDirection', condition: FocusDirection, callback: AsyncCallback<AccessibilityElement>): void; | 9 |
| AccessibilityExtensionContext | findElement(type: 'focusDirection', condition: FocusDirection): Promise<AccessibilityElement>; | 9 |
| ohos.accessibility | function on(type: 'accessibilityStateChange', callback: Callback<boolean>): void; | 7 |
| ohos.accessibility | function on(type: 'touchGuideStateChange', callback: Callback<boolean>): void; | 7 |
| ohos.accessibility | function off(type: 'accessibilityStateChange', callback?: Callback<boolean>): void; | 7 |
| ohos.accessibility | function off(type: 'touchGuideStateChange', callback?: Callback<boolean>): void; | 7 |
| ohos.accessibility | function getCaptionsManager(): CaptionsManager; | 8 |
| ohos.application.AccessibilityExtensionAbility | onConnect(): void; | 9 |
| ohos.application.AccessibilityExtensionAbility | onDisconnect(): void; | 9 |
| ohos.application.AccessibilityExtensionAbility | onAccessibilityEvent(event: AccessibilityEvent): void; | 9 |
| ohos.application.AccessibilityExtensionAbility | onKeyEvent(keyEvent: KeyEvent): boolean; | 9 |
| ohos.accessibility.GesturePath | constructor(durationTime: number); | 9 |
| ohos.accessibility.GesturePoint | constructor(positionX: number, positionY: number); | 9 |
- 以下接口删除:
| 所属包名 | 方法声明 | 起始API Level |
|---|---|---|
| AccessibilityExtensionContext | getCursorPosition(callback: AsyncCallback<number>): void; | 12 |
| AccessibilityExtensionContext | getCursorPosition(): Promise<number>; | 12 |
| AccessibilityExtensionContext | findElement(type: 'textType', condition: string): Promise<Array<AccessibilityElement>>; | 12 |
| AccessibilityExtensionContext | findElement(type: 'elementId', condition: number): Promise<AccessibilityElement>; | 12 |
- 设置-辅助功能下,不再提供已安装的服务查询和管理功能。
适配指导
此变更开发者无需适配。
你可能感兴趣的鸿蒙文章
harmony 鸿蒙ArkCompiler子系统Changelog