Unity용 6labs SDK

6labs SDK는 Unity 패키지 파일 형태로 제공됩니다.

다음 단계를 따라 Unity 프로젝트에 모듈을 추가합니다:

1. 다운로드 6labs Unity SDK 최신 버전 v4.0.0.
2. 패키지를 Unity 프로젝트로 가져옵니다:
   • Unity 에디터에서 Assets > Import Package > Custom Package를 클릭합니다.
   • 시스템에서 다운로드한 .unitypackage 파일을 선택하세요.
   • Import를 클릭하여 가져오기를 완료합니다.

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

using SixLabs.SDK;

SixLabsSDK.Instance.StartSession(
    inGameId: "<optional_player_in_game_id>",
    developerPayload: "<optional_developer_payload_here>",
    callbackOnComplete: (sdkResponse, errorMessage) => {
        // sdkResponse == SdkResponse.SUCCESS이면 StartSession()이 성공적으로 완료된 것입니다
        // 결과 처리
        // SixLabsSDK.Instance.CurrentState로 SDK의 현재 상태를 확인할 수 있습니다
    }
);

public void StartSession(
    string inGameId = null,
    string developerPayload = null,
    Action<SdkResponse, string> callbackOnComplete = null)

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

SixLabsSDK.Instance.SetInGameId("<player_in_game_id>");

public void SetInGameId(string inGameId)

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

bool result = SixLabsSDK.Instance.SendGameEvent(
    eventName: "<event_name>",
    eventDataJson: "<event_data_as_json>"
);

public bool SendGameEvent(
    string eventName,
    string eventDataJson)

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

5.1 일시 중지 (PauseSession)

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

SdkResponse result = SixLabsSDK.Instance.PauseSession();

public SdkResponse PauseSession()

5.2 재개 (ResumeSession)

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

SixLabsSDK.Instance.ResumeSession(
    callbackOnComplete: (sdkResponse, errorMessage) => {
        // sdkResponse == SdkResponse.SUCCESS이면 ResumeSession()이 성공적으로 완료된 것입니다
        // 결과 처리
        // SixLabsSDK.Instance.CurrentState로 SDK의 현재 상태를 확인할 수 있습니다
    }
);

public void ResumeSession(Action<SdkResponse, string> callbackOnComplete = null)

5.3 정지 (StopSession)

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

SixLabsSDK.Instance.StopSession(
    callbackOnComplete: (sdkResponse, errorMessage) => {
        // sdkResponse == SdkResponse.SUCCESS이면 StopSession()이 성공적으로 완료된 것입니다
        // 결과 처리
        // SixLabsSDK.Instance.CurrentState로 SDK의 현재 상태를 확인할 수 있습니다
    }
);

public void StopSession(Action<SdkResponse, string> callbackOnComplete = null)

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

• SixLabsSDK.Instance.CurrentState를 사용하면 언제든 SDK의 현재 상태를 확인할 수 있습니다.
• StartSession(), PauseSession(), ResumeSession(), StopSession()은 유효한 SDK 상태에서만 호출할 수 있습니다. 유효하지 않은 상태에서 작업을 호출하면 오류가 반환됩니다.
• PauseSession()은 SdkResponse를 직접 반환합니다. StartSession(), ResumeSession(), StopSession()은 선택적인 callbackOnComplete 콜백을 통해 결과를 반환합니다.
• callbackOnComplete 콜백은 비동기적으로 호출됩니다.

6.1 콜백 파라미터

이 콜백은 Action<SdkResponse, string> 타입이며, 다음 두 개의 파라미터를 받습니다:

6.2 상태

6.3 응답 코드