オンライン サービスの Title File インターフェース では、ランタイム時にプラットフォームのバックエンドのオンライン サービスからファイルを読み取るためのサポートをゲームに提供します。
ゲームでは、タイトルにパッケージされていないファイルを読み取る必要がある場合があります。Title File インターフェースでは、バックエンドのオンライン サービスにアップロードしたファイルを読み取るツールを提供します。このような情報の例としては、コンフィギュレーション ファイルやその日のメッセージなどがあります。このインターフェースは、ランタイム時に使用するこれらのファイルにアクセスし、ダウンロードするうえで役立ちます。
プレイヤー固有のファイル ストレージについては、「User File インターフェース」を参照してください。
API の概要
関数
次の表は、Title File インターフェースによって提供される関数の概要です。
| 関数 | 説明 |
|---|---|
EnumerateFiles |
利用可能なファイルをすべて列挙します。 |
GetEnumeratedFiles |
EnumerateFiles の呼び出しによって列挙されたファイルのキャッシュされたリストを取得します。 |
ReadFile |
ファイルを読み取り、その内容を返します。 |
プロセスのフロー
Title File インターフェースを使用してバックエンドのオンライン サービスからファイルを読み取るには、次の手順を実行します。
EnumerateFilesは、オンライン サービスから取得可能なすべてのファイルのリストをインターフェースで非同期にキャッシュします。GetEnumeratedFilesは、EnumerateFilesによってインターフェースでキャッシュされたファイルのリストを取得します。ReadFileは、取得したリストのファイルごとに、非同期でファイルを読み取り、ゲーム内で使用できるようにその内容を返します。
詳細情報
ヘッダ ファイル
詳細については、必要に応じて、「TitleFile.h」ヘッダ ファイルを直接確認してください。Title File インターフェースのヘッダ ファイル「TitleFile.h」は、次のディレクトリに格納されています。
UNREAL_ENGINE_ROOT\Engine\Plugins\Online\OnlineServices\Source\OnlineServicesInterface\Public\Online
UE のソース コードの入手手順については、「Unreal Engine のソース コードをダウンロードする」を参照してください。
関数パラメータおよび戻り型
パラメータの渡し方や関数が返すときの結果の処理を含む、関数のパラメータと戻り型については、「Online Services の概要」ページの「関数」セクションを参照してください。