UE4引擎之Commandlet命令

最新推荐文章于 2024-07-25 20:42:50 发布
最新推荐文章于 2024-07-25 20:42:50 发布
阅读量3.3k 收藏 4
点赞数 2
分类专栏： UE4引擎 文章标签： c++
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/KKsuser/article/details/110458915
版权

开篇

其实UE4中有很多Commandlet这些Commandlet 为我们提供了不同的功能有自动导入资源的ImportAssetsCommandlet；烘焙的CookCommandlet等等。了解和熟悉这些Commandlet可以帮助我们实现自动化或者半自动化流程。

今天我们就来讲讲ImportAssetsCommandlet 这个Commandlet 可以实现静默的资源导入。想具体了解这个命令都干了些什么事情就需要去到引擎源代码中的Editor\UnrealEd\Private\Commandlets\ImportAssetsCommandlet.cpp 看源码了。 在这里我教大家如何使用或者是如何配置一个自动化导入资源的命令以及简单的剖析这个命令的源码 ，看看里面都做了些什么。

正文

如何使用
使用这个命令的方式很简单打开cmd命令行找到 引擎的Binaries\Win64文件夹 下有一个叫UE4Ediotr-cmd.exe 的可执行文件 将这个exe 拖进cmd窗口 然后 按照下面的格式输入命令:

 项目的.uproject  -run=ImportAssets -importSettings="导入设置的json文件路径"

完整示例:

D:\SoftWare\UE_4.25\Engine\Binaries\Win64\UE4Editor-Cmd.exe "D:\WorkSpace\Unreal Project\ACT\ACT.uproject" -run=ImportAssets -importSettings="D:/Export/Importsetting.json"

在这里插入图片描述

首先我们来讲下 第一个是引擎编辑器的cmd 第二个参数是你要导入的项目 第三个是需要导入的资源的json 文件

下面我们来看看这个导入设置的json 文件

{
  "ImportGroups": [
    {
      "FileNames": [ "C:/Users/VR/Desktop/Export/43291A04.fbx" ],
      "bReplaceExisting": "true",
      "DestinationPath": "/Game/mesh/UserModel/638281/43291A04/",
      "FactoryName": "FbxFactory",
      "ImportSettings": {}
    },
    {
      "FileNames": [ "C:/Users/VR/Desktop/Temp/43291A04/3d66Mat-855555-maps-1_diffuse.jpg", "C:/Users/VR/Desktop/Temp/43291A04/3d66Mat-855555-maps-1_normal.jpg", "C:/Users/VR/Desktop/Temp/43291A04/43291A04_001_AO.png", "C:/Users/VR/Desktop/Temp/43291A04/43291A04_002_AO.png", "C:/Users/VR/Desktop/Temp/43291A04/43291A04_003_AO.png", "C:/Users/VR/Desktop/Temp/43291A04/43291A04_006_AO.png"],
      "bReplaceExisting": "true",
      "DestinationPath": "/Game/mesh/UserModel/638281/43291A04/Texture/",
      "bSkipReadOnly": "true",
      "ImportSettings": {}
    }
  ]
}

我们来解析一下 ImportGroups 里面是 代表的是每组导入的资源 可以分组导入
例如我第一组到的可能是fbx文件 然后指定使用fbx的工厂类去处理这批资源自动导入 其中还有
bReplaceExisting 参数指定是否替换现有资源；
FileNames 组里面都是些需要导入的资源的路径 ；
DestinationPath 需要将这组资源导入到什么位置
bSkipReadOnly 是否跳过自读的文件 ；
ImportSettings 里面没放参数 但是可以通过json去指定一些导入的设置 下面放一组fbx 的可指定参数参照; ------当然除了这种Json的方式指定导入时的设置我们还可以打开我们的项目将我们需要导入的资源不同类型的先导入一遍然后按照自己的设置去导入 然后会发现我们的项目save\Config\Windows\EditorPerProjectUserSettings.ini下的配置文件会帮我们记录这份导入设置 看下图

"ImportSettings": {
    "AnimSequenceImportData":{},
    "SkeletalMeshImportData":{},
    "TextureImportData":{},
    "StaticMeshImportData":{}
    "bCombineMeshes":0,
    "bAutoGenerateCollision":1,
    "bRemoveDegenerates":1
}

