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 패키지 파일 SixLabsSDK-1.1.10.unitypackage 형태로 제공됩니다.

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

SDK 패키지 다운로드 (최신 버전의 6Labs Unity SDK 포함)
패키지를 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 아니요 게임 내 사용자를 식별하기 위한 선택적 ID입니다. 값을 전달하지 않으면 기본값으로 빈 문자열이 사용됩니다.

developerPayload

string

아니요

세션과 연관된 선택적 개발자 정의 메타데이터입니다. 이 값은 세션 요청과 함께 원본 그대로 전달되며, 사용자 정의 추적 정보나 컨텍스트 정보를 첨부하는 데 사용할 수 있습니다. 더 풍부한 developerPayload를 제공하면 AI 기반 분석 및 세션 이해의 품질을 크게 향상시킬 수 있습니다.
예시:

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

3. 고급 제어

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

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

3.1 관찰 시작

게임플레이 관찰 시작 시점을 명확하게 제어하려는 경우 StartSession() 메서드를 사용합니다.

                                                                                SixLabsSDK.Instance.StartSession(
                                                                                
                                                                                        inGameId:
                                                                                        "<optional_player_in_game_id>",

                                                                                        developerPayload:
                                                                                        "<optional_developer_payload_here>"
                                                                                
                                                                                );
                                                                        

메서드 시그니처

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

파라미터

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

3.2 관찰 중지

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

SixLabsSDK.Instance.StopSession();

중요 안내

게임플레이 관찰을 중지합니다.
새로운 관찰을 시작하려면 이후에 다시 StartSession()를 호출할 수 있습니다.

개요

Unreal용 6labs SDK

Unity용 6labs SDK

사전 요구 사항

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

2. 게임플레이 관찰 시작

중요 안내

참고

메서드 시그니처

파라미터

3. 고급 제어

3.1 관찰 시작

메서드 시그니처

파라미터

3.2 관찰 중지

중요 안내

목차

목차