ULevelPlayerPlacer 클래스 참조

#include <LevelPlayerPlacer.h>

ULevelPlayerPlacer에 대한 상속 다이어그램 :

ULevelPlayerPlacer에 대한 협력 다이어그램:

Protected 멤버 함수
void	PlacePlayerAtTransform (UWorld *InWorld, const FPrimaryAssetId &LevelAssetID, const FTransform &SpawnTransform)
APawn *	EnsurePlayerPawn (UWorld *InWorld, const FPrimaryAssetId &LevelAssetID, const FTransform &SpawnTransform, bool &bOutSpawned)
bool	CanPlacePlayerAtTransform (UWorld *InWorld, const FTransform &SpawnTransform) const
void	SchedulePlacementRetry (UWorld *InWorld, const FPrimaryAssetId &LevelAssetID, const FTransform &SpawnTransform)

Protected 속성
float	PlacementTraceStartOffsetZ = 0.0f
float	PlacementTraceEndOffsetZ = 150.0f
float	PlacementRetryInterval = 0.1f

상세한 설명

플레이어 배치 전략의 기반 클래스.

멤버 함수 문서화

CanPlacePlayerAtTransform()

bool ULevelPlayerPlacer::CanPlacePlayerAtTransform ( UWorld *  InWorld, const FTransform &  SpawnTransform  ) const

protected

{
    if (InWorld == nullptr)
    {
        return false;
    }
 
    const FVector SpawnLocation = SpawnTransform.GetLocation();
    const FVector TraceStart = SpawnLocation + FVector::UpVector * PlacementTraceStartOffsetZ;
    const FVector TraceEnd = SpawnLocation - FVector::UpVector * PlacementTraceEndOffsetZ;
 
    FHitResult Hit;
    FCollisionObjectQueryParams ObjectQueryParams;
    ObjectQueryParams.AddObjectTypesToQuery(ECC_WorldStatic);
    const FCollisionQueryParams QueryParams(SCENE_QUERY_STAT(PlayerPlacementTrace), false);
 
    return InWorld->LineTraceSingleByObjectType(Hit, TraceStart, TraceEnd, ObjectQueryParams, QueryParams);
}

이 함수를 호출하는 함수들에 대한 그래프입니다.:

EnsurePlayerPawn()

APawn * ULevelPlayerPlacer::EnsurePlayerPawn ( UWorld *  InWorld, const FPrimaryAssetId &  LevelAssetID, const FTransform &  SpawnTransform, bool &  bOutSpawned  )

protected

{
    bOutSpawned = false;
 
    if (InWorld == nullptr)
    {
        LOG_ERROR(LogCK, "World가 유효하지 않습니다.");
        return nullptr;
    }
 
    APlayerController* PC = InWorld->GetFirstPlayerController();
 
    if (PC == nullptr)
    {
        LOG_ERROR(LogCK, "PlayerController를 찾을 수 없습니다.");
        return nullptr;
    }
 
    APawn* ExistingPawn = PC->GetPawn();
 
    if (ExistingPawn)
    {
        return ExistingPawn;
    }
 
    AGameModeBase* GameMode = InWorld->GetAuthGameMode();
 
    if (GameMode == nullptr)
    {
        LOG_ERROR(LogCK, "GameMode를 가져올 수 없어 플레이어 Pawn을 스폰할 수 없습니다.");
        return nullptr;
    }
 
    GameMode->RestartPlayerAtTransform(PC, SpawnTransform);
    APawn* NewPawn = PC->GetPawn();
 
    if (NewPawn == nullptr)
    {
        LOG_ERROR(LogCK, "플레이어 Pawn 스폰에 실패했습니다.");
        return nullptr;
    }
 
    bOutSpawned = true;
 
    UGameInstance* GameInstance = InWorld->GetGameInstance();
 
    if (GameInstance == nullptr)
    {
        LOG_WARNING(LogCK, "GameInstance가 유효하지 않아 PlayerManagementSubsystem에 스폰을 알릴 수 없습니다.");
        return NewPawn;
    }
 
    ULocalPlayer* LocalPlayer = GameInstance->GetFirstGamePlayer();
 
    if (LocalPlayer == nullptr)
    {
        LOG_WARNING(LogCK, "LocalPlayer가 유효하지 않아 PlayerManagementSubsystem에 스폰을 알릴 수 없습니다.");
        return NewPawn;
    }
 
    if (UPlayerManagementSubsystem* PlayerManagement = LocalPlayer->GetSubsystem<UPlayerManagementSubsystem>())
    {
        PlayerManagement->HandlePlayerSpawn(NewPawn, LevelAssetID, InWorld);
    }
    else
    {
        LOG_ERROR(LogCK, "PlayerManagementSubsystem을 가져올 수 없습니다.");
    }
 
    return NewPawn;
}

