1# 无障碍子系统Changelog
2
3## cl.accessibility.1 Accessibility扩展服务相关API废弃
4
5**访问级别**
6
7公开接口
8
9**变更原因**
10
11为提升系统安全性,无障碍不再开放扩展服务接口能力。
12
13**变更影响**
14
151. 该变更为不兼容变更;
16
172. Accessibility模块扩展服务接口废弃;
18
193. 设置-辅助功能下,不再提供已安装的服务查询和管理功能。
20
21**变更发生版本**
22
23从OpenHarmony SDK 5.0.0.35开始。
24
25**变更的接口/组件**
26
271. 以下接口废弃:
28
29    | 所属包名         | 方法声明                        |起始API Level|
30    | ----------- | ------------------------- |------------------------- |
31    | AccessibilityExtensionContext | setTargetBundleName(targetNames: Array<string>, callback: AsyncCallback<void>): void;   |9   |
32    | AccessibilityExtensionContext | setTargetBundleName(targetNames: Array<string>): Promise<void>;   |9   |
33    | AccessibilityExtensionContext | getFocusElement(isAccessibilityFocus: boolean, callback: AsyncCallback<AccessibilityElement>): void;   |9   |
34    | AccessibilityExtensionContext | getFocusElement(isAccessibilityFocus?: boolean): Promise<AccessibilityElement>;   |9   |
35    | AccessibilityExtensionContext | getFocusElement(callback: AsyncCallback<AccessibilityElement>): void;   |9   |
36    | AccessibilityExtensionContext | getWindowRootElement(windowId: number, callback: AsyncCallback<AccessibilityElement>): void; |9   |
37    | AccessibilityExtensionContext | getWindowRootElement(windowId?: number): Promise<AccessibilityElement>; |9   |
38    | AccessibilityExtensionContext |  getWindowRootElement(callback: AsyncCallback<AccessibilityElement>): void; |9   |
39    | AccessibilityExtensionContext |  getWindows(displayId: number, callback: AsyncCallback<Array<AccessibilityElement>>): void; |9   |
40    | AccessibilityExtensionContext |   getWindows(displayId?: number): Promise<Array<AccessibilityElement>>; |9   |
41    | AccessibilityExtensionContext |  getWindows(callback: AsyncCallback<Array<AccessibilityElement>>): void; |9   |
42    | AccessibilityExtensionContext |  injectGestureSync(gesturePath: GesturePath): void; |10   |
43    | AccessibilityExtensionContext |   attributeNames<T extends keyof ElementAttributeValues>(callback: AsyncCallback<Array<T>>): void; |9   |
44    | AccessibilityExtensionContext |   attributeNames<T extends keyof ElementAttributeValues>(): Promise<Array<T>>; |9   |
45    | AccessibilityExtensionContext |   attributeValue<T extends keyof ElementAttributeValues>(attributeName: T, callback: AsyncCallback<ElementAttributeValues[T]>): void; |9   |
46    | AccessibilityExtensionContext | attributeValue<T extends keyof ElementAttributeValues>(attributeName: T): Promise<ElementAttributeValues[T]>; |9   |
47    | AccessibilityExtensionContext |   actionNames(callback: AsyncCallback<Array<string>>): void; |9   |
48    | AccessibilityExtensionContext |   actionNames(): Promise<Array<string>>; |9   |
49    | AccessibilityExtensionContext | performAction(actionName: string, parameters: object, callback: AsyncCallback<void>): void; |9   |
50    | AccessibilityExtensionContext |   performAction(actionName: string, parameters?: object): Promise<void>; |9   |
51    | AccessibilityExtensionContext |   performAction(actionName: string, callback: AsyncCallback<void>): void; |9   |
52    | AccessibilityExtensionContext |  findElement(type: 'content', condition: string, callback: AsyncCallback<Array<AccessibilityElement>>): void; |9   |
53    | AccessibilityExtensionContext | findElement(type: 'content', condition: string): Promise<Array<AccessibilityElement>>; |9   |
54    | AccessibilityExtensionContext | findElement(type: 'focusType', condition: FocusType, callback: AsyncCallback<AccessibilityElement>): void; |9   |
55    | AccessibilityExtensionContext | findElement(type: 'focusType', condition: FocusType): Promise<AccessibilityElement>; |9   |
56    | AccessibilityExtensionContext | findElement(type: 'focusDirection', condition: FocusDirection, callback: AsyncCallback<AccessibilityElement>): void; |9   |
57    | AccessibilityExtensionContext |   findElement(type: 'focusDirection', condition: FocusDirection): Promise<AccessibilityElement>; |9   |
58    | ohos.accessibility | function on(type: 'accessibilityStateChange', callback: Callback<boolean>): void; |7   |
59    | ohos.accessibility |  function on(type: 'touchGuideStateChange', callback: Callback<boolean>): void; |7   |
60    | ohos.accessibility | function off(type: 'accessibilityStateChange', callback?: Callback<boolean>): void; |7   |
61    | ohos.accessibility | function off(type: 'touchGuideStateChange', callback?: Callback<boolean>): void; |7   |
62    | ohos.accessibility |   function getCaptionsManager(): CaptionsManager; |8   |
63    | ohos.application.AccessibilityExtensionAbility |   onConnect(): void; |9   |
64    | ohos.application.AccessibilityExtensionAbility |   onDisconnect(): void; |9   |
65    | ohos.application.AccessibilityExtensionAbility |   onAccessibilityEvent(event: AccessibilityEvent): void; |9   |
66    | ohos.application.AccessibilityExtensionAbility |   onKeyEvent(keyEvent: KeyEvent): boolean; |9   |
67    | ohos.accessibility.GesturePath |   constructor(durationTime: number); |9   |
68    | ohos.accessibility.GesturePoint |  constructor(positionX: number, positionY: number); |9   |
69
70
712. 以下接口删除:
72
73    | 所属包名         | 方法声明                        |起始API Level|
74    | ----------- | ------------------------- |------------------------- |
75    | AccessibilityExtensionContext | getCursorPosition(callback: AsyncCallback<number>): void;   |12   |
76    | AccessibilityExtensionContext | getCursorPosition(): Promise<number>;   |12   |
77    | AccessibilityExtensionContext | findElement(type: 'textType', condition: string): Promise<Array<AccessibilityElement>>;   |12   |
78    | AccessibilityExtensionContext | findElement(type: 'elementId', condition: number): Promise<AccessibilityElement>;   |12   |
79
80
813. 设置-辅助功能下,不再提供已安装的服务查询和管理功能。
82
83**适配指导**
84
85此变更开发者无需适配。