Unreal용 6labs SDK

이 섹션에서는 Windows 환경의 Unreal Engine 앱에 6labs SDK를 통합하는 방법을 설명합니다.

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

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

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

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

2. 게임플레이 캡처 시작

아래와 같이 Init() 메서드를 사용하여 SDK를 초기화하고 게임플레이 캡처를 시작합니다:

#include "SixLabsSubsystem.h"

 USixLabsSubsystem* SixLabs = GetSubsystem<USixLabsSubsystem>();

 // 캡처 세션 시작
 SixLabs->Init(TEXT("optional_player_in_game_id"), TEXT("optional_developer_payload_here"));

 // ... 게임플레이 진행 — 데이터가 자동으로 캡처되고 업로드됩니다 ...

중요 정보

게임플레이 캡처를 시작하기 전에 반드시 사용자 동의를 받아야 합니다. SDK는 자동으로 권한을 요청하지 않으므로, 동의 처리는 게임 로직에서 구현해야 합니다.
권장 모범 사례로, 게임의 EULA 또는 개인정보처리방침에 게임플레이 녹화에 대한 고지 내용을 포함하는 것을 고려할 수 있습니다.
올바르게 테스트하려면 대상 플랫폼용 빌드를 생성하고 실제 기기에서 실행해야 합니다.

참고

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

메서드 시그니처

SixLabs->Init(TEXT("optional_player_in_game_id"), TEXT("optional_developer_payload_here"));

매개변수

매개변수 타입 필수 설명

InGameId FString 아니요 게임 내 선택적 사용자 식별자입니다. 전달하지 않으면 기본값은 빈 문자열입니다.

DeveloperPayload

FString

아니요

세션과 연결되는 선택적 개발자 정의 메타데이터입니다. 이 값은 캡처 요청과 함께 그대로 전달되며, 사용자 정의 추적 정보나 컨텍스트 정보를 첨부하는 데 사용할 수 있습니다.
예시:

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

3. 고급 캡처 제어

대부분의 통합에서는 Init()를 호출하는 것만으로 캡처 흐름을 시작하기에 충분합니다. 보다 고급이거나 사용자 정의 캡처 제어가 필요한 경우에는 StartCapture() 및 StopCapture()를 직접 사용할 수도 있습니다.

3.1 캡처 시작

게임플레이 캡처가 시작되는 시점을 명시적으로 제어하려는 경우 StartCapture() 메서드를 사용합니다.

#include "SixLabsSubsystem.h"

 USixLabsSubsystem* SixLabs = GetSubsystem<USixLabsSubsystem>();

 // 캡처 세션 시작
 SixLabs->StartCapture(TEXT("optional_player_in_game_id"), TEXT("optional_developer_payload_here"));

 // ... 게임플레이 진행 — 데이터가 자동으로 캡처되고 업로드됩니다 ...

메서드 시그니처

SixLabs->StartCapture(TEXT("optional_player_in_game_id"), TEXT("optional_developer_payload_here"));

매개변수

매개변수	타입	필수	설명
`InGameId`	`FString`	아니요	게임 내 선택적 사용자 식별자입니다. 전달하지 않으면 기본값은 빈 문자열입니다.
`DeveloperPayload`	`FString`	아니요	세션과 연결되는 선택적 개발자 정의 메타데이터입니다. 이 값은 캡처 요청과 함께 그대로 전달되며, 사용자 정의 추적 정보나 컨텍스트 정보를 첨부하는 데 사용할 수 있습니다.

3.2 캡처 중지

활성 게임플레이 캡처 세션을 중지하려면 StopCapture() 메서드를 사용합니다.

// 세션 중지
 SixLabs->StopCapture();

중요 정보

활성 게임플레이 캡처 세션을 중지합니다.
나중에 StartCapture()를 다시 호출하여 새 세션을 시작할 수 있습니다.

Unity용 6labs SDK