在Unreal Engine 5 (UE5) 中，编写C++代码以控制关卡中的视频自动循环播放需要仔细管理媒体播放器的生命周期和事件。以下是一个详细的C++类示例，该类将控制视频的自动循环播放，并为每行代码添加了详细的注释。
请注意，这个例子假设你已经有一个 UMediaTexture 和一个相应的媒体文件（如MP4），并且你已经知道如何在UE5编辑器中设置这些资源。
cpp
// MyVideoPlayer.h
#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "MediaPlayer.h"
#include "MyVideoPlayer.generated.h"
UCLASS()
class YOURPROJECTNAME_API AMyVideoPlayer : public AActor
{
GENERATED_BODY()
public:
// 构造函数
AMyVideoPlayer();
protected:
// 游戏开始时调用
virtual void BeginPlay() override;
// 虚函数，每帧调用（如果需要的话）
virtual void Tick(float DeltaTime) override;
// 媒体播放器，用于播放视频
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Video")
UMediaPlayer* MediaPlayer;
// 媒体结束事件的处理句柄
FMediaEndedEventHandle OnMediaEndedHandle;
// 当媒体结束时调用的函数
void OnMediaEnded();
};
// MyVideoPlayer.cpp
#include "MyVideoPlayer.h"
// 构造函数
AMyVideoPlayer::AMyVideoPlayer()
{
// 设置为每帧调用Tick函数（如果不需要，则保持为false）
PrimaryActorTick.bCanEverTick = false; // 假设我们不需要每帧处理
// 创建媒体播放器的默认子对象
// 注意：在构造函数中创建可能不是最佳实践，但在本例中为了简单起见这样做
MediaPlayer = CreateDefaultSubobject<UMediaPlayer>(TEXT("MediaPlayer"));
// 将媒体结束事件绑定到我们的处理函数
// 注意：这里我们假设MediaPlayer已经准备好绑定事件（在实际情况中可能需要检查）
OnMediaEndedHandle = MediaPlayer->OnMediaEnded().AddUObject(this, &AMyVideoPlayer::OnMediaEnded);
}
// 游戏开始时调用
void AMyVideoPlayer::BeginPlay()
{
Super::BeginPlay();
// 假设MediaPlayer的媒体源和纹理已经在编辑器中设置好了
// 并且MediaPlayer已经准备好播放（这里可能需要添加检查逻辑）
// 开始播放视频
if (MediaPlayer && MediaPlayer->IsPrepared())
{
MediaPlayer->Play();
}
else
{
// 如果MediaPlayer没有准备好，可以在这里添加日志或其他处理逻辑
UE_LOG(LogTemp, Warning, TEXT("MediaPlayer is not prepared!"));
}
}
// 当媒体结束时调用的函数
void AMyVideoPlayer::OnMediaEnded()
{
// 视频已结束，循环播放
if (MediaPlayer)
{
// 直接调用Play()来重新播放视频，实现循环
MediaPlayer->Play();
}
}
// Tick函数，虽然在这个例子中我们不需要它，但保留以展示其结构
void AMyVideoPlayer::Tick(float DeltaTime)
{
Super::Tick(DeltaTime);
// 这里可以添加每帧的更新逻辑，但在这个例子中我们不需要
}
注意：
MediaPlayer的准备状态：在 BeginPlay 函数中，我添加了一个检查来确保 MediaPlayer 已经准备好播放。在实际应用中，你可能需要添加更复杂的逻辑来处理媒体加载和准备的状态。
编辑器设置：请确保在UE5编辑器中正确设置了 MediaPlayer 的 Media Texture 和 Media Source。这些设置通常在 MediaPlayer 的细节面板中进行。
性能考虑：如果你的视频在关卡加载时立即播放，请考虑其对游戏加载时间和性能的影响。你可能希望在游戏流程的更晚阶段（如玩家到达某个区域时）再开始播放视频。
事件绑定：在构造函数中绑定事件是可行的，但请确保在对象销毁时（如 Actor 被销毁时）解绑这些事件，以避免潜在的内存泄漏或崩溃。在这个简单的例子中，由于我们是在 AActor 的子类中工作，并且 AActor 的生命周期管理由UE5自动处理，因此通常不需要手动解绑事件。然而，在更复杂的情况下（例如，如果你将 MediaPlayer 作为独立的类管理），则可能需要这样做。
