harmony 鸿蒙@ohos.accessibility (辅助功能)

2022-08-09 浏览 (1311)

@ohos.accessibility (辅助功能)

本模块提供辅助功能查询能力，包括获取辅助应用列表、辅助应用启用状态、无障碍字幕配置等。

说明：

本模块首批接口从 API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import accessibility from '@ohos.accessibility';

AbilityState

辅助应用状态类型。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

名称描述
enable辅助应用已启用。
disable辅助应用已禁用。
install辅助应用已安装。

AbilityType

无障碍辅助应用类型。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

名称描述
audible表示具有听觉反馈。
generic表示具有通用反馈。
haptic表示具有触觉反馈。
spoken表示具有语音反馈。
visual表示具有视觉反馈。
all9+表示以上所有类别。

AccessibilityAbilityInfo

辅助应用信息。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

属性

名称类型可读可写说明
idstring是否ability id。
namestring是否ability 名。
bundleNamestring是否Bundle名称。
targetBundleNames9+Array<string>是否关注的目标Bundle名称。
abilityTypesArray<AbilityType>是否辅助应用类型。
capabilitiesArray<Capability>是否辅助应用能力列表。
descriptionstring是否辅助应用描述。
eventTypesArray<EventType>是否辅助应用关注的无障碍事件列表。

Action

应用所支持的目标动作。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

名称描述
click表示点击操作。
longClick表示长按操作。
scrollForward表示向前滚动操作；当前版本暂不支持。
scrollBackward表示向后滚动操作；当前版本暂不支持。
focus表示获得焦点操作；当前版本暂不支持。
clearFocus表示清除焦点操作；当前版本暂不支持。
clearSelection表示清除选择操作；当前版本暂不支持。
accessibilityFocus表示获得无障碍焦点操作。
clearAccessibilityFocus表示清除无障碍焦点操作。
cut表示剪切操作；当前版本暂不支持。
copy表示复制操作；当前版本暂不支持。
paste表示粘贴操作；当前版本暂不支持。
select表示选择操作，当前版本暂不支持。
setText表示设置文本操作；当前版本暂不支持。
delete表示删除操作；当前版本暂不支持。
setSelection表示选择操作；当前版本暂不支持。

Capability

辅助应用能力类型。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

名称描述
retrieve具有检索窗口内容的能力。
touchGuide具有触摸探索模式的能力。
keyEventObserver具有过滤按键事件的能力。
zoom具有控制显示放大的能力；当前版本暂不支持。
gesture具有执行手势动作的能力。

CaptionsFontEdgeType8+

字幕字体边缘类型。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Hearing

名称描述
none无效果。
raised凸起效果。
depressed凹陷效果。
uniform轮廓效果。
dropShadow阴影效果。

CaptionsFontFamily8+

字幕字体。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Hearing

名称描述
default默认字体。
monospacedSerif等宽 Serif 字体。
serifSerif 字体。
monospacedSansSerif等宽 Sans Serif 字体。
sansSerifSans Serif 字体。
casual非正式字体。
cursive手写字体。
smallCapitals小型大写字母字体。

CaptionsStyle8+

字幕风格。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Hearing

名称类型可读可写说明
fontFamilyCaptionsFontFamily是否描述字幕字体。
fontScalenumber是否描述字幕字体缩放系数，单位%，参数范围1~200。
fontColornumber |string是否描述字幕字体颜色，例如red对应#FF0000。
fontEdgeTypeCaptionsFontEdgeType是否描述字幕字体边缘。
backgroundColornumber |string是否描述字幕背景颜色，例如red对应#FF0000。
windowColornumber |string是否描述字幕窗口颜色，例如red对应#FF0000。

CaptionsManager8+

字幕配置管理，在调用CaptionsManager的方法前，需要先通过 accessibility.getCaptionsManager()获取 CaptionsManager实例。

系统能力：以下各项对应的系统能力均为SystemCapability.BarrierFree.Accessibility.Hearing

属性

名称类型可读可写说明
enabledboolean是否表示是否启用字幕配置。
styleCaptionsStyle是否表示字幕风格。

on('enableChange')

on(type: 'enableChange', callback: Callback<boolean>): void;

监听字幕配置启用状态变化事件，使用callback异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Hearing

参数：

参数名类型必填说明
typestring是监听的事件名，固定为‘enableChange’，即字幕配置启用状态变化事件。
callbackCallback<boolean>是回调函数，在启用状态变化时将状态通过此函数进行通知。

示例：

import accessibility from '@ohos.accessibility';

