언리얼 엔진의 온라인 서비스 콘솔 명령 | 언리얼 엔진 5.7 문서

온라인 서비스 콘솔 명령을 사용하면 게임플레이 동안 온라인 서비스 플러그인을 디버깅하고 테스트할 수 있습니다.

콘솔 명령 실행

온라인 서비스 플러그인 콘솔 명령은 언리얼 엔진 콘솔에서 실행됩니다. 콘솔은 에디터에서 플레이(PIE) 도중 물결(~) 키를 한 번(피드백 없음) 또는 두 번(상세 피드백) 눌러 액세스할 수 있습니다. 다음 구문을 사용하여 온라인 서비스 콘솔 명령을 실행합니다.

OnlineServices Index=<NUM> <INTERFACE> <FUNCTION> [ARG1] [ARG2] ...

파라미터

아래 표에는 온라인 서비스 플러그인 콘솔 명령을 구성하는 파라미터에 대한 설명이 정리되어 있습니다.

파라미터	설명	추가 정보
`NUM`	액세스할 서비스의 인덱스 번호입니다.	콘솔 명령 `OnlineServices List` 를 사용하면 서비스 목록을 각 번호와 함께 얻을 수 있습니다. 일반적인 작업에서 `Index=0` 이 디폴트 플랫폼 서비스입니다.
`INTERFACE`	액세스할 함수 기능의 인터페이스입니다.	그 예시로는 인증, 현재상태, 통계 등이 있습니다. 전체 인터페이스 목록은 온라인 서비스 개요 문서의 인터페이스 섹션을 참고하세요.
`FUNCTION`	지정된 인터페이스 내에서 사용하려는 함수입니다.	예시로는 현재상태 인터페이스의 `UpdatePresence`, 인증 인터페이스의 `Login` 등이 있습니다. 선택한 인터페이스에서 이용 가능한 함수의 전체 목록은 인터페이스 문서 페이지를 참고하세요. 사용 가능한 전체 인터페이스 목록은 온라인 서비스 인터페이스 랜딩 페이지에서 찾을 수 있습니다.
`ARG1`, `ARG2`, …	선언된 명령에서 `FUNCTION` 의 연결된 `Param` 구조체를 구성하는 실행인자입니다.	원하는 함수의 전체 파라미터 목록은 언리얼 엔진 API 문서를 참고하세요. 복잡한 실행인자 타입을 전달하는 것과 관련된 자세한 내용은 아래 실행인자 섹션을 참고하세요.

예를 들어 온라인 서비스 콘솔 명령의 경우 이 페이지의 콘솔 명령 예시 섹션을 참고하세요.

실행인자

온라인 서비스 함수를 사용할 때는 다양한 파라미터 타입을 전달해야 합니다. 온라인 서비스 콘솔 명령이 온라인 서비스 함수 실행을 위한 메커니즘을 제공한 이래로 이러한 함수 파라미터 타입에 대응하도록 다양한 콘솔 명령 실행인자 타입이 구현되었습니다. 온라인 서비스 콘솔 명령은 특정 방식으로 이러한 타입을 처리하여 복잡한 C++ 타입을 언리얼 엔진 콘솔을 통해 전달하고 이러한 함수를 사용할 수 있도록 지원합니다.

특수 타입은 다음과 같습니다.

FAccountId
TSharedPtr
TOptional
TVariant
Objects
TArray
TMap

아래 테이블은 각 특수 타입을 전달하는 것과 관련된 추가 정보를 예시와 함께 제공합니다.