在这里插入图片描述
上图中都是记录的一些导入设置 ImportAssets 命令执行时如果发现 ImportSettings 里面是空的就会去读项目的设置

代码的简单分析
由于代码过多这里没有办法对所有代码进行注解，只能对部分我认为比较重要的代码进行注解

bool UImportAssetsCommandlet::ImportAndSave(const TArray<UAutomatedAssetImportData*>& AssetImportList)
{
	bool bImportAndSaveSucceeded = true; //初始化自动导入和自动保存

	FAssetToolsModule& AssetToolsModule = FModuleManager::Get().LoadModuleChecked<FAssetToolsModule>("AssetTools"); //加载AssetTools模块 这个模块内包含了很多对资源进行操作的功能 具体可以看看AssetTools模块的源代码 

	ISourceControlProvider& SourceControlProvider = ISourceControlModule::Get().GetProvider();

	for(const UAutomatedAssetImportData* ImportData : AssetImportList) //枚举每组导入资源
	{
		UE_LOG(LogAutomatedImport, Log, TEXT("Importing group %s"), *ImportData->GetDisplayName() );

		UFactory* Factory = ImportData->Factory; //从这组导入资源中获取指定的工厂类 我们上面示例Json中导入 FBX就有指定
		const TSharedPtr<FJsonObject>* ImportSettingsJsonObject = nullptr;
		if(ImportData->ImportGroupJsonData.IsValid()) //判断这组导入资源的Json是否有效
		{
			ImportData->ImportGroupJsonData->TryGetObjectField(TEXT("ImportSettings"), ImportSettingsJsonObject); //尝试获取导入设置Json
		}

		if(Factory != nullptr && ImportSettingsJsonObject) //如果拿到了有效的Json 并且知道了改用什么工厂类去处理
		{
			IImportSettingsParser* ImportSettings = Factory->GetImportSettingsParser(); //拿到这个工程类对导入设置的解析器 因为每种资源的导入都有专门的工厂类去处理
			if(ImportSettings)
			{
				ImportSettings->ParseFromJson(ImportSettingsJsonObject->ToSharedRef()); //解析导入设置
			}
		}
		else if(Factory == nullptr && ImportSettingsJsonObject)
		{
			UE_LOG(LogAutomatedImport, Warning, TEXT("A vaild factory name must be specfied in order to specify settings"));
		}

		// Load a level if specified
		bImportAndSaveSucceeded = LoadLevel(ImportData->LevelToLoad); //尝试去加载指定的关卡 无指定则 会自动忽略 具体可以看里面的代码实现

		// Clear dirty packages that were created as a result of loading the level.  We do not want to save these
		ClearDirtyPackages(); //资源操作 ---- 清理所有资源身上的需要保存的标记

		TArray<UObject*> ImportedAssets = AssetToolsModule.Get().ImportAssetsAutomated(ImportData); //根据解析好的数据以及设置自动进行资源呢导入 返回一组以及导入的资源
		if(ImportedAssets.Num() > 0 && bImportAndSaveSucceeded)
		{
			TArray<UPackage*> DirtyPackages; //创建包

			TArray<FSourceControlStateRef> PackageStates;

			FEditorFileUtils::GetDirtyContentPackages(DirtyPackages); //将内容浏览器中刚刚自动导入的资源并标记为需要保存的添加到这个包的数组内
			FEditorFileUtils::GetDirtyWorldPackages(DirtyPackages);//这个则是世界中的 同上

			bool bUseSourceControl = bHasSourceControl && SourceControlProvider.IsAvailable(); //这个是版本管理的 git 或者 svn 等
			if(bUseSourceControl)
			{
				SourceControlProvider.GetState(DirtyPackages, PackageStates, EStateCacheUsage::ForceUpdate);
			}

			for(int32 PackageIndex = 0; PackageIndex < DirtyPackages.Num(); ++PackageIndex)
			{
				UPackage* PackageToSave = DirtyPackages[PackageIndex];

				FString PackageFilename = SourceControlHelpers::PackageFilename(PackageToSave);

				bool bShouldAttemptToSave = false;
				bool bShouldAttemptToAdd = false;
				if(bUseSourceControl) //下面都是版本管理的内容
				{
					FSourceControlStateRef PackageSCState = PackageStates[PackageIndex];

					bool bPackageCanBeCheckedOut = false;
					if(PackageSCState->IsCheckedOutOther())
					{
						// Cannot checkout, file is already checked out
						UE_LOG(LogAutomatedImport, Error, TEXT("%s is already checked out by someone else, can not submit!"), *PackageFilename);
						bImportAndSaveSucceeded = false;
					}
					else if(!PackageSCState->IsCurrent())
					{
						// Cannot checkout, file is not at head revision
						UE_LOG(LogAutomatedImport, Error, TEXT("%s is not at the head revision and cannot be checked out"), *PackageFilename);
						bImportAndSaveSucceeded = false;
					}
					else if(PackageSCState->CanCheckout())
					{
						const bool bWasCheckedOut = SourceControlHelpers::CheckOutOrAddFile(PackageFilename);
						bShouldAttemptToSave = bWasCheckedOut;
						if(!bWasCheckedOut)
						{
							UE_LOG(LogAutomatedImport, Error, TEXT("%s could not be checked out"), *PackageFilename);
							bImportAndSaveSucceeded = false;
						}
					}
					else
					{
						// package was not checked out by another user and is at the current head revision and could not be checked out
						// this means it should be added after save because it doesn't exist
						bShouldAttemptToSave = true;
						bShouldAttemptToAdd = true;
					}
				}
				else
				{
					bool bIsReadOnly = IFileManager::Get().IsReadOnly(*PackageFilename); //判断是否只读
					if(bIsReadOnly && ImportData->bSkipReadOnly) //判断是否跳过只读
					{
						bShouldAttemptToSave = false;
						if(bIsReadOnly)
						{
							UE_LOG(LogAutomatedImport, Error, TEXT("%s is read only and -skipreadonly was specified.  Will not save"), *PackageFilename);
							bImportAndSaveSucceeded = false;
						}
					}
					else if(bIsReadOnly)
					{
						bShouldAttemptToSave = FPlatformFileManager::Get().GetPlatformFile().SetReadOnly(*PackageFilename, false); //设置为不是只读
						if(!bShouldAttemptToSave)
						{
							UE_LOG(LogAutomatedImport, Error, TEXT("%s is read only and could not be made writable.  Will not save"), *PackageFilename);
							bImportAndSaveSucceeded = false;
						}
					}
					else
					{
						bShouldAttemptToSave = true;
					}
				}

				if(bShouldAttemptToSave)
				{
					SavePackage(PackageToSave, PackageFilename); //将包保存下来

					if(bShouldAttemptToAdd)
					{
						const bool bWasAdded = SourceControlHelpers::MarkFileForAdd(PackageFilename);
						if(!bWasAdded)
						{
							UE_LOG(LogAutomatedImport, Error, TEXT("%s could not be added to source control"), *PackageFilename);
							bImportAndSaveSucceeded = false;
						}
					}
				}
			}
		}
		else
		{
			bImportAndSaveSucceeded = false;
			UE_LOG(LogAutomatedImport, Error, TEXT("Failed to import all assets in group %s"), *ImportData->GetDisplayName());
		}
	}

	return bImportAndSaveSucceeded;
}

