해당 문서는 붕괴 스타레일의 우편 시스템을 모작한 내용을 기록한 문서이다.

현재 서버 연동이 없는 상태에서 클라이언트가 임시적으로 처리하고 있으며, 향후 서버 추가 시 수정될 구조를 고려하여 설계가 되었다.

주요 기능

• 메일 리스트 뷰

  • 받은 메일을 리스트 형태로 확인 가능

  • 서버에서 한 번에 많은 메일을 보내는 것을 방지하기 위해 분할 요청을 처리

  • 스크롤 특정 위치 도달 시 새로운 메일 데이터를 요청하여 추가적인 패킷 로드를 최소화

  • 서버에서 받은 메일 개수를 초과하면 더 이상 요청하지 않도록 구현

  • 서버 요청 흐름(향후 서버 연동 시)

    1. 스크롤이 70% 이상 내려가면 메일 추가 요청
    2. 서버에서 추가 메일 데이터를 반환
    3. 기존 리스트에서 새로운 메일을 추가
    4. 만약 서버에서 “더 이상 메일 없음” 응답을 받으면 추가 요청 중지

    서버 요청 다이어그램 (예시)

    [스크롤 특정 위치 도달] → [서버에 추가 메일 요청] → [서버 응답 수신] → [UI 업데이트]

• 메일 상세 팝업

  • 선택한 메일의 제목, 발신자, 내용, 첨부 보상 등을 확인 가능

• 보상 수령 및 메일 삭제

  • 보상 수령 후 삭제 가능 (현재는 클라이언트에서 임시 처리)
  • 향후 서버 추가 시 요청 - 응답을 기반으로 삭제 방식 변경 예정

우편 데이터 구조

• 운영툴에서 생성된 메일과 시스템 메일을 구분

  • 운영툴에서 직접 생성하는 메일과 게임 시스템에서 자동 발송하는 메일을 분리하여 관리
  • 서버에서 받은 데이터의 테이블 ID가 0이면 운영툴에서 생성한 메일로 간주

• 데이터 구조

  tableNo	MailType	MailName	MailDesc
  int	MailType	string	string

서버 연동 및 확장성

• 메일 데이터 요청 흐름
  1. 메일 UI 스크롤 특정 위치(70%)에 도달하면 추가 요청 발생
  2. 서버에서 새로운 데이터를 가져옴
  3. 서버에서 받을 수 있는 최대 메일을 초과화면 추가 요청 중지
• 서버가 추가되면 삭제 로직 변경
  • 현재는 클라이언트에서 즉시 삭제되지만 서버 연동 후에는 요청 패킷을 보내고 응답을 받은 후 삭제되도록 변경될 예정

UI/UI 고려 사항

• RedDot 처리
  • 보상을 받지 않은 메일은 레드닷 표시를 통해 미확인 메일임을 명확히 함
  • 신규 메일 도착 시 로비의 메일 UI에도 레드닷 활성화
• 메일 리스트 업데이트 최적화
  • 전체 데이터를 매번 재생성하는 대신, 기존 데이터 업데이트, 신규 데이터 추가, 불필요한 데이터 삭제를 통해 성능 최적화

서버 데이터 처리

• 서버에서 데이터를 받더라도, 클라이언트는 만료된 메일을 현재 시간과 비교하여 삭제

• 주요 코드

  // 만료된 메일 자동 삭제 (서버 통신 전 단계에서 정리)
  MailDatas.RemoveAll([](const FMailData& MailData) {
  	return MailData.ExpireDate.GetTicks() < FDateTime::Now().GetTicks();
  	});

메일 업데이트 갱신 및 레드닷 처리

• 보상을 아직 받지 않은 메일이 있는 경우 레드닷을 활성화

• 주요 코드

  void UPTPlayerDataSubsystem::UpdateMails() 
  {
      bool RedDotActive = MailDatas.ContainsByPredicate([](const FMailData& MailData) {
          return MailData.ReceivedDate.GetTicks() == 0;
      });
      UpdateContentRedDot(ERedDotType::Mail, RedDotActive);
  
      const FPTGameplayTags& GameplayTags = FPTGameplayTags::Get();
      UGameplayMessageSubsystem& MessageSubsystem = UGameplayMessageSubsystem::Get(this);
      FUIUpdateMailMessage Message;
      MessageSubsystem.BroadcastMessage(GameplayTags.UI_Event_MailUpdate, Message);
  }

