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