6Labs >

Unity용 6labs SDK

이 섹션에서는 6Labs SDK를 Unity 애플리케이션에 통합하는 방법을 설명합니다.

사전 요구 사항

  • Unity 2021 LTS 이상이 필요합니다. 이전 버전은 작동할 수 있지만 적극적으로 지원되지는 않습니다.
  • Apple 플랫폼 전용 — 개발 머신에 다음 도구가 설치되어 있는지 확인하세요:
    • Xcode 26.2 이상
    • CocoaPods 1.12.0 이상
  • Unity 프로젝트는 다음 최소 배포 대상을 충족해야 합니다:
    • iOS — iOS 15 이상
    • tvOS — tvOS 15 이상
    • Android — API 레벨 23 (Android 6.0 Marshmallow) 이상

1. 모듈 다운로드 및 가져오기

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

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

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

2. 게임플레이 관찰 시작

Init() 메서드를 사용하여 SDK를 초기화하고 게임플레이 관찰을 시작할 수 있습니다. 아래 예시를 참고하세요.

using SixLabs.SDK;

SixLabsSDK.Instance.Init( inGameId: "<optional_player_in_game_id>",
developerPayload: "<optional_developer_payload_here>" );

중요 안내

  • inGameId가 전달되지 않으면 관찰된 세션이 폐기될 수 있으며 AI 분석에 사용되지 않습니다. 이 값이 없으면 세션을 플레이어에게 귀속시킬 수 없으며, 이는 후속 인사이트 생성에 필요합니다.
  • 게임플레이 관찰을 시작하기 전에 반드시 사용자 동의를 확보해야 합니다. SDK는 자동으로 권한을 요청하지 않으므로, 동의 처리는 게임 로직에서 직접 구현해야 합니다.
  • 권장되는 모범 사례로, 게임의 EULA(최종 사용자 라이선스 계약) 또는 개인정보 처리방침에 게임플레이 관찰에 대한 내용을 명시하는 것이 좋습니다.
  • 대상 플랫폼에 맞게 앱에 필요한 인터넷 접근 권한이 활성화되어 있는지 확인하세요.
  • SDK는 Unity Editor 환경에서는 동작하지 않습니다. 올바르게 테스트하려면 플랫폼별 빌드를 생성한 후 실제 디바이스에서 실행해야 합니다.

참고

다음은 Init() 메서드에 대한 참조 정보입니다.

메서드 시그니처

public void Init(string inGameId = null, string developerPayload = null)

파라미터

파라미터 타입 필수 여부 설명
inGameId string 아니요 선택적이지만 권장되는 사용자 식별자입니다. 생략하면 세션이 폐기될 수 있으며 AI 분석에 사용되지 않습니다.
developerPayload string 아니요 세션과 연관된 선택적 개발자 정의 메타데이터입니다. 이 값은 세션 요청과 함께 원본 그대로 전달되며, 사용자 정의 추적 정보나 컨텍스트 정보를 첨부하는 데 사용할 수 있습니다. 더 풍부한 developerPayload를 제공하면 AI 기반 분석 및 세션 이해의 품질을 크게 향상시킬 수 있습니다.
예시:

  • 사용자 유입 채널
  • 캠페인 ID
  • 사용자 세그먼트 (예: 신규 사용자, 복귀 사용자, 고가치 사용자)
  • A/B 테스트 변형 (예: variant_a, variant_b) — 사용자를 코호트로 나누고 6Labs 대시보드에서 각 코호트의 게임플레이 지표를 비교하세요.
  • 내부 참조 식별자

3. 인게임 ID 설정

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

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

참고

  • Init() 호출 시 inGameId를 전달한 경우, SetInGameId()를 호출하면 현재 세션에 설정된 기존 값이 덮어씌워집니다.

참고

다음은 SetInGameId() 메서드에 대한 참조 정보입니다.

메서드 시그니처

public void SetInGameId(string inGameId)

파라미터

파라미터 타입 필수 여부 설명
inGameId string 예 현재 세션에 연결할 플레이어의 인게임 식별자입니다.

4. 고급 제어

일반적인 통합 환경에서는 Init() 호출만으로 게임플레이 관찰을 시작할 수 있습니다.

관찰 시작 또는 종료 시점을 보다 세밀하게 제어하려는 경우 Resume() 및 Pause() 메서드를 직접 사용할 수 있습니다.

4.1 재개 (Resume)

게임플레이 관찰을 재개하려는 경우 Resume() 메서드를 사용합니다.

SixLabsSDK.Instance.Resume( inGameId: "<optional_player_in_game_id>",
developerPayload: "<optional_developer_payload_here>" );

메서드 시그니처

public void Resume(string inGameId = null, string developerPayload = null)

파라미터

파라미터 타입 필수 여부 설명
inGameId string 아니요 선택적이지만 권장되는 사용자 식별자입니다. 생략하면 세션이 폐기될 수 있으며 AI 분석에 사용되지 않습니다.
developerPayload string 아니요 세션과 연관된 선택적 개발자 정의 메타데이터입니다. 이 값은 세션 요청과 함께 원본 그대로 전달되며, 사용자 정의 추적 정보나 컨텍스트 정보를 첨부하는 데 사용할 수 있습니다. 더 풍부한 developerPayload를 제공하면 AI 기반 분석 및 세션 이해의 품질을 크게 향상시킬 수 있습니다.

4.2 일시 중지 (Pause)

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

SixLabsSDK.Instance.Pause();

중요 안내

  • 게임플레이 관찰을 일시 중지합니다.
  • 관찰을 재개하려면 이후에 다시 Resume()를 호출할 수 있습니다.
×

목차

6labs SDK for Unity

목차

목차

6Labs SDK 사용하기
Text copied to clipboard
질문이 있으신가요? 다음 주소로 문의하세요. dev-support@6labs.ai