let captionsManager = accessibility.getCaptionsManager();
try {
    captionsManager.on('enableChange', (data: boolean) => {
        console.info('subscribe caption manager enable state change, result: ' + JSON.stringify(data));
    });
} 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异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Hearing

参数：

参数名类型必填说明
typestring是监听的事件名，固定为‘styleChange’，即字幕风格变化事件。
callbackCallback<CaptionsStyle>是回调函数，在字幕风格变化时通过此函数进行通知。

示例：

import accessibility from '@ohos.accessibility';

let captionStyle: accessibility.CaptionsStyle;
let captionsManager = accessibility.getCaptionsManager();
try {
    captionsManager.on('styleChange', (data: accessibility.CaptionsStyle) => {
        captionStyle = data;
        console.info('subscribe caption manager style state change, result: ' + JSON.stringify(data));
    });
} 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异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Hearing

参数：

参数名类型必填说明
typestring是取消监听的事件名，固定为‘enableChange’，即字幕配置启用状态变化事件。
callbackCallback<boolean>否回调函数，取消指定callback对象的事件响应。需与on('enableChange')的callback一致。缺省时，表示注销所有已注册事件。

示例：

import accessibility from '@ohos.accessibility';

let captionsManager = accessibility.getCaptionsManager();
try {
    captionsManager.off('enableChange', (data: boolean) => {
        console.info('Unsubscribe caption manager enable state change, result: ' + JSON.stringify(data));
    });
} 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异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Hearing

参数：

参数名类型必填说明
typestring是取消监听的事件名，固定为‘styleChange’，即字幕风格变化事件。
callbackCallback<CaptionsStyle>否回调函数，取消指定callback对象的事件响应。需与on('styleChange')的callback一致。缺省时，表示注销所有已注册事件。

示例：

import accessibility from '@ohos.accessibility';

let captionStyle: accessibility.CaptionsStyle;
let captionsManager = accessibility.getCaptionsManager();
try {
    captionsManager.off('styleChange', (data: accessibility.CaptionsStyle) => {
        captionStyle = data;
        console.info('Unsubscribe caption manager style state change, result: ' + JSON.stringify(data));
    });
} catch (exception) {
    console.error('failed to Unsubscribe caption manager style state change, because ' + JSON.stringify(exception));
}

EventInfo

界面变更事件。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

属性

名称类型可读可写说明
typeEventType是是无障碍事件类型。
windowUpdateTypeWindowUpdateType是是窗口变化类型。
bundleNamestring是是目标应用名。
componentTypestring是是事件源组件类型，如按钮、图表。
pageIdnumber是是事件源的页面 ID。
descriptionstring是是事件描述；当前版本暂不支持。
triggerActionAction是是触发事件的 Action。
textMoveUnitTextMoveUnit是是文本移动粒度；当前版本暂不支持。
contentsArray<string>是是内容列表。
lastContentstring是是最新内容。
beginIndexnumber是是画面显示条目的开始序号；当前版本暂不支持。
currentIndexnumber是是当前条目序号；当前版本暂不支持。
endIndexnumber是是画面显示条目的结束序号；当前版本暂不支持。
itemCountnumber是是条目总数；当前版本暂不支持。

constructor

constructor(jsonObject)

构造函数。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

参数：

参数名类型必填说明
jsonObjectstring是创建对象所需要的 JSON 格式字符串。

示例：

import accessibility from '@ohos.accessibility';

let eventInfo: accessibility.EventInfo = ({
  type: 'click',
  bundleName: 'com.example.MyApplication',
  triggerAction: 'click'
});

EventType

无障碍事件类型。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

名称描述
click描述点击组件的事件。
longClick描述长按组件的事件。
select描述选择组件的事件；当前版本暂不支持。
focus描述组件获得焦点的事件；当前版本暂不支持。
textUpdate描述组件文本已更改的事件；当前版本暂不支持。
hoverEnter描述悬停进入组件的事件；当前版本暂不支持。
hoverExit描述悬停离开组件的事件；当前版本暂不支持。
scroll描述滚动视图的事件；当前版本暂不支持。
textSelectionUpdate描述选定文本已更改的事件；当前版本暂不支持。
accessibilityFocus描述获得无障碍焦点的事件。
accessibilityFocusClear描述清除无障碍焦点的事件。

TextMoveUnit

文本无障碍导航移动粒度。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

名称描述
char以字符为移动粒度遍历节点文本。
word以词为移动粒度遍历节点文本。
line以行为移动粒度遍历节点文本。
page以页为移动粒度遍历节点文本。
paragraph以段落为移动粒度遍历节点文本。

WindowUpdateType

窗口变化类型。

