技术问询：加载族的类型目录引用及通过Forge查找对应.rfa信息

要从加载了类型目录但无原始RFA的RVT文件中，提取每个对象所属的RFA文件信息，可以借助Forge的Model Derivative API实现，具体步骤如下：

• 第一步：转换模型并获取元数据
  先将目标RVT文件上传至Forge OSS存储，通过Model Derivative API将其转换为SVF2格式（默认转换时会包含完整元数据）。转换完成后，调用GET {urn}/metadata接口获取模型的结构化元数据。

• 第二步：解析元数据提取族文件信息
  在返回的元数据结构中，族实例对应的节点会包含关联的原始族文件属性。重点查找以下属性字段（不同Revit版本可能略有差异）：

  • Family File Name：直接存储原始RFA文件名
  • Original Family File：包含RFA文件的完整路径或文件名
  • 部分场景下，族类型节点的externalFileReference字段也会记录外部族文件的引用信息

• 代码示例（Python）
  以下是简化的元数据遍历提取逻辑：

  import requests
  
  # 替换为你的access_token和模型urn
  ACCESS_TOKEN = "your_access_token"
  MODEL_URN = "your_encoded_model_urn"
  
  def get_family_rfa_info():
      url = f"https://developer.api.autodesk.com/modelderivative/v2/designdata/{MODEL_URN}/metadata"
      headers = {"Authorization": f"Bearer {ACCESS_TOKEN}"}
      resp = requests.get(url, headers=headers).json()
      root_node = resp["data"]["metadata"][0]
  
      def traverse(node):
          # 检查当前节点是否为族类型或实例
          if "properties" in node:
              props = node["properties"]
              # 提取族文件名
              rfa_name = props.get("Family File Name") or props.get("Original Family File")
              if rfa_name:
                  print(f"对象类型: {node['name']}, 所属RFA文件: {rfa_name}")
          # 递归遍历子节点
          if "children" in node:
              for child in node["children"]:
                  traverse(child)
  
      traverse(root_node)
  
  get_family_rfa_info()
  

• 关键注意点

  • 内建族（如基本墙、楼板等）没有对应的RFA文件，提取时需注意过滤这类节点。
  • 若不确定属性字段名，可通过Forge Viewer打开模型，查看目标族实例的属性面板，确认具体字段后再调整代码逻辑。

内容的提问来源于stack exchange，提问作者Max Stefaniv