이 함수를 호출하는 함수들에 대한 그래프입니다.:

PlacePlayerAtTransform()

void ULevelPlayerPlacer::PlacePlayerAtTransform ( UWorld *  InWorld, const FPrimaryAssetId &  LevelAssetID, const FTransform &  SpawnTransform  )

protectedvirtual

{
    if (InWorld == nullptr)
    {
        LOG_ERROR(LogCK, "World가 유효하지 않습니다.");
        return;
    }
 
    if (CanPlacePlayerAtTransform(InWorld, SpawnTransform) == false)
    {
        SchedulePlacementRetry(InWorld, LevelAssetID, SpawnTransform);
        return;
    }
 
    bool bSpawned = false;
    APawn* Pawn = EnsurePlayerPawn(InWorld, LevelAssetID, SpawnTransform, bSpawned);
 
    if (Pawn == nullptr)
    {
        return;
    }
 
    if (bSpawned)
    {
        return;
    }
 
    Pawn->SetActorLocationAndRotation(SpawnTransform.GetLocation(), SpawnTransform.GetRotation().Rotator(), true, nullptr, ETeleportType::TeleportPhysics);
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

SchedulePlacementRetry()

void ULevelPlayerPlacer::SchedulePlacementRetry ( UWorld *  InWorld, const FPrimaryAssetId &  LevelAssetID, const FTransform &  SpawnTransform  )

protected

{
    if (InWorld == nullptr)
    {
        return;
    }
 
    TWeakObjectPtr<ULevelPlayerPlacer> WeakThis = this;
    TWeakObjectPtr<UWorld> WeakWorld = InWorld;
 
    auto RetryPlacement = [WeakThis, WeakWorld, LevelAssetID, SpawnTransform]()
    {
        ULevelPlayerPlacer* Placer = WeakThis.Get();
        UWorld* World = WeakWorld.Get();
 
        if (Placer == nullptr || World == nullptr)
        {
            return;
        }
 
        Placer->PlacePlayerAtTransform(World, LevelAssetID, SpawnTransform);
    };
 
    if (PlacementRetryInterval < KINDA_SMALL_NUMBER)
    {
        InWorld->GetTimerManager().SetTimerForNextTick(RetryPlacement);
        return;
    }
 
    FTimerHandle RetryTimerHandle;
    FTimerManager& TimeManager = InWorld->GetTimerManager();
    TimeManager.SetTimer(RetryTimerHandle, RetryPlacement, PlacementRetryInterval, false);
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

PlacementRetryInterval

float ULevelPlayerPlacer::PlacementRetryInterval = 0.1f

protected

PlacementTraceEndOffsetZ

float ULevelPlayerPlacer::PlacementTraceEndOffsetZ = 150.0f

protected

PlacementTraceStartOffsetZ

float ULevelPlayerPlacer::PlacementTraceStartOffsetZ = 0.0f

protected

---

이 클래스에 대한 문서화 페이지는 다음의 파일들로부터 생성되었습니다.:

• Source/CK_UE/Level/Placer/LevelPlayerPlacer.h
• Source/CK_UE/Level/Placer/LevelPlayerPlacer.cpp