Unreal용 6labs SDK

6labs SDK는 Unreal Engine 플러그인 형태로 제공됩니다.

이 모듈을 Unreal 프로젝트에 추가합니다:

1. 다운로드 6labs Unreal SDK 최신 버전 v2.3.5.
2. 플러그인을 프로젝트의 Plugins 디렉터리(YourProject/Plugins/SixLabsSDK/)에 압축 해제합니다.
3. 플러그인이 활성화되어 있는지 확인합니다:
   • Unreal Editor에서 Edit > Plugins 로 이동합니다.
   • “6labs SDK”를 검색하고 활성화되어 있는지 확인합니다.
4. 모듈 종속성을 추가합니다
   • 게임 모듈의 Build.cs에 다음을 추가합니다: PublicDependencyModuleNames.Add("SixLabsSDK");

StartSession() 메서드를 사용하여 게임플레이 관찰을 시작합니다. 아래 예시를 참고하세요.

// MyGameInstance.h
UFUNCTION()
void OnStartSessionComplete(ESixLabsSdkResponse Response, const FString& ErrorMessage);

// MyGameInstance.cpp
#include "SixLabsSubsystem.h"
if (USixLabsSubsystem* SixLabs = GetSubsystem<USixLabsSubsystem>())
{
    FSixLabsLifecycleComplete OnComplete;
    OnComplete.BindDynamic(this, &UMyGameInstance::OnStartSessionComplete);
    
    SixLabs->StartSession(TEXT("<player_in_game_id>"), TEXT("<developer_payload>"), OnComplete);
}

void UMyGameInstance::OnStartSessionComplete(ESixLabsSdkResponse Response, const FString& ErrorMessage)
{
    // Response == ESixLabsSdkResponse::SIXLABS_SUCCESS이면 StartSession()이 성공적으로 완료된 것입니다
    // 결과 처리
    // SixLabs->GetSdkState()로 SDK의 현재 상태를 확인할 수 있습니다
}

void StartSession(
    const FString& InGameId,
    const FString& DeveloperPayload,
    const FSixLabsLifecycleComplete& OnComplete);

SetInGameId() 메서드를 사용하여 플레이어의 인게임 ID를 기존 관찰 세션에 연결합니다. 이 메서드는 사용자 계정이 생성되기 전에 SDK가 초기화된 경우, 로그인한 사용자를 이미 진행 중인 세션에 연결할 때 주로 사용됩니다.

if (USixLabsSubsystem* SixLabs = GetSubsystem<USixLabsSubsystem>())
{
    SixLabs->SetInGameId(TEXT("<player_in_game_id>"));
}

void SetInGameId(const FString& InGameId);

SendGameEvent() 메서드를 사용하여 진행 중인 관찰 세션에서 사용자 지정 게임플레이 이벤트를 기록할 수 있습니다. 이벤트는 세션에 첨부되며, 분석 시 특정 게임플레이 순간과 연관 짓는 데 사용할 수 있습니다.

const bool bAccepted = SixLabs->SendGameEvent(TEXT("<event_name>"), TEXT("<event_data_as_json>"));
if (!bAccepted)
{
    // 이벤트가 전송되지 않았습니다. 아래 조건을 참조하세요
}

bool SendGameEvent(
    const FString& EventName,
    const FString& EventDataJson);

StartSession()은 새 세션에 대한 게임플레이 관찰을 시작합니다. 이후 필요에 따라 PauseSession(), ResumeSession(), StopSession()을 사용하여 해당 세션을 제어할 수 있습니다.

5.1 일시 중지 (PauseSession)

PauseSession() 메서드를 사용하여 게임플레이 관찰을 일시 중지합니다.

const ESixLabsSdkResponse Response = SixLabs->PauseSession();
if (Response != ESixLabsSdkResponse::SIXLABS_SUCCESS)
{
    // SDK가 관찰 중이 아니었습니다. 아래 응답을 참조하세요
}

ESixLabsSdkResponse PauseSession();

5.2 재개 (ResumeSession)

이전에 PauseSession()으로 일시 중지된 세션을 이어가려면 ResumeSession() 메서드를 사용합니다.

// MyGameInstance.h
UFUNCTION()
void OnResumeSessionComplete(ESixLabsSdkResponse Response, const FString& ErrorMessage);

// MyGameInstance.cpp
#include "SixLabsSubsystem.h"
if (USixLabsSubsystem* SixLabs = GetSubsystem<USixLabsSubsystem>())
{
    FSixLabsLifecycleComplete OnComplete;
    OnComplete.BindDynamic(this, &UMyGameInstance::OnResumeSessionComplete);
    
    SixLabs->ResumeSession(OnComplete);
}

void UMyGameInstance::OnResumeSessionComplete(ESixLabsSdkResponse Response, const FString& ErrorMessage)
{
    // Response == ESixLabsSdkResponse::SIXLABS_SUCCESS이면 ResumeSession()이 성공적으로 완료된 것입니다
    // 결과 처리
    // SixLabs->GetSdkState()로 SDK의 현재 상태를 확인할 수 있습니다
}

void ResumeSession(const FSixLabsLifecycleComplete& OnComplete);

5.3 정지 (StopSession)

StopSession() 메서드를 사용하여 현재 세션을 완전히 종료합니다. PauseSession()과 달리, 정지된 세션은 ResumeSession()으로 이어갈 수 없습니다 — 새 세션을 시작하려면 다시 StartSession()을 호출해야 합니다.

// MyGameInstance.h
UFUNCTION()
void OnStopSessionComplete(ESixLabsSdkResponse Response, const FString& ErrorMessage);

// MyGameInstance.cpp
#include "SixLabsSubsystem.h"
if (USixLabsSubsystem* SixLabs = GetSubsystem<USixLabsSubsystem>())
{
    FSixLabsLifecycleComplete OnComplete;
    OnComplete.BindDynamic(this, &UMyGameInstance::OnStopSessionComplete);
    
    SixLabs->StopSession(OnComplete);
}

void UMyGameInstance::OnStopSessionComplete(ESixLabsSdkResponse Response, const FString& ErrorMessage)
{
    // Response == ESixLabsSdkResponse::SIXLABS_SUCCESS이면 StopSession()이 성공적으로 완료된 것입니다
    // 결과 처리
    // SixLabs->GetSdkState()로 SDK의 현재 상태를 확인할 수 있습니다
}

void StopSession(const FSixLabsLifecycleComplete& OnComplete);

SDK는 다음 상태를 오갑니다. 호출할 수 있는 메서드와 그 결과는 현재 상태에 따라 달라집니다:

• GetSdkState()를 사용하면 언제든 SDK의 현재 상태를 확인할 수 있으며, 반환 타입은 ESixLabsSdkState입니다.
• StartSession(), PauseSession(), ResumeSession(), StopSession()은 유효한 SDK 상태에서만 호출할 수 있습니다. 유효하지 않은 상태에서 작업을 호출하면 오류가 반환됩니다.
• PauseSession()은 ESixLabsSdkResponse를 직접 반환합니다. StartSession(), ResumeSession(), StopSession()은 OnComplete 콜백을 통해 결과를 반환합니다.
• OnComplete 콜백은 게임 스레드에서 비동기적으로 호출됩니다.

6.1 콜백 타입

FSixLabsLifecycleComplete는 다음 두 개의 파라미터를 받는 다이내믹 델리게이트입니다:

6.2 상태

6.3 응답 코드