Unity FBX Exporter 使用教程

项目介绍

Unity FBX Exporter 是一个开源的工具，专门用于将 Unity 中的网格模型、动画、蒙皮和混合形状等资源导出为 FBX 格式文件。该项目支持与主流 3D 建模软件（如 Autodesk Maya、3ds Max 等）的无缝协作，特别适合需要将 Unity 中的模型数据导出到专业 DCC 工具进行进一步编辑的场景。

功能特性

• 支持网格模型导出，包含顶点、法线、切线、UV 和颜色数据
• 完整的蒙皮动画支持，可导出骨骼权重和绑定姿势
• 混合形状（BlendShape）导出功能
• 地形数据导出支持
• 四边形化优化功能
• 支持 Unity 2017.1 及以上版本

安装与配置

克隆项目仓库

首先需要将项目克隆到本地：

git clone https://gitcode.com/gh_mirrors/fb/FbxExporter

导入 Unity 项目

1. 打开 Unity 编辑器，创建新项目或打开现有项目
2. 将克隆的 FbxExporter 文件夹拖入 Unity 项目的 Assets 目录中
3. 等待 Unity 自动导入资源并编译脚本

插件配置

在 Unity 编辑器中，通过菜单栏打开 FBX Exporter 窗口：

Window -> Fbx Exporter

基本使用方法

导出单个对象

1. 在 Hierarchy 视图中选择要导出的游戏对象
2. 在 Fbx Exporter 窗口中选择导出范围（Selected Objects）
3. 点击 Export 按钮选择保存路径
4. 等待导出完成

导出整个场景

1. 在 Fbx Exporter 窗口中将 Scope 设置为 "Entire Scene"
2. 点击 Export 按钮选择保存路径
3. 等待导出完成

代码集成示例

FBX Exporter 提供了完整的 API 接口，可以在脚本中直接调用导出功能：

using UnityEngine;
using UTJ.FbxExporter;

public class CustomFBXExporter : MonoBehaviour
{
    public void ExportSelectedObject(GameObject targetObject)
    {
        var options = ExportOptions.defaultValue;
        var exporter = new FbxExporter(options);
        
        if (exporter.CreateScene(targetObject.name))
        {
            exporter.AddNode(targetObject);
            exporter.WriteAsync("ExportPath/filename.fbx", Format.FBX);
        }
    }
}

高级功能

蒙皮网格导出

FBX Exporter 完全支持蒙皮网格的导出，包括骨骼层级结构和权重信息：

// 获取 SkinnedMeshRenderer 组件并导出
var skinnedMesh = GetComponent<SkinnedMeshRenderer>();
if (skinnedMesh != null)
{
    // 自动处理骨骼和权重数据
}

混合形状支持

支持从网格中提取并导出混合形状数据：

// 处理混合形状帧数据
int blendshapeCount = mesh.blendShapeCount;
for (int bi = 0; bi < blendshapeCount; ++bi)
{
    string name = mesh.GetBlendShapeName(bi);
    int frameCount = mesh.GetBlendShapeFrameCount(bi);
    // 导出每个帧的变形数据
}

地形数据导出

支持将 Unity 地形数据转换为网格并导出：

// 处理地形高度图数据
var terrainData = terrain.terrainData;
var heightmap = terrainData.GetHeights(0, 0, width, height);
// 生成地形网格并导出

最佳实践

性能优化建议

• 在导出前确保所有网格都是可读的（Read/Write Enabled）
• 对于复杂场景，建议分批次导出而不是一次性导出全部
• 使用异步导出避免阻塞主线程

兼容性注意事项

• 确保目标 3D 软件支持导入的 FBX 版本
• 检查材质和纹理的兼容性
• 验证骨骼和动画数据的正确性

错误处理

在代码中使用适当的错误处理机制：

try
{
    // 导出操作
    exporter.WriteAsync(path, format);
}
catch (System.Exception e)
{
    Debug.LogError("导出失败: " + e.Message);
}

常见问题解答

Q: 导出的 FBX 文件在其他软件中无法打开？ A: 请检查目标软件支持的 FBX 版本，并确保所有依赖资源都已正确导出。

Q: 蒙皮权重数据丢失？ A: 确保 SkinnedMeshRenderer 组件和相关的骨骼层级结构完整。

Q: 混合形状数据不完整？ A: 检查网格的混合形状帧数据是否可读，并在导出前验证数据完整性。

通过本教程，您应该能够熟练使用 Unity FBX Exporter 进行模型数据的导出操作，实现 Unity 与专业 3D 软件之间的无缝数据交换。