ランチャーをEpic Gamesストアと統合する方法

どのように動作するか

ゲームをEpic Gamesストア（EGS）でのランチャーと統合できます。エクソーラランチャーを介して他のEGSゲームを宣伝することができます。

前提条件

EGS統合を設定するには、次が必要です：

• Epic アプリID（アーティファクトID）
• Epic Gamesデベロッパーポータルの管理者ロールとゲームアプリケーションを持つアカウント
• EGSで公開するためのゲームビルド
• アドミンページで構成されたすぐに使用できるランチャー
• 最新バージョンのBuildPatchツール

EpicアプリID（アーティファクトID）を取得する

EpicアプリIDを確認するには：

1. Epic Gamesデベロッパーポータルにログインします。
2. ゲーム製品に移動します。
3. ゲームカード内をクリックし、「Epic Games Store」のオプションを選択します。

4. サイドメニューで、アーティファクトとバイナリをクリックしてサンドボックスとアーティファクトを選択します。

5. アーティファクト名をクリックすると、Epic アプリIDが表示されます

統合手順

認証をセットアップする

1. クライアントポリシーがない場合は、作成してください：
   1. Epic Gamesデベロッパーポータルをログインします。
   2. あなたの製品（ゲーム）の設定「Product Settings > Clients > Add new client policy」セクションに移動します。
   3. 「Client policy」フィルドでポリシー名を追加します
   4. 「Client policy type」ドロップダウンリストからの「GameClient」ポリシーを選択します。
   5. 「Add new policy」をクリックします。

2. ログインクライアントを作成するには：
   1. 製品設定で、「Product Settings > Clients > Add new client」に移動します。
   2. 「Client name」フィルドでクライアント名を入力します。
   3. 「Client policy」ドロップダウンリストから新しく作成したクライアントポリシーを選択します。

3. 「Create Application」をクリックします。

4. 作成したクライアントを割り当てます：
   1. 右上にある「Linked Clients」をクリックします。
   2. 「Select Clients」ドロップダウンリストからこの前に作成したクライアントを選択します。

5. 権限が設定されていることを確認しPermissionsナビゲーションバーをクリックします。Not configuredとマークされている場合は、いずれかのオプションを有効または無効にし、変更内容を保存します。

6. アドミンページのプロジェクトで、ログインセクションに移動します。
7. ログインオプションを選択し、「認証 > パブリッシングプラットフォーム > Epic Games」セクションに移動します。
8. 「アプリケーションID」フィールドと「アプリケーション秘密キー」フィールドに入力します。Epic Gamesデベロッパーポータル（Product Settings > Clients > Edit clientセクション）からフィールド値をコピーできます。
9. 「変更内容を保存する」をクリックします。

EGSプラットフォームをセットアップしてファイルをダウンロードする

1. アドミンページのプロジェクトで、ランチャーセクションに移動します。
2. ダッシュボードでランチャーを見つけ、「ランチャーを編集」をクリックします。
3. 「設定」セクションに移動して、Epic Gamesプラットフォームのロゴの右側にある「セットアップ」をクリックします。

4. ゲームのEpicアプリIDを入力します。
5. ユーザーエンタイトルメントが正しく機能するように、オーディエンスアイテムIDを指定します。IDを取得するには、次の手順を実行します：
   1. 製品設定で、「Epic Gamesストア > オファー」セクションに移動します。
   2. ランチャーがエンタイトルメントを確認するためにどのオファーを使用するかを決定します。ユーザーが選択したエンタイトルメントオファーを持っている場合、ランチャーはユーザーがゲームを所有していると見なします。
   「Edit offer」をクリックして「Audience Item ID」を表示します。

7. 「ランチャーホストをダウンロード」をクリックして、WindowsまたはmacOS用のLauncherHost.zipアーカイブをダウンロードします。
8. 「構成ファイルをダウンロード」をクリックして、WindowsまたはmacOSのhostArgs.json構成ファイルをダウンロードします。

ランチャーインストーラーの生成とダウンロード

EGSのゲームビルドを準備する

1. 「LauncherHost.zip」のアーカイブ（前の手順でダウンロードする必要があります）を任意のフォルダーに解凍します。このアーカイブには、Epicデベロッパーポータルにアップロードされるゲームビルドの準備に使用されるGameBuildディレクトリが含まれています。

• LauncherHost.exe — LauncherHostユーティリティの実行可能ファイル
• Qt5Core.dll vcruntime140-140_1.dll、msvcp140-140_1.dll — LauncherHost.exeユーティリティのサービスライブラリ
• installer — ランチャーインストーラーを含むディレクトリ

MacOSのディレクトリ構造：

• LauncherHost — LauncherHostユーティリティの実行可能ファイル
• Frameworks — LauncherHostユーティリティライブラリのシステムフォルダ
• installer — ランチャーインストーラーを含むフォルダ

