온라인 서비스 연결 인터페이스(Online Services Connectivity Interface) 는 게임이 플랫폼의 백엔드 온라인 서비스에 연결되어 있는지 여부를 판단할 수 있는 툴을 제공합니다.
API 개요
기능
다음 표에는 연결 인터페이스가 제공하는 함수에 대한 개요가 나와 있습니다.
| 함수 | 설명 |
|---|---|
GetConnectionStatus |
제공되는 온라인 서비스에 대한 연결 상태를 가져옵니다. |
OnConnectionStatusChaned |
온라인 서비스 연결 상태가 변경되면 트리거되는 이벤트입니다. |
열거형 클래스
온라인 서비스 연결 상태는 EOnlineServicesConnectionStatus 열거형 클래스에 의해 표시됩니다.
EOnlineServicesConnectionStatus
| 값 | 설명 |
|---|---|
Connected |
온라인 서비스에 연결되었습니다. |
NotConnected |
온라인 서비스에 연결되지 않았습니다. |
연결 상태
GetConnectionStatus 는 제공되는 온라인 서비스에 대한 현재 연결 상태를 반환합니다. 일부 온라인 서비스는 다수의 기저 마이크로서비스로 이루어져 있습니다. 이러한 마이크로서비스 중 하나의 이름을 GetConnectionStatus 의 파라미터로 사용하여 특정 마이크로서비스의 연결 상태를 판단합니다. 온라인 서비스 파라미터를 지정하지 않은 경우 GetConnectionStatus 는 모든 기저 마이크로서비스가 연결될 때만 EOnlineServicesConnectionStatus::Connected 를 반환합니다.
이벤트에 OnConnectionStatusChanged 를 바인딩하여 온라인 서비스 또는 온라인 서비스의 마이크로서비스 중 하나가 변경될 때 알리도록 할 수 있습니다.
온라인 서비스의 구성과 특정 마이크로서비스에 대한 접근성은 플랫폼마다 다릅니다. 자세한 내용은 플랫폼의 온라인 서비스 문서를 참조하세요.
추가 정보
헤더 파일
자세한 정보가 필요한 경우 Connectivity.h 헤더 파일을 직접 참조하세요. 연결 인터페이스 헤더 파일 Connectivity.h 의 디렉터리 위치는 다음과 같습니다.
Engine\Plugins\Online\OnlineServices\Source\OnlineServicesInterface\Public\Online
UE 소스 코드를 얻는 방법을 알아보려면 언리얼 엔진 소스 코드 다운로드 문서를 참고하세요.
함수 파라미터 및 반환 타입
파라미터를 전달하고 함수의 반환 결과를 처리하는 방법을 비롯하여 함수 파라미터 및 반환 타입에 대한 자세한 설명은 온라인 서비스 개요 페이지의 함수 섹션을 참고하세요.