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"));// ... 게임플레이 진행 — 세션 데이터가 자동으로 업로드됩니다 ...
중요 정보
InGameId가 전달되지 않으면 관찰된 세션이 폐기될 수 있으며 AI 분석에 사용되지 않습니다. 이 값이 없으면 세션을 플레이어에게 귀속시킬 수 없으며, 이는 후속 인사이트 생성에 필요합니다.- 게임플레이 관찰을 시작하기 전에 반드시 사용자 동의를 받아야 합니다. SDK는 자동으로 권한을 요청하지 않으므로, 동의 처리는 게임 로직에서 구현해야 합니다.
- 권장 모범 사례로, 게임의 EULA 또는 개인정보처리방침에 게임플레이 관찰에 대한 고지 내용을 포함하는 것을 고려할 수 있습니다.
- 올바르게 테스트하려면 플랫폼별로 빌드를 생성한 뒤, 실제 기기에서 실행해야 합니다.
참고
다음은 Init() 메서드에 대한 참조입니다.
메서드 시그니처
매개변수
| 매개변수 | 타입 | 필수 | 설명 |
|---|---|---|---|
InGameId |
FString |
아니요 | 게임 내 선택적 사용자 식별자입니다. 전달하지 않으면 기본값은 빈 문자열입니다. |
DeveloperPayload
|
FString |
아니요 | 세션과 연결되는 선택적 개발자 정의 메타데이터입니다. 이 값은 세션 요청과 함께 그대로 전달되며, 사용자 정의 추적 정보나
컨텍스트 정보를 첨부하는 데 사용할 수 있습니다.세션과 연관된 선택적 개발자 정의 메타데이터입니다. 이 값은 세션 요청과 함께 원본 그대로 전달되며, 사용자 정의 추적 정보나 컨텍스트 정보를 첨부하는 데 사용할 수 있습니다. 더 풍부한 DeveloperPayload를 제공하면 AI 기반 분석 및 세션 이해의 품질을 크게 향상시킬 수 있습니다.
例:
|
3. 고급 제어
대부분의 통합에서는 Init()를 호출하는 것만으로 게임플레이 관찰을 시작하기에 충분합니다. 보다 고급이거나 사용자 정의 제어가 필요한 경우에는 StartSession() 및 StopSession()를 직접 사용할 수도 있습니다.
3.1 관찰 시작
게임플레이 관찰이 시작되는 시점을 명시적으로 제어하려는 경우 StartSession() 메서드를 사용합니다.
#include "SixLabsSubsystem.h"
USixLabsSubsystem* SixLabs = GetSubsystem<USixLabsSubsystem>();
// 게임플레이 관찰 시작
SixLabs->StartSession(TEXT("optional_player_in_game_id"), TEXT("optional_developer_payload_here"));// ... 게임플레이 진행 — 세션 데이터가 자동으로 업로드됩니다 ...
메서드 시그니처
매개변수
| 매개변수 | 타입 | 필수 | 설명 |
|---|---|---|---|
InGameId |
FString |
아니요 | 게임 내 선택적 사용자 식별자입니다. 전달하지 않으면 기본값은 빈 문자열입니다. |
DeveloperPayload
|
FString |
아니요 | 세션과 연관된 선택적 개발자 정의 메타데이터입니다. 이 값은 세션 요청과 함께 원본 그대로 전달되며, 사용자 정의 추적 정보나 컨텍스트 정보를 첨부하는 데 사용할 수 있습니다. 더 풍부한 DeveloperPayload를 제공하면 AI 기반 분석 및 세션 이해의 품질을 크게 향상시킬 수 있습니다. |
3.2 관찰 중지
게임플레이 관찰을 중지하려면 StopSession() 메서드를 사용합니다.
// 게임플레이 관찰 중지
SixLabs->StopSession();중요 정보
- 게임플레이 관찰을 중지합니다.
- 나중에
StartSession()를 다시 호출하여 새 관찰을 시작할 수 있습니다.
목차
목차
문서 Rev. 1.0