Unreal Engine 5.7 — 已弃用的 API
最后验证： 2026-02-13
已弃用 API 及其替代方案的快速查阅表。
格式：不要用 X → 改用 Y
迁移： 安装 Enhanced Input 插件，创建 Input Actions 和 Input Mapping Contexts。
渲染
世界构建
动画
游戏玩法
Niagara（VFX）
音频
网络
C++ 脚本
快速迁移模式
// ❌ Deprecated
void AMyCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent) {
PlayerInputComponent->BindAction("Jump", IE_Pressed, this, &ACharacter::Jump);
}
// ✅ Enhanced Input
#include "EnhancedInputComponent.h"
void AMyCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent) {
UEnhancedInputComponent* EIC = Cast<UEnhancedInputComponent>(PlayerInputComponent);
if (EIC) {
EIC->BindAction(JumpAction, ETriggerEvent::Started, this, &ACharacter::Jump);
}
}
材质示例
// ❌ Deprecated: Legacy material
// Use standard material graph (still works but not recommended)
// ✅ Substrate Material
// Enable: Project Settings > Engine > Substrate > Enable Substrate
// Use Substrate nodes in material editor
World Partition 示例
// ❌ Deprecated: Level streaming volumes
// Load/unload levels manually
// ✅ World Partition
// Enable: World Settings > Enable World Partition
// Use Data Layers for streaming
粒子系统示例
// ❌ Deprecated: Cascade
UParticleSystemComponent* PSC = CreateDefaultSubobject<UParticleSystemComponent>(TEXT("Particles"));
// ✅ Niagara
UNiagaraComponent* NiagaraComp = CreateDefaultSubobject<UNiagaraComponent>(TEXT("Niagara"));
音频示例
// ❌ Deprecated: Sound Cue for complex logic
// Use Sound Cue editor nodes
// ✅ MetaSounds
// Create MetaSound Source asset, use node-based audio
总结：UE 5.7 技术栈
参考来源：
- https://docs.unrealengine.com/5.7/en-US/deprecated-and-removed-features/
- https://dev.epicgames.com/documentation/en-us/unreal-engine/unreal-engine-5-7-release-notes