通过自绘制接入无障碍
通过自定义绘制接入的第三方框架平台，NDK提供了对接无障碍服务的接口函数，使三方框架组件能够支持ArkUI中的基本无障碍功能，包括焦点获取、获取无障碍节点和操作响应。
从API version 13开始，支持基于Xcomponent的自绘制方式接入。
从API version 23开始，支持基于CustomNode构建渲染节点树的自绘制方式接入。
三方框架从绘制容器组件获取到ArkUI_AccessibilityProvider，通过实现其中对接无障碍的回调函数，来适配无障碍系统发出的操作Action，并针对组件交互行为发送无障碍事件Event到无障碍子系统，实现无障碍辅助应用的交互体验。
基于Xcomponent的自绘制方式接入方式通过OH_NativeXComponent_GetNativeAccessibilityProvider获得无障碍接入ArkUI_AccessibilityProvider。
基于CustomNode构建渲染节点树的自绘制方式接入方式通过OH_ArkUI_NativeModule_GetNativeAccessibilityProvider获得无障碍接入ArkUI_AccessibilityProvider。
如果需要支持单实例，通过OH_ArkUI_AccessibilityProviderRegisterCallback注册接入无障碍所需的回调函数ArkUI_AccessibilityProviderCallbacks。
如果需要支持多实例，则通过OH_ArkUI_AccessibilityProviderRegisterCallbackWithInstance注册接入无障碍所需的回调函数ArkUI_AccessibilityProviderCallbacksWithInstance。
说明：
- 无障碍能力：指开发者能够创建可访问的应用界面，满足视觉、听觉、运动和认知障碍等用户需求的能力。
- 实现OH_ArkUI_AccessibilityProviderRegisterCallback或者OH_ArkUI_AccessibilityProviderRegisterCallbackWithInstance回调查询接口时，查询到的每个无障碍节点信息通过OH_ArkUI_AddAndGetAccessibilityElementInfo创建分配element内存，并将其加入到指定的elementList中。
- 使用OH_ArkUI_SendAccessibilityAsyncEvent发送事件时，需要使用OH_ArkUI_CreateAccessibilityEventInfo创建ArkUI_AccessibilityEventInfo，使用OH_ArkUI_CreateAccessibilityElementInfo创建ArkUI_AccessibilityElementInfo，使用结束后，需要调用OH_ArkUI_DestoryAccessibilityEventInfo以及OH_ArkUI_DestoryAccessibilityElementInfo销毁函数释放内存。
- 回调函数打印日志时，携带输入的requestId，用于关联一次交互过程相关的日志，便于索引查询整个流程，协助问题定位。
基于Xcomponent的自绘制接入方式
以下示例提供了对接无障碍能力的实现方法，仅包含主要步骤，完整示例请参考AccessibilityCapiSample。对接完成后，在开启无障碍功能时，可使XComponent中的三方框架绘制组件接入，实现无障碍交互。
-
按照自定义渲染（XComponent）的使用OH_ArkUI_SurfaceHolder管理Surface生命周期场景创建前置工程。
-
获得无障碍接入provider并注册回调函数（以多实例场景为例）。
#include <arkui/native_interface_accessibility.h> #include <string> #include "common/common.h" // 完整实现请参考AccessibilityCapiSample。 #include "fakenode/fake_node.h" // 完整实现请参考AccessibilityCapiSample。 #include "AccessibilityManager.h" // ... AccessibilityManager::AccessibilityManager() { // 多实例场景 accessibilityProviderCallbacksWithInstance_.findAccessibilityNodeInfosById = FindAccessibilityNodeInfosById; accessibilityProviderCallbacksWithInstance_.findAccessibilityNodeInfosByText = FindAccessibilityNodeInfosByText; accessibilityProviderCallbacksWithInstance_.findFocusedAccessibilityNode = FindFocusedAccessibilityNode; accessibilityProviderCallbacksWithInstance_.findNextFocusAccessibilityNode = FindNextFocusAccessibilityNode; accessibilityProviderCallbacksWithInstance_.executeAccessibilityAction = ExecuteAccessibilityAction; accessibilityProviderCallbacksWithInstance_.clearFocusedFocusAccessibilityNode = ClearFocusedFocusAccessibilityNode; accessibilityProviderCallbacksWithInstance_.getAccessibilityNodeCursorPosition = GetAccessibilityNodeCursorPosition; // 单实例场景 accessibilityProviderCallbacks_.findAccessibilityNodeInfosById = FindAccessibilityNodeInfosById; accessibilityProviderCallbacks_.findAccessibilityNodeInfosByText = FindAccessibilityNodeInfosByText; accessibilityProviderCallbacks_.findFocusedAccessibilityNode = FindFocusedAccessibilityNode; accessibilityProviderCallbacks_.findNextFocusAccessibilityNode = FindNextFocusAccessibilityNode; accessibilityProviderCallbacks_.executeAccessibilityAction = ExecuteAccessibilityAction; accessibilityProviderCallbacks_.clearFocusedFocusAccessibilityNode = ClearFocusedFocusAccessibilityNode; accessibilityProviderCallbacks_.getAccessibilityNodeCursorPosition = GetAccessibilityNodeCursorPosition; } void AccessibilityManager::Initialize(const std::string &id, OH_NativeXComponent *nativeXComponent) { int32_t ret = OH_NativeXComponent_GetNativeAccessibilityProvider(nativeXComponent, &provider); if (provider == nullptr) { OH_LOG_Print(LOG_APP, LOG_ERROR, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "get provider is null"); return; } // 2.注册回调函数 ret = OH_ArkUI_AccessibilityProviderRegisterCallbackWithInstance(id.c_str(), provider, &accessibilityProviderCallbacksWithInstance_); if (ret != 0) { OH_LOG_Print(LOG_APP, LOG_ERROR, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "InterfaceDesignTest OH_ArkUI_AccessibilityProviderRegisterCallback failed"); return; } g_provider = provider; } // ... -
三方框架需要实现如下回调函数。
-
基于指定的节点，查询所需的节点信息
说明：
- 当无障碍系统传入的elementId为-1时，代表其约定的“根节点标识”。三方框架需将该外部标识，映射为自身内部节点树中唯一根节点的ID，以便无障碍系统正确定位到框架的根节点。
- 三方框架需要提供一个且仅包含一个根节点。
- 根节点的属性中的parentId须设置为特殊值
-2100000。在无障碍树中，根节点是最顶层节点，没有父节点。这个特殊值-2100000是ArkUI无障碍框架的硬编码约定，用于明确标识 “此节点为根节点，无父节点”。使用一个特殊值而非0或-1，是为了防止与三方框架内部的有效ID产生冲突，确保系统能准确识别根节点。 - 根节点的属性中的enabled须设置为true。如果设置为false，根节点被禁用，无障碍系统会认为整个控件树都不可交互，从而忽略所有子节点的查询和操作。根节点作为整个控件树的入口，必须处于可用状态，才能保证无障碍服务正常工作。
- 根节点的属性中的visible须设置为true。无障碍系统只对可见的节点进行遍历和交互。如果设置为false，根节点不可见，整个控件树都会被无障碍服务忽略，导致三方框架的无障碍能力完全失效。确保用户在使用无障碍功能时，能感知到三方框架渲染的所有界面元素。
int32_t AccessibilityManager::FindAccessibilityNodeInfosById(const char* instanceId, int64_t elementId, ArkUI_AccessibilitySearchMode mode, int32_t requestId, ArkUI_AccessibilityElementInfoList *elementList) { OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "FindAccessibilityNodeInfosById start,instanceId %{public}s elementId: %{public}ld, " "requestId: %{public}d, mode: %{public}d", instanceId, elementId, requestId, static_cast<int32_t>(mode)); if (elementList == nullptr) { OH_LOG_Print(LOG_APP, LOG_ERROR, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "FindAccessibilityNodeInfosById elementList is null"); return OH_NATIVEXCOMPONENT_RESULT_FAILED; } int ret = 0; const int parentOfRoot = -2100000; if (elementId == -1) { elementId = 0; } if (mode == ARKUI_ACCESSIBILITY_NATIVE_SEARCH_MODE_PREFETCH_RECURSIVE_CHILDREN) { // 三方框架需要在该方法中实现自己的查找策略，返回无障碍节点信息给无障碍服务，以下逻辑仅为示意过程。 // ArkUI框架设计的特殊值，根节点必须设置parentId为这个值。 auto rootNode = OH_ArkUI_AddAndGetAccessibilityElementInfo(elementList); if (!rootNode) { return OH_NATIVEXCOMPONENT_RESULT_FAILED; } // 设置根节点信息 OH_ArkUI_AccessibilityElementInfoSetElementId(rootNode, 0); OH_ArkUI_AccessibilityElementInfoSetParentId(rootNode, parentOfRoot); FakeWidget::Instance().fillAccessibilityElement(rootNode); ArkUI_AccessibleRect rect; rect.leftTopX = NUMBER_ZERO; rect.leftTopY = NUMBER_ZERO; rect.rightBottomX = NUMBER_THIRD; rect.rightBottomY = NUMBER_THIRD; ret = OH_ArkUI_AccessibilityElementInfoSetScreenRect(rootNode, &rect); // 设置根节点不可被无障碍辅助服务所识别。 OH_ArkUI_AccessibilityElementInfoSetAccessibilityLevel(rootNode, "no"); auto objects = FakeWidget::Instance().GetAllObjects(instanceId); int64_t childNodes[1024]; for (int i = 0; i < objects.size(); i++) { int elementId = i + 1; childNodes[i] = elementId; } for (int i = 0; i < objects.size(); i++) { int elementId = i + 1; childNodes[i] = elementId; auto child = OH_ArkUI_AddAndGetAccessibilityElementInfo(elementList); // 设置子节点信息。 OH_ArkUI_AccessibilityElementInfoSetElementId(child, elementId); OH_ArkUI_AccessibilityElementInfoSetParentId(child, 0); // 设置当前组件可被无障碍辅助服务所识别。 OH_ArkUI_AccessibilityElementInfoSetAccessibilityLevel(child, "yes"); objects[i]->fillAccessibilityElement(child); ArkUI_AccessibleRect rect; rect.leftTopX = i * NUMBER_FIRST; rect.leftTopY = NUMBER_FIRST; rect.rightBottomX = i * NUMBER_FIRST + NUMBER_FIRST; rect.rightBottomY = NUMBER_SECOND; OH_ArkUI_AccessibilityElementInfoSetScreenRect(child, &rect); if (objects[i]->ObjectType() == "FakeSlider") { auto rangeInfo = objects[i]->GetRangeInfo(); OH_ArkUI_AccessibilityElementInfoSetRangeInfo(child, &rangeInfo); } if (objects[i]->ObjectType() == "FakeList") { auto gridInfo = objects[i]->GetGridInfo(); OH_ArkUI_AccessibilityElementInfoSetGridInfo(child, &gridInfo); } if (objects[i]->ObjectType() == "FakeSwiper") { auto gridItemInfo = objects[i]->GetGridItemInfo(); OH_ArkUI_AccessibilityElementInfoSetGridItemInfo(child, &gridItemInfo); } } ret = OH_ArkUI_AccessibilityElementInfoSetChildNodeIds(rootNode, objects.size(), childNodes); OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "FindAccessibilityNodeInfosById child count: %{public}ld %{public}d", objects.size(), ret); } else if (mode == ARKUI_ACCESSIBILITY_NATIVE_SEARCH_MODE_PREFETCH_CURRENT) { auto &widget = FakeWidget::Instance(); AccessibleObject *obj = nullptr; if (elementId == 0) { obj = &widget; } else { obj = widget.GetChild(elementId); } if (!obj) { return OH_NATIVEXCOMPONENT_RESULT_FAILED; } auto node = OH_ArkUI_AddAndGetAccessibilityElementInfo(elementList); OH_ArkUI_AccessibilityElementInfoSetElementId(node, elementId); OH_ArkUI_AccessibilityElementInfoSetParentId(node, elementId == 0 ? parentOfRoot : 0); OH_ArkUI_AccessibilityElementInfoSetAccessibilityLevel(node, elementId == 0 ? "no" : "yes"); obj->fillAccessibilityElement(node); ArkUI_AccessibleRect rect; if (elementId == 0) { rect.leftTopX = NUMBER_ZERO; rect.leftTopY = NUMBER_ZERO; rect.rightBottomX = NUMBER_THIRD; rect.rightBottomY = NUMBER_THIRD; } else { int i = elementId - 1; rect.leftTopX = i * NUMBER_FIRST; rect.leftTopY = NUMBER_FIRST; rect.rightBottomX = i * NUMBER_FIRST + NUMBER_FIRST; rect.rightBottomY = NUMBER_SECOND; } OH_ArkUI_AccessibilityElementInfoSetScreenRect(node, &rect); if (elementId == 0) { auto objects = FakeWidget::Instance().GetAllObjects(instanceId); int64_t childNodes[1024]; for (int i = 0; i < objects.size(); i++) { int elementId = i + 1; childNodes[i] = elementId; auto child = OH_ArkUI_AddAndGetAccessibilityElementInfo(elementList); OH_ArkUI_AccessibilityElementInfoSetElementId(child, elementId); OH_ArkUI_AccessibilityElementInfoSetParentId(child, 0); objects[i]->fillAccessibilityElement(child); ArkUI_AccessibleRect rect; rect.leftTopX = i * NUMBER_FIRST; rect.leftTopY = NUMBER_ZERO; rect.rightBottomX = i * NUMBER_FIRST + NUMBER_FIRST; rect.rightBottomY = NUMBER_SECOND; OH_ArkUI_AccessibilityElementInfoSetScreenRect(child, &rect); } ret = OH_ArkUI_AccessibilityElementInfoSetChildNodeIds(node, objects.size(), childNodes); OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "FindAccessibilityNodeInfosById child2 count: %{public}ld", objects.size()); } } OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "FindAccessibilityNodeInfosById end"); return OH_NATIVEXCOMPONENT_RESULT_SUCCESS; } -
基于指定的节点，查询下一个可聚焦的无障碍节点
int32_t AccessibilityManager::FindNextFocusAccessibilityNode(const char* instanceId, int64_t elementId, ArkUI_AccessibilityFocusMoveDirection direction, int32_t requestId, ArkUI_AccessibilityElementInfo *elementInfo) { // 查找下一个可聚焦的无障碍节点，三方框架需要在该方法中实现自己的查找策略，以下逻辑仅为示意过程。 OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "FindNextFocusAccessibilityNode instanceId %{public}s " "elementId: %{public}ld, requestId: %{public}d, direction: %{public}d", instanceId, elementId, requestId, static_cast<int32_t>(direction)); auto objects = FakeWidget::Instance().GetAllObjects(instanceId); OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "objects.size() %{public}d", objects.size()); // object.size 不包含 root节点 if ((elementId < 0) || (elementId > objects.size())) { OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "elementId invalid"); return OH_NATIVEXCOMPONENT_RESULT_FAILED; } int64_t nextElementId = -1; if (direction == ARKUI_ACCESSIBILITY_NATIVE_DIRECTION_FORWARD) { nextElementId = elementId + 1; } else { nextElementId = elementId - 1; } // 屏幕朗读约束 如果是根节点 然后backward的话需要回到最后一个节点 if ((nextElementId == -1) && (direction == ARKUI_ACCESSIBILITY_NATIVE_DIRECTION_BACKWARD)) { nextElementId = objects.size(); } if (nextElementId > objects.size()) { OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "nextElementId invalid"); return OH_NATIVEXCOMPONENT_RESULT_FAILED; } if (nextElementId <= 0) { OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "nextElementId less than zero"); return OH_NATIVEXCOMPONENT_RESULT_FAILED; } OH_ArkUI_AccessibilityElementInfoSetElementId(elementInfo, nextElementId); OH_ArkUI_AccessibilityElementInfoSetParentId(elementInfo, 0); // id 比object索引大1 objects[nextElementId - 1]->fillAccessibilityElement(elementInfo); ArkUI_AccessibleRect rect; rect.leftTopX = nextElementId * NUMBER_FIRST; rect.leftTopY = NUMBER_ZERO; rect.rightBottomX = nextElementId * NUMBER_FIRST + NUMBER_FIRST; rect.rightBottomY = NUMBER_SECOND; OH_ArkUI_AccessibilityElementInfoSetScreenRect(elementInfo, &rect); auto eventInfo = OH_ArkUI_CreateAccessibilityEventInfo(); OH_ArkUI_AccessibilityEventSetRequestFocusId(eventInfo, requestId); OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "%{public}ld", nextElementId); return OH_NATIVEXCOMPONENT_RESULT_SUCCESS; } -
基于指定的节点，查询满足指定组件文本内容的节点信息
int32_t AccessibilityManager::FindAccessibilityNodeInfosByText(const char* instanceId, int64_t elementId, const char *text, int32_t requestId, ArkUI_AccessibilityElementInfoList *elementList) { // 三方框架需实现根据文本内容查询无障碍节点的逻辑。 OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "FindAccessibilityNodeInfosByText start,instanceId %{public}s elementId: %{public}ld, " "requestId: %{public}d, text: %{public}s.", instanceId, elementId, requestId, text); return OH_NATIVEXCOMPONENT_RESULT_SUCCESS; } -
基于指定的节点，查询已经聚焦的节点信息
int32_t AccessibilityManager::FindFocusedAccessibilityNode(const char* instanceId, int64_t elementId, ArkUI_AccessibilityFocusType focusType, int32_t requestId, ArkUI_AccessibilityElementInfo *elementInfo) { // 三方框架需实现基于指定节点获取焦点元素信息的逻辑。 OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "FindFocusedAccessibilityNode start instanceId %{public}s, " "elementId: %{public}ld, requestId: %{public}d, focusType: %{public}d", instanceId, elementId, requestId, static_cast<int32_t>(focusType)); return OH_NATIVEXCOMPONENT_RESULT_SUCCESS; } -
基于指定的节点，执行指定的操作
void FillEvent(ArkUI_AccessibilityEventInfo *eventInfo, ArkUI_AccessibilityElementInfo *elementInfo, ArkUI_AccessibilityEventType eventType, std::string announcedText) { if (eventInfo == nullptr) { return; } if (elementInfo == nullptr) { return; } // 设置事件类型 OH_ArkUI_AccessibilityEventSetEventType(eventInfo, eventType); // 设置事件对应的元素信息 OH_ArkUI_AccessibilityEventSetElementInfo(eventInfo, elementInfo); if (eventType == ARKUI_ACCESSIBILITY_NATIVE_EVENT_TYPE_ANNOUNCE_FOR_ACCESSIBILITY && announcedText.size() > 0) { // 给无障碍节点设置优先播报的无障碍文本 OH_ArkUI_AccessibilityEventSetTextAnnouncedForAccessibility(eventInfo, announcedText.data()); } } // ... void AccessibilityManager::SendAccessibilityAsyncEvent(ArkUI_AccessibilityElementInfo *elementInfo, ArkUI_AccessibilityEventType eventType, std::string announcedText) { auto eventInfo = OH_ArkUI_CreateAccessibilityEventInfo(); // 1.填写event内容 FillEvent(eventInfo, elementInfo, eventType, announcedText); // 2.callback auto callback = [](int32_t errorCode) { OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "result: %{public}d", errorCode); }; // 3. 调用接口发送事件给OH侧 OH_ArkUI_SendAccessibilityAsyncEvent(g_provider, eventInfo, callback); } // ... int32_t AccessibilityManager::ExecuteAccessibilityAction(const char* instanceId, int64_t elementId, ArkUI_Accessibility_ActionType action, ArkUI_AccessibilityActionArguments *actionArguments, int32_t requestId) { // 三方框架需要实现执行无障碍节点行为的逻辑。 OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "ExecuteAccessibilityAction instanceId %{public}s elementId: %{public}ld, " "action: %{public}d, requestId: %{public}d", instanceId, elementId, action, requestId); auto object = FakeWidget::Instance().GetChild(elementId); // 传入的无障碍节点对象可能为空，需要做非空判断。 if (!object) { return 0; } // 获取无障碍节点element。 auto announcedText = object->GetAnnouncedForAccessibility(); auto element = OH_ArkUI_CreateAccessibilityElementInfo(); OH_ArkUI_AccessibilityElementInfoSetElementId(element, elementId); const char *actionKey = "some_key"; char *actionValue = nullptr; OH_ArkUI_FindAccessibilityActionArgumentByKey(actionArguments, actionKey, &actionValue); // 根据action类型执行对应的行为。 switch (action) { case ARKUI_ACCESSIBILITY_NATIVE_ACTION_TYPE_CLICK: if (object) { object->OnClick(); object->fillAccessibilityElement(element); } // 向无障碍服务发送指定事件。 AccessibilityManager::SendAccessibilityAsyncEvent(element, ARKUI_ACCESSIBILITY_NATIVE_EVENT_TYPE_CLICKED, announcedText); break; case ARKUI_ACCESSIBILITY_NATIVE_ACTION_TYPE_GAIN_ACCESSIBILITY_FOCUS: if (object) { object->SetFocus(true); object->fillAccessibilityElement(element); } // 向无障碍服务发送指定事件。 AccessibilityManager::SendAccessibilityAsyncEvent(element, ARKUI_ACCESSIBILITY_NATIVE_EVENT_TYPE_ACCESSIBILITY_FOCUSED, announcedText); break; case ARKUI_ACCESSIBILITY_NATIVE_ACTION_TYPE_CLEAR_ACCESSIBILITY_FOCUS: if (object) { object->SetFocus(false); object->fillAccessibilityElement(element); } AccessibilityManager::SendAccessibilityAsyncEvent( element, ARKUI_ACCESSIBILITY_NATIVE_EVENT_TYPE_ACCESSIBILITY_FOCUS_CLEARED, announcedText); break; default: // 处理不支持的action行为。 break; } OH_ArkUI_DestoryAccessibilityElementInfo(element); return OH_NATIVEXCOMPONENT_RESULT_SUCCESS; } -
清除当前获焦的节点
int32_t AccessibilityManager::ClearFocusedFocusAccessibilityNode(const char* instanceId) { // 三方框架需要实现清除当前获焦的节点的行为。 OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "ClearFocusedFocusAccessibilityNode, instanceId %{public}s", instanceId); return OH_NATIVEXCOMPONENT_RESULT_SUCCESS; } -
基于指定的节点，获取当前文本组件的光标位置
int32_t AccessibilityManager::GetAccessibilityNodeCursorPosition(const char* instanceId, int64_t elementId, int32_t requestId, int32_t *index) { // 三方框架需要实现获取当前组件中（文本组件）光标位置。 OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, LOG_PRINT_TEXT, "GetAccessibilityNodeCursorPosition, instanceId %{public}s " "elementId: %{public}ld, requestId: %{public}d, index: %{public}d", instanceId, elementId, requestId, index); return OH_NATIVEXCOMPONENT_RESULT_SUCCESS; }
provider通过回调函数OH_ArkUI_AccessibilityProviderRegisterCallback或者OH_ArkUI_AccessibilityProviderRegisterCallbackWithInstance对接成功后，可开启无障碍功能。
基于CustomNode的自绘制接入方式
说明：
- 基于CustomNode的自定义绘制容器组件，仅支持类型为ARKUI_NODE_CUSTOM且无其他子节点的ArkUI_Node。绘制容器组件的宽和高不能为0，避免被无障碍辅助应用忽略或错误处理子节点树。
以下示例提供了对接无障碍能力的实现方法，仅包含主要步骤，完整示例请参考AccessibilityCustomCapi。回调函数实现请参考基于Xcomponent的自绘制接入方式。完成回调函数实现后，开启无障碍功能，基于CustomNode构建渲染节点树的三方框架即可接入无障碍服务，实现控件树的无障碍交互与信息查询。
-
按照基于CustomNode构建渲染节点树场景创建前置工程。
-
获取无障碍接入Provider实例，将回调函数与Provider实例绑定并完成注册。
int32_t AccessibilityMaker::GetAccessibilityProvider(ArkUI_NodeHandle* customNode, const char* id) { AccessibilityMaker::accessibilityProviderCallbacksWithInstance_.findAccessibilityNodeInfosById = FindAccessibilityNodeInfosById; AccessibilityMaker::accessibilityProviderCallbacksWithInstance_.findAccessibilityNodeInfosByText = FindAccessibilityNodeInfosByText; AccessibilityMaker::accessibilityProviderCallbacksWithInstance_.findFocusedAccessibilityNode = FindFocusedAccessibilityNode; AccessibilityMaker::accessibilityProviderCallbacksWithInstance_.findNextFocusAccessibilityNode = FindNextFocusAccessibilityNode; AccessibilityMaker::accessibilityProviderCallbacksWithInstance_.executeAccessibilityAction = ExecuteAccessibilityAction; AccessibilityMaker::accessibilityProviderCallbacksWithInstance_.clearFocusedFocusAccessibilityNode = ClearFocusedFocusAccessibilityNode; AccessibilityMaker::accessibilityProviderCallbacksWithInstance_.getAccessibilityNodeCursorPosition = GetAccessibilityNodeCursorPosition; // 获取 native 层提供的 accessibility provider，并为其注册回调 OH_ArkUI_NativeModule_GetNativeAccessibilityProvider(customNode, &accessibilityProvider_); if (accessibilityProvider_ == nullptr) { OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, "AccessibilityMaker", "accessibilityProvider_ is null"); return 0; } int32_t ret = OH_ArkUI_AccessibilityProviderRegisterCallbackWithInstance(id, accessibilityProvider_, &AccessibilityMaker::accessibilityProviderCallbacksWithInstance_); if (ret != 0) { return 0; } return 0; } -
三方框架需要实现回调函数。请参考前文的基于Xcomponent的自绘制接入方式。