ランチャーをSteamに統合する方法

どのように動作するか

クロスプラットフォームフロー

ゲームをSteamでのランチャーと統合できます。エクソーラランチャーを介して他のSteamゲームを宣伝することができます。

ランチャーがSteamに統合されている場合、最初にSteamを起動する際にユーザーのコンピュータに別個のアプリケーションとしてインストールされます。その後のランチャーの動作は、起動方法によって異なります：

• Steam経由：
  • ランチャーは、ドメインページで指定されたSteam AppIDのゲームのみを表示します。
  • 「購入する」ボタンをクリックすると、Steam アプリケーションのゲームのページに移動します。
  • 「インストールする」ボタンは、Steamアプリケーション内でゲームのインストールを開始します。
  • ランチャーは、Steamへユーザーをリダイレクトしてゲーム内での購入を行います。
  • 特定のゲームのランチャープロジェクト設定でストアを有効にし、Steam AppIDを入力する場合、ランチャーはSteamからそのゲームで利用可能なDLCの情報を取得し、エクソーラランチャーストアにDLCのカードを作成します。ユーザーが購入するボタンをクリックすると、Steamアプリケーションのアイテムのページにリダイレクトされます。
  • エクソーラログインは、ユーザーのSteamからのデータを使用してエクソーラエコシステム内でユーザーアカウントを自動的に作成します。これにより、エクソーラログインデータベースのドメインページ内で全てのランチャーユーザーを確認できます。ユーザーはSteam以外からランチャーを起動し、エクソーラランチャーのストアを介してゲーム内での購入を行うことができます。そのため、Steamから起動されていても、Xsolla APIメソッドを使用してエクソーラランチャーのストアで購入したアイテムの所有権をユーザーが確認できます。
  • ユーザーがランチャーを開始したゲーム以外のゲームの「プレイする」ボタンをクリックした場合、ランチャーは閉じられ、選択したゲームがバックグラウンドでSteamで開始されます。ランチャーは即座にゲームを開始し、ランチャーUIを表示しません。ユーザーがゲームを終了すると、ランチャーUIが表示されます。

• ランチャーの実行可能ファイルまたはデスクトップのショートカットを介して、スタンドアロンのアプリケーションとして使用する場合：
  • そのランチャーは、Steam AppIDが指定されているかどうかに関わらず、ランチャープロジェクトに追加されたすべてのゲームを表示します。

• • エクソーラランチャーストアには、ドメインページを通じて追加されたゲーム内アイテムが表示されます。

• • そのランチャーは、Steam経由でローカルにインストールされたゲームに関する情報にアクセスします。Steamを通じて配信されたゲームがローカルにインストールされている場合、「購入」ボタンはプレイボタンに置き換わります。ユーザーがプレイボタンをクリックすると、ランチャーはSteam経由で再起動します。

前提条件

Steam統合をセットアップするには、次のものが必要です：

• Steam AppID
• Steamworksのアカウントとゲーム
• Steamで公開するゲームビルド
• アドミンページで構成された、すぐに使用できるランチャー

Steamworksのゲーム管理パネルでSteamアプリIDを見つけることができます。Steamworks > アプリ管理者セクションに移動してプロジェクト名の横に表示されます。

統合手順

Steamプラットフォームのセットアップとファイルのダウンロード

1. アドミンページでプロジェクトを開きます
2. サイドメニューでランチャーをクリックします。
3. ダッシュボードでランチャーを見つけて、ランチャーを編集するをクリックします。
4. 設定セクションに移動してSteamプラットフォームロゴの右側にあるセットアップをクリックします。
5. Steam Web APIキーを入力します。
6. ゲームのSteam AppIDを入力します
7. ランチャーホストをダウンロードするをクリックして、WindowsまたはmacOS向けのLauncherHost.zipアーカイブをダウンロードします。
8. 「構成をダウンロードする」をクリックして、ゲームの構成ファイルをダウンロードします。
9. 「ランチャー動作」タブを開き、ユーザーがSteamからゲームを実行する際にランチャーが行うべきことを選択します（任意）：
   • ランチャーを実行する（デフォルト）
   • ゲームを実行する

10. 「ユーザーログイン」タブで、ログイン方法を選択します（任意）：
    • 自動でSteamアカウントからログイン（デフォルト）。
    • 手動でログインウィジェットからログイン。ウィジェットは、ランチャー作成時に選択したログインプロジェクトを使用します。

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

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

1. LauncherHost.zipアーカイブ（ステップ1でダウンロードする必要があります）を任意のディレクトリに解凍します。このアーカイブには、Steamにアップロードするランチャーを使用してゲームを準備するためのGameBuildディレクトリが含まれています。Windows用のフォルダー構造：
   • LauncherHost.exe — LauncherHostユーティリティの実行可能ファイル
   • Qt5Core.dll、vcruntime140-140_1.dll、msvcp140-140_1.dll — LauncherHost.exeユーティリティ用のサービスライブラリ
   • installer — ランチャーインストーラー用のフォルダー

