InteractableComponent.h

이 파일의 문서화 페이지로 가기

// Copyright (c) 2025 Doppleddiggong. All rights reserved. Unauthorized copying, modification, or distribution of this file, via any medium is strictly prohibited. Proprietary and confidential.
 
#pragma once
 
#include "CoreMinimal.h"
#include "Components/ActorComponent.h"
#include "InteractableComponent.generated.h"
 
#define INTERACT_WIDGET_PATH TEXT("/Game/CustomContents/UI/Widgets/WBP_InteractWidget.WBP_InteractWidget_C")
 
UENUM(BlueprintType)
enum class EInteractionType : uint8
{
    None        UMETA(DisplayName = "None"),
    PickUp      UMETA(DisplayName = "Pick Up"),         // 집어올리기
    Button      UMETA(DisplayName = "Button"),          // 버튼 누르기
    Kiosk       UMETA(DisplayName = "Kiosk"),
};
 
DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnInteractionTriggered, AActor*, Interactor);
 
DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnOutlineStateChanged, bool, bShouldShowOutline);
 
UCLASS(ClassGroup=(Custom), meta=(BlueprintSpawnableComponent))
class ONEPIECE_API UInteractableComponent : public UActorComponent
{
    GENERATED_BODY()
 
public:
    UInteractableComponent();
    
protected:
    virtual void BeginPlay() override;
    virtual void TickComponent(float DeltaTime, ELevelTick TickType, FActorComponentTickFunction* ThisTickFunction) override;
    virtual void GetLifetimeReplicatedProps(TArray<class FLifetimeProperty>& OutLifetimeProps) const override;
 
private:
    void InitDetectionRange();
    
public:
    // ========================================
    // 상호작용 설정
    // ========================================
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Interaction")
    EInteractionType InteractionType = EInteractionType::PickUp;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Interaction")
    FString InteractionPrompt = TEXT("Press E to Interact");
 
    UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Interaction")
    TObjectPtr<class UBoxComponent> DetectionRange;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Interaction")
    float DetectionDistance = 250.0f;
 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Debug")
    bool bShowDetectionDebug = true;
 
    UPROPERTY(BlueprintReadOnly, Category = "Interaction")
    bool bCanInteract = true;
 
    // ========================================
    // 델리게이트
    // ========================================
 
    UPROPERTY(BlueprintAssignable, Category = "Interaction")
    FOnInteractionTriggered OnInteractionTriggered;
 
    UPROPERTY(BlueprintAssignable, Category = "Interaction")
    FOnOutlineStateChanged OnOutlineStateChanged;
 
public:
    UFUNCTION()
    void OnRep_HoldingOwner();
 
    UFUNCTION()
    void OnRep_IsPickedUp();
 
    // 현재 들고 있는 상태인지 확인
    // BlueprintPure : 값만 반환, 상태 변경 없을 때 사용
    UFUNCTION(BlueprintPure, Category = "Interaction")
    FORCEINLINE bool IsPickedUp() const {return bIsPickedUp;}
    
    // 물체 집어올림
    UFUNCTION(BlueprintCallable, Category = "Interaction")
    void PickUp(class AActor* NewHoldingOwner);
 
    UFUNCTION(Server, Reliable, WithValidation)
    void Server_PickUp(class AActor* NewHoldingOwner);
 
    // 물체 놓음
    UFUNCTION(BlueprintCallable, Category = "Interaction")
    void Drop();
 
    UFUNCTION(Server, Reliable, WithValidation)
    void Server_Drop();
 
    // 디버그 정보 표시 (타겟팅 중일 때)
    UFUNCTION(BlueprintCallable, Category = "Debug")
    void ShowDebugInfo(AActor* ViewerActor);
 
    // ========================================
    // 범용 상호작용
    // ========================================
 
    UFUNCTION(BlueprintCallable, Category = "Interaction")
    void TriggerInteraction(AActor* Interactor);
 
    UFUNCTION(BlueprintCallable, Category = "Interaction")
    void SetOutlineState(bool bEnabled);
    
public:
    // Interaction
    UPROPERTY(ReplicatedUsing=OnRep_HoldingOwner)
    AActor* HoldingOwner;
    UPROPERTY(ReplicatedUsing=OnRep_IsPickedUp, BlueprintReadOnly, Category = "Interaction")
    bool bIsPickedUp = false;
 
    
protected:
    // ========================================
    // Overlap 콜백 (InteractionSystem 등록)
    // ========================================
 
    UFUNCTION()
    void OnDetectionBeginOverlap(UPrimitiveComponent* OverlappedComponent, AActor* OtherActor,
                                  UPrimitiveComponent* OtherComp, int32 OtherBodyIndex,
                                  bool bFromSweep, const FHitResult& SweepResult);
 
    UFUNCTION()
    void OnDetectionEndOverlap(UPrimitiveComponent* OverlappedComponent, AActor* OtherActor,
                                UPrimitiveComponent* OtherComp, int32 OtherBodyIndex);
 
    // ========================================
    // Internal
    // ========================================
 
    bool bOriginalSimulatePhysics = false;
 
    TEnumAsByte<ECollisionEnabled::Type> OriginalCollisionType;
 
protected:
    // Owner Actor의 PrimitiveComponent 찾기
    // UPrimitiveComponent : 물리/충돌/렌더링을 가진 컴포넌트
    //                       USceneComponent의 하위에 존재
    // 컴포넌트가 붙는 액터의 Mesh를 가져오는 역할
    UPrimitiveComponent* GetOwnerPrimitiveComponent() const;
 
 
 
#pragma region Widget
public:
    void InitWidget(class UWidgetComponent* InWidgetComp);
    void UpdateInteractPrompt(const FString& NewPrompt);
 
    bool IsWidgetShowEnable(const class ACharacter* Character) const;
 
    UFUNCTION(BlueprintCallable, Category = "Interaction")
    void SetWidgetVisibility(bool bVisible);
    
    // ========================================
    // 상호작용 위젯
    // ========================================
 
private:
    UFUNCTION(BlueprintCallable, Category = "Interaction")
    void ShowInteractWidget();
 
    UFUNCTION(BlueprintCallable, Category = "Interaction")
    void HideInteractWidget();
 
    void BillboardInteractWidget();
 
private:
    UPROPERTY()
    TObjectPtr<class UWidgetComponent> WidgetComp;
 
#pragma endregion   
};