2. GameBuildフォルダーで新しいフォルダーを作成します。
3. ゲームビルドをコピーしてそのフォルダーに貼り付けます。
4. ゲーム > ビルド > 実行可能ファイルセクションでゲームの実行可能ファイル名（Windows / macOS）を設定し、ゲームの実行可能ファイルへの相対パスを指定します。

5. ランチャーインストーラーとhostArgs.jsonファイルをGameBuildディレクトリにコピーします。そして、GameBuildディレクトリは次の構造になります：
   • Windows向け：

\---GameBuild
    |   hostArgs.json
    |   LauncherHost.exe
    |   msvcp140.dll
    |   msvcp140_1.dll
    |   Qt5Core.dll
    |   vcruntime140.dll
    |   vcruntime140_1.dll
    |
    \---installer
            installer.exe

2. • macOS向け：

\---GameBuild
    |   hostArgs.json
    |   LauncherHost
    |
    +---Frameworks
    |   \---QtCore.framework
    |       \---Versions
    |           \---5
    |               |   QtCore
    |               |
    |               \---Resources
    |                       Info.plist
    |                       QtCore.prl
    |
    \---installer
            Launcher.pkg

ゲームビルドをEGSにアップロードする

1. この前にダウンロードしたBuildPatchツールを解凍します。
2. ゲームビルドのキャッシュディレクトリとして使用するBuildPatchツールのディレクトリを作成します。
3. 解凍したディレクトリBuildPatchTool_x.y.z/Engine/Binaries/Win64に移動します（これは、BuildPatchツールのバージョンとオペレーティングシステムによって異なります）。
4. このディレクトリ内のターミナルを開き、次のコマンドを実行してゲームバイナリをアップロードします。詳細な手順については、ドキュメントを参照してください。

.\BuildPatchTool.exe
  -ClientId="<YourClientId>"
  -ClientSecret="<secret>"
  -mode=UploadBinary
  -OrganizationId="<YourOrg>"
  -ProductId="<YourProduct>"
  -ArtifactId="<YourArtifact>"
  -BuildRoot="<absolute-path-to-GameBuild-directory>"
  -CloudDir="<absolute-path-to-cache-directory>"
  -BuildVersion="1.0.2-launcher-win"
  -AppLaunch="LauncherHost.exe"
  -AppArgs=""

コマンドのパラメータは：

• ClientIdとClientSecretはProduct Settings > BPT Credentialsセクションのデベロッパーポータルで利用可能です。

• OrganizationIdはOrganization > SettingsタブでのGeneral Settingsセクションで利用可能です。

• ProductIdはProduct Settings > SDK Download & CredentialsタブでのEOS SDK Credentialsセクションで利用可能です。

• ArtifactIdパラメータとBuildVersionパラメータの値を確認するには、手順を参照してください。BuildVersionパラメータの値は、Epic Gamesランチャーのゲームカードのアクションメニューでも使用できます。

• AppLaunch — 次の形式の BuildRoot を基準としたメイン実行可能ファイルへの相対パス：
  • LauncherHost.exe — Windows向けLauncherHost — MacOS向け

• AppArgs — 追加の起動引数。空文字列も可能です。

アーティファクトにプラットフォームを割り当てる

1. アーティファクトのページに移動します。
2. 右側で「Inactive binaries」セクションまでスクロールし、アクションメニューボタン（...）をクリックし、「Assign platforms」をクリックします。それに応じてプラットフォームを選択します。

EGSランチャーでゲームへの開発者アクセスを取得する

1. 新しいユーザーをグループに追加します：
   1. 「Product Settings > Player Groups」セクション移動します。
   2. 特定のプレイヤーグループのアクションメニューボタン（...）をクリックして、「Edit Group」をクリックします。
   3. 「Add accounts」タブに移動して、「IDプロバイダー」として「Epic Games」を選択し、アカウントIDを指定します。

2. アクセスキーを生成します：
   1. プロジェクト設定の「Epic Games Store > Access keys」セクションに移動します。
   2. 右上にある「Generate keys」をクリックします。

2. 3. 鍵を生成したいサンドボックスとオファーを選択します。

2. 4. 「Batch name」フィルドにキー名を入力します。
   5. 「Testing」タイプを選択します。
   6. 数量を指定します。

2. 5. キーを作成したら、ダウンロードします。アクション「…」メニューボタンをクリックして、「Download」をクリックします。

5. EGSランチャーの右上にあるプロファイルボタンをクリックし、Redeem Codeオプションをクリックします。
6. ダウンロードしたキーを引き換えます。オファーのキーが正常に引き換えられると、ユーザーはその特定のオファーを受ける権利が与えられます。

ゲームビルドを更新する

既存のゲームビルドを更新するには、ゲームビルドの準備、EGSへのアップロード、アーティファクトへの割り当ての手順を繰り返します。