1. MacOS向けのフォルダー構造：
   • LauncherHost — LauncherHostユーティリティの実行可能ファイル
   • Frameworks — LauncherHostの
   • ユーティリティライブラリ用のシステムフォルダーinstaller — ランチャーインストーラー用のフォルダー

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

5. スタンドアロンランチャー インストーラー（Windows / macOS）をコピーしてインストーラーフォルダーに貼り付けます。
6. Steam構成ファイルをコピーしてGameBuildフォルダーに貼り付けます。
7. すでにSteamでゲームがある場合は、 LauncherHost.exeファイル名をゲームの実行可能ファイルの名前に置き換えます。この情報は、ゲーム管理パネルのアプリとパッケージ > すべてのアプリケーション > Steamworks管理者 > インストール > 一般インストールセクションの実行可能フィールドで確認できます。

8. ゲーム管理パネルでISteamApps::GetLaunchCommandLine()を使用することを有効にする

9. 公開の準備をクリックして、自分の作品と他のユーザーの作品の間に競合がないかどうかを確認します。

WindowsゲームのビルドファイルをSteamにアップロードする

1. Steamworksにログインし、Steamworks SDKをダウンロードします。
2. SDKアーカイブを解凍します。

3. steamworks_sdk_151\sdk\toolsフォルダーに移動し、ゲームビルドをSteamにアップロードするためのSteamPipeGUIユーティリティを解凍します。

4. SteamPipeGUIユーティリティを実行します。

5. 設定ウィンドウで次のフィールドに入力します：
   1. App IDフィルドで、ゲームのSteam AppIDを指定します。
   2. ビルド説明フィルドで、このビルドの簡単な説明を入力して、Steam管理者パネルで簡単に識別できるようにします。
   3. Steamworks SDK ContentBuilderパスフィルドで、Steamworks SDK ContentBuilderへのパスを指定します。
   4. SteamログインとSteamパスワードフィルドで、Steamworksのログインとパスワードを入力します。

5. 5. デポットを追加するをクリックします。ビルドパスフィルドで、ゲームビルドとランチャーインストーラーでGameBuildへのパスを指定します。

5. 6. アップロードをクリックして、アップロードが完了するまで待機します。

macOSのゲームビルドファイルをSteamにアップロード

1. launcher.dmgをコピーしてGameBuild/installerで貼り付けます。
2. hostArgs.jsonをコピーしてGameBuildフォルダーで貼り付けます。
3. Steamにファイルをアップロードします：
   1. 解凍したSteamSDKフォルダーを開きます

5. 2. tools/scriptsフォルダーに移動します
   3. app_build_<steam_id>.vdfという名前のvdfスクリプトを作成します。<steam_id>はプロジェクトのSteam IDであり、次の内容です（3行目のxxxxxxをSteam IDに、11行目の yyyyyyをDepot IDに置き換える - これはSteam ID + 1です：

	"AppID" "xxxxxx" // your AppID
	"Desc" "This is a simple build script 1" // internal description for this build

	"ContentRoot" "../content/" // root content folder, relative to location of this file
	"BuildOutput" "../output/" // build output folder for build logs and build cache files

	"Depots"
	{
		"yyyyyy" // your DepotID
		{
			"FileMapping"
			{
				"LocalPath" "*" // all files from contentroot folder
				"DepotPath" "." // mapped into the root of the depot
				"recursive" "1" // include all subfolders
			}
		}
	}
}

5. 4. 変更内容を保存します
   5. GameBuildディレクトリの内容をコピーしてtools/ContentBuilder/Contentフォルダーに貼り付けます
   6. ターミナルコンソールで、tools/ContentBuilder/builder_osxフォルダーに移動します
   7. ./steamcmd.shコマンドを呼び出して、初期化と構成を開始します。
   8. 次のコマンドを呼び出して、ビルドをSteamサーバーにアップロードするスクリプトを実行します：

cmd.sh +login <username> <password> +run_app_build_http ../scripts/app_build_{Steam_id}.vdf

Steamworksでゲーム ビルドを公開する

1. Steamworksのゲーム管理パネルに移動します。
2. Steamworks管理者をクリックして、アプリケーションの管理者ページを開きます

3. SteamPipes > ビルドセクションに移動します。

4. 新しいブランチを作成するか、デフォルトのブランチを使用します。
5. アップロードされたビルドをビルドID、アップロード日、または説明で見つけて、ビルドをブランチに配置します。
6. 変更をプレビューをクリックし、変更を表示します。
7. 今すぐビルドをライブに設定をクリックします。