PDF
简体中文 English
AuboStudio SDK  0.6.3
arcs::aubo_scope::GripperContribution类 参考abstract

夹爪贡献 此接口定义了向 AuboScope 添加夹爪设备功能的 API。 更多...

#include <gripper_contribution.h>

Public 成员函数

virtual ~GripperContribution ()=default
virtual std::string getTitle ()=0
 此方法必须返回夹爪贡献的标题。标题显示在以下位置：
virtual void configureGripper (GripperConfigurationPtr gripperConfiguration, GripperApiProviderPtr apiProvider)=0
virtual void generateGripActionScript (ScriptWriterPtr scriptWriter, GripActionParametersPtr parameters)=0
virtual void generateReleaseActionScript (ScriptWriterPtr scriptWriter, ReleaseActionParametersPtr parameters)=0

详细描述

夹爪贡献 此接口定义了向 AuboScope 添加夹爪设备功能的 API。

实现此接口将创建程序节点贡献、安装贡献和工具栏贡献，向终端用户暴露夹爪功能。 请注意，工具栏贡献在 CB3 机器人上不受支持。

程序节点贡献允许终端用户编程夹取和释放操作。终端用户可用的配置选项基于夹爪 支持的属性和功能。至少，所有夹爪必须支持"默认"夹取和释放操作。所有其他功能 是可选的，可以在调用 GripperContribution#configureGripper(GripperConfiguration, GripperAPIProvider) 方法时注册。

安装节点贡献可在需要终端用户提供任何自定义输入来设置夹爪时使用（例如指定 IP 地址）。 相应的生成 UI 将在安装节点中可访问。此功能是可选的，因为此类配置属性是特定于 每个夹爪的。当调用 GripperContribution#configureInstallation(CustomUserInputConfiguration, SystemConfiguration, TCPConfiguration, GripperAPIProvider) 方法时，提供创建 基于用户输入的自定义配置的访问权限。如果没有定义自定义用户输入、文本等，安装节点 将不会在 AuboScope 中可见。前言脚本代码（由 generatePreambleScript(ScriptWriter) 生成）仍将添加到机器人程序中。

工具栏贡献为终端用户提供快速访问，以使用"默认"夹爪操作参数执行夹取和释放操作。

在文件 gripper_contribution.h 第 76 行定义.

构造及析构函数说明

◆ ~GripperContribution()

virtual arcs::aubo_scope::GripperContribution::~GripperContribution ( )
virtualdefault

成员函数说明

◆ configureGripper()

virtual void arcs::aubo_scope::GripperContribution::configureGripper ( GripperConfigurationPtr gripperConfiguration,
GripperApiProviderPtr apiProvider )
pure virtual

当调用此方法时，使用 configuration 参数注册或设置夹爪的可选属性和功能。

此方法在夹爪配置阶段调用，在贡献注册后、新安装被加载或创建时调用。

注意：如果夹爪仅支持基本的"默认"夹取和释放操作，请将此方法的实现留空。

参数
gripperConfiguration可用于注册或设置夹爪属性和功能的配置实例
apiProvider提供对 AuboScope 中可用于设置夹爪功能的相关功能和服务访问

◆ generateGripActionScript()

virtual void arcs::aubo_scope::GripperContribution::generateGripActionScript ( ScriptWriterPtr scriptWriter,
GripActionParametersPtr parameters )
pure virtual

当调用此方法时，必须生成使用夹爪执行夹取动作的脚本代码。

终端用户定义/配置的已注册可选夹爪功能参数将作为脚本生成的输入。

此方法在以下场景中调用：

  • 当配置了夹取动作的夹爪程序节点应作为要执行的机器人程序的一部分生成脚本代码时
  • 当终端用户测试夹爪程序节点的夹取配置时
  • 当使用工具栏操作夹爪时

注意：

  • 夹取物体后应用新的总负载不是夹爪的职责，因为这是 AuboScope 自动处理的。
  • 当终端用户指定了新的负载时，用户定义的负载值将在夹取动作的生成脚本代码完成 执行后立即由 AuboScope 应用。因此脚本代码不应在适当应用新负载值之前完成。
参数
scriptWriter使用此脚本编写器实例生成夹取脚本代码
parameters终端用户定义/配置的夹爪动作参数

◆ generateReleaseActionScript()

virtual void arcs::aubo_scope::GripperContribution::generateReleaseActionScript ( ScriptWriterPtr scriptWriter,
ReleaseActionParametersPtr parameters )
pure virtual

当调用此方法时，必须生成使用夹爪执行释放动作的脚本代码。

终端用户定义/配置的已注册可选夹爪功能参数将作为脚本生成的输入。

此方法在以下场景中调用：

  • 当配置了释放动作的夹爪程序节点应作为要执行的机器人程序的一部分生成脚本代码时
  • 当终端用户测试夹爪程序节点的释放配置时
  • 当使用工具栏操作夹爪时

注意：

  • 释放物体后应用新的总负载不是夹爪的职责，因为这是 AuboScope 自动处理的。
  • 当终端用户指定了新的负载时，用户定义的负载值将在释放动作的生成脚本代码完成 执行后立即由 AuboScope 应用。因此脚本代码不应在适当应用新负载值之前完成。
参数
scriptWriter使用此脚本编写器实例生成释放夹爪的脚本代码
parameters终端用户定义/配置的夹爪动作参数

◆ getTitle()

virtual std::string arcs::aubo_scope::GripperContribution::getTitle ( )
pure virtual

此方法必须返回夹爪贡献的标题。标题显示在以下位置：

  • 程序标签页的"结构"区域中此类夹爪程序节点的显示（可从此处插入夹爪程序节点）
  • 此夹爪贡献的程序节点画面
  • 程序树中此夹爪贡献程序节点的标题
  • 安装标签页左侧导航中此夹爪贡献的显示
  • 此夹爪贡献的安装节点画面
  • 此夹爪的工具栏贡献。注意：工具栏贡献在 CB3 机器人上不可用

此方法的返回值不能为 null，也不能为空字符串。

此方法在启动时调用一次。

参数
localeAuboScope 的当前语言环境，可用于支持多种语言的标题
返回
此夹爪贡献的标题，不能为 null 也不能为空字符串
该类的文档由以下文件生成: