6Labs SDK 사용하기

이 섹션에서는 Unity 기반 iOS 및 Android 앱에 6Labs SDK를 통합하는 방법을 설명합니다.

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

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

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

SDK 패키지 다운로드 (최신 버전의 6Labs Unity SDK 포함)
패키지를 Unity 프로젝트로 가져옵니다:
- Unity 에디터에서 Assets > Import Package > Custom Package를 클릭합니다.
- 로컬 시스템에서 SixLabsSDK-1.0.6.unitypackage 파일을 선택합니다.
- Import를 클릭하여 가져오기를 완료합니다.

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

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

게임플레이 캡처를 시작하기 전에 반드시 사용자 동의를 확보해야 합니다. SDK는 자동으로 권한을 요청하지 않으므로, 동의 처리는 게임 로직에서 직접 구현해야 합니다.
권장되는 모범 사례로, 게임의 EULA(최종 사용자 라이선스 계약) 또는 개인정보 처리방침에 게임플레이 녹화에 대한 내용을 명시하는 것이 좋습니다.
SDK는 Unity Editor 환경에서는 동작하지 않습니다. 올바르게 테스트하려면 플랫폼별 빌드를 생성한 후 실제 디바이스에서 실행해야 합니다.

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

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

파라미터 타입 필수 여부 설명

inGameId string 아니요 게임 내 사용자를 식별하기 위한 선택적 ID입니다. 값을 전달하지 않으면 기본값으로 빈 문자열이 사용됩니다.

developerPayload

string

아니요

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

일반적인 통합 환경에서는 Init() 호출만으로 캡처 프로세스를 시작할 수 있습니다.

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

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

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

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

파라미터	타입	필수 여부	설명
`inGameId`	`string`	아니요	게임 내 사용자를 식별하기 위한 선택적 ID입니다. 전달하지 않으면 기본값으로 빈 문자열이 사용됩니다.
`developerPayload`	`string`	아니요	개발자 정의 메타데이터로, 사용자 추적 또는 추가 컨텍스트 정보를 전달하는 데 사용할 수 있습니다.

StopCapture() 메서드를 사용하여 현재 진행 중인 게임플레이 캡처 세션을 중지합니다.

SixLabsSDK.Instance.StopCapture();