온라인 서비스 타이틀 파일 인터페이스(Online Services Title File Interface) 는 게임이 런타임에 플랫폼의 백엔드 온라인 서비스에서 파일을 읽어 올 수 있도록 지원합니다.
이따금 게임이 타이틀과 함께 패키지에 포함되지 않은 파일을 읽어야 할 때가 있습니다. 타이틀 파일 인터페이스는 백엔드 온라인 서비스에 업로드한 파일을 읽을 수 있는 툴을 제공합니다. 이러한 정보의 예로는 환경설정 파일이나 오늘의 메시지 등이 있습니다. 이 인터페이스를 통해 런타임에 사용할 파일에 액세스하여 다운로드할 수 있습니다.
플레이어별 파일 스토리지에 대해 알아보려면 사용자 파일 인터페이스를 참고하세요.
API 개요
함수
다음 표에서는 타이틀 파일 인터페이스가 제공하는 함수를 간략히 소개합니다.
| 함수 | 설명 |
|---|---|
EnumerateFiles |
사용할 수 있는 모든 파일을 나열합니다. |
GetEnumeratedFiles |
EnumerateFiles 를 호출해 나열한 파일의 캐시된 목록을 가져옵니다. |
ReadFile |
파일을 읽어 콘텐츠를 반환합니다. |
프로세스 플로
타이틀 파일 인터페이스로 백엔드 온라인 서비스의 파일을 읽으려면 다음 단계를 따르세요.
EnumerateFiles는 인터페이스를 사용해 온라인 서비스에서 얻을 수 있는 모든 파일의 목록을 비동기적으로 캐싱합니다.GetEnumeratedFiles는 인터페이스가EnumerateFiles를 통해 캐싱한 파일의 목록을 가져옵니다.ReadFile은 가져온 목록의 각 파일을 비동기적으로 읽고 게임에서 사용할 수 있도록 콘텐츠를 반환합니다.
추가 정보
헤더 파일
필요한 추가 정보는 TitleFile.h 헤더 파일에서 직접 확인하세요. 타이틀 파일 인터페이스의 TitleFile.h 헤더 파일은 다음 경로에 있습니다.
UNREAL_ENGINE_ROOT\Engine\Plugins\Online\OnlineServices\Source\OnlineServicesInterface\Public\Online
UE 소스 코드를 얻는 방법을 알아보려면 언리얼 엔진 소스 코드 다운로드 문서를 참고하세요.
함수 파라미터 및 반환 타입
함수 파라미터를 전달하고 함수가 반환할 결과를 처리하는 방법을 포함한 함수 파라미터 및 반환 타입에 대한 설명은 온라인 서비스 개요 페이지의 함수 섹션을 참고하세요.