메일 리스트 업데이트 및 서버 분할 요청

• 스크롤 특정 위치(70%) 도달 시 새로운 메일 데이터를 요청

• 주요 코드

  void UPTMailWidget::RegisterGetMailDataCallback()
  {
  	// 현재 위치의 70% 정도가 되면 메일 업데이트 요청을 진행
  	int32 NumItems = MailListView->GetNumItems();
  	int32 Index = FMath::FloorToInt(NumItems * RecieveScrollPercent);
  	Index = FMath::Clamp(Index, 0, NumItems - 1);
  
  	UObject* Target = MailListView->GetItemAt(Index);
  	if (UPTMailCellData* CellData = Cast<UPTMailCellData>(Target))
  	{
  		CellData->OnGetMailDataCallback = [this]()
  			{
  				RequesetRecieveMailData();
  			};
  	}
  }

메일 삭제

• 서버가 없기 때문에 클라이언트에서 삭제를 임시 처리하지만, 향후 서버에서 응답 후 삭제하도록 변경 예정

• 서버 연동 후에는 요청을 보내고 응답을 받은 후 실제 삭제가 이루어지는 방식으로 변경

• 현재는 클라이언트에서 즉시 삭제하지만, 향후 서버 검증 후 삭제 적용

• 주요 코드

  void UPTPlayerDataSubsystem::RequestDeleteMail(FGameplayTag InChannel, const FDeleteMailMessage& InMessage)
  {
  	TArray<FMailData> RemoveMails = MailDatas.FilterByPredicate([InMessage](const FMailData& MailData)
  		{
  			bool CanRemove = MailData.ReceivedDate.GetTicks() > 0 || MailData.ExpireDate.GetTicks() < FDateTime::Now().GetTicks();
  			return CanRemove && InMessage.Pids.Contains(MailData.Pid);
  		});
  
  	if (!RemoveMails.IsEmpty())
  	{
  		//해당 부분은 서버가 있다면 서버에서 받은 데이터 처리를 하고 UpdateMails()를 호출한다.
  		MailDatas.RemoveAll([InMessage](const FMailData& MailData)
  			{
  				bool CanRemove = MailData.ReceivedDate.GetTicks() > 0 || MailData.ExpireDate.GetTicks() < FDateTime::Now().GetTicks();
  				return CanRemove && InMessage.Pids.Contains(MailData.Pid);
  			});
  		UpdateMails();
  	}
  }

메일 보상

• 보상 미 수령 메일에 대해 클라이언트에서 보상 요청을 처리하고, UI 팝업을 통해 보상 내역을 표시

• 주요 코드

  void UPTPlayerDataSubsystem::RequestReceiveReward(FGameplayTag InChannel, const FRecieveRewardMessage& InMessage)
  {
      UE_LOG(PTLog, Error, TEXT("[PTPlayerDataSubsystem] RequestReceiveReward"));
  
      if (InMessage.Pids.IsEmpty())
          return;
  
      TArray<FMailData> MergeRewardDatas;
      FDateTime CurrentTime = FDateTime::Now();
      for (const FString& Pid : InMessage.Pids)
      {
          FMailData* MailData = MailDatas.FindByPredicate([Pid](const FMailData& MailData)
          {
              return MailData.Pid == Pid;
          });
  
          if (!MailData)
              continue;
  
          MailData->ReceivedDate = CurrentTime;
          MergeRewardDatas.Add(*MailData);
      }
  
      if (!MergeRewardDatas.IsEmpty())
      {
          TArray<FItemReward> ItemRewards = MergeRewardData(MergeRewardDatas);
          UPTUIManagerSubsystem* UIManager = GetWorld()->GetGameInstance()->GetSubsystem<UPTUIManagerSubsystem>();
          UIManager->ShowItemRewardPopup(ItemRewards);
      }
  
      UpdateMails();
  }