[返回博客](/cn/blog) # BimRv SDK：使用MEP连接器

Ilya Kovaldov 六月 04, 2021 [\#rvt](/cn/blog/tag/rvt) [\#rfa](/cn/blog/tag/rfa)

<a class="a2a_button_facebook"></a><a class="a2a_button_twitter"></a><a class="a2a_button_linkedin"></a>

#### 简介

连接器是逻辑实体，是其他元素的一部分，允许包含连接器的组件在系统拓扑中正确交互。它们由 OdBmConnector 类表示。

##### 获取域类型

要获取连接器的域类型，请使用 getDomainType() 方法。可能的值在 OdBm::ConnectorDomainType::Enum 枚举中定义：

- DomainUndefined — 连接器的域类型未定义。
- DomainHvac — HVAC/风管连接器。
- DomainElectrical — 电气连接器。
- DomainPiping — 管道连接器。
- DomainCableTrayConduit — 电缆桥架导管连接器。
- DomainStructuralAnalytical — 结构分析模型连接器。

##### 获取连接类型

要获取连接器的连接类型，请使用 getConnectorType() 方法。可能的值在 OdBm::ConnectorTypes::Enum 枚举中定义：

- Invalid — 无效连接类型。
- End — 末端连接类型。
- Curve — 曲线连接类型。
- Logical — 逻辑连接类型。
- Reference — 参照连接类型。
- Surface — 曲面连接类型。
- EndSurface — 末端或曲面连接类型。
- Physical — 物理连接类型。
- NonEnd — 非末端连接类型。
- MasterSurface — 主曲面连接类型。
- Family — 族连接类型。
- NodeReference — 布局节点的参照。
- BlankEnd — 空白末端连接类型。
- AnyEnd — 任意末端连接类型。
- Super — 超级连接类型。
- AllModes — 所有连接类型。

物理连接类型包括末端、曲线和曲面。要检查连接类型是否为物理类型，请使用 isPhysicalConnector() 方法。

##### 获取流向

连接流向仅支持 HVAC 和管道连接器。

要获取连接器的流向，请使用 getDirection() 方法。可能的值在 OdBm::FlowDirectionType::Enum 枚举中定义：

- Bidirectional — 双向流向。
- In — 输入流向。
- Out — 输出流向。

对于 HVAC 和管道连接器以外的域类型，该函数返回 OdResult::eNotApplicable。如果无法计算方向，该函数还会返回错误。

##### 获取连接器的系统

连接器可以属于 MEP 系统。要获取此系统的标识符，请使用 getMEPSystem() 方法。如果连接器在系统中，该函数会将系统标识符放入 systemId 参数并返回 OdResult::eOk；如果连接器不在系统中，则返回 OdResult::eNotApplicable。

##### 获取连接器管理器

要获取连接器的连接器管理器，请使用 getConnectorManager() 方法。如果连接器没有所有者元素，此成员函数将返回连接器的连接器管理器或 NULL。

##### 检查连接

要检查连接器是否与另一个元素有物理连接，请使用 isConnected() 方法。如果连接器连接到另一个元素，此函数将返回 true。此函数仅适用于物理连接器。

##### 获取连接器坐标系

要获取连接器坐标系、其位置和空间方向，请使用 getCoordinateSystem 方法。如果成功检索到坐标系，此函数会将连接器坐标系放入 connectorCS 参数并返回 OdResult::eOk，否则返回 OdResult::eNotApplicable。此函数仅适用于物理连接器。如果将 connectorCS 的原点视为参考点，并且 z 轴应垂直于连接器，则可以计算连接器位置。

##### 示例

以下代码示例包含模板，其中附有应用上述所有功能的说明。

```
//   opening some family instance element.
//   there can be any type of element with connectors:
//   FamilyInstance, RbsCurve, RbsSystem, etc.
OdBmFamilyInstancePtr famInst = pDb->getObjectId(OdDbHandle(handle)).safeOpenObject();
if (famInst.isNull())
{
  pIO->putString(OD_T("Invalid handle"));
  return;
}
OdBm::ConnectorDomainType::Enum conDomainType;
OdBm::ConnectorTypes::Enum conType;
OdBm::FlowDirectionType::Enum conFlowDirection;
bool isPhysical;
bool isConnected;
OdBmConnectorManagerPtr pConManager;
OdGeMatrix3d conCoordSystem;
OdBmConnectorPtrArray connectors;
OdResult result;
OdBmObjectId connectorSystemId;
// getting connectors via element connector manager
famInst->getBaseConnectorManager()->getConnectors(connectors);
// processing connectors
for (auto connector : connectors)
{
  // 1. Getting domain type
  conDomainType = connector->getDomainType();
  if (conDomainType == OdBm::ConnectorDomainType::DomainPiping)
  {
    // do some actions in case of Piping connector
  }
  // 2. Getting connection type
  conType = connector->getConnectorType();
  if (conType == OdBm::ConnectorTypes::Logical)
  {
    // do some actions in case of Logical connection
  }
  // 3. Check if physical connector
  isPhysical = connector->isPhysicalConnector();
  if (!isPhysical)
  {
    // do some actions in case of Non-physical connector
  }
  // 4. Getting connection flow direction
  result = connector->getDirection(conFlowDirection);
  if (result == eOk && conFlowDirection == OdBm::FlowDirectionType::Out)
  {
    // do some actions in case of calculated Out flow direction
  }
  // 5. Getting connector MEP system
  result = connector->getMEPSystem(connectorSystemId);
  if (result == eOk)
  {
    OdBmRbsSystemPtr pMEPSystem = connectorSystemId.safeOpenObject();
    if (!pMEPSystem.isNull())
    {
      // do some actions with connector MEP system
    }
  }
  // 6. Getting connector manager
  pConManager = connector->getConnectorManager();
  if (!pConManager.isNull())
  {
    // do some actions with connector ConnectorManager
  }
  // 7. Checking if connector connected to another element
  isConnected = connector->isConnected();
  if (isConnected)
  {
    // do some actions if connector identified as connected
  }
  // 8. Getting connector location
  result = connector->getCoordinateSystem(conCoordSystem);
  if (result == eOk)
  {
    OdGePoint3d connectorOrigin = conCoordSystem.getCsOrigin();
    OdGeVector3d connectorNormal = conCoordSystem.getCsZAxis();
    // do some actions with connector location
  }
}
```

## 今天就开始行动

**免费试用 ODA 软件 60 天。  
无风险，无需信用卡。**

[免费试用](https://www.opendesign.com/cn/free-trial)