上面这部分是资源的的保存了，资源的导入过程中还做了很多事情。不过那都是在一个个工厂类中的事情了，还有前期的Commandlet是如何在为指定工厂类的情况下 知道改用那种工厂类去解析的 。 具体这些代码都可以翻看UE4的源码找到答案

最后
还是那句话如果文章中有一些错误内容请帮我指出，我会十分感谢!!!

文章虽然写的不是很好，但希望转载时注明出处。

Khcys_
关注
专栏目录
ue4cmd怎么调用_虚幻引擎UE4-命令行使用的一些详细技巧
weixin_39915700的博客
12-22 3031
虚幻引擎支持很多的命令行命令和参数，你可以替换 UE4Editor-*.exe 或者 UE4-*.exe 你需要打开内置的其他配置项目。一、从命令行运行编辑项目1. 导航到您的[LauncherInstall][VersionNumber]\Engine\Binaries\Win64 目录中。2. 右键单击上 UE4Editor.exe 的可执行文件，并选择创建快捷方式。3. 重命名该快捷方式，它...
UE4 自定义Commanlet
一个字
06-04 614
参考文档：https://blog.csdn.net/u013412391/article/details/104869974 在4.24引擎上跑不起来，提示unresolved externals 新的如下： importassetscommandlet.h #pragma once #include "Commandlets/Commandlet.h" //#include "CoreMinimal.h" //#include "UObject/ObjectMacros.h" //#inc
UE4调试UE4Editor-Cmd.exe
最新发布
sinat_23135151的博客
07-25 420
EnginePath%\Binaries\Win64\UE4Editor-Cmd.exe %ClientPath%\%ProjectName%.uproject -run=HotPatcher {其它参数}在调试器中，下图【1】处，选择工程，然后在【2】处，修改为上面的命令。当然，前面的UE4Editor-Cmd.exe不用写在Program arguments处，因为它其实在图2处配置了，鼠标悬停可见其值。然后，断点在你想要调试的地方，就可以Debug了。
ue4离线文档_[UE4,automation]UE4批渲染cmd篇
weixin_39702479的博客
12-11 559
之前做项目的过程中，有一部分工作是在UE4里制作输出小短片。由于要完成的量比较大，所以研究了一些批渲染的方法。逻辑上跟以前在maya里用batch render差不多，不过UE4这边的设置相对繁琐一点点。本文讲解了在不打开UE4软件的前提下，批量输出预先设置好的sequence序列的方法。也算是我的传统艺能了。因为代码排版和外链接问题，知乎阅读体验更佳。https://zhuanlan...
UE4 Commandlet
游戏开发、游戏引擎开发、逆向破解爱好者
07-02 538
网上关于UE4 Commandlet的介绍实在是不多，唯一能找到的两篇文章，不过有这两篇文章也足够理解Commandlet了。 尝试UE4的Commandlet。 UE4: How To Write a Commandlet。
尝试UE4的Commandlet
主要记录了工作之余胡乱学习的知识，大部分是入门级别的内容。 主要是为了自己未来有用到时能快速上手，相当于是个备忘录。 当然，也很开心其他人可以从中找到对自己有用的信息。^_^
03-14 7623
关于UE4的Commandlet，我并没有找到官方文档专门介绍这个功能。不过他的基本功能还是比较直观的：可以通过控制台直接调用一些命令，而这些命令是可以自己定制的。调用的格式是： [UE4Editor-Cmd.exe路径] [uproject路径] -run=[Commandlet名字] -这条Commandlet的参数 现在我想尝试使用一下这个功能。 观察 首先，UCommandlet是一个继承...
尝试使用UE4的Commandlet的参数
主要记录了工作之余胡乱学习的知识，大部分是入门级别的内容。 主要是为了自己未来有用到时能快速上手，相当于是个备忘录。 当然，也很开心其他人可以从中找到对自己有用的信息。^_^
04-19 1204
尝试使用Commandlet的参数。
游戏引擎效果演示，用于展示 Vue + UE4
03-27
游戏引擎效果演示，用于展示 Vue + UE4
虚幻引擎(UE4)技术基础 PPT课件(共8单元)项目八VR硬件平台搭建.pdf
06-28
虚幻引擎(UE4)技术基础 PPT课件(共8单元)项目八VR硬件平台搭建.pdf虚幻引擎(UE4)技术基础 PPT课件(共8单元)项目八VR硬件平台搭建.pdf虚幻引擎(UE4)技术基础 PPT课件(共8单元)项目八VR硬件平台搭建.pdf虚幻引擎(UE4)...
UE4引擎浅析
04-25
**UE4引擎浅析** UE4，全称Unreal Engine 4，是由Epic Games开发的一款强大、功能全面的游戏开发引擎。它以其先进的图形技术、高效的性能优化和强大的脚本系统，深受全球游戏开发者和影视制作团队的喜爱。本文将...
UE4引擎批量重命名插件
11-19
UE4（Unreal Engine 4）是一款由Epic Games开发的强大的游戏开发引擎，被广泛应用于游戏制作、影视特效、虚拟现实等领域。在UE4中，资源管理是至关重要的，尤其是当项目涉及到大量的素材和对象时，保持资产的命名...
UE4帮助文档 UE4离线帮助文档 UE4API
11-10
UE4的API是其核心功能之一，提供了丰富的编程接口，允许开发者通过C++或者蓝图系统进行深度定制和扩展。 UE4离线帮助文档是一个极其重要的资源，尤其对于那些没有稳定网络环境或需要高效查阅的人来说。"UE4API"文件...
ue 小知识点 commandlet
opk8848的专栏
10-09 802
上面引擎定制好的 一些commandlet的功能，可以直接通过命令行调用 [UE4Editor-Cmd.exe路径] [uproject路径] -run=[Commandlet名字] -这条Commandlet的参数 "D:/Epic Games/UE_4.24/Engine/Binaries/Win64/UE4Editor-Cmd.exe" D:/0_WorkSpace/UE4/test1/test1.uproject -run=TextAsset filename=testFolder/te...
UE4 Command-Line Arguments
痞子龙3D编程
09-02 4847
On this page: ModesURL Parameters General OptionsServer Options Switches DeveloperRenderingNetworkUserServer SwitchesGame Stats/DatabaseINI/Config FilesDebuggingMisc. Command-Line Arg
ue4cmd怎么调用_ue4控制台怎么使用，常用命令是那些?
weixin_42511177的博客
01-13 3702
原文发布在我的专栏里，内容的其中一部分非常符合这个题目，搬运过来。想看后续更新，可以关注原文。戴巍：[UE4]偏门实用技巧合集​zhuanlan.zhihu.com控制台使用技巧~ 号键打开控制台(就是键盘上1的左边，tab的上面)在什么都不输入的情况下，使用键盘上的 箭头↑ 键，可以看到并且选择之前已经输入过的控制台指令，反复开关某些指令的时候，非常实用输入控制台指令，并不需要打全名，比如我记得...
ue4cmd怎么调用_UE4控制台命令
weixin_39561004的博客
12-22 1551
打包后执行想要恒定帧率及显示帧率可在蓝图中执行：修改分辨率的命令是：，但不能一开始就执行，可能会被配置文件里的设置顶替(可能是，再研究下)其中w是指窗口，要全屏可改成f。也可以在代码中修改分辨率，如下：void AHxVipPlayerManager::SetFullScreenMode(bool bFull){if (bFull){UGameUserSettings::GetGameUserSe...
UE4/虚幻4 运行脚本【python script commandlet looks like a commandlet but we could not find the class】问题解决指引
BedivereAlter的博客
07-29 1538
目录问题产生场景可能的解决方案0可能的解决方案1可能的解决方案2可能的解决方案3可能的解决方案4可能的解决方案5备选方案 问题产生场景 先看一下我是怎么遇到这个问题的吧， 运行cmd（非管理员身份） cd跳转到\Engine\Binaries\Win64 运行命令 UE4Editor-Cmd.exe “工程路径” -run=pythonscript -script=“脚本路径” 可能的解决方案0 在遇到事情之后，你肯定逃不掉先看看官方文档 https://docs.unrealengine.com/4.26
PowerShell 杂记(二)－－－Commandlet基本概念
知识的天空
09-26 1785
 一个WPS命令称为commandlet(cmdlet)或function。它有三个部分：1. 动词 2. 名词 3. 参数列表(可选)构成Verb-Norn [-parameter list]形式，如Get-Process参数可以多个。下面三个命令是一样的。Get-ChildItem C:/temp *.doc   (但不能写成Get-ChildItem *.doc C:/temp)Get-Ch
UE4 调用Windows默认程序打开文件
weixin_42318094的博客
04-24 684
.h #include "CoreMinimal.h" #include "Misc/Paths.h" //获取项目路径 #include "Kismet/BlueprintFunctionLibrary.h" #include "MyBlueprintFunctionLibrary.generated.h" UCLASS() class MYTEST05_API UMyBlueprintFunctionLibrary : public UBlueprintFunctionLibrary { ...
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值