From e98b9d60d9d10c8ef3d03f69eaad891a7b9fd198 Mon Sep 17 00:00:00 2001 From: zaki Date: Tue, 18 Oct 2022 22:22:01 +0800 Subject: [PATCH] Modify the accessible subsystem document and add the description of the api error code Signed-off-by: zaki Change-Id: I5b687b801855bbf51cea600847e116179706889a --- .../apis/js-apis-accessibility-GesturePath.md | 4 +- .../js-apis-accessibility-GesturePoint.md | 4 +- .../apis/js-apis-accessibility-config.md | 412 ++++++++----- ...js-apis-accessibility-extension-context.md | 567 +++++++++++------- .../reference/apis/js-apis-accessibility.md | 472 ++++++++++++--- ...plication-AccessibilityExtensionAbility.md | 38 +- .../errorcodes/errorcode-accessibility.md | 96 +++ 7 files changed, 1110 insertions(+), 483 deletions(-) create mode 100644 zh-cn/application-dev/reference/errorcodes/errorcode-accessibility.md diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePath.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePath.md index 738f1d435c..89e43e02cb 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePath.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePath.md @@ -11,7 +11,7 @@ GesturePath表示手势路径信息。 ## 导入模块 ```ts -import GesturePath from "@ohos.accessibility.GesturePath"; +import GesturePath from '@ohos.accessibility.GesturePath'; ``` ## GesturePath @@ -43,7 +43,7 @@ constructor(durationTime: number); **示例：** -```typescript +```ts let durationTime = 20; let gesturePath = new GesturePath(durationTime); ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePoint.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePoint.md index b5a2cd1a6c..d787f38222 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePoint.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePoint.md @@ -11,7 +11,7 @@ GesturePoint表示手势触摸点。 ## 导入模块 ```ts -import GesturePoint from "@ohos.accessibility.GesturePoint"; +import GesturePoint from '@ohos.accessibility.GesturePoint'; ``` ## GesturePoint @@ -44,7 +44,7 @@ constructor(positionX: number, positionY: number); **示例：** -```typescript +```ts let positionX = 1; let positionY = 2; let gesturePoint = new GesturePoint(positionX, positionY); diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility-config.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility-config.md index 8ef198195d..4d7842e341 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility-config.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility-config.md @@ -8,8 +8,8 @@ ## 导入模块 -```typescript -import config from "@ohos.accessibility.config"; +```ts +import config from '@ohos.accessibility.config'; ``` ## 属性 @@ -27,171 +27,243 @@ import config from "@ohos.accessibility.config"; | mouseKey | [Config](#config)\| 是 | 是 | 表示鼠标键功能启用状态。 | | mouseAutoClick | [Config](#config)\| 是 | 是 | 表示鼠标自动点击功能启用状态。取值 0~5000，单位为毫秒。 | | shortkey | [Config](#config)\| 是 | 是 | 表示辅助扩展快捷键功能启用状态。 | -| shortkeyTarget | [Config](#config)\| 是 | 是 | 表示辅助扩展快捷键的目标配置。取值为辅助应用的名称，格式为："bundleName/abilityName"。 | +| shortkeyTarget | [Config](#config)\| 是 | 是 | 表示辅助扩展快捷键的目标配置。取值为辅助应用的名称，格式为：'bundleName/abilityName'。 | | captions | [Config](#config)\| 是 | 是 | 表示辅助字幕功能启用状态。 | -| captionsStyle | [Config](#config)\<[accessibility.CaptionsStyle](./js-apis-accessibility.md#captionsstyle8)>| 是 | 是 | 表示辅助字幕的配置。 | +| captionsStyle | [Config](#config)\<[CaptionsStyle](js-apis-accessibility.md#captionsstyle8)>| 是 | 是 | 表示辅助字幕的配置。 | ## enableAbility -enableAbility(name: string, capability: Array<[accessibility.Capability](./js-apis-accessibility.md#capability)>): Promise<void>; +enableAbility(name: string, capability: Array<accessibility.Capability>): Promise<void>; -启用辅助扩展。 +启用辅助扩展，使用Promise异步回调。 **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | name | string | 是 | 辅助应用的名称，格式为："bundleName/abilityName"。 | - | capability | Array<[accessibility.Capability](./js-apis-accessibility.md#capability)>) | 是 | 辅助应用的能力属性。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| name | string | 是 | 辅助应用的名称，格式为：'bundleName/abilityName'。 | +| capability | Array<[accessibility.Capability](js-apis-accessibility.md#capability)>) | 是 | 辅助应用的能力属性。 | **返回值：** - | 类型 | 说明 | - | -------- | -------- | - | Promise<void> | Promise实例，用于返回方法执行结果。 | +| 类型 | 说明 | +| -------- | -------- | +| Promise<void> | 无返回结果的Promise对象。 | + +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300001 | Invalid bundle name or ability name. | +| 9300002 | Target ability already enabled. | **示例：** - ```typescript - config.enableAbility("com.ohos.example/axExtension", ['retrieve']) - .then(() => { - console.info('enable succeed'); - }).catch((error) => { - console.error('enable failed'); - }); +```ts +let name = 'com.ohos.example/axExtension'; +let capability = ['retrieve']; +try { + config.enableAbility(name, capability).then(() => { + console.info('enable ability succeed'); + }).catch((err) => { + console.error('failed to enable ability, because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to enable ability, because ' + JSON.stringify(exception)); +}; ``` ## enableAbility -enableAbility(name: string, capability: Array<[accessibility.Capability](./js-apis-accessibility.md#capability)>, callback: AsyncCallback<void>): void; +enableAbility(name: string, capability: Array<accessibility.Capability>, callback: AsyncCallback<void>): void; -启用辅助扩展。 +启用辅助扩展，使用callback异步回调。 **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | name | string | 是 | 辅助应用的名称，格式为："bundleName/abilityName"。 | - | capability | Array<[accessibility.Capability](./js-apis-accessibility.md#capability)> | 是 | 辅助应用的能力属性。 | - | callback | AsyncCallback<void> | 是 | 回调函数，返回方法执行结果。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| name | string | 是 | 辅助应用的名称，格式为：'bundleName/abilityName'。 | +| capability | Array<[accessibility.Capability](js-apis-accessibility.md#capability)> | 是 | 辅助应用的能力属性。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | + +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300001 | Invalid bundle name or ability name. | +| 9300002 | Target ability already enabled. | **示例：** - ```typescript - config.enableAbility("com.ohos.example/axExtension", ['retrieve'], (err, data) => { - if (err) { - console.error('enable failed'); - return; - } - console.info('enable succeed'); - }) - ``` +```ts +let name = 'com.ohos.example/axExtension'; +let capability = ['retrieve']; +try { + config.enableAbility(name, capability, (err, data) => { + if (err) { + console.error('failed to enable ability, because ' + JSON.stringify(err)); + return; + } + console.info('enable ability succeed'); + }); +} catch (exception) { + console.error('failed to enable ability, because ' + JSON.stringify(exception)); +}; +``` ## disableAbility disableAbility(name: string): Promise<void>; -关闭辅助扩展。 +关闭辅助扩展，使用Promise异步回调。 **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | name | string | 是 | 辅助应用的名称，格式为："bundleName/abilityName"。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| name | string | 是 | 辅助应用的名称，格式为：'bundleName/abilityName'。 | **返回值：** - | 类型 | 说明 | - | -------- | -------- | - | Promise<void> | Promise实例，用于返回方法执行结果。 | +| 类型 | 说明 | +| -------- | -------- | +| Promise<void> | 无返回结果的Promise对象。 | + +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300001 | Invalid bundle name or ability name. | **示例：** - ```typescript - config.disableAbility("com.ohos.example/axExtension") - .then(() => { - console.info('disable succeed'); - }).catch((error) => { - console.error('disable failed'); - }); - ``` +```ts +let name = 'com.ohos.example/axExtension'; +try { + config.enableAbility(name).then(() => { + console.info('disable ability succeed'); + }).catch((err) => { + console.error('failed to disable ability, because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to disable ability, because ' + JSON.stringify(exception)); +}; +``` ## disableAbility disableAbility(name: string, callback: AsyncCallback<void>): void; -关闭辅助扩展。 +关闭辅助扩展，使用callback异步回调。 **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | name | string | 是 | 辅助应用的名称，格式为："bundleName/abilityName"。 | - | callback | AsyncCallback<void> | 是 | 回调函数，返回方法执行结果。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| name | string | 是 | 辅助应用的名称，格式为：'bundleName/abilityName'。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | + +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300001 | Invalid bundle name or ability name. | **示例：** - ```typescript - config.disableAbility("com.ohos.example/axExtension", (err, data) => { - if (err) { - console.error('disable failed'); - return; - } - console.info('disable succeed'); - }) - ``` +```ts +let name = 'com.ohos.example/axExtension'; +try { + config.disableAbility(name, (err, data) => { + if (err) { + console.error('failed to enable ability, because ' + JSON.stringify(err)); + return; + } + console.info('disable succeed'); + }); +} catch (exception) { + console.error('failed to enable ability, because ' + JSON.stringify(exception)); +}; +``` -## on('enableAbilityListsStateChanged') +## on('enabledAccessibilityExtensionListChange') -on(type: 'enableAbilityListsStateChanged', callback: Callback<void>): void; +on(type: 'enabledAccessibilityExtensionListChange', callback: Callback<void>): void; -添加启用的辅助扩展的列表变化监听。 +添加启用的辅助扩展的列表变化监听，使用callback异步回调。 **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | type | string | 是 | 参数固定为enableAbilityListsStateChanged，监听启用的辅助扩展的列表变化。 | - | callback | Callback<void> | 是 | 回调函数，在启用的辅助扩展的列表变化时通过此函数进行通知。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| type | string | 是 | 参数固定为enabledAccessibilityExtensionListChange，监听启用的辅助扩展的列表变化。 | +| callback | Callback<void> | 是 | 回调函数，在启用的辅助扩展的列表变化时通过此函数进行通知。 | **示例：** - ```typescript - config.on('enableAbilityListsStateChanged',() => { - console.info('ax extension ability enable list changed'); - }); - ``` +```ts +try { + config.on('enabledAccessibilityExtensionListChange', () => { + console.info('subscribe enabled accessibility extension list change state success'); + }).catch((err) => { + console.error('failed to subscribe enabled accessibility extension list change state, because ' + + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to subscribe enabled accessibility extension list change state, because ' + + JSON.stringify(exception)); +}; +``` -## off('enableAbilityListsStateChanged') +## off('enabledAccessibilityExtensionListChange') -off(type: 'enableAbilityListsStateChanged', callback?: Callback<void>): void; +off(type: 'enabledAccessibilityExtensionListChange', callback?: Callback<void>): void; -取消启用的辅助扩展的列表变化监听。 +取消启用的辅助扩展的列表变化监听，使用callback异步回调。 **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | type | string | 否 | 参数固定为enableAbilityListsStateChanged，监听启用的辅助扩展的列表变化。 | - | callback | Callback<void> | 否 | 要取消的监听回调函数。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| type | string | 否 | 参数固定为enabledAccessibilityExtensionListChange，监听启用的辅助扩展的列表变化。 | +| callback | Callback<void> | 否 | 要取消的监听回调函数。 | **示例：** - ```typescript - config.off('enableAbilityListsStateChanged'); - ``` +```ts +try { + config.off('enabledAccessibilityExtensionListChange', () => { + console.info('unSubscribe enabled accessibility extension list change state success'); + }).catch((err) => { + console.error('failed to unSubscribe enabled accessibility extension list change state, because ' + + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to unSubscribe enabled accessibility extension list change state, because ' + + JSON.stringify(exception)); +}; +``` ## Config @@ -201,152 +273,178 @@ off(type: 'enableAbilityListsStateChanged', callback?: Callback<void>): vo set(value: T): Promise<void>; -设置属性。 +设置属性，使用Promise异步回调。 **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | value | T | 是 | 设置的属性值。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| value | T | 是 | 设置的属性值。 | **返回值：** - | 类型 | 说明 | - | -------- | -------- | - | Promise<void> | Promise实例，用于返回方法执行结果。 | +| 类型 | 说明 | +| -------- | -------- | +| Promise<void> | 无返回结果的Promise对象。 | **示例：** - ```typescript - config.highContrastText.set(true) - .then(() => { - console.info('highContrastText set succeed'); - }).catch((error) => { - console.error('highContrastText set failed'); - }); - ``` +```ts +let value = true; +try { + config.highContrastText.set(value).then(() => { + console.info('set highContrastText succeed'); + }).catch((err) => { + console.error('failed to set highContrastText, because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to set config, because ' + JSON.stringify(exception)); +}; +``` ### set set(value: T, callback: AsyncCallback<void>): void; -设置属性。 +设置属性，使用callback异步回调。 **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | value | T | 是 | 设置的属性值。 | - | callback | AsyncCallback<void> | 是 | 回调函数，返回方法执行结果。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| value | T | 是 | 设置的属性值。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | **示例：** - ```typescript - config.highContrastText.set(true, (err, data) => { - if (err) { - console.error('highContrastText set failed'); - return; - } - console.info('highContrastText set succeed'); - }) - ``` +```ts +let value = true; +try { + config.highContrastText.set(value, (err, data) => { + if (err) { + console.error('failed to set highContrastText, because ' + JSON.stringify(err)); + return; + } + console.info('set highContrastText succeed'); + }); +} catch (exception) { + console.error('failed to set config, because ' + JSON.stringify(exception)); +}; +``` ### get get(): Promise<T>; -获取属性。 +获取属性，使用Promise异步回调。 **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **返回值：** - | 类型 | 说明 | - | -------- | -------- | - | Promise<T> | Promise实例，用于返回属性值。 | +| 类型 | 说明 | +| -------- | -------- | +| Promise<T> | Promise对象，返回对应属性值。 | **示例：** - ```typescript - config.highContrastText.get() - .then((value) => { - console.info('highContrastText get succeed'); - }).catch((error) => { - console.error('highContrastText get failed'); - }); - ``` +```ts +let value; +config.highContrastText.get().then((data) => { + value = data; + console.info('get highContrastText success'); +}).catch((err) => { + console.error('failed to get highContrastText, because ' + JSON.stringify(err)); +}); +``` ### get get(callback: AsyncCallback<T>): void; -获取属性。 +获取属性，使用callback异步回调。 **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | callback | AsyncCallback<void> | 是 | 回调函数，返回属性值。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| callback | AsyncCallback<void> | 是 | 回调函数，返回属性值。 | **示例：** - ```typescript - config.highContrastText.get((err, data) => { - if (err) { - console.error('highContrastText get failed'); - return; - } - console.info('highContrastText get succeed'); - }) - ``` +```ts +let value; +config.highContrastText.get((err, data) => { + if (err) { + console.error('failed to get highContrastText, because ' + JSON.stringify(err)); + return; + } + value = data; + console.info('get highContrastText success'); +}); +``` ### on on(callback: Callback<T>): void; -添加属性变化监听。 +添加属性变化监听，使用callback异步回调。 **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | callback | Callback<T> | 是 | 回调函数，在属性变化时通过此函数进行通知。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| callback | Callback<T> | 是 | 回调函数，在属性变化时通过此函数进行通知。 | **示例：** - ```typescript - config.highContrastText.on(() => { - console.info('highContrastText changed'); - }); - ``` +```ts +try { + config.highContrastText.on((err, data) => { + if (err) { + console.error('failed subscribe highContrastText, because ' + JSON.stringify(err)); + return; + } + console.info('subscribe highContrastText success'); + }); +} catch (exception) { + console.error('failed subscribe highContrastText, because ' + JSON.stringify(exception)); +} +``` ### off off(callback?: Callback<T>): void; -取消属性变化监听。 +取消属性变化监听，使用callback异步回调。 **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** - | 参数名 | 参数类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | callback | Callback<T> | 否 | 要取消的监听回调函数。 | +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| callback | Callback<T> | 否 | 要取消的监听回调函数。 | **示例：** - ```typescript - config.highContrastText.off(); - ``` +```ts +config.highContrastText.off((err, data) => { + if (err) { + console.error('failed unSubscribe highContrastText, because ' + JSON.stringify(err)); + return; + } + console.info('unSubscribe highContrastText success'); +}); +``` ## DaltonizationColorFilter diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility-extension-context.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility-extension-context.md index b82d3dfc5a..83dbfdf4b0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility-extension-context.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility-extension-context.md @@ -11,14 +11,15 @@ AccessibilityExtensionContext是AccessibilityExtensionAbility上下文环境， ## 使用说明 -在使用AccessibilityExtensionContext的功能前，需要通过AccessibilityExtensionAbility子类实例获取。 +在使用AccessibilityExtensionContext的功能前，需要通过AccessibilityExtensionAbility子类实例获取AccessibilityExtensionContex的实例。 ```js import AccessibilityExtensionAbility from '@ohos.application.AccessibilityExtensionAbility' +let axContext; class MainAbility extends AccessibilityExtensionAbility { onConnect(): void { console.log('AxExtensionAbility onConnect'); - let axContext = this.context; + axContext = this.context; } } ``` @@ -97,11 +98,15 @@ setTargetBundleName(targetNames: Array\): Promise\; ```ts let targetNames = ['com.ohos.xyz']; -this.context.setTargetBundleName().then(() => { - console.info('set target bundle names success'); -}).catch((err) => { - console.error('failed to set target bundle names because ' + JSON.stringify(err)); -}); +try { + axContext.setTargetBundleName(targetNames).then(() => { + console.info('set target bundle names success'); + }).catch((err) => { + console.error('failed to set target bundle names, because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to set target bundle names, because ' + JSON.stringify(exception)); +}; ``` ## AccessibilityExtensionContext.setTargetBundleName @@ -123,13 +128,17 @@ setTargetBundleName(targetNames: Array\, callback: AsyncCallback\) ```ts let targetNames = ['com.ohos.xyz']; -this.context.setTargetBundleName().then((err, data) => { - if (err) { - console.error('failed to set target bundle names because ' + JSON.stringify(err)); - return; - } - console.info('set target bundle names success'); -}); +try { + axContext.setTargetBundleName(targetNames, (err, data) => { + if (err) { + console.error('failed to set target bundle names, because ' + JSON.stringify(err)); + return; + } + console.info('set target bundle names success'); + }); +} catch (exception) { + console.error('failed to set target bundle names, because ' + JSON.stringify(exception)); +}; ``` ## AccessibilityExtensionContext.getFocusElement @@ -152,16 +161,28 @@ getFocusElement(isAccessibilityFocus?: boolean): Promise\; | ----------------------------------- | ---------------------- | | Promise<AccessibilityElement> | Promise对象，返回当前对应的焦点元素。 | +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300003 | Do not have accessibility right for this operation. | + **示例：** ```ts let focusElement; -this.context.getFocusElement().then((data) => { - focusElement = data; - console.log('get focus element success'); -}).catch((err) => { - console.error('failed to get focus element because ' + JSON.stringify(err)); -}); +try { + axContext.getFocusElement().then((data) => { + focusElement = data; + console.log('get focus element success'); + }).catch((err) => { + console.error('failed to get focus element, because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to get focus element, because ' + JSON.stringify(exception)); +} ``` ## AccessibilityExtensionContext.getFocusElement @@ -178,18 +199,29 @@ getFocusElement(callback: AsyncCallback\): void; | -------- | -------- | -------- | -------- | | callback | AsyncCallback<AccessibilityElement> | 是 | 回调函数，返回当前对应的焦点元素。 | +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300003 | Do not have accessibility right for this operation. | + **示例：** ```ts -let focusElement; -this.context.getFocusElement().then((err, data) => { - if (err) { - console.error('failed to get focus element because ' + JSON.stringify(err)); - return; - } - focusElement = data; - console.info('get focus element success'); -}); +try { + axContext.getFocusElement((err, data) => { + if (err) { + console.error('failed to get focus element, because ' + JSON.stringify(err)); + return; + } + focusElement = data; + console.info('get focus element success'); + }); +} catch (exception) { + console.error('failed to get focus element, because ' + JSON.stringify(exception)); +} ``` ## AccessibilityExtensionContext.getFocusElement @@ -210,15 +242,18 @@ getFocusElement(isAccessibilityFocus: boolean, callback: AsyncCallback\ { +try { + axContext.getFocusElement(isAccessibilityFocus, (err, data) => { if (err) { - console.error('failed to get focus element because ' + JSON.stringify(err)); + console.error('failed to get focus element, because ' + JSON.stringify(err)); return; } focusElement = data; console.info('get focus element success'); }); +} catch (exception) { + console.error('failed to get focus element, because ' + JSON.stringify(exception)); +} ``` ## AccessibilityExtensionContext.getWindowRootElement @@ -240,16 +275,28 @@ getWindowRootElement(windowId?: number): Promise\; | ----------------------------------- | ---------------------- | | Promise<AccessibilityElement> | Promise对象，返回指定屏幕的所有窗口。 | +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300003 | Do not have accessibility right for this operation. | + **示例：** ```ts let rootElement; -this.context.getWindowRootElement().then((data) => { - rootElement = data; - console.log('get root element of the window success'); -}).catch((err) => { - console.error('failed to get root element of the window because ' + JSON.stringify(err)); -}); +try { + axContext.getWindowRootElement().then((data) => { + rootElement = data; + console.log('get root element of the window success'); + }).catch((err) => { + console.error('failed to get root element of the window, because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to get root element of the window, ' + JSON.stringify(exception)); +} ``` ## AccessibilityExtensionContext.getWindowRootElement @@ -266,18 +313,29 @@ getWindowRootElement(callback: AsyncCallback\): void; | -------- | -------- | -------- | -------- | | callback | AsyncCallback<AccessibilityElement> | 是 | 回调函数，返回指定窗口的根节点元素。 | +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300003 | Do not have accessibility right for this operation. | + **示例：** ```ts -let rootElement; -this.context.getWindowRootElement().then((err, data) => { +try { + axContext.getWindowRootElement((err, data) => { if (err) { - console.error('failed to get root element of the window because ' + JSON.stringify(err)); + console.error('failed to get root element of the window, because ' + JSON.stringify(err)); return; } rootElement = data; console.info('get root element of the window success'); }); +} catch (exception) { + console.error('failed to get root element of the window, because ' + JSON.stringify(exception)); +} ``` ## AccessibilityExtensionContext.getWindowRootElement @@ -295,19 +353,29 @@ getWindowRootElement(windowId: number, callback: AsyncCallback\ { +try { + axContext.getWindowRootElement(windowId, (err, data) => { if (err) { - console.error('failed to get root element of the window because ' + JSON.stringify(err)); + console.error('failed to get root element of the window, because ' + JSON.stringify(err)); return; } rootElement = data; console.info('get root element of the window success'); }); +} catch (exception) { + console.error('failed to get root element of the window, because ' + JSON.stringify(exception)); +} ``` ## AccessibilityExtensionContext.getWindows @@ -330,16 +398,28 @@ getWindows(displayId?: number): Promise\>; | ----------------------------------- | ---------------------- | | Promise<Array<AccessibilityElement>> | Promise对象，返回指定屏幕的所有窗口。 | +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300003 | Do not have accessibility right for this operation. | + **示例：** ```ts let windows; -this.context.getWindows().then((data) => { - windows = data; - console.log('get windows success'); -}).catch((err) => { - console.error('failed to get windows because ' + JSON.stringify(err)); -}); +try { + axContext.getWindows().then((data) => { + windows = data; + console.log('get windows success'); + }).catch((err) => { + console.error('failed to get windows, because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to get windows, because ' + JSON.stringify(exception)); +} ``` ## AccessibilityExtensionContext.getWindows @@ -356,18 +436,30 @@ getWindows(callback: AsyncCallback\>): void; | -------- | -------- | -------- | -------- | | callback | AsyncCallback<Array<AccessibilityElement>> | 是 | 回调函数，返回指定屏幕的所有窗口。 | +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300003 | Do not have accessibility right for this operation. | + **示例：** ```ts let windows; -this.context.getWindows().then((err, data) => { - if (err) { - console.error('failed to get windows because ' + JSON.stringify(err)); - return; - } - windows = data; - console.info('get windows success'); -}); +try { + axContext.getWindows((err, data) => { + if (err) { + console.error('failed to get windows, because ' + JSON.stringify(err)); + return; + } + windows = data; + console.info('get windows success'); + }); +} catch (exception) { + console.error('failed to get windows, because ' + JSON.stringify(exception)); +} ``` ## AccessibilityExtensionContext.getWindows @@ -385,19 +477,31 @@ getWindows(displayId: number, callback: AsyncCallback\ { - if (err) { - console.error('failed to get windows because ' + JSON.stringify(err)); - return; - } - windows = data; - console.info('get windows success'); -}); +let displayId = 10; +try { + axContext.getWindows(displayId, (err, data) => { + if (err) { + console.error('failed to get windows, because ' + JSON.stringify(err)); + return; + } + windows = data; + console.info('get windows success'); + }); +} catch (exception) { + console.error('failed to get windows, because ' + JSON.stringify(exception)); +} ``` ## AccessibilityExtensionContext.injectGesture @@ -420,20 +524,32 @@ injectGesture(gesturePath: GesturePath): Promise\; | ----------------------------------- | ---------------------- | | Promise<void> | 无返回结果的Promise对象。 | +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300003 | Do not have accessibility right for this operation. | + **示例：** ```ts -import { GesturePath } from "../@ohos.accessibility.GesturePath"; +import GesturePath from "@ohos.accessibility.GesturePath"; let gesturePath = new GesturePath(100); -for (let i = 0; i < 10; i++) { - let gesturePoint = new GesturePosition(100, i * 200); - gesturePath.positions.push(gesturePoint); +try { + for (let i = 0; i < 10; i++) { + let gesturePoint = new GesturePoint(100, i * 200); + gesturePath.points.push(gesturePoint); + } + axContext.injectGesture(gesturePath).then(() => { + console.info('inject gesture success'); + }).catch((err) => { + console.error('failed to inject gesture, because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to inject gesture, because ' + JSON.stringify(exception)); } -this.context.gestureInject(gesturePath, () => { - console.info('inject gesture success'); -}).catch((err) => { - console.error('failed to inject gesture because ' + JSON.stringify(err)); -}); ``` ## AccessibilityExtensionContext.injectGesture @@ -450,25 +566,38 @@ injectGesture(gesturePath: GesturePath, callback: AsyncCallback\): void | gesturePath | [GesturePath](js-apis-accessibility-GesturePath.md#gesturepath) | 是 | 表示手势的路径信息。 | | callback | AsyncCallback<void> | 是 | 回调函数，表示注入手势执行结果的回调。 | +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300003 | Do not have accessibility right for this operation. | + **示例：** ```ts +import GesturePath from "@ohos.accessibility.GesturePath"; let gesturePath = new GesturePath(100); -for (let i = 0; i < 10; i++) { - let gesturePoint = new GesturePosition(100, i * 200); - gesturePath.positions.push(gesturePoint); -} -this.context.gestureInject(gesturePath, (err, data) => { - if (err) { - console.error('failed to inject gesture because ' + JSON.stringify(err)); - return; +try { + for (let i = 0; i < 10; i++) { + let gesturePoint = new GesturePoint(100, i * 200); + gesturePath.points.push(gesturePoint); } - console.info('inject gesture success'); -}); + axContext.injectGesture(gesturePath, (err, data) => { + if (err) { + console.error('failed to inject gesture, because ' + JSON.stringify(err)); + return; + } + console.info('inject gesture success'); + }); +} catch (exception) { + console.error('failed to inject gesture, because ' + JSON.stringify(exception)); +} ``` -## AccessibilityElement9 +## AccessibilityElement9+ -无障碍节点元素。 +无障碍节点元素, 在调用AccessibilityElement的方法前，需要先通过[AccessibilityExtensionContext.getFocusElement()](#accessibilityextensioncontextgetfocuselement)或者[AccessibilityExtensionContext.getWindowRootElement()](#accessibilityextensioncontextgetwindowrootelement)获取AccessibilityElement实例。 **系统能力**：以下各项对应的系统能力均为SystemCapability.BarrierFree.Accessibility.Core @@ -489,18 +618,14 @@ attributeNames\(): Promise\>; **示例：** ```ts -let accessibilityElement; +let rootElement; let attributeNames; -try { - accessibilityElement.attributeNames().then((data) => { - console.log('get attribute names success'); - attributeNames = data; - }).catch((err) => { - console.log('get attribute names err: ' + JSON.stringify(err)); - }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); -} +rootElement.attributeNames().then((data) => { + console.log('get attribute names success'); + attributeNames = data; +}).catch((err) => { + console.log('failed to get attribute names, because ' + JSON.stringify(err)); +}); ``` ## attributeNames @@ -519,20 +644,16 @@ attributeNames\(callback: AsyncCallback\ **示例：** ```ts -let accessibilityElement; +let rootElement; let attributeNames; -try { - accessibilityElement.attributeNames().then((err, data) => { - if (err) { - console.error('failed to get attribute names because ' + JSON.stringify(err)); - return; - } - attributeNames = data; - console.info('get attribute names success'); - }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); -} +rootElement.attributeNames((err, data) => { + if (err) { + console.error('failed to get attribute names, because ' + JSON.stringify(err)); + return; + } + attributeNames = data; + console.info('get attribute names success'); +}); ``` ## AccessibilityElement.attributeValue @@ -554,21 +675,27 @@ attributeValue\(attributeName: T): Promi | ---------------------------------------- | ------------------------ | | Promise<ElementAttributeValues[T]> | Promise对象，返回根据节点属性名称获取的属性值。 | +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300004 | This property does not exist. | + **示例：** ```ts -let accessibilityElement; -let attributeValue; +let attributeName = 'name'; try { - let attributeName = 'name'; - accessibilityElement.attributeValue(attributeName).then((data) => { + rootElement.attributeValue(attributeName).then((data) => { console.log('get attribute value by name success'); attribtueValue = data; }).catch((err) => { - console.log('get attribute value by name err: ' + JSON.stringify(err)); + console.log('failed to get attribute value, because ' + JSON.stringify(err)); }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); +} catch (exception) { + console.log('failed to get attribute value, because ' + JSON.stringify(exception)); } ``` ## AccessibilityElement.attributeValue @@ -587,23 +714,31 @@ attributeValue\(attributeName: T, | attributeName | T | 是 | 表示属性的名称。 | | callback | AsyncCallback<ElementAttributeValues[T]> | 是 | 回调函数，返回根据节点属性名称获取的属性值。 | +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300004 | This property does not exist. | + **示例：** ```ts -let accessibilityElement; +let rootElement; let attributeValue; +let attributeName = 'name'; try { - let attributeName = 'name'; - accessibilityElement.attributeValue(attributeName).then((err, data) => { + rootElement.attributeValue(attributeName, (err, data) => { if (err) { - console.error('failed to get attribute value because ' + JSON.stringify(err)); + console.error('failed to get attribute value, because ' + JSON.stringify(err)); return; } attributeValue = data; console.info('get attribute value success'); }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); +} catch (exception) { + console.log('failed to get attribute value, because ' + JSON.stringify(exception)); } ``` ## actionNames @@ -623,18 +758,14 @@ actionNames(): Promise\>; **示例：** ```ts -let accessibilityElement; +let rootElement; let actionNames; -try { - accessibilityElement.actionNames().then((data) => { - console.log('get action names success'); - actionNames = data; - }).catch((err) => { - console.log('get action names err: ' + JSON.stringify(err)); - }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); -} +rootElement.actionNames().then((data) => { + console.log('get action names success'); + actionNames = data; +}).catch((err) => { + console.log('failed to get action names because ' + JSON.stringify(err)); +}); ``` ## actionNames @@ -653,20 +784,16 @@ actionNames(callback: AsyncCallback\>): void; **示例：** ```ts -let accessibilityElement; +let rootElement; let actionNames; -try { - accessibilityElement.actionNames().then((err, data) => { - if (err) { - console.error('failed to get action names because ' + JSON.stringify(err)); - return; - } - actionNames = data; - console.info('get action names success'); - }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); -} +rootElement.actionNames((err, data) => { + if (err) { + console.error('failed to get action names, because ' + JSON.stringify(err)); + return; + } + actionNames = data; + console.info('get action names success'); +}); ``` ## performAction @@ -689,20 +816,28 @@ performAction(actionName: string, parameters?: object): Promise\; | ---------------------------------------- | ------------------------ | | Promise<boolean> | Promise对象，返回执行指定操作后的回调结果，true为执行成功，false为执行失败。 | +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300005 | This action is not supported. | + **示例：** ```ts -let accessibilityElement; +let rootElement; let performActionRes; try { - accessibilityElement.performAction('action').then((data) => { + rootElement.performAction('action').then((data) => { console.info('perform action success'); performActionRes = data; }).catch((err) => { - console.log('failed to perform action because ' + JSON.stringify(err)); + console.log('failed to perform action, because ' + JSON.stringify(err)); }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); +} catch (exception) { + console.log('failed to perform action, because ' + JSON.stringify(exception)); } ``` ## performAction @@ -718,24 +853,32 @@ performAction(actionName: string, callback: AsyncCallback\): void; | 参数名 | 参数类型 | 必填 | 说明 | | ----------- | ---------------------------------------- | ---- | -------------- | | actionName | string | 是 | 表示属性的名称。 | -| callback | AsyncCallback<boolean> | 是 | 回调函数，返回执行指定操作后的回调结果，true为执行成功，false为执行失败。 | +| callback | AsyncCallback<boolean> | 是 | 回调函数，返回执行指定操作后的回调结果，true为执行成功，false为执行失败。| + +**错误码：** + +以下错误码的详细介绍请参见[无障碍子系统错误码](../errorcodes/errorcode-accessibility.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 9300005 | This action is not supported. | **示例：** ```ts -let accessibilityElement; +let rootElement; let performActionRes; try { - accessibilityElement.performAction('action').then((err, data) => { + rootElement.performAction('action', (err, data) => { if (err) { - console.error('failed to perform action because ' + JSON.stringify(err)); + console.error('failed to perform action, because ' + JSON.stringify(err)); return; } performActionRes = data; console.info('perform action success'); }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); +} catch (exception) { + console.log('failed to perform action, because ' + JSON.stringify(exception)); } ``` ## performAction @@ -752,35 +895,43 @@ performAction(actionName: string, parameters: object, callback: AsyncCallback\ { + rootElement.performAction(actionName, parameters, (err, data) => { if (err) { - console.error('failed to perform action because ' + JSON.stringify(err)); + console.error('failed to perform action, because ' + JSON.stringify(err)); return; } performActionRes = data; console.info('perform action success'); }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); +} catch (exception) { + console.log('failed to perform action, because ' + JSON.stringify(exception)); } ``` ## findElement('content') findElement(type: 'content', condition: string): Promise\>; -根据节点内容查询所有节点元素。 +根据节点内容查询所有节点元素，使用Promise异步回调。 **系统能力：** SystemCapability.BarrierFree.Accessibility.Core @@ -800,19 +951,19 @@ findElement(type: 'content', condition: string): Promise\ { + rootElement.findElement(type, condition).then((data) => { elements = data; console.log('find element success'); }).catch((err) => { - console.log('failed to find element because ' + JSON.stringify(err)); + console.log('failed to find element, because ' + JSON.stringify(err)); }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); +} catch (exception) { + console.log('failed to find element, because ' + JSON.stringify(exception)); } ``` ## findElement('content') @@ -834,28 +985,28 @@ findElement(type: 'content', condition: string, callback: AsyncCallback\ { + rootElement.findElement(type, condition, (err, data) => { if (err) { - console.error('failed to find element because ' + JSON.stringify(err)); + console.error('failed to find element, because ' + JSON.stringify(err)); return; } elements = data; console.info('find element success'); }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); +} catch (exception) { + console.log('failed to find element, because ' + JSON.stringify(exception)); } ``` ## findElement('focusType') findElement(type: 'focusType', condition: FocusType): Promise\; -根据焦点元素类型查询节点元素。 +根据焦点元素类型查询节点元素，使用Promise异步回调。 **系统能力：** SystemCapability.BarrierFree.Accessibility.Core @@ -875,26 +1026,26 @@ findElement(type: 'focusType', condition: FocusType): Promise\ { - elements = data; + rootElement.findElement(type, condition).then((data) => { + element = data; console.log('find element success'); }).catch((err) => { - console.log('failed to find element because ' + JSON.stringify(err)); + console.log('failed to find element, because ' + JSON.stringify(err)); }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); +} catch (exception) { + console.log('failed to find element, because ' + JSON.stringify(exception)); } ``` ## findElement('focusType') findElement(type: 'focusType', condition: FocusType, callback: AsyncCallback\): void; -根据焦点元素类型查询节点元素。 +根据焦点元素类型查询节点元素，使用callback异步回调。 **系统能力：** SystemCapability.BarrierFree.Accessibility.Core @@ -909,28 +1060,28 @@ findElement(type: 'focusType', condition: FocusType, callback: AsyncCallback\ { + rootElement.findElement(type, condition, (err, data) => { if (err) { - console.error('failed to find element because ' + JSON.stringify(err)); + console.error('failed to find element, because ' + JSON.stringify(err)); return; } - elements = data; + element = data; console.info('find element success'); }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); +} catch (exception) { + console.log('failed to find element, because ' + JSON.stringify(exception)); } ``` ## findElement('focusDirection') findElement(type: 'focusDirection', condition: FocusDirection): Promise\; -根据下一焦点元素方向查询节点元素。 +根据下一焦点元素方向查询节点元素，使用Promise异步回调。 **系统能力：** SystemCapability.BarrierFree.Accessibility.Core @@ -950,26 +1101,26 @@ findElement(type: 'focusDirection', condition: FocusDirection): Promise\ { - elements = data; + rootElement.findElement(type, condition).then((data) => { + element = data; console.log('find element success'); }).catch((err) => { - console.log('failed to find element because ' + JSON.stringify(err)); + console.log('failed to find element, because ' + JSON.stringify(err)); }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); +} catch (exception) { + console.log('failed to find element, because ' + JSON.stringify(exception)); } ``` ## findElement('focusDirection') findElement(type: 'focusDirection', condition: FocusDirection, callback: AsyncCallback\): void; -根据下一焦点元素方向查询所有节点元素。 +根据下一焦点元素方向查询所有节点元素，使用callback异步回调。 **系统能力：** SystemCapability.BarrierFree.Accessibility.Core @@ -984,20 +1135,20 @@ findElement(type: 'focusDirection', condition: FocusDirection, callback: AsyncCa **示例：** ```ts -let accessibilityElement; +let rootElement; let type = 'focusDirection'; let condition = 'up'; let elements; try { - accessibilityElement.findElement(type, condition).then((err, data) => { + rootElement.findElement(type, condition, (err, data) => { if (err) { - console.error('failed to find element because ' + JSON.stringify(err)); + console.error('failed to find element, because ' + JSON.stringify(err)); return; } elements = data; console.info('find element success'); }); -} catch (e) { - console.log('An unexpected error occurred. Error:' + e); +} catch (exception) { + console.log('failed to find element, because ' + JSON.stringify(exception)); } ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md index 77311ac0c1..b36394fe89 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md @@ -7,7 +7,7 @@ ## 导入模块 -```typescript +```ts import accessibility from '@ohos.accessibility'; ``` @@ -144,7 +144,7 @@ import accessibility from '@ohos.accessibility'; ## CaptionsManager8+ -字幕配置管理，在调用CaptionsManager的方法前，需要先通过 [accessibility.getCaptionsManager()](#accessibilitygetcaptionsmanager8)获取 captionsManager实例。 +字幕配置管理，在调用CaptionsManager的方法前，需要先通过 [accessibility.getCaptionsManager()](#accessibilitygetcaptionsmanager8)获取 CaptionsManager实例。 **系统能力**：以下各项对应的系统能力均为SystemCapability.BarrierFree.Accessibility.Hearing @@ -159,7 +159,7 @@ import accessibility from '@ohos.accessibility'; on(type: 'enableChange', callback: Callback<boolean>): void; -监听字幕配置启用状态变化事件。 +监听字幕配置启用状态变化事件，使用callback异步回调。 **参数：** @@ -170,18 +170,28 @@ on(type: 'enableChange', callback: Callback<boolean>): void; **示例：** - ```typescript - let captionsManager = accessibility.getCaptionsManager(); - captionsManager.on('enableChange',(data) => { - console.info('success data:subscribeStateObserver : ' + JSON.stringify(data)) - }); - ``` +```ts +let result = false; +let captionsManager = accessibility.getCaptionsManager(); +try { + captionsManager.on('enableChange', (err, data) => { + if (err) { + console.error('failed to subscribe caption manager enable state change, because ' + JSON.stringify(err)); + return; + } + result = data; + console.info('subscribe caption manager enable state change success'); + }); +} catch (exception) { + console.error('failed to subscribe caption manager enable state change, because ' + JSON.stringify(exception)); +} +``` ### on('styleChange') on(type: 'styleChange', callback: Callback<CaptionsStyle>): void; -监听字幕风格变化事件。 +监听字幕风格变化事件，使用callback异步回调。 **参数：** @@ -192,18 +202,28 @@ on(type: 'styleChange', callback: Callback<CaptionsStyle>): void; **示例：** - ```typescript - let captionsManager = accessibility.getCaptionsManager(); - captionsManager.on('styleChange',(data) => { - console.info('success data:subscribeStateObserver : ' + JSON.stringify(data)) - }); - ``` +```ts +let captionStyle; +let captionsManager = accessibility.getCaptionsManager(); +try { + captionsManager.on('styleChange', (err, data) => { + if (err) { + console.error('failed to subscribe caption manager style state change, because ' + JSON.stringify(err)); + return; + } + captionStyle = data; + console.info('subscribe caption manager style state change success'); + }); +} catch (exception) { + console.error('failed to subscribe caption manager style state change, because ' + JSON.stringify(exception)); +} +``` ### off('enableChange') off(type: 'enableChange', callback?: Callback<boolean>): void; -取消监听字幕配置启用状态变化事件。 +取消监听字幕配置启用状态变化事件，使用callback异步回调。 **参数：** @@ -214,18 +234,28 @@ off(type: 'enableChange', callback?: Callback<boolean>): void; **示例：** - ```typescript - let captionsManager = accessibility.getCaptionsManager(); - captionsManager.off('enableChange',(data) => { - console.info('success data:unSubscribeStateObserver : ' + JSON.stringify(data)) - }); - ``` +```ts +let result = false; +let captionsManager = accessibility.getCaptionsManager(); +try { + captionsManager.off('enableChange', (err, data) => { + if (err) { + console.error('failed to unSubscribe caption manager enable state change, because ' + JSON.stringify(err)); + return; + } + result = data; + console.info('unSubscribe caption manager enable state change success'); + }); +} catch (exception) { + console.error('failed to unSubscribe caption manager enable state change, because ' + JSON.stringify(exception)); +} +``` ### off('styleChange') off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; -取消字幕风格变化监听事件。 +取消字幕风格变化监听事件，使用callback异步回调。 **参数：** @@ -236,12 +266,22 @@ off(type: 'styleChange', callback?: Callback<CaptionsStyle>): void; **示例：** - ```typescript - let captionsManager = accessibility.getCaptionsManager(); - captionsManager.off('styleChange',(data) => { - console.info('success data:unSubscribeStateObserver : ' + JSON.stringify(data)) - }); - ``` +```ts +let captionStyle; +let captionsManager = accessibility.getCaptionsManager(); +try { + captionsManager.off('styleChange', (err, data) => { + if (err) { + console.error('failed to unSubscribe caption manager style state change, because ' + JSON.stringify(err)); + return; + } + captionStyle = data; + console.info('unSubscribe caption manager style state change success'); + }); +} catch (exception) { + console.error('failed to unSubscribe caption manager style state change, because ' + JSON.stringify(exception)); +} +``` ## EventInfo @@ -284,11 +324,11 @@ constructor(jsonObject) **示例：** - ```typescript + ```ts let eventInfo = new accessibility.EventInfo({ - "type":"click", - "bundleName":"com.example.MyApplication", - "triggerAction":"click" + 'type':'click', + 'bundleName':'com.example.MyApplication', + 'triggerAction':'click' }); ``` @@ -340,12 +380,17 @@ constructor(jsonObject) | active | 窗口变为活动或不活动的窗口变化事件。 | | focus | 窗口焦点发生变化的窗口变化事件。 | -## accessibility.getAbilityLists +## accessibility.getAbilityLists(deprecated) getAbilityLists(abilityType: AbilityType, stateType: AbilityState): Promise<Array<AccessibilityAbilityInfo>> 查询辅助应用列表，使用Promise异步回调。 +> **说明：** +> +> 从API version 7开始支持，从API version 9开始废弃。 +> 推荐使用[getAccessibilityExtensionList()](#accessibilitygetaccessibilityextensionlist9)。 + **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** @@ -363,26 +408,39 @@ getAbilityLists(abilityType: AbilityType, stateType: AbilityState): Promise<A **示例：** -```typescript -accessibility.getAbilityLists("spoken", "enable").then((data) => { - console.info('success data:getAbilityList1 : ' + JSON.stringify(data)); - for (let item of data) { - console.info(item.id); - console.info(item.name); - console.info(item.description); - console.info(item.bundleName); - } -}).catch((err) => { - console.error('failed to getAbilityList1 because ' + JSON.stringify(err)); -}); +```ts +let abilityType = 'spoken'; +let abilityState = 'enable'; +let abilityList: accessibility.AccessibilityInfo[]; +try { + accessibility.getAbilityLists(abilityType, abilityState).then((data) => { + for (let item of data) { + console.info(item.id); + console.info(item.name); + console.info(item.description); + console.info(item.bundleName); + extensionList.push(item); + } + console.info('get accessibility extension list success'); + }).catch((err) => { + console.error('failed to get accessibility extension list because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to get accessibility extension list because ' + JSON.stringify(exception)); +} ``` -## accessibility.getAbilityLists +## accessibility.getAbilityLists(deprecated) getAbilityLists(abilityType: AbilityType, stateType: AbilityState,callback: AsyncCallback<Array<AccessibilityAbilityInfo>>): void 查询辅助应用列表，使用callback异步回调。 +> **说明：** +> +> 从API version 7开始支持，从API version 9开始废弃。 +> 推荐使用[getAccessibilityExtensionList()](#accessibilitygetaccessibilityextensionlist9-1)。 + **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** @@ -395,21 +453,120 @@ getAbilityLists(abilityType: AbilityType, stateType: AbilityState,callback: Asyn **示例：** -```typescript -accessibility.getAbilityLists("visual", "enable", (err, data) => { - if (err) { - console.error('failed to getAbilityList2 because ' + JSON.stringify(err)); - return; - } - console.info('success data:getAbilityList2 : ' + JSON.stringify(data)); - for (let item of data) { - console.info(item.id); - console.info(item.name); - console.info(item.description); - console.info(item.bundleName); - } -}); - ``` +```ts +let abilityType = 'spoken'; +let abilityState = 'enable'; +let abilityList: accessibility.AccessibilityInfo[]; +try { + accessibility.getAbilityLists(abilityType, abilityState, (err, data) => { + if (err) { + console.error('failed to get accessibility extension list because ' + JSON.stringify(err)); + return; + } + for (let item of data) { + console.info(item.id); + console.info(item.name); + console.info(item.description); + console.info(item.bundleName); + abilityList.push(item); + } + console.info('get accessibility extension list success'); + }).catch((err) => { + console.error('failed to get accessibility extension list because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to get accessibility extension list because ' + JSON.stringify(exception)); +} +``` + +## accessibility.getAccessibilityExtensionList9+ + +getAccessibilityExtensionList(abilityType: AbilityType, stateType: AbilityState): Promise<Array<AccessibilityAbilityInfo>> + +查询辅助应用列表，使用Promise异步回调。 + +**系统能力**：SystemCapability.BarrierFree.Accessibility.Core + +**参数：** + +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| abilityType | [AbilityType](#abilitytype) | 是 | 辅助应用的类型。 | +| stateType | [AbilityState](#abilitystate) | 是 | 辅助应用的状态。 | + +**返回值：** + +| 类型 | 说明 | +| -------- | -------- | +| Promise<Array<[AccessibilityAbilityInfo](#accessibilityabilityinfo)>> | Promise对象，返回辅助应用信息列表。 | + +**示例：** + +```ts +let abilityType = 'spoken'; +let abilityState = 'enable'; +let extensionList: accessibility.AccessibilityInfo[]; +try { + accessibility.getAccessibilityExtensionList(abilityType, abilityState).then((data) => { + for (let item of data) { + console.info(item.id); + console.info(item.name); + console.info(item.description); + console.info(item.bundleName); + extensionList.push(item); + } + console.info('get accessibility extension list success'); + }).catch((err) => { + console.error('failed to get accessibility extension list because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to get accessibility extension list because ' + JSON.stringify(exception)); +} +``` + +## accessibility.getAccessibilityExtensionList9+ + +getAccessibilityExtensionList(abilityType: AbilityType, stateType: AbilityState,callback: AsyncCallback<Array<AccessibilityAbilityInfo>>): void + +查询辅助应用列表，使用callback异步回调。 + +**系统能力**：SystemCapability.BarrierFree.Accessibility.Core + +**参数：** + +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| abilityType | [AbilityType](#abilitytype) | 是 | 辅助应用的类型。 | +| stateType | [AbilityState](#abilitystate) | 是 | 辅助应用的状态。 | +| callback | AsyncCallback<Array<[AccessibilityAbilityInfo](#accessibilityabilityinfo)>> | 是 | 回调函数，返回辅助应用信息列表。 | + +**示例：** + +```ts +let abilityType = 'spoken'; +let abilityState = 'enable'; +let extensionList: accessibility.AccessibilityInfo[]; +try { + accessibility.getAccessibilityExtensionList(abilityType, abilityState, (err, data) => { + if (err) { + console.error('failed to get accessibility extension list because ' + JSON.stringify(err)); + return; + } + for (let item of data) { + console.info(item.id); + console.info(item.name); + console.info(item.description); + console.info(item.bundleName); + extensionList.push(item); + } + console.info('get accessibility extension list success'); + }).catch((err) => { + console.error('failed to get accessibility extension list because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to get accessibility extension list because ' + JSON.stringify(exception)); +} +``` ## accessibility.getCaptionsManager8+ @@ -427,7 +584,7 @@ getCaptionsManager(): CaptionsManager **示例：** -```typescript +```ts let captionsManager = accessibility.getCaptionsManager(); ``` @@ -435,7 +592,7 @@ let captionsManager = accessibility.getCaptionsManager(); on(type: 'accessibilityStateChange', callback: Callback<boolean>): void -监听辅助应用启用状态变化事件。 +监听辅助应用启用状态变化事件，使用callback异步回调。 **系统能力**：以下各项对应的系统能力有所不同，详见下表。 @@ -448,17 +605,25 @@ on(type: 'accessibilityStateChange', callback: Callback<boolean>): void **示例：** -```typescript -accessibility.on('accessibilityStateChange',(data) => { - console.info('success data:subscribeStateObserver : ' + JSON.stringify(data)) -}); +```ts +try { + accessibility.on('accessibilityStateChange', (err, data) => { + if (err) { + console.error('failed to subscribe accessibility state change, because ' + JSON.stringify(err)); + return; + } + console.info('subscribe accessibility state change success'); + }); +} catch (exception) { + console.error('failed to subscribe accessibility state change, because ' + JSON.stringify(exception)); +} ``` ## accessibility.on('touchGuideStateChange') on(type: 'touchGuideStateChange', callback: Callback<boolean>): void -监听触摸浏览功能启用状态变化事件。 +监听触摸浏览功能启用状态变化事件，使用callback异步回调。 **系统能力**：以下各项对应的系统能力有所不同，详见下表。 @@ -471,17 +636,25 @@ on(type: 'touchGuideStateChange', callback: Callback<boolean>): void **示例：** -```typescript -accessibility.on('touchGuideStateChange',(data) => { - console.info('success data:subscribeStateObserver : ' + JSON.stringify(data)) -}); +```ts +try { + accessibility.on('touchGuideStateChange', (err, data) => { + if (err) { + console.error('failed to subscribe touch guide state change, because ' + JSON.stringify(err)); + return; + } + console.info('subscribe touch guide state change success'); + }); +} catch (exception) { + console.error('failed to subscribe touch guide state change, because ' + JSON.stringify(exception)); +} ``` ## accessibility.off('accessibilityStateChange') off(type: 'accessibilityStateChange', callback?: Callback<boolean>): void -取消监听辅助应用启用状态变化事件。 +取消监听辅助应用启用状态变化事件，使用callback异步回调。 **系统能力**：以下各项对应的系统能力有所不同，详见下表。 @@ -494,17 +667,25 @@ off(type: 'accessibilityStateChange', callback?: Callback<boolean>): void **示例：** -```typescript -accessibility.off('accessibilityStateChange',(data) => { - console.info('success data:unSubscribeStateObserver : ' + JSON.stringify(data)) -}); +```ts +try { + accessibility.on('accessibilityStateChange', (err, data) => { + if (err) { + console.error('failed to unSubscribe accessibility state change, because ' + JSON.stringify(err)); + return; + } + console.info('unSubscribe accessibility state change success'); + }); +} catch (exception) { + console.error('failed to unSubscribe accessibility state change, because ' + JSON.stringify(exception)); +} ``` ## accessibility.off('touchGuideStateChange') off(type: 'touchGuideStateChange', callback?: Callback<boolean>): void -取消监听触摸浏览启用状态变化事件。 +取消监听触摸浏览启用状态变化事件，使用callback异步回调。 **系统能力**：以下各项对应的系统能力有所不同，详见下表。 @@ -517,10 +698,18 @@ off(type: 'touchGuideStateChange', callback?: Callback<boolean>): void **示例：** -```typescript -accessibility.off('touchGuideStateChange',(data) => { - console.info('success data:unSubscribeStateObserver : ' + JSON.stringify(data)) -}); +```ts +try { + accessibility.on('touchGuideStateChange', (err, data) => { + if (err) { + console.error('failed to unSubscribe touch guide state change, because ' + JSON.stringify(err)); + return; + } + console.info('unSubscribe touch guide state change success'); + }); +} catch (exception) { + console.error('failed to unSubscribe touch guide state change, because ' + JSON.stringify(exception)); +} ``` ## accessibility.isOpenAccessibility @@ -539,7 +728,7 @@ isOpenAccessibility(): Promise<boolean> **示例：** -```typescript +```ts accessibility.isOpenAccessibility().then((data) => { console.info('success data:isOpenAccessibility : ' + JSON.stringify(data)) }).catch((err) => { @@ -563,7 +752,7 @@ isOpenAccessibility(callback: AsyncCallback<boolean>): void **示例：** -```typescript +```ts accessibility.isOpenAccessibility((err, data) => { if (err) { console.error('failed to isOpenAccessibility because ' + JSON.stringify(err)); @@ -589,7 +778,7 @@ isOpenTouchGuide(): Promise<boolean> **示例：** -```typescript +```ts accessibility.isOpenTouchGuide().then((data) => { console.info('success data:isOpenTouchGuide : ' + JSON.stringify(data)) }).catch((err) => { @@ -613,7 +802,7 @@ isOpenTouchGuide(callback: AsyncCallback<boolean>): void **示例：** -```typescript +```ts accessibility.isOpenTouchGuide((err, data) => { if (err) { console.error('failed to isOpenTouchGuide because ' + JSON.stringify(err)); @@ -623,12 +812,17 @@ accessibility.isOpenTouchGuide((err, data) => { }); ``` -## accessibility.sendEvent +## accessibility.sendEvent(deprecated) sendEvent(event: EventInfo): Promise<void> 发送无障碍事件, 使用Promise异步回调。 +> **说明：** +> +> 从API version 7开始支持，从API version 9开始废弃。 +> 推荐使用[sendAccessibilityEvent()](#accessibilitysendaccessibilityevent9)。 + **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** @@ -645,11 +839,11 @@ sendEvent(event: EventInfo): Promise<void> **示例：** -```typescript +```ts let eventInfo = new accessibility.EventInfo({ - "type":"click", - "bundleName":"com.example.MyApplication", - "triggerAction":"click" + 'type':'click', + 'bundleName':'com.example.MyApplication', + 'triggerAction':'click' }); accessibility.sendEvent(eventInfo).then(() => { console.info('send event success'); @@ -658,12 +852,17 @@ accessibility.sendEvent(eventInfo).then(() => { }); ``` -## accessibility.sendEvent +## accessibility.sendEvent(deprecated) sendEvent(event: EventInfo, callback: AsyncCallback<void>): void 发送无障碍事件, 使用callback异步回调。 +> **说明：** +> +> 从API version 7开始支持，从API version 9开始废弃。 +> 推荐使用[sendAccessibilityEvent()](#accessibilitysendaccessibilityevent9-1)。 + **系统能力**：SystemCapability.BarrierFree.Accessibility.Core **参数：** @@ -675,11 +874,11 @@ sendEvent(event: EventInfo, callback: AsyncCallback<void>): void **示例：** -```typescript +```ts let eventInfo = new accessibility.EventInfo({ - "type":"click", - "bundleName":"com.example.MyApplication", - "triggerAction":"click" + 'type':'click', + 'bundleName':'com.example.MyApplication', + 'triggerAction':'click' }); accessibility.sendEvent(eventInfo, (err, data) => { if (err) { @@ -688,4 +887,79 @@ accessibility.sendEvent(eventInfo, (err, data) => { } console.info('sendEvent success'); }); - ``` +``` + +## accessibility.sendAccessibilityEvent9+ + +sendAccessibilityEvent(event: EventInfo): Promise<void> + +发送无障碍事件, 使用Promise异步回调。 + +**系统能力**：SystemCapability.BarrierFree.Accessibility.Core + +**参数：** + +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| event | [EventInfo](#eventinfo) | 是 | 无障碍事件对象。 | + +**返回值：** + +| 类型 | 说明 | +| -------- | -------- | +| Promise<void> | 无返回结果的Promise对象。 | + +**示例：** + +```ts +let eventInfo = new accessibility.EventInfo({ + 'type':'click', + 'bundleName':'com.example.MyApplication', + 'triggerAction':'click' +}); +try { + accessibility.sendAccessibilityEvent(eventInfo).then(() => { + console.info('send event success'); + }).catch((err) => { + console.error('failed to send event because ' + JSON.stringify(err)); + }); +} catch (exception) { + console.error('failed to send event because ' + JSON.stringify(exception)); +} +``` + +## accessibility.sendAccessibilityEvent9+ + +sendAccessibilityEvent(event: EventInfo, callback: AsyncCallback<void>): void + +发送无障碍事件, 使用callback异步回调。 + +**系统能力**：SystemCapability.BarrierFree.Accessibility.Core + +**参数：** + +| 参数名 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| event | [EventInfo](#eventinfo) | 是 | 辅助事件对象。 | +| callback | AsyncCallback<void> | 是 | 回调函数，如果发送无障碍事件失败，则 AsyncCallback中err有数据返回。 | + +**示例：** + +```ts +let eventInfo = new accessibility.EventInfo({ + 'type':'click', + 'bundleName':'com.example.MyApplication', + 'triggerAction':'click' +}); +try { + accessibility.sendEvent(eventInfo, (err, data) => { + if (err) { + console.error('failed to send event because ' + JSON.stringify(err)); + return; + } + console.info('send event success'); + }); +} catch (exception) { + console.error('failed to send event because ' + JSON.stringify(exception)); +} +``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-AccessibilityExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-application-AccessibilityExtensionAbility.md index ea67b7e858..46efda3887 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-AccessibilityExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-AccessibilityExtensionAbility.md @@ -94,8 +94,10 @@ onConnect(): void; **示例：** ```ts -onConnect(): void { - console.log("AxExtensionAbility onConnect"); +class MyAccessibilityExtensionAbility extends AccessibilityExtensionAbility { + onConnect() { + console.log('AxExtensionAbility onConnect'); + } }; ``` @@ -110,8 +112,10 @@ onDisconnect(): void; **示例：** ```ts -onDisconnect(): void { - console.log("AxExtensionAbility onDisconnect"); +class MyAccessibilityExtensionAbility extends AccessibilityExtensionAbility { + onDisconnect() { + console.log('AxExtensionAbility onDisconnect'); + } }; ``` @@ -127,15 +131,17 @@ onAccessibilityEvent(event: AccessibilityEvent): void; | 参数名 | 参数类型 | 必填 | 说明 | | ----- | ---------------------------------------- | ---- | --------------- | -| event | [AccessibilityEvent](accessibilityevent) | 是 | 无障碍事件回调函数。无返回值。 | +| event | [AccessibilityEvent](#accessibilityevent) | 是 | 无障碍事件回调函数。无返回值。 | **示例：** ```ts -onAccessibilityEvent(event: AccessibilityEvent): void { - console.log("AxExtensionAbility onAccessibilityEvent"); - if (event.eventType == 'click') { - console.log("AxExtensionAbility onAccessibilityEvent: click"); +class MyAccessibilityExtensionAbility extends AccessibilityExtensionAbility { + onAccessibilityEvent(event) { + console.log('AxExtensionAbility onAccessibilityEvent'); + if (event.eventType == 'click') { + console.log('AxExtensionAbility onAccessibilityEvent: click'); + } } }; ``` @@ -157,12 +163,14 @@ onKeyEvent(keyEvent: KeyEvent): boolean; **示例：** ```ts -onKeyEvent(keyEvent: inputEventClient.KeyEvent): boolean { - console.log("AxExtensionAbility onKeyEvent"); - if (keyEvent.keyCode == 22) { - console.log("AxExtensionAbility onKeyEvent: intercept 22"); - return true; +class MyAccessibilityExtensionAbility extends AccessibilityExtensionAbility { + onKeyEvent(keyEvent) { + console.log('AxExtensionAbility onKeyEvent'); + if (keyEvent.keyCode == 22) { + console.log('AxExtensionAbility onKeyEvent: intercept 22'); + return true; + } + return false; } - return false; }; ``` diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-accessibility.md b/zh-cn/application-dev/reference/errorcodes/errorcode-accessibility.md new file mode 100644 index 0000000000..e8674f3954 --- /dev/null +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-accessibility.md @@ -0,0 +1,96 @@ +# 无障碍子系统错误码 + +## 9300001 输入无效的包名称或者Ability名称 + +**错误信息** + +Invalid bundle name or ability name. + +**错误描述** + +当输入的包名称或者Ability名称无效时，方法将返回该错误码。 + +**可能原因** + +该错误码表示输入无效的包名称或者Ability名称，可能原因如下： +1. 包名称不存在。 +2. 包里面没有对应的Ability。 + +**处理步骤** + +1. 检查包名称是否正确。 +2. 检查包名对应的Ability是否正确。 + +## 9300002 目标Ability已启用 + +**错误信息** + +Target ability already enabled. + +**错误描述** + +当目标Ability已启用时，方法将返回该错误码。 + +**可能原因** + +该错误码表示目标Ability已启用，可能原因是目标Ability已经启用，无法再次启用。 + +**处理步骤** + +1. 停止该目标Ability。 +2. 重新启用该目标Ability。 + +## 9300003 不具备执行该操作的无障碍权限 + +**错误信息** + +Do not have accessibility right for this operation. + +**错误描述** + +当应用执行了用户在启用无障碍扩展应用时没有开启的辅助操作时，方法将返回该错误码。 + +**可能原因** + +该错误码表示应用不具备该操作的无障碍权限，可能原因是应用执行了用户在启用无障碍扩展应用时没有开启的辅助操作。 + +**处理步骤** + +1. 尝试向用户提示请求执行无障碍辅助操作的必要性，并获取用户授权。 +2. 重新启用无障碍扩展应用，并开启所需的辅助操作。 + +## 9300004 属性不存在 + +**错误信息** + +This property does not exist. + +**错误描述** + +当输入无障碍节点元素中不存在的属性时，方法将返回该错误码。 + +**可能原因** + +该错误码表示输入了无效的无障碍节点元素的属性，可能原因是无障碍节点元素中不存在该属性。 + +**处理步骤** + +检查无障碍节点元素中是否存在该属性。 + +## 9300005 不支持该操作 + +**错误信息** + +This action is not supported. + +**错误描述** + +当应用执行无障碍节点元素不支持的操作时，方法将返回该错误码。 + +**可能原因** + +该错误码表示执行了无障碍节点元素不支持的操作，可能原因是无障碍节点元素不支持执行该操作。 + +**处理步骤** + +确认该无障碍节点元素支持的操作列表中是否包含该操作。 \ No newline at end of file -- GitLab