错误信息
The node type is not custom node.
错误描述
当前操作的节点不是 NDK 侧的自定义节点。
可能原因
开发者传入的 ArkUI_NodeHandle 指针对应的节点类型非 ARKUI_NODE_CUSTOM 类型。
处理步骤
接入渲染节点流程时,创建一个 ARKUI_NODE_CUSTOM 类型的 NDK 节点作为渲染节点的根节点。
错误信息
Node already has children.
错误描述
当前操作的自定义节点已存在子节点。
可能原因
开发者构造渲染树时,作为根节点的自定义节点已挂载子 FrameNode 或 RenderNode。
处理步骤
接入渲染节点流程时,使用未挂载子节点的自定义节点作为根节点;如果目标自定义节点已存在子节点,先移除其子节点。
错误信息
RenderNode parent is existed.
错误描述
当前操作的渲染节点已有父节点,无法挂载至相应自定义组件下。
可能原因
开发者传入的 ArkUI_RenderNodeHandle 指针对应的节点已挂载至其他组件下。
处理步骤
接入渲染节点流程时,使用未挂载至其他组件的 RenderNode;如果目标 RenderNode 已有父节点,先将其从原父节点移除。
错误信息
RenderNode child is not exist.
错误描述
无法查找到对应的渲染子节点。
可能原因
开发者传入的 ArkUI_RenderNodeHandle 指针对应的渲染节点无法查询到对应下标的子节点。
处理步骤
确认 ArkUI_RenderNodeHandle 指针对应的渲染节点存在子节点,并将传入的下标调整到该节点的有效子节点索引范围内。
错误信息
Param is out of range.
错误描述
入参值超出接口接收值的范围。
可能原因
开发者传入的参数超出该接口的边界。
处理步骤
检查接口允许的入参范围,并将参数值调整到该范围内。
错误信息
The RenderNode is obtained from a FrameNode.
错误描述
该 RenderNode 是从 FrameNode 获取的,此类节点不允许执行当前操作。
可能原因
该 RenderNode 是从 FrameNode 获取的,除作为子节点上下树外,不允许其他操作。
处理步骤
当前节点仅可作为子节点上下树;执行其他操作时,请跳过该节点。
错误信息
The RenderNode is obtained from a FrameNode, and its corresponding FrameNode is no longer in the adopted state.
错误描述
该 RenderNode 是从 FrameNode 获取的,其对应的 FrameNode 已经被取消接纳或销毁。
可能原因
从被接纳的 FrameNode 上获取 RenderNode 后,该 FrameNode 被取消接纳或者析构。
处理步骤
如果通过OH_ArkUI_NativeModule_RemoveAdoptedChild取消接纳被接纳的FrameNode,或销毁该FrameNode,应调用OH_ArkUI_RenderNodeUtils_DisposeNode释放此前通过OH_ArkUI_RenderNodeUtils_GetRenderNode获取的RenderNode。
错误信息
The node is not adopted.
错误描述
该节点未被接纳,不能获取其 RenderNode。
可能原因
调用 OH_ArkUI_RenderNodeUtils_GetRenderNode 前,未通过 OH_ArkUI_NativeModule_AdoptChild 将该节点接纳为附属节点。
处理步骤
先通过 OH_ArkUI_NativeModule_AdoptChild 接口使当前节点被其他节点接纳,然后再获取其 RenderNode。