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| 201  | Permission verification failed. The application does not have the permission required to call the API.  |
260| 202 | Permission verification failed. A non-system application calls a system API. |
261| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
262
263**示例:**
264
265```ts
266import { config } from '@kit.AccessibilityKit';
267
268config.on('enabledAccessibilityExtensionListChange', () => {
269  console.info('subscribe enabled accessibility extension list change state success');
270});
271```
272
273## off('enabledAccessibilityExtensionListChange')
274
275off(type: 'enabledAccessibilityExtensionListChange', callback?: Callback&lt;void&gt;): void;
276
277需要权限:ohos.permission.READ_ACCESSIBILITY_CONFIG
278
279取消启用的辅助扩展的列表变化监听,使用callback异步回调。
280
281**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
282
283**参数:**
284
285| 参数名 | 类型 | 必填 | 说明 |
286| -------- | -------- | -------- | -------- |
287| type |  string | 是 | 参数固定为enabledAccessibilityExtensionListChange,监听启用的辅助扩展的列表变化。 |
288| callback | Callback&lt;void&gt; | 否 | 取消指定callback对象的事件响应。需与on('enabledAccessibilityExtensionListChange')的callback一致。缺省时,表示注销所有已注册事件。 |
289
290**错误码:**
291
292以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
293
294| 错误码ID | 错误信息 |
295| ------- | -------------------------------- |
296| 201  | Permission verification failed. The application does not have the permission required to call the API.  |
297| 202 | Permission verification failed. A non-system application calls a system API. |
298| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
299
300**示例:**
301
302```ts
303import { config } from '@kit.AccessibilityKit';
304
305config.off('enabledAccessibilityExtensionListChange', () => {
306  console.info('Unsubscribe enabled accessibility extension list change state success');
307});
308```
309
310## on('installedAccessibilityListChange')<sup>12+</sup>
311
312on(type: 'installedAccessibilityListChange', callback: Callback&lt;void&gt;): void;
313
314需要权限:ohos.permission.READ_ACCESSIBILITY_CONFIG
315
316添加已安装的辅助扩展的列表变化监听,使用callback异步回调。
317
318**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
319
320**参数:**
321
322| 参数名 | 类型 | 必填 | 说明 |
323| -------- | -------- | -------- | -------- |
324| type | string | 是 | 参数固定为installedAccessibilityListChange,监听已安装的辅助扩展的列表变化。 |
325| callback | Callback&lt;void&gt; | 是 | 回调函数,在已安装的辅助扩展的列表变化时通过此函数进行通知。 |
326
327**错误码:**
328
329以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
330
331| 错误码ID | 错误信息 |
332| ------- | -------------------------------- |
333| 201  | Permission verification failed. The application does not have the permission required to call the API.  |
334| 202 | Permission verification failed. A non-system application calls a system API. |
335| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
336
337**示例:**
338
339```ts
340import { config } from '@kit.AccessibilityKit';
341
342config.on('installedAccessibilityListChange', () => {
343  console.info('subscribe installed accessibility extension list change state success');
344});
345```
346
347## off('installedAccessibilityListChange')<sup>12+</sup>
348
349off(type: 'installedAccessibilityListChange', callback?: Callback&lt;void&gt;): void;
350
351需要权限:ohos.permission.READ_ACCESSIBILITY_CONFIG
352
353取消已安装的辅助扩展的列表变化监听,使用callback异步回调。
354
355**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
356
357**参数:**
358
359| 参数名 | 类型 | 必填 | 说明 |
360| -------- | -------- | -------- | -------- |
361| type |  string | 是 | 参数固定为installedAccessibilityListChange,监听已安装的辅助扩展的列表变化。 |
362| callback | Callback&lt;void&gt; | 否 | 取消指定callback对象的事件响应。需与on('installedAccessibilityListChange')的callback一致。缺省时,表示注销所有已注册事件。 |
363
364**错误码:**
365
366以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
367
368| 错误码ID | 错误信息 |
369| ------- | -------------------------------- |
370| 201  | Permission verification failed. The application does not have the permission required to call the API.  |
371| 202 | Permission verification failed. A non-system application calls a system API. |
372| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
373
374**示例:**
375
376```ts
377import { config } from '@kit.AccessibilityKit';
378
379config.off('installedAccessibilityListChange', () => {
380  console.info('Unsubscribe installed accessibility extension list change state success');
381});
382```
383
384## Config
385
386用于属性的设置、获取与监听。
387
388### set
389
390set(value: T): Promise&lt;void&gt;;
391
392需要权限:ohos.permission.WRITE_ACCESSIBILITY_CONFIG
393
394设置属性,使用Promise异步回调。
395
396**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
397
398**参数:**
399
400| 参数名 | 类型 | 必填 | 说明 |
401| -------- | -------- | -------- | -------- |
402| value | T | 是 | 设置的属性值。 |
403
404**返回值:**
405
406| 类型 | 说明 |
407| -------- | -------- |
408| Promise&lt;void&gt; | 无返回结果的Promise对象。 |
409
410**错误码:**
411
412以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
413
414| 错误码ID | 错误信息 |
415| ------- | -------------------------------- |
416| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
417| 202 | Permission verification failed. A non-system application calls a system API. |
418| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
419
420**示例:**
421
422```ts
423import { config } from '@kit.AccessibilityKit';
424import { BusinessError } from '@kit.BasicServicesKit';
425
426let value: boolean = true;
427
428config.highContrastText.set(value).then(() => {
429  console.info(`Succeeded in set highContrastText value is ${value}`);
430}).catch((err: BusinessError) => {
431  console.error(`failed to set highContrastText, Code is ${err.code}, message is ${err.message}`);
432});
433```
434
435### set
436
437set(value: T, callback: AsyncCallback&lt;void&gt;): void;
438
439需要权限:ohos.permission.WRITE_ACCESSIBILITY_CONFIG
440
441设置属性,使用callback异步回调。
442
443**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
444
445**参数:**
446
447| 参数名 | 类型 | 必填 | 说明 |
448| -------- | -------- | -------- | -------- |
449| value | T | 是 | 设置的属性值。 |
450| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
451
452**错误码:**
453
454以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
455
456| 错误码ID | 错误信息 |
457| ------- | -------------------------------- |
458| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
459| 202 | Permission verification failed. A non-system application calls a system API. |
460| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
461
462**示例:**
463
464```ts
465import { config } from '@kit.AccessibilityKit';
466import { BusinessError } from '@kit.BasicServicesKit';
467
468let value: boolean = true;
469
470config.highContrastText.set(value, (err: BusinessError) => {
471  if (err) {
472    console.error(`failed to set highContrastText, Code is ${err.code}, message is ${err.message}`);
473    return;
474  }
475  console.info(`Succeeded in set highContrastText, value is ${value}`);
476});
477```
478
479### get
480
481get(): Promise&lt;T&gt;;
482
483获取属性,使用Promise异步回调。
484
485**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
486
487**返回值:**
488
489| 类型 | 说明 |
490| -------- | -------- |
491| Promise&lt;T&gt; | Promise对象,返回对应属性值。 |
492
493**错误码:**
494
495以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
496
497| 错误码ID | 错误信息 |
498| ------- | -------------------------------- |
499| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
500| 202 | Permission verification failed. A non-system application calls a system API. |
501
502**示例:**
503
504```ts
505import { config } from '@kit.AccessibilityKit';
506import { BusinessError } from '@kit.BasicServicesKit';
507
508config.highContrastText.get().then((data: boolean) => {
509  console.info(`Succeeded in get highContrastText, data is ${data}`);
510}).catch((err: BusinessError) => {
511  console.error(`failed to get highContrastText, Code is ${err.code}, message is ${err.message}`);
512});
513```
514
515### get
516
517get(callback: AsyncCallback&lt;T&gt;): void;
518
519获取属性,使用callback异步回调。
520
521**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
522
523**参数:**
524
525| 参数名 | 类型 | 必填 | 说明 |
526| -------- | -------- | -------- | -------- |
527| callback | AsyncCallback&lt;T&gt; | 是 | 回调函数,返回属性值。 |
528
529**错误码:**
530
531以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
532
533| 错误码ID | 错误信息 |
534| ------- | -------------------------------- |
535| 202 | Permission verification failed. A non-system application calls a system API. |
536
537**示例:**
538
539```ts
540import { config } from '@kit.AccessibilityKit';
541import { BusinessError } from '@kit.BasicServicesKit';
542
543config.highContrastText.get((err: BusinessError, data: boolean) => {
544  if (err) {
545    console.error(`failed to get highContrastText, Code is ${err.code}, message is ${err.message}`);
546    return;
547  }
548  console.info(`Succeeded in get highContrastText, data is ${data}`);
549});
550```
551
552### on
553
554on(callback: Callback&lt;T&gt;): void;
555
556需要权限:ohos.permission.READ_ACCESSIBILITY_CONFIG
557
558添加属性变化监听,使用callback异步回调。
559
560**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
561
562**参数:**
563
564| 参数名 | 类型 | 必填 | 说明 |
565| -------- | -------- | -------- | -------- |
566| callback | Callback&lt;T&gt; | 是 | 回调函数,在属性变化时通过此函数进行通知。 |
567
568**错误码:**
569
570以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
571
572| 错误码ID | 错误信息 |
573| ------- | -------------------------------- |
574| 201 | Permission verification failed. The application does not have the permission required to call the API.  |
575| 202 | Permission verification failed. A non-system application calls a system API. |
576| 401  | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
577
578**示例:**
579
580```ts
581import { config } from '@kit.AccessibilityKit';
582
583config.highContrastText.on((data: boolean) => {
584  console.info(`subscribe highContrastText success, result: ${JSON.stringify(data)}`);
585});
586```
587
588### off
589
590off(callback?: Callback&lt;T&gt;): void;
591
592需要权限:ohos.permission.READ_ACCESSIBILITY_CONFIG
593
594取消属性变化监听,使用callback异步回调。
595
596**系统能力**:SystemCapability.BarrierFree.Accessibility.Core
597
598**参数:**
599
600| 参数名 | 类型 | 必填 | 说明 |
601| -------- | -------- | -------- | -------- |
602| callback | Callback&lt;T&gt; | 否 | 取消指定callback对象的事件响应。需与on()的callback一致。缺省时,表示注销所有已注册事件。 |
603
604**错误码:**
605
606以下错误码的详细介绍请参见[无障碍子系统错误码](errorcode-accessibility.md)。
607
608| 错误码ID | 错误信息 |
609| ------- | -------------------------------- |
610| 201  | Permission verification failed. The application does not have the permission required to call the API.  |
611| 202 | Permission verification failed. A non-system application calls a system API. |
612
613**示例:**
614
615```ts
616import { config } from '@kit.AccessibilityKit';
617
618config.highContrastText.off((data: boolean) => {
619  console.info(`Unsubscribe highContrastText success, result: ${JSON.stringify(data)}`);
620});
621```
622
623## DaltonizationColorFilter
624
625用于不同弱视类型的校正颜色滤镜。
626颜色滤镜功能开启时([daltonizationState](#属性)设置为true),颜色滤镜的配置(即设置的DaltonizationColorFilter的值)生效;颜色滤镜功能关闭时([daltonizationState](#属性)设置为false),显示为正常类型<sup>11+</sup>。
627
628**系统能力**:以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core
629
630| 名称 | 说明 |
631| -------- | -------- |
632| Normal | 表示正常类型。 |
633| Protanomaly | 表示红色弱视类型。 |
634| Deuteranomaly | 表示绿色弱视类型。 |
635| Tritanomaly  | 表示蓝色弱视类型。 |
636
637## ClickResponseTime<sup>11+</sup>
638
639用于不同时间长短的点击重复时间。
640
641**系统能力**:以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core
642
643| 名称          | 说明         |
644|-------------|------------|
645| Short       | 表示短 (默认)。  |
646| Medium      | 表示中。       |
647| Long        | 表示长。       |
648
649## RepeatClickInterval<sup>11+</sup>
650
651用于不同时间间隔的忽略重复点击。
652忽略重复点击功能开启时([ignoreRepeatClick](#属性)设置为true),忽略重复点击的配置(即设置的RepeatClickInterval的值)生效;忽略重复点击功能关闭时([ignoreRepeatClick](#属性)设置为false),显示为正常类型。
653
654**系统能力**:以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core
655
656| 名称       | 说明    |
657|----------|-------|
658| Shortest | 表示最短。 |
659| Short    | 表示短。  |
660| Medium   | 表示中。  |
661| Long     | 表示长。  |
662| Longest  | 表示最长。 |
663
664