系统能力：以下各项对应的系统能力均为 SystemCapability.BarrierFree.Accessibility.Core

名称描述
add添加窗口的窗口变化事件。
remove一个窗口被删除的窗口变化事件。
bounds窗口边界已更改的窗口变化事件。
active窗口变为活动或不活动的窗口变化事件。
focus窗口焦点发生变化的窗口变化事件。

accessibility.getAbilityLists(deprecated)

getAbilityLists(abilityType: AbilityType, stateType: AbilityState): Promise<Array<AccessibilityAbilityInfo>>

查询辅助应用列表，使用Promise异步回调。

说明：

从API version 7开始支持，从API version 9开始废弃。 推荐使用getAccessibilityExtensionList()。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

参数：

参数名类型必填说明
abilityTypeAbilityType是辅助应用的类型。
stateTypeAbilityState是辅助应用的状态。

返回值：

类型说明
Promise<Array<AccessibilityAbilityInfo>>Promise对象，返回辅助应用信息列表。

示例：

import accessibility from '@ohos.accessibility';

let abilityType : accessibility.AbilityType = 'spoken';
let abilityState : accessibility.AbilityState = 'enable';
let abilityList: accessibility.AccessibilityAbilityInfo[];
try {
  accessibility.getAbilityLists(abilityType, abilityState)
    .then((data: accessibility.AccessibilityAbilityInfo[]) => {
      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: object) => {
      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(deprecated)

getAbilityLists(abilityType: AbilityType, stateType: AbilityState,callback: AsyncCallback<Array<AccessibilityAbilityInfo>>): void

查询辅助应用列表，使用callback异步回调。

说明：

从API version 7开始支持，从API version 9开始废弃。 推荐使用getAccessibilityExtensionList()。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

参数：

参数名类型必填说明
abilityTypeAbilityType是辅助应用的类型。
stateTypeAbilityState是辅助应用的状态。
callbackAsyncCallback<Array<AccessibilityAbilityInfo>>是回调函数，返回辅助应用信息列表。

示例：

import accessibility from '@ohos.accessibility';
import { BusinessError } from '@ohos.base';

let abilityType : accessibility.AbilityType = 'spoken';
let abilityState : accessibility.AbilityState = 'enable';
let abilityList: accessibility.AccessibilityAbilityInfo[];
try {
    accessibility.getAbilityLists(abilityType, abilityState, 
    (err: BusinessError<void>, data: accessibility.AccessibilityAbilityInfo[]) => {
        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 (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

参数：

参数名类型必填说明
abilityTypeAbilityType是辅助应用的类型。
stateTypeAbilityState是辅助应用的状态。

返回值：

类型说明
Promise<Array<AccessibilityAbilityInfo>>Promise对象，返回辅助应用信息列表。

示例：

import accessibility from '@ohos.accessibility';

let abilityType : accessibility.AbilityType = 'spoken';
let abilityState : accessibility.AbilityState = 'enable';
let extensionList: accessibility.AccessibilityAbilityInfo[] = [];
try {
    accessibility.getAccessibilityExtensionList(abilityType, abilityState)
    .then((data: accessibility.AccessibilityAbilityInfo[]) => {
        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: object) => {
        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

参数：

参数名类型必填说明
abilityTypeAbilityType是辅助应用的类型。
stateTypeAbilityState是辅助应用的状态。
callbackAsyncCallback<Array<AccessibilityAbilityInfo>>是回调函数，返回辅助应用信息列表。

示例：

import accessibility from '@ohos.accessibility';
import { BusinessError } from '@ohos.base';

let abilityType : accessibility.AbilityType = 'spoken';
let abilityState : accessibility.AbilityState = 'enable';
let extensionList: accessibility.AccessibilityAbilityInfo[] = [];
try {
    accessibility.getAccessibilityExtensionList(abilityType, abilityState, 
    (err: BusinessError<void>, data: accessibility.AccessibilityAbilityInfo[]) => {
        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 (exception) {
    console.error('failed to get accessibility extension list because ' + JSON.stringify(exception));
}

accessibility.getCaptionsManager8+

getCaptionsManager(): CaptionsManager

获取无障碍字幕配置管理实例。

系统能力：SystemCapability.BarrierFree.Accessibility.Hearing

返回值：

类型说明
CaptionsManager无障碍字幕配置管理。

示例：

import accessibility from '@ohos.accessibility';

let captionsManager = accessibility.getCaptionsManager();

accessibility.on('accessibilityStateChange')

on(type: 'accessibilityStateChange', callback: Callback<boolean>): void

监听辅助应用启用状态变化事件，使用callback异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

参数：

参数名类型必填说明
typestring是监听的事件名，固定为‘accessibilityStateChange’，即辅助应用启用状态变化事件。
callbackCallback<boolean>是回调函数，在辅助应用启用状态变化时将状态通过此函数进行通知。此状态为全局辅助应用启用状态。

示例：

import accessibility from '@ohos.accessibility';

try {
    accessibility.on('accessibilityStateChange', (data: boolean) => {
        console.info('subscribe accessibility state change, result: ' + JSON.stringify(data));
    });
} 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异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Vision

参数：

参数名类型必填说明
typestring是监听的事件名，固定为‘touchGuideStateChange’，即触摸浏览启用状态变化事件。
callbackCallback<boolean>是回调函数，在触摸浏览启用状态变化时将状态通过此函数进行通知。

示例：

import accessibility from '@ohos.accessibility';

try {
    accessibility.on('touchGuideStateChange', (data: boolean) => {
        console.info('subscribe touch guide state change, result: ' + JSON.stringify(data));
    });
} 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异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

参数：

参数名类型必填说明
typestring是取消监听的事件名，固定为‘accessibilityStateChange’，即辅助应用启用状态变化事件。
callbackCallback<boolean>否回调函数，取消指定callback对象的事件响应。需与accessibility.on('accessibilityStateChange')的callback一致。缺省时，表示注销所有已注册事件。

示例：

import accessibility from '@ohos.accessibility';

try {
    accessibility.off('accessibilityStateChange', (data: boolean) => {
        console.info('Unsubscribe accessibility state change, result: ' + JSON.stringify(data));
    });
} 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异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

参数：

参数名类型必填说明
typestring是取消监听的事件名，固定为‘touchGuideStateChange’，即触摸浏览启用状态变化事件。
callbackCallback<boolean>否回调函数，取消指定callback对象的事件响应。需与accessibility.on('touchGuideStateChange')的callback一致。缺省时，表示注销所有已注册事件。

示例：

import accessibility from '@ohos.accessibility';

try {
    accessibility.off('touchGuideStateChange', (data: boolean) => {
        console.info('Unsubscribe touch guide state change, result: ' + JSON.stringify(data));
    });
} catch (exception) {
    console.error('failed to Unsubscribe touch guide state change, because ' + JSON.stringify(exception));
}

accessibility.isOpenAccessibility(deprecated)

isOpenAccessibility(): Promise<boolean>

判断是否启用了辅助功能, 使用Promise异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

返回值：

类型说明
Promise<boolean>Promise对象，如果辅助功能已启用，则返回 true；否则返回 false。

示例：

import accessibility from '@ohos.accessibility';

accessibility.isOpenAccessibility().then((data: boolean) => {
    console.info('success data:isOpenAccessibility : ' + JSON.stringify(data))
}).catch((err: object) => {
    console.error('failed to  isOpenAccessibility because ' + JSON.stringify(err));
});

accessibility.isOpenAccessibility(deprecated)

isOpenAccessibility(callback: AsyncCallback<boolean>): void

判断是否启用了辅助功能，使用callback异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

参数：

参数名类型必填说明
callbackAsyncCallback<boolean>是回调函数，如果辅助功能已启用，则返回 true；否则返回 false。

示例：

import accessibility from '@ohos.accessibility';
import { BusinessError } from '@ohos.base';

accessibility.isOpenAccessibility((err: BusinessError<void>, data: boolean) => {
    if (err) {
        console.error('failed to isOpenAccessibility because ' + JSON.stringify(err));
        return;
    }
    console.info('success data:isOpenAccessibility : ' + JSON.stringify(data))
});

accessibility.isOpenAccessibilitySync10+

isOpenAccessibilitySync(): boolean

是否启用了辅助功能。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

返回值：

类型说明
boolean>启用辅助功能返回true，否则返回false。

示例：

import accessibility from '@ohos.accessibility';
import { BusinessError } from '@ohos.base';

try {
    let status: boolean = accessibility.isOpenAccessibilitySync();
} catch (exception) {
    console.error('failed to isOpenAccessibilitySync because ' + JSON.stringify(exception));
}

accessibility.isOpenTouchGuide(deprecated)

isOpenTouchGuide(): Promise<boolean>

判断触摸浏览模式是否开启, 使用Promise异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Vision

返回值：

类型说明
Promise<boolean>Promise对象，如果触摸浏览模式已开启，则返回 true；否则返回 false。

示例：

import accessibility from '@ohos.accessibility';

accessibility.isOpenTouchGuide().then((data: boolean) => {
    console.info('success data:isOpenTouchGuide : ' + JSON.stringify(data))
}).catch((err: object) => {
    console.error('failed to  isOpenTouchGuide because ' + JSON.stringify(err));
});

accessibility.isOpenTouchGuide(deprecated)

isOpenTouchGuide(callback: AsyncCallback<boolean>): void

判断触摸浏览模式是否开启, 使用callback异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Vision

参数：

参数名类型必填说明
callbackAsyncCallback<boolean>是回调函数，如果触摸浏览模式已开启，则返回 true；否则返回 false。

示例：

import accessibility from '@ohos.accessibility';
import { BusinessError } from '@ohos.base';

accessibility.isOpenTouchGuide((err: BusinessError<void>, data: boolean) => {
    if (err) {
        console.error('failed to isOpenTouchGuide because ' + JSON.stringify(err));
        return;
    }
    console.info('success data:isOpenTouchGuide : ' + JSON.stringify(data))
});

accessibility.isOpenTouchGuideSync10+

isOpenTouchGuideSync(): boolean

是否开启了触摸浏览模式。

系统能力：SystemCapability.BarrierFree.Accessibility.Vision

返回值：

类型说明
boolean启用辅助功能返回true，否则返回false。

示例：

import accessibility from '@ohos.accessibility';
import { BusinessError } from '@ohos.base';

try {
    let status: boolean = accessibility.isOpenTouchGuideSync();
} catch (exception) {
    console.error('failed to isOpenTouchGuideSync because ' + JSON.stringify(exception));
}

accessibility.sendEvent(deprecated)

sendEvent(event: EventInfo): Promise<void>

发送无障碍事件, 使用Promise异步回调。

说明：

从API version 7开始支持，从API version 9开始废弃。 推荐使用sendAccessibilityEvent()。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

参数：

参数名类型必填说明
eventEventInfo是无障碍事件对象。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

示例：

import accessibility from '@ohos.accessibility';

let eventInfo: accessibility.EventInfo = ({
  type: 'click',
  bundleName: 'com.example.MyApplication',
  triggerAction: 'click'
});
accessibility.sendEvent(eventInfo).then(() => {
    console.info('send event success');
}).catch((err: object) => {
    console.error('failed to sendEvent because ' + JSON.stringify(err));
});

accessibility.sendEvent(deprecated)

sendEvent(event: EventInfo, callback: AsyncCallback<void>): void

发送无障碍事件, 使用callback异步回调。

说明：

从API version 7开始支持，从API version 9开始废弃。 推荐使用sendAccessibilityEvent()。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

参数：

参数名类型必填说明
eventEventInfo是辅助事件对象。
callbackAsyncCallback<void>是回调函数，如果发送无障碍事件失败，则 AsyncCallback中err有数据返回。

示例：

import accessibility from '@ohos.accessibility';
import { BusinessError } from '@ohos.base';

let eventInfo: accessibility.EventInfo = ({
  type: 'click',
  bundleName: 'com.example.MyApplication',
  triggerAction: 'click'
});
accessibility.sendEvent(eventInfo, (err: BusinessError<void>) => {
    if (err) {
        console.error('failed to sendEvent because ' + JSON.stringify(err));
        return;
    }
    console.info('sendEvent success');
});

accessibility.sendAccessibilityEvent9+

sendAccessibilityEvent(event: EventInfo): Promise<void>

发送无障碍事件, 使用Promise异步回调。

系统能力：SystemCapability.BarrierFree.Accessibility.Core

参数：

参数名类型必填说明
eventEventInfo是无障碍事件对象。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

示例：

import accessibility from '@ohos.accessibility';

let eventInfo: accessibility.EventInfo = ({
  type: 'click',
  bundleName: 'com.example.MyApplication',
  triggerAction: 'click'
});
try {
    accessibility.sendAccessibilityEvent(eventInfo).then(() => {
        console.info('send event success');
    }).catch((err: object) => {
        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

参数：

参数名类型必填说明
eventEventInfo是辅助事件对象。
callbackAsyncCallback<void>是回调函数，如果发送无障碍事件失败，则 AsyncCallback中err有数据返回。

示例：

import accessibility from '@ohos.accessibility';
import { BusinessError } from '@ohos.base';

let eventInfo: accessibility.EventInfo = ({
  type: 'click',
  bundleName: 'com.example.MyApplication',
  triggerAction: 'click'
});
try {
    accessibility.sendAccessibilityEvent(eventInfo, (err: BusinessError<void>) => {
        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));
}

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述（仅对系统应用开放）

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/cf7e4b770f544dd5963a7af73eb6b961