yjj/test-ue-project

Fork 0

Files

yjj dd642c8585 ceshi

2026-02-26 23:45:31 +08:00

7.1 KiB

Raw Blame History

模型导入优化方案 - Quixel风格自动化导入

📋 改进概述

本次优化将插件的模型导入方式从简单的 AssetTools.ImportAssets() 升级为 Quixel Bridge 风格的自动化导入流程，使用 UAssetImportTask 实现。

✅ 已完成改进（第一阶段）

核心变更

1. 无弹窗自动导入

Task->bAutomated = true;  // 禁用所有UI弹窗
Task->bSave = true;        // 自动保存
Task->bReplaceExisting = bOverwrite;

2. FBX文件自动配置

if (Extension == TEXT("fbx"))
{
    UFbxImportUI* ImportUI = NewObject<UFbxImportUI>();
    
    // 禁用自动检测，明确指定为静态网格体
    ImportUI->bAutomatedImportShouldDetectType = false;
    ImportUI->MeshTypeToImport = FBXIT_StaticMesh;
    
    // 自动导入材质和纹理
    ImportUI->bImportMaterials = true;
    ImportUI->bImportTextures = true;
    
    // 静态网格体设置
    ImportUI->StaticMeshImportData->bAutoGenerateCollision = true;
    ImportUI->StaticMeshImportData->bCombineMeshes = true;
    
    Task->Options = ImportUI;
}

3. 批量导入任务

AssetTools.ImportAssetTasks(ImportTasks);  // 替代了 ImportAssets()

🎯 当前效果

特性	旧方式	新方式（已实现）
UI弹窗	❌ 可能弹出	✅ 完全禁用
FBX配置	❌ 使用默认设置	✅ 自动配置导入选项
材质导入	⚠️ 引擎默认	✅ 自动导入材质和纹理
批量处理	✅ 支持	✅ 改用Task机制
碰撞生成	❌ 需手动	✅ 自动生成碰撞

🚀 进阶改进方向（可选的第二阶段）

如果您希望进一步实现 Quixel级别的PBR材质自动生成，可以考虑以下方向：

方案A：基于命名规则的智能材质生成

Quixel的核心技术是识别纹理命名模式，例如：

Hero_Albedo.png
Hero_Normal.png
Hero_Roughness.png
Hero_Metallic.png
Hero_AO.png

实现步骤：

导入完成后，扫描导入的纹理资产
使用正则表达式或命名约定识别贴图类型
自动创建 UMaterialInstanceConstant
将识别的贴图自动连接到PBR Master Material

方案B：自定义导入Factory

创建继承自 UFbxFactory 的自定义Factory：

完全控制导入流程
在导入过程中自动创建和配置材质
实现自定义命名规范

方案C：后置处理Hook

使用 FAssetEditorManager 或 AssetTools 的回调：

监听资产导入完成事件
自动执行材质创建和配置
应用项目特定的标准

📝 使用示例

TypeScript调用（无变化）

const result = await wsService.callRequest('content.import', {
  files: ['C:/Downloads/Hero.fbx', 'C:/Downloads/Texture_Albedo.png'],
  destination_path: '/Game/Characters/Hero',
  overwrite: false
});

预期效果

✅ 无弹窗 - 不会出现任何导入确认对话框
✅ 自动配置 - FBX文件自动使用优化的导入设置
✅ 材质导入 - 自动导入FBX内嵌的材质和纹理
✅ 碰撞生成 - 自动生成碰撞网格

🔧 技术细节

关键API变更

旧代码

TArray<UObject*> ImportedAssets = AssetTools.ImportAssets(FilesToImport, DestinationPath);

新代码

// 1. 创建任务
UAssetImportTask* Task = NewObject<UAssetImportTask>();
Task->Filename = FilePath;
Task->DestinationPath = DestinationPath;
Task->bAutomated = true;  // 核心：禁用UI

// 2. 配置选项（针对FBX）
UFbxImportUI* ImportUI = NewObject<UFbxImportUI>();
ImportUI->bAutomatedImportShouldDetectType = false;
ImportUI->MeshTypeToImport = FBXIT_StaticMesh;
ImportUI->bImportMaterials = true;
Task->Options = ImportUI;

// 3. 执行批量导入
AssetTools.ImportAssetTasks(ImportTasks);

// 4. 从Task获取结果
Task->ImportedObjectPaths  // 导入的资产路径列表

添加的头文件

#include "AssetImportTask.h"
#include "Factories/FbxImportUI.h"

🎨 Quixel完整实现需要什么？

要达到 完全的Quixel水平，还需要：

1. 智能纹理识别系统

// 伪代码示例
TMap<FString, UTexture2D*> ClassifyTextures(const TArray<UTexture2D*>& Textures)
{
    TMap<FString, UTexture2D*> ClassifiedTextures;
    
    for (UTexture2D* Texture : Textures)
    {
        FString Name = Texture->GetName().ToLower();
        
        if (Name.Contains("albedo") || Name.Contains("diffuse"))
            ClassifiedTextures.Add("Albedo", Texture);
        else if (Name.Contains("normal"))
            ClassifiedTextures.Add("Normal", Texture);
        else if (Name.Contains("rough"))
            ClassifiedTextures.Add("Roughness", Texture);
        // ... 其他类型
    }
    
    return ClassifiedTextures;
}

2. PBR材质实例自动生成

UMaterialInstanceConstant* CreatePBRMaterial(
    const FString& AssetName,
    const TMap<FString, UTexture2D*>& Textures,
    UMaterial* MasterMaterial)
{
    // 创建材质实例
    UMaterialInstanceConstant* MatInst = CreateAsset<UMaterialInstanceConstant>(
        DestinationPath, AssetName + "_Mat");
    
    MatInst->SetParentEditorOnly(MasterMaterial);
    
    // 设置纹理参数
    if (Textures.Contains("Albedo"))
        MatInst->SetTextureParameterValueEditorOnly("AlbedoTexture", Textures["Albedo"]);
    
    if (Textures.Contains("Normal"))
        MatInst->SetTextureParameterValueEditorOnly("NormalTexture", Textures["Normal"]);
    
    // ... 设置其他参数
    
    return MatInst;
}

3. 标准化命名系统

FString StandardizeName(const FString& OriginalName, const FString& AssetType)
{
    // 示例：T_Hero_Albedo, SM_Hero, M_Hero_Inst
    FString Prefix;
    if (AssetType == "Texture") Prefix = "T_";
    else if (AssetType == "StaticMesh") Prefix = "SM_";
    else if (AssetType == "Material") Prefix = "M_";
    
    return Prefix + CleanName(OriginalName);
}

💬 下一步建议

选项1：保持当前实现（推荐）

当前的改进已经解决了弹窗问题
FBX自动导入材质和纹理
满足大部分自动化需求

选项2：实现完整的PBR自动生成

如果您需要：

创建一个 PBR Master Material
实现 content.import_pbr 新命令，包含：
- 纹理分类算法
- 自动材质实例创建
- 标准化命名
将材质自动应用到导入的模型

选项3：混合方案

保留当前的 content.import（通用导入）
新增 content.import_pbr（Quixel风格PBR导入）
让用户根据需求选择使用哪个

📚 参考资料

Unreal Engine文档: UAssetImportTask
FBX导入: UFbxImportUI
AssetTools: IAssetTools::ImportAssetTasks

作者： Antigravity AI Assistant
日期： 2025-12-11
版本： v1.0 - 基础自动化导入实现

7.1 KiB Raw Blame History Unescape Escape