Epic Online Services (EOS) SDK の Mods Sample (Mods サンプル) は以下のような Mod Marketplace のインタラクションのデモを行います。
アプリケーションで利用できるすべての mod の列挙
ユーザーがインストールした mod の列挙
mod のインストールおよびアンインストール
mod の更新
このページでは mod サンプルのセットアップおよび実行方法を説明し、これらの機能の使い方を概説します。
始める前に
Mods サンプルを使用する前に、以下の前提条件を満たす必要があります。
EOS-SDK.zip
Epic Games Store Launcher クライアントをインストールすること
Developer Portal で Epic Games Store テスト アプリケーションを以下の情報を構成すること
productid
sandboxid
deploymentid
clientid
clientsecret
Win64 / Win32 用セットアップ
このセクションでは Windows OS (32-bit / 64-bit) で使用する mod のビルドおよび実行方法を説明します。
Mods サンプル アプリケーションを Win64 / Win32 用にビルドする
EOS-SDK.zip を選択して場所に解凍します。
「
\EOS-SDK\Samples\
」に移動します。Samples.sln
をダブルクリックすると、Visual Studio が Solution Explorer でサンプルと一緒に開きます。[StartUp Project] を [Mods] プロジェクトに設定します。
SampleConstants.h
を開きます。テスト アプリケーションの値に基づいてProductId
、SandboxId
、DeploymentId
、ClientCredentialsId
、ClientCredentialsSecret
を更新します。ソリューションのコンフィギュレーションを選択します。
Release_DX
またはDebug_DX
を使用します。ソリューション プラットフォームを [
x64
(Win64)] または [x86
(Win32)] から選択します。[Solution Explorer] で [Mods] プロジェクトをクリックして [Build] を選択します。
正常にビルドが完了すると、「
\EOS-SDK\Samples\Mods\Bin\Win64\Release_DX\
」で以下のファイルが使用できるようになります。
サンプル アプリケーションを実行できるようになります。
Mods サンプル アプリケーションを Win64 / Win32 用に実行する
Mods サンプルを実行するには、始める前に の前提条件を満たし、さらに前のセクションに従ってテスト アプリケーションをビルドする必要があります。また、ランチャーをインストールしてテストビルドに指定する必要があります。以下の手順に従ってアプリケーションの準備および起動をします。
テスト ビルドに指定してランチャーを開いてテスト アプリケーションをインストールします。
ローカルの EOS SDK 「
\EOS-SDK\
」に移動します。ここに、前のセクションでビルドしたサンプルが含まれています。別のファイル エクスプローラーで、テスト アプリケーションの インストール先 に移動します。
ローカルの
EOS-SDK
から以下のファイルをアプリケーションのインストール先にコピーします。\Mods\Bin\Win64\Release_DX\EOSSDK-Win64-Shipping.dll
\Mods\Bin\Win64\Release_DX\Mods.exe
\Shared\Assets*.*
コマンド プロンプトで、
cd
コマンドを使って Mods.exe へ移動します。例:C:\Program Files\Epic Games\TestApp\Samples\Mods\Bin\Win64\Release_DX\
サンプル アプリケーションを開くには、
start ./Mods.exe
コマンドを実行します。画像:上記のセットアップを完了すると、mods サンプル アプリケーションが実行します。クリックして拡大表示。
サンプル アプリケーションが開いて、テストに進むことができます。詳細については、Mods サンプル アプリケーションを実行する を参照してください。
MacOS 用のセットアップ
このセクションでは、MacOS で mod サンプル アプリケーションをインストールおよび実行する方法を説明します。
セットアップの前提条件
MacOS で mod サンプル アプリケーションをビルドするには、次の依存関係をインストールする必要があります。
SDL2
SDL2_ttf
GLEW
cmake
gcc (コマンドライン Tools for Xcode を使用)
上記の条件は 始める前に に記されている項目に加えて必要になります。
Mods サンプル アプリケーションを MacOS 用にビルドする
EOS-SDK.zip を選択して場所に解凍します。
Terminal で
\EOS-SDK\Samples\Mods\
に移動します。SampleConstants.h を開き、テスト アプリケーションの値に基づいて
ProductId
、SandboxId
、DeploymentId
、ClientCredentialsId
、ClientCredentialsSecret
を更新します。./Build.sh
を実行します。正常にビルドが完了すると、
\EOS-SDK\Samples\Mods\Build\
の中に新しいファイルができます。
サンプル アプリケーションを実行できるようになりました。
Mods サンプル アプリケーションを実行する
テスト ビルドに指定してランチャーを開きます。
テスト アプリケーションをインストールします。
ローカルの EOS-SDK 「
\EOS-SDK\
」に移動します。このディレクトリには、前にビルドしたサンプルが含まれています。別の [Finder] ウィンドウで、新しくインストールされたテスト アプリケーションのインストール先に移動します。
ローカルの EOS-SDK から以下のファイルをアプリケーションのインストール先にコピーします。
/Build/Mods
/Build/Assets/*.*
Terminal で
cd
コマンドを使ってアプリケーションのインストール先のBuild
フォルダへ移動します。例:~/Users/Shared/Epic Games/TestApp/Build/
サンプル アプリケーションを開くには、
./Mods
コマンドを実行します。画像:上記のセットアップを完了すると、mods サンプル アプリケーションが実行します。クリックして拡大表示。
サンプル アプリケーションが開いて、テストに進むことができます。詳細については、Mods サンプル アプリケーションを実行する を参照してください。
Mods サンプル アプリケーションを使用する
Developer Authentication Tool からログインするには、[Dev Auth] オプション > [Log In] の順に選択します。ログインすると、Mods サンプル アプリケーションに次のオプションが含まれます。
Enumerate All Mods
[Enumerate All Mods (すべての mod を列挙する)] を選択すると、アプリケーションで利用可能なすべての mod を取得しリスト表示します。このリストには、各 mod のインストール状況も含まれます (ユーザーの mod の使用権限に関係なく)。ユーザーは、このビューから mod の インストール、更新、アンインストール を行うことができます。
Enumerate All Mods 機能を使用すると、ユーザーの使用資格のない mod も含めて、アプリケーションで使用可能なすべての mod が表示されます。クリックして拡大表示。
Enumerate Installed Mods
[Enumerate Installed Mods (インストールした mod の列挙)] を選択すると、ユーザーがインストールしたすべての mod をリスト表示します。このリストには、各 mod のインストール状況も含まれます (ユーザーが mod を使用することができるかどうかを含めて)。ユーザーは、このビューから mod の 更新 と アンインストール を行うことができます。
Enumerate installed mods 機能を使用すると、ユーザーがアプリケーションにインストールしたすべての mod をして、これらを管理することができます。クリックして拡大表示。