• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.accessibility.config (系统辅助功能配置)(系统接口)
2
3本模块提供系统辅助功能的配置,包括辅助扩展的启用与关闭、高对比度文字显示、鼠标键、无障碍字幕配置等。
4
5> **说明:**
6>
7> - 本模块首批接口从 API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8> - 本模块接口为系统接口。
9
10## 导入模块
11
12```ts
13import { config } from '@kit.AccessibilityKit';
14```
15
16## 属性
17
18**系统能力**:以下各项对应的系统能力均为SystemCapability.BarrierFree.Accessibility.Core
19
20| 名称                                 | 类型                                                                                         | 可读 | 可写 | 说明                                                        |
21|------------------------------------|--------------------------------------------------------------------------------------------| -------- | -------- |-----------------------------------------------------------|
22| highContrastText                   | [Config](#config)\<boolean>                                                                | 是 | 是 | 表示高对比度文字功能启用状态。                                           |
23| invertColor                        | [Config](#config)\<boolean>                                                                | 是 | 是 | 表示颜色反转功能启用状态。                                             |
24| daltonizationState<sup>11+</sup>   | [Config](#config)\<boolean>                                                                | 是 | 是 | 表示颜色滤镜功能启动状态。配合daltonizationColorFilter使用。                |
25| daltonizationColorFilter           | [Config](#config)&lt;[DaltonizationColorFilter](#daltonizationcolorfilter)&gt;             | 是 | 是 | 表示颜色滤镜功能配置。                                               |
26| contentTimeout                     | [Config](#config)\<number>                                                                 | 是 | 是 | 表示内容显示建议时长配置。取值 0~5000,单位为毫秒。                             |
27| animationOff                       | [Config](#config)\<boolean>                                                                | 是 | 是 | 表示关闭动画功能启用状态。                                             |
28| brightnessDiscount                 | [Config](#config)\<number>                                                                 | 是 | 是 | 表示亮度折扣系统配置。取值 0~1.0。                                      |
29| mouseKey                           | [Config](#config)\<boolean>                                                                | 是 | 是 | 表示鼠标键功能启用状态。                                              |
30| mouseAutoClick                     | [Config](#config)\<number>                                                                 | 是 | 是 | 表示鼠标自动点击功能启用状态。取值 0~5000,单位为毫秒。                           |
31| shortkey                           | [Config](#config)\<boolean>                                                                | 是 | 是 | 表示辅助扩展快捷键功能启用状态。                                          |
32| shortkeyTarget                     | [Config](#config)\<string>                                                                 | 是 | 是 | 表示辅助扩展快捷键的目标配置。取值为辅助应用的名称,格式为:'bundleName/abilityName'。   |
33| captions                           | [Config](#config)\<boolean>                                                                | 是 | 是 | 表示辅助字幕功能启用状态。                                             |
34| captionsStyle                      | [Config](#config)\<[accessibility.CaptionsStyle](js-apis-accessibility.md#captionsstyle8)> | 是 | 是 | 表示辅助字幕的配置。                                                |
35| audioMono<sup>10+</sup>            | [Config](#config)\<boolean>                                                                | 是 | 是 | 表示音频单声道的配置。                                               |
36| audioBalance<sup>10+</sup>         | [Config](#config)\<number>                                                                 | 是 | 是 | 表示左右声道音量平衡的配置。取值 -1.0~1.0。                                |
37| shortkeyMultiTargets<sup>11+</sup> | [Config](#config)&lt;Array\<string>&gt;                                                    | 是 | 是 | 表示辅助扩展快捷键的列表配置。取值为辅助应用的名称,格式为:['bundleName/abilityName']。 |
38| clickResponseTime<sup>11+</sup>    | [Config](#config)&lt;[ClickResponseTime](#clickresponsetime11)&gt;                         | 是 | 是 | 表示点击持续时间功能配置。                                             |
39| ignoreRepeatClick<sup>11+</sup>    | [Config](#config)\<boolean>                                                                | 是 | 是 | 表示忽略重复点击功能启用状态。配合repeatClickInterval使用。                   |
40| repeatClickInterval<sup>11+</sup>  | [Config](#config)&lt;[RepeatClickInterval](#repeatclickinterval11)&gt;                     | 是 | 是 | 表示忽略重复点击功能配置。                                             |
41
42boolean返回值的含义:True表示开启,False表示关闭。
43[]()
44## enableAbility
45
46enableAbility(name: string, capability: Array&lt;accessibility.Capability&gt;): Promise&lt;void&gt;;
47
48需要权限:ohos.permission.WRITE_ACCESSIBILITY_CONFIG
49
50启用辅助扩展,使用Promise异步回调。
51
52**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
53
54**参数:**
55
56| 参数名 | 类型                                                                           | 必填 | 说明 |
57| -------- |------------------------------------------------------------------------------| -------- | -------- |
58| name | string                                                                       | 是 | 辅助应用的名称,格式为:'bundleName/abilityName'。 |
59| capability | Array&lt;[accessibility.Capability](js-apis-accessibility.md#capability)&gt; | 是 | 辅助应用的能力属性。 |
60
61**返回值:**
62
63| 类型 | 说明 |
64| -------- | -------- |
65| Promise&lt;void&gt; | 无返回结果的Promise对象。 |
66
67**错误码:**
68
69以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
70
71| 错误码ID | 错误信息 |
72| ------- | -------------------------------- |
73| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
74| 202 | Permission verification failed. A non-system application calls a system API. |
75| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
76| 9300001 | Invalid bundle name or ability name.  |
77| 9300002 | Target ability already enabled. |
78
79**示例:**
80
81```ts
82import { accessibility, config } from '@kit.AccessibilityKit';
83import { BusinessError } from '@kit.BasicServicesKit';
84
85let name: string = 'com.ohos.example/axExtension';
86let capability: accessibility.Capability[] = ['retrieve'];
87
88config.enableAbility(name, capability).then(() => {
89  console.info(`Succeeded  in enable ability, name is ${name}, capability is ${capability}`);
90}).catch((err: BusinessError) => {
91  console.error(`failed to enable ability, Code is ${err.code}, message is ${err.message}`);
92});
93```
94
95## enableAbility
96
97enableAbility(name: string, capability: Array&lt;[accessibility.Capability](js-apis-accessibility.md#capability)&gt;, callback: AsyncCallback&lt;void&gt;): void;
98
99需要权限:ohos.permission.WRITE_ACCESSIBILITY_CONFIG
100
101启用辅助扩展,使用callback异步回调。
102
103**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
104
105**参数:**
106
107| 参数名 | 类型                                                                              | 必填 | 说明 |
108| -------- |---------------------------------------------------------------------------------| -------- | -------- |
109| name | string                                                                          | 是 | 辅助应用的名称,格式为:'bundleName/abilityName'。 |
110| capability | Array&lt;[accessibility.Capability](js-apis-accessibility.md#capability)&gt; | 是 | 辅助应用的能力属性。 |
111| callback | AsyncCallback&lt;void&gt;                                                       | 是 | 回调函数。 |
112
113**错误码:**
114
115以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
116
117| 错误码ID | 错误信息 |
118| ------- | -------------------------------- |
119| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
120| 202 | Permission verification failed. A non-system application calls a system API. |
121| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
122| 9300001 | Invalid bundle name or ability name.  |
123| 9300002 | Target ability already enabled. |
124
125**示例:**
126
127```ts
128import { accessibility, config } from '@kit.AccessibilityKit';
129import { BusinessError } from '@kit.BasicServicesKit';
130
131let name: string = 'com.ohos.example/axExtension';
132let capability: accessibility.Capability[] = ['retrieve'];
133
134config.enableAbility(name, capability, (err: BusinessError) => {
135  if (err) {
136    console.error(`failed to enable ability, Code is ${err.code}, message is ${err.message}`);
137    return;
138  }
139  console.info(`Succeeded in enable ability, name is ${name}, capability is ${capability}`);
140});
141```
142
143## disableAbility
144
145disableAbility(name: string): Promise&lt;void&gt;;
146
147需要权限:ohos.permission.WRITE_ACCESSIBILITY_CONFIG
148
149关闭辅助扩展,使用Promise异步回调。
150
151**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
152
153**参数:**
154
155| 参数名 | 类型 | 必填 | 说明 |
156| -------- | -------- | -------- | -------- |
157| name | string | 是 | 辅助应用的名称,格式为:'bundleName/abilityName'。 |
158
159**返回值:**
160
161| 类型 | 说明 |
162| -------- | -------- |
163| Promise&lt;void&gt; | 无返回结果的Promise对象。 |
164
165**错误码:**
166
167以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
168
169| 错误码ID | 错误信息 |
170| ------- | -------------------------------- |
171| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
172| 202 | Permission verification failed. A non-system application calls a system API. |
173| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
174| 9300001 | Invalid bundle name or ability name.  |
175
176**示例:**
177
178```ts
179import { accessibility, config } from '@kit.AccessibilityKit';
180import { BusinessError } from '@kit.BasicServicesKit';
181
182let name: string = 'com.ohos.example/axExtension';
183
184config.disableAbility(name).then(() => {
185  console.info(`Succeeded in disable ability, name is ${name}`);
186}).catch((err: BusinessError) => {
187  console.error(`failed to disable ability, Code is ${err.code}, message is ${err.message}`);
188})
189```
190
191## disableAbility
192
193disableAbility(name: string, callback: AsyncCallback&lt;void&gt;): void;
194
195需要权限:ohos.permission.WRITE_ACCESSIBILITY_CONFIG
196
197关闭辅助扩展,使用callback异步回调。
198
199**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
200
201**参数:**
202
203| 参数名 | 类型 | 必填 | 说明 |
204| -------- | -------- | -------- | -------- |
205| name | string | 是 | 辅助应用的名称,格式为:'bundleName/abilityName'。 |
206| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
207
208**错误码:**
209
210以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
211
212| 错误码ID | 错误信息 |
213| ------- | -------------------------------- |
214| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
215| 202 | Permission verification failed. A non-system application calls a system API. |
216| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
217| 9300001 | Invalid bundle name or ability name.  |
218
219**示例:**
220
221```ts
222import { accessibility, config } from '@kit.AccessibilityKit';
223import { BusinessError } from '@kit.BasicServicesKit';
224
225let name: string = 'com.ohos.example/axExtension';
226
227config.disableAbility(name, (err: BusinessError) => {
228  if (err) {
229    console.error(`failed to enable ability, Code is ${err.code}, message is ${err.message}`);
230    return;
231  }
232  console.info(`Succeeded in disable, name is ${name}`);
233});
234```
235
236## on('enabledAccessibilityExtensionListChange')
237
238on(type: 'enabledAccessibilityExtensionListChange', callback: Callback&lt;void&gt;): void;
239
240需要权限:ohos.permission.READ_ACCESSIBILITY_CONFIG
241
242添加启用的辅助扩展的列表变化监听,使用callback异步回调。
243
244**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
245
246**参数:**
247
248| 参数名 | 类型 | 必填 | 说明 |
249| -------- | -------- | -------- | -------- |
250| type | string | 是 | 参数固定为enabledAccessibilityExtensionListChange,监听启用的辅助扩展的列表变化。 |
251| callback | Callback&lt;void&gt; | 是 | 回调函数,在启用的辅助扩展的列表变化时通过此函数进行通知。 |
252
253**错误码:**
254
255以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
256
257| 错误码ID | 错误信息 |
258| ------- | -------------------------------- |
259| 202 | Permission verification failed. A non-system application calls a system API. |
260| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
261
262**示例:**
263
264```ts
265import { config } from '@kit.AccessibilityKit';
266
267config.on('enabledAccessibilityExtensionListChange', () => {
268  console.info('subscribe enabled accessibility extension list change state success');
269});
270```
271
272## off('enabledAccessibilityExtensionListChange')
273
274off(type: 'enabledAccessibilityExtensionListChange', callback?: Callback&lt;void&gt;): void;
275
276需要权限:ohos.permission.READ_ACCESSIBILITY_CONFIG
277
278取消启用的辅助扩展的列表变化监听,使用callback异步回调。
279
280**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
281
282**参数:**
283
284| 参数名 | 类型 | 必填 | 说明 |
285| -------- | -------- | -------- | -------- |
286| type |  string | 是 | 参数固定为enabledAccessibilityExtensionListChange,监听启用的辅助扩展的列表变化。 |
287| callback | Callback&lt;void&gt; | 否 | 取消指定callback对象的事件响应。需与on('enabledAccessibilityExtensionListChange')的callback一致。缺省时,表示注销所有已注册事件。 |
288
289**错误码:**
290
291以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
292
293| 错误码ID | 错误信息 |
294| ------- | -------------------------------- |
295| 202 | Permission verification failed. A non-system application calls a system API. |
296| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
297
298**示例:**
299
300```ts
301import { config } from '@kit.AccessibilityKit';
302
303config.off('enabledAccessibilityExtensionListChange', () => {
304  console.info('Unsubscribe enabled accessibility extension list change state success');
305});
306```
307
308## on('installedAccessibilityListChange')<sup>12+</sup>
309
310on(type: 'installedAccessibilityListChange', callback: Callback&lt;void&gt;): void;
311
312需要权限:ohos.permission.READ_ACCESSIBILITY_CONFIG
313
314添加已安装的辅助扩展的列表变化监听,使用callback异步回调。
315
316**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
317
318**参数:**
319
320| 参数名 | 类型 | 必填 | 说明 |
321| -------- | -------- | -------- | -------- |
322| type | string | 是 | 参数固定为installedAccessibilityListChange,监听已安装的辅助扩展的列表变化。 |
323| callback | Callback&lt;void&gt; | 是 | 回调函数,在已安装的辅助扩展的列表变化时通过此函数进行通知。 |
324
325**错误码:**
326
327以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
328
329| 错误码ID | 错误信息 |
330| ------- | -------------------------------- |
331| 202 | Permission verification failed. A non-system application calls a system API. |
332| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
333
334**示例:**
335
336```ts
337import { config } from '@kit.AccessibilityKit';
338
339config.on('installedAccessibilityListChange', () => {
340  console.info('subscribe installed accessibility extension list change state success');
341});
342```
343
344## off('installedAccessibilityListChange')<sup>12+</sup>
345
346off(type: 'installedAccessibilityListChange', callback?: Callback&lt;void&gt;): void;
347
348需要权限:ohos.permission.READ_ACCESSIBILITY_CONFIG
349
350取消已安装的辅助扩展的列表变化监听,使用callback异步回调。
351
352**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
353
354**参数:**
355
356| 参数名 | 类型 | 必填 | 说明 |
357| -------- | -------- | -------- | -------- |
358| type |  string | 是 | 参数固定为installedAccessibilityListChange,监听已安装的辅助扩展的列表变化。 |
359| callback | Callback&lt;void&gt; | 否 | 取消指定callback对象的事件响应。需与on('installedAccessibilityListChange')的callback一致。缺省时,表示注销所有已注册事件。 |
360
361**错误码:**
362
363以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
364
365| 错误码ID | 错误信息 |
366| ------- | -------------------------------- |
367| 202 | Permission verification failed. A non-system application calls a system API. |
368| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
369
370**示例:**
371
372```ts
373import { config } from '@kit.AccessibilityKit';
374
375config.off('installedAccessibilityListChange', () => {
376  console.info('Unsubscribe installed accessibility extension list change state success');
377});
378```
379
380## Config
381
382用于属性的设置、获取与监听。
383
384### set
385
386set(value: T): Promise&lt;void&gt;;
387
388需要权限:ohos.permission.WRITE_ACCESSIBILITY_CONFIG
389
390设置属性,使用Promise异步回调。
391
392**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
393
394**参数:**
395
396| 参数名 | 类型 | 必填 | 说明 |
397| -------- | -------- | -------- | -------- |
398| value | T | 是 | 设置的属性值。 |
399
400**返回值:**
401
402| 类型 | 说明 |
403| -------- | -------- |
404| Promise&lt;void&gt; | 无返回结果的Promise对象。 |
405
406**错误码:**
407
408以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
409
410| 错误码ID | 错误信息 |
411| ------- | -------------------------------- |
412| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
413| 202 | Permission verification failed. A non-system application calls a system API. |
414| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
415
416**示例:**
417
418```ts
419import { config } from '@kit.AccessibilityKit';
420import { BusinessError } from '@kit.BasicServicesKit';
421
422let value: boolean = true;
423
424config.highContrastText.set(value).then(() => {
425  console.info(`Succeeded in set highContrastText value is ${value}`);
426}).catch((err: BusinessError) => {
427  console.error(`failed to set highContrastText, Code is ${err.code}, message is ${err.message}`);
428});
429```
430
431### set
432
433set(value: T, callback: AsyncCallback&lt;void&gt;): void;
434
435需要权限:ohos.permission.WRITE_ACCESSIBILITY_CONFIG
436
437设置属性,使用callback异步回调。
438
439**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
440
441**参数:**
442
443| 参数名 | 类型 | 必填 | 说明 |
444| -------- | -------- | -------- | -------- |
445| value | T | 是 | 设置的属性值。 |
446| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
447
448**错误码:**
449
450以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
451
452| 错误码ID | 错误信息 |
453| ------- | -------------------------------- |
454| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
455| 202 | Permission verification failed. A non-system application calls a system API. |
456| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
457
458**示例:**
459
460```ts
461import { config } from '@kit.AccessibilityKit';
462import { BusinessError } from '@kit.BasicServicesKit';
463
464let value: boolean = true;
465
466config.highContrastText.set(value, (err: BusinessError) => {
467  if (err) {
468    console.error(`failed to set highContrastText, Code is ${err.code}, message is ${err.message}`);
469    return;
470  }
471  console.info(`Succeeded in set highContrastText, value is ${value}`);
472});
473```
474
475### get
476
477get(): Promise&lt;T&gt;;
478
479获取属性,使用Promise异步回调。
480
481**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
482
483**返回值:**
484
485| 类型 | 说明 |
486| -------- | -------- |
487| Promise&lt;T&gt; | Promise对象,返回对应属性值。 |
488
489**错误码:**
490
491以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
492
493| 错误码ID | 错误信息 |
494| ------- | -------------------------------- |
495| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
496| 202 | Permission verification failed. A non-system application calls a system API. |
497
498**示例:**
499
500```ts
501import { config } from '@kit.AccessibilityKit';
502import { BusinessError } from '@kit.BasicServicesKit';
503
504config.highContrastText.get().then((data: boolean) => {
505  console.info(`Succeeded in get highContrastText, data is ${data}`);
506}).catch((err: BusinessError) => {
507  console.error(`failed to get highContrastText, Code is ${err.code}, message is ${err.message}`);
508});
509```
510
511### get
512
513get(callback: AsyncCallback&lt;T&gt;): void;
514
515获取属性,使用callback异步回调。
516
517**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
518
519**参数:**
520
521| 参数名 | 类型 | 必填 | 说明 |
522| -------- | -------- | -------- | -------- |
523| callback | AsyncCallback&lt;T&gt; | 是 | 回调函数,返回属性值。 |
524
525**错误码:**
526
527以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
528
529| 错误码ID | 错误信息 |
530| ------- | -------------------------------- |
531| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
532| 202 | Permission verification failed. A non-system application calls a system API. |
533
534**示例:**
535
536```ts
537import { config } from '@kit.AccessibilityKit';
538import { BusinessError } from '@kit.BasicServicesKit';
539
540config.highContrastText.get((err: BusinessError, data: boolean) => {
541  if (err) {
542    console.error(`failed to get highContrastText, Code is ${err.code}, message is ${err.message}`);
543    return;
544  }
545  console.info(`Succeeded in get highContrastText, data is ${data}`);
546});
547```
548
549### on
550
551on(callback: Callback&lt;T&gt;): void;
552
553需要权限:ohos.permission.READ_ACCESSIBILITY_CONFIG
554
555添加属性变化监听,使用callback异步回调。
556
557**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
558
559**参数:**
560
561| 参数名 | 类型 | 必填 | 说明 |
562| -------- | -------- | -------- | -------- |
563| callback | Callback&lt;T&gt; | 是 | 回调函数,在属性变化时通过此函数进行通知。 |
564
565**错误码:**
566
567以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
568
569| 错误码ID | 错误信息 |
570| ------- | -------------------------------- |
571| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
572| 202 | Permission verification failed. A non-system application calls a system API. |
573| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
574
575**示例:**
576
577```ts
578import { config } from '@kit.AccessibilityKit';
579
580config.highContrastText.on((data: boolean) => {
581  console.info(`subscribe highContrastText success, result: ${JSON.stringify(data)}`);
582});
583```
584
585### off
586
587off(callback?: Callback&lt;T&gt;): void;
588
589需要权限:ohos.permission.READ_ACCESSIBILITY_CONFIG
590
591取消属性变化监听,使用callback异步回调。
592
593**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
594
595**参数:**
596
597| 参数名 | 类型 | 必填 | 说明 |
598| -------- | -------- | -------- | -------- |
599| callback | Callback&lt;T&gt; | 否 | 取消指定callback对象的事件响应。需与on()的callback一致。缺省时,表示注销所有已注册事件。 |
600
601**错误码:**
602
603以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
604
605| 错误码ID | 错误信息 |
606| ------- | -------------------------------- |
607| 202 | Permission verification failed. A non-system application calls a system API. |
608
609**示例:**
610
611```ts
612import { config } from '@kit.AccessibilityKit';
613
614config.highContrastText.off((data: boolean) => {
615  console.info(`Unsubscribe highContrastText success, result: ${JSON.stringify(data)}`);
616});
617```
618
619## DaltonizationColorFilter
620
621用于不同弱视类型的校正颜色滤镜。
622颜色滤镜功能开启时([daltonizationState](#属性)设置为true),颜色滤镜的配置(即设置的DaltonizationColorFilter的值)生效;颜色滤镜功能关闭时([daltonizationState](#属性)设置为false),显示为正常类型<sup>11+</sup>。
623
624**系统能力**:以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core
625
626| 名称 | 说明 |
627| -------- | -------- |
628| Normal | 表示正常类型。 |
629| Protanomaly | 表示红色弱视类型。 |
630| Deuteranomaly | 表示绿色弱视类型。 |
631| Tritanomaly  | 表示蓝色弱视类型。 |
632
633## ClickResponseTime<sup>11+</sup>
634
635用于不同时间长短的点击重复时间。
636
637**系统能力**:以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core
638
639| 名称          | 说明         |
640|-------------|------------|
641| Short       | 表示短 (默认)。  |
642| Medium      | 表示中。       |
643| Long        | 表示长。       |
644
645## RepeatClickInterval<sup>11+</sup>
646
647用于不同时间间隔的忽略重复点击。
648忽略重复点击功能开启时([ignoreRepeatClick](#属性)设置为true),忽略重复点击的配置(即设置的RepeatClickInterval的值)生效;忽略重复点击功能关闭时([ignoreRepeatClick](#属性)设置为false),显示为正常类型。
649
650**系统能力**:以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core
651
652| 名称       | 说明    |
653|----------|-------|
654| Shortest | 表示最短。 |
655| Short    | 表示短。  |
656| Medium   | 表示中。  |
657| Long     | 表示长。  |
658| Longest  | 表示最长。 |
659
660