타입	정보	예시
`FAccountId`	`FAccountId` 의 경우 다음 중 하나를 전달할 수 있습니다. n번째 로컬 사용자를 나타내는 0~9 사이의 인티저 핸들의 `ToString` 메서드 출력 앞에 서비스 이름을 접두사로 추가한 값(예: `epic:<EPIC_ID>`). 접두사는 ID로 표준 인티저를 사용하는 여러 플랫폼을 구분하기 위한 것입니다.
`TSharedPtr`	평상시와 같이 파라미터 이름을 입력합니다. `TSharedRef` 는 기술적으로는 구현되어 있습니다. 하지만 `TSharedRef` 를 사용하면 쉐어드 레퍼런스를 디폴트로 생성할 수 없기 때문에 크래시가 발생합니다. 현재는 공유 포인터가 있는 모든 콘솔 명령에서 `TSharedRef` 대신 `TSharedPtr` 를 사용할 것을 권장합니다.
`TOptional`	선택적 값을 설정하지 않고 전달하려면 `null` 을 사용합니다.
`TVariant`	TVariant를 전달하는 구문은 `<TYPE>:<VALUE>` 입니다. 현재 구현된 타입은 다음과 같습니다. `s`: string `i`: int64 `i32`: int32 `b`: bool `u`: user(FAccountId) `d`: double `f`: float `e`: enum 커스텀 열거형이 있는 경우 `MAKE_VARIANT_ENUM_INFO(<YOUR_ENUM_NAME>)` 매크로를 사용해야 온라인 서비스 콘솔 명령에서 제대로 작동합니다. 열거형이 두 개 이상인 경우 `ELoginStatus::Unknown` 같은 전체 열거형 이름이 `Unknown` 에 완전히 적합한 이름인지 확인해야 합니다. 열거형이 두 개 이상인 변수에 `e:` 를 사용하는 것은 정의되지 않은 행동입니다.	다음은 각 타입과 값 쌍의 예시입니다. `s:MyString` `i:42000000000` `i32:42` `b:true` `u:0` `d:2.718` `f:3.14` `e:Unknown`
`Objects`	온라인 메타데이터가 있는 오브젝트의 경우, 괄호로 구분된 구문을 사용하여 모든 파라미터를 명확하게 선언합니다. 오브젝트는 내부 오브젝트 및 배열을 지원합니다.	다음은 오브젝트 예시입니다. `{true "AuthLogin" s:username s:password}` `{{5 3} {4 false}}`
`TArray`	`TArray` 에는 괄호로 구분된 구문을 사용합니다. 목록 안의 값을 구분하는 쉼표는 선택 사항입니다.	다음은 서로 동일한 두 가지 `TArray` 예시입니다. `[5, 3, 7, 9]` `[5 3 7 9]`
`TMap`	`TMap` 에는 괄호로 구분된 구문을 사용합니다. `TMap` 은 고급 구문을 지원하지 않으므로 중첩 오브젝트, 배열 등은 제대로 파싱되지 않습니다.	다음은 `TMap` 예시입니다. `{licenseData=licenseDataText, kNumUsers=5}`

콘솔 명령 예시

이 섹션에는 프로젝트에서 활성화한 온라인 서비스 플러그인과 함께 사용할 수 있는 콘솔 명령의 몇 가지 예시가 나와 있습니다. 온라인 서비스 콘솔 명령을 사용하려면 다음 조건을 충족해야 합니다.

온라인 서비스 플러그인을 활성화합니다.
프로젝트에서 사용할 플러그인을 환경설정합니다.
프로젝트 코드에서 사용할 서비스에 대한 레퍼런스를 얻습니다.

이러한 콘솔 명령은 사용할 서비스에 대한 레퍼런스를 얻고 각 인터페이스를 적절하게 환경설정하지 않으면 프로젝트에서 아래와 같이 작동하지 않을 수 있습니다.

사용 가능한 온라인 서비스 목록

명령

OnlineServices List

이 명령 목록은 온라인 서비스 플러그인을 통해 액세스할 수 있는 플랫폼 서비스를 열거합니다.

샘플 출력

0: Null
1: Epic
2: Steam
...

이 샘플 출력의 경우, 다수의 온라인 플랫폼 서비스를 이용할 수 있으며 적절한 인덱스 번호를 통해 온라인 서비스 콘솔 명령에서 레퍼런스할 수 있습니다. 예를 들어 null은 Index=0 으로, 에픽게임즈는 Index=1 로, Steam은 Index=2 로 레퍼런스할 수 있습니다.

로컬 온라인 사용자 구하기

명령

OnlineServices Index=0 Auth GetLocalOnlineUserByPlatformUserId 0

샘플 출력

LogConsoleResponse: Display: GetLocalOnlineUserByPlatformUserId result: { AccountInfo: [{ AccountId: Null:1 (ID_STRING), PlatformUserId: 0, LoginStatus: LoggedIn, Attributes: {DisplayName:String:ID_STRING} }] }

타이틀 파일 구하기

명령

OnlineServices Index=0 TitleFile GetEnumeratedFiles 0

샘플 출력

LogConsoleResponse: Display: GetEnumeratedFiles result: { Filenames: [StatusFile] }

이 출력은 'StatusFile'이라는 타이틀의 백엔드 온라인 서비스에 등록된 단일 타이틀 파일이 있음을 보여줍니다.

추가 정보

이 페이지에서 다뤄진 주제와 관련된 자세한 내용은 다음 페이지를 참고하세요.