Set Up Steam Integration in ADT
適用対象: ADT Web + Windows 上の ADT Hub
概要
スタジオの Steam パブリッシングアカウントを ADT に接続し、ゲームごとの Steam 設定を構成し、ADT Hub に SteamCMD のパスを設定することで、チームが認証情報を手動で管理したり外部ツールを実行したりすることなく、ビルドを Steam にプロモートできるようになります。
このガイドでは、3 つのセットアップタスクについて説明します。
- ADT Web でSteamCredentialsをNamespace Settingsに接続する(スタジオ管理者、Namespace ごとに 1 回実施)
- ADT Web でゲームごとの Steam 設定を Game Settings で構成する(スタジオ管理者、ゲームごとに 1 回実施)
- ADT Hub で SteamCMD のパスを設定する(各開発者、マシンごとに 1 回実施)
チームメンバーがプロモーションをトリガーできるようになる前に、この 3 つすべてを完了する必要があります。
前提条件
スタジオ管理者向け(ステップ 1 および 2):
- Studio Admin ロールを持つ ADT Web へのアクセス
- 該当する App ID に対して以下の Steamworks 権限が付与された、専用の Steam パブリッシング用ボットアカウント(個人アカウントではない):
- "Edit App Metadata"
- "Publish App Changes To Steam"
- ボットアカウントのパスワード
- ボットアカウントに メールベースの Steam Guard が構成されていること(かつ Steam Mobile Authenticator が削除されていること — ステップ 3 の警告を参照)、およびプロモーション時にそのメール受信トレイにアクセスできること。プロモーションが開始されると、Steam はワンタイムの Steam Guard コードをこの受信トレイに送信します
- 構成対象のゲームの Steam App ID、Depot ID、およびターゲットブランチ名
各開発者向け(ステップ 3):
- Windows にインストールされ実行されている ADT Hub — 現在のリリースでは、プロモーションのトリガーは Windows Hub からのみサポートされています
- Windows マシンにインストールされた SteamCMD(
steamcmd.exe)— Valve SteamCMD wiki からダウンロードします - SteamCMD インストールディレクトリへのフルパスをメモしておいてください — ステップ 3 で必要になります
パート 1: Steam Credentials を接続する(Namespace Settings)
スタジオ管理者はこのセクションを 1 回実施します。これにより、スタジオの Steam パブリッシング用ボットアカウントが ADT Namespace に接続され、Namespace 内のすべてのゲームで認証情報を利用できるようになります。
ステップ 1: Namespace Settings を開く
ADT Web で、トップナビゲーションにある Namespace 名をクリックし、Namespace Settings を選択します。
ステップ 2: Steam Integration セクションに移動する
左サイドバーの Integrations グループの下にある Steam Integration を見つけます。それをクリックして Steam Integration 設定ページを開きます。
Namespace にまだ Steam アカウントが接続されていない場合は、グレーのステータスインジケーターと「Set Up Steam Integration」ボタンが付いた「Not Connected」カードが表示されます。
ステップ 3: Steam ボットアカウントの認証情報を入力する
Set Up Steam Integration(既存の認証情報を更新する場合は Edit)をクリックします。次のフィールドに入力します。
| フィールド | 入力する内容 | 必須? |
|---|---|---|
| ボットアカウントのユーザー名 | 専用の Steam パブリッシング用ボットアカウントのユーザー名 | はい |
| ボットアカウントのパスワード | 専用の Steam パブリッシング用ボットアカウントのパスワード | はい |
ADT は TOTP 共有シークレットを保存しません。その代わり、プロモーションをトリガーする人は、ボットアカウントの現在の 6 桁の Steam Guard コードを入力するよう求められます。プロモーションが開始されると、Hub は Steam へのログインを実行し、それにより Steam がワンタイムの Steam Guard コードをボットアカウントのメールアドレスに送信します — その受信トレイからコードを取得して Hub に入力してください。このコードは 1 回だけ使用され、保存されることはありません。チーム全体がアクセスできる受信トレイ(例: 共有メールボックスやエイリアス)を使用すると、どのチームメンバーでもプロモーションを実行できます。
プロモーションフローは メールベースの Steam Guard のみ をサポートしており、Steam Mobile Authenticator のコードを取得することはできません。ボットアカウントで Steam Mobile Authenticator が有効なままだと、ログインがタイムアウトします。プロモーションの前に、ボットアカウントから Mobile Authenticator を削除し、メールベースの Steam Guard に切り替えてください。
あるマシンでコードの入力に成功すると、Steam のログインセッションはそのマシンで約 24 時間(正確な期間は変動します)有効なままとなり、その間のプロモーションでは新しいコードの入力を求められないことがあります。セッションが期限切れになると(通常は翌日)、または別のマシンからプロモーションする場合には、新しいメールコードが必要です — セッションはログインしたマシンに紐づいています。
Steam では、自動アップロードに専用のパブリッシングアカウント(個人の Steam アカウントではない)が必要です。個人アカウントを使用すると Valve の利用規約に違反し、アカウント停止のリスクがあります。ボットアカウントには、パブリッシュする予定の各 App ID に対して Steamworks で "Edit App Metadata" および "Publish App Changes To Steam" の権限が必要です。
ステップ 4: 接続を保存して検証する
Save をクリックします。ADT は認証情報を直ちに検証します。接続に成功すると、Steam Integration セクションに、接続されたアカウントのユーザー名とともに緑色の Connected ステータスインジケーターが表示されます。
検証に失敗すると、ADT は具体的なエラーメッセージを表示します。よくある問題:
- ユーザー名またはパスワードが無効 — ユーザー名が Steamworks に表示されているとおりに正確に入力されているか、パスワードが先頭や末尾のスペースを含まず正しく入力されているかを確認してください。
- アカウント権限エラー — ボットアカウントに、いずれの App ID に対しても必要な Steamworks 権限がありません。Steamworks パートナーポータルで、ボットアカウントが正しい App ID に対して "Edit App Metadata" および "Publish App Changes To Steam" を持っていることを確認してください。
- 3 日間のセキュリティロックアウト — ボットアカウントで最近セキュリティ設定(メール、電話番号、パスワード)が変更された場合、Valve は自動アップロードを許可する前に 3 日間のロックアウト期間を適用します。ADT は制限が解除される予定日を表示します。
- 地域または場所のエラー — ADT のサーバーは AWS オレゴン(us-west-2)でホストされています。Steam は検証ログインを見慣れない場所からのサインインとしてフラグを立てることがあります。最初の接続でこれを解決する方法については、以下のトラブルシューティングセクションを参照してください。
これで Namespace の認証情報が設定されました。特定のゲームの設定を構成するには、パート 2 に進んでください。
パート 2: ゲームごとに Steam 設定を構成する(Game Settings)
スタジオ管理者はこのセクションをゲームごとに 1 回実施します。これにより、Hub がアップロード構成ファイルを生成するときに使用する Steam App ID、depot マッピング、およびトラックとブランチのマッピングが定義されます。
Game Settings → Steam は、Namespace の認証情報が接続されるまでロックされています。Namespace Settings へ案内するメモとともにロック状態が表示された場合は、先にパート 1 を完了してください。
ステップ 1: Game Settings を開く
ADT Web で、構成したいゲームに移動します。ゲーム名の横にある ⋯ メニューをクリックするか、ゲームダッシュボードから Game Settings に移動します。
ステップ 2: Steam セクションに移動する
Game Settings で、左サイドバー(Integrations グループの下)の Steam をクリックします。
ステップ 3: Steam App ID を入力する
App ID フィールドにゲームの Steam App ID を入力します。これは Steamworks におけるゲームの数値識別子です(Steamworks アプリページの URL に表示されます。例:https://partner.steamgames.com/apps/landing/1234560)。
プロンプトが表示されたら Verify をクリックします — ADT は App ID が接続されたボットアカウントからアクセス可能なアプリと一致するかを確認します。
ステップ 4: depot マッピングを追加する
各 ADT プラットフォームトラックは 1 つの Steam depot に対応します。各 depot ID を、それが受け取るべきビルドフォルダーにマッピングする必要があります。
Add Depot Mapping をクリックして入力します。
| フィールド | 入力する内容 |
|---|---|
| Depot ID | Steamworks アプリ構成の数値 Steam Depot ID(例:1234561) |
| Platform | この depot が対象とするプラットフォーム(Windows、macOS、Linux) |
各 depot について繰り返します。ほとんどのゲームではプラットフォームごとに 1 つの depot があります。例:
| Platform | Depot ID |
|---|---|
| Windows | 1234561 |
| macOS | 1234562 |
| Linux | 1234563 |
ステップ 5: ADT トラックを Steam ブランチにマッピングする
各 ADT トラック(チャンネルとプラットフォームの組み合わせ)は 1 つの Steam ブランチにマッピングされます。これにより、そのトラックからトリガーされたときにビルドがどの Steam ブランチにプロモートされるかが決まります。
Add Branch Mapping をクリックして入力します。
| フィールド | 入力する内容 |
|---|---|
| Channel | ADT チャンネル(例:「Latest Stable」または「QA」) |
| Platform | そのチャンネル内のプラットフォームトラック(例:Windows) |
| Steam branch | ターゲットとする Steam プレリリースブランチの名前(例:prerelease、beta、qa) |
Steam ブランチ名として default を入力すると、ADT はデフォルトブランチへのプロモーションには手動での Steam Mobile App の承認が必要であり、この機能はまだ利用できないことを説明する琥珀色の警告を表示します。今のところ、名前付きのプレリリースブランチ(例:prerelease または beta)を使用してください。
プロモーションを有効にしたい各トラックについて繰り返します。
ステップ 6: デフォルトのファイル除外を設定する(オプション)
ファイル除外は、ビルドフォルダー内のどのファイルを Steam アップロードから除外するかを定義します。一般的な除外により、デバッグシンボル、ログファイル、OS 固有のメタデータファイルが Steam に送信されるのを防ぎます。
File Exclusions フィールドに、カンマ区切りの glob パターンを入力します。例:
*.pdb, *.log, .DS_Store
これらのパターンは、このゲームのすべてのプロモーション確認フォームにあらかじめ入力されます。開発者は、保存されたデフォルトを変更することなく、プロモーションごとに編集できます。
ステップ 7: 保存する
Save をクリックします。ADT は構成が保存されたことを確認します。これで、ブランチマッピングを持つトラックのビルドに対して、Hub で「Promote to Steam」アクションが利用できるようになります。
パート 3: ADT Hub で SteamCMD のパスを設定する
ビルドをプロモートする各開発者は、Windows マシン上でこのセクションを 1 回実施します。これにより、Hub がアップロードを呼び出すために SteamCMD の場所を認識できるようになります。
現在のリリースでは、ADT Hub からのプロモーションのトリガーは Windows でのみサポートされています。macOS を使用している場合は、Promotions メニューでプロモーション履歴を表示できますが、プロモーションのトリガーや再試行はできません。
ステップ 1: Hub Settings を開く
ADT Hub で、左下のナビゲーションにある Settings アイコン(歯車アイコン)をクリックします。
ステップ 2: Integrations → SteamCMD に移動する
Settings サイドバーで Integrations をクリックし、次に SteamCMD をクリックします。
ステップ 3: SteamCMD のパスを入力する
SteamCMD path フィールドに、マシン上で SteamCMD がインストールされているディレクトリへのフルパスを入力します。パスを直接入力するか、Browse をクリックしてフォルダーに移動できます。
パスは、実行ファイル自体ではなく、steamcmd.exe を含むディレクトリを指す必要があります。
パスの例:
| インストール場所 | SteamCMD ディレクトリのパス |
|---|---|
| デフォルトの Valve インストーラー | C:\steamcmd |
| カスタムの場所 | C:\Program Files\steamcmd または展開した場所 |
ステップ 4: 保存して検証する
Save をクリックします。Hub は指定されたパスに SteamCMD 実行ファイルが存在することを検証します。
- パスが有効な場合、Hub は SteamCMD フィールドの横に緑色の Ready インジケーターを表示します。SteamCMD の前提条件が満たされています。
- パスが無効であるか、実行ファイルが見つからない場合、Hub は赤いエラーを表示します。SteamCMD がインストールされていること、およびパスが正しいディレクトリを指していることを確認してください。
検証
3 つのセットアップステップすべてが完了し、プロモーションの準備ができていることを確認するには:
-
ADT Web で Namespace Settings → Steam Integration に移動し、ステータスが Connected(緑色のインジケーター)と表示されていることを確認します。
-
ADT Web で、該当するゲームの Game Settings → Steam に移動し、少なくとも 1 つの depot マッピングと 1 つのブランチマッピングが保存されていることを確認します。
-
ADT Hub で Settings → Integrations → SteamCMD に移動し、Ready(緑色)インジケーターが表示されていることを確認します。
-
ADT Hub でチャンネルに移動し、Tracks タブを開き、ブランチマッピングを持つトラックの ⋯ メニューをクリックします。Build サブメニューを開き、Promote to Steam がアクティブな項目として表示されることを確認します。「not configured」モーダルが開く場合、モーダルにはどの設定がまだ不足しているかが表示されます。
トラブルシューティング
Steam Integration セクションがロックされているか「Configure credentials first」と表示される Game Settings → Steam は、Namespace の認証情報が接続されるまでロックされています。先にパート 1 を完了してから、パート 2 に戻ってください。
認証情報の検証が「Invalid credentials」で失敗する ボットアカウントのユーザー名が Steamworks に表示されているとおりに正確であること、およびパスワードが正しく入力されていることを確認してください。パスワードを再入力して再度保存してください — 末尾にスペースが追加されている可能性のあるソースからコピーしないでください。
認証情報の検証が「Account does not have permissions」で失敗する ボットアカウントには、構成しようとしている App ID に対して "Edit App Metadata" または "Publish App Changes To Steam" の権限がありません。管理者権限を持つアカウントで Steamworks パートナーポータルにログインし、アプリの Manage Groups & Permissions セクションに移動して、ボットアカウントに必要な権限を付与してください。
認証情報の検証が「3-day lockout」メッセージで失敗する Valve は、Steam アカウントで過去 3 日以内にセキュリティ変更(パスワード、メール、電話番号)があった場合に一時的なロックアウトを適用します。表示された日付まで待ってから再試行してください。
認証情報の検証が地域または場所のエラーで失敗する ADT のサーバーは AWS オレゴン(us-west-2)でホストされています。Steam は検証ログインを見慣れない場所から来たものと見なしてブロックすることがあります。最初の接続で解決するには:
- ボットアカウントで、Steam Guard を一時的に無効にします(Steam → Settings → Security → Steam Guard → オフにする)。
- ADT Web → Namespace Settings → Steam Integration で認証情報を再度保存します。
- 検証が成功しステータスが Connected と表示されたら、ボットアカウントでメールベースの Steam Guard を再度有効にします。
プロモーションのログインがタイムアウトする、または届かないコードを要求し続ける ボットアカウントでまだ Steam Mobile Authenticator が有効になっています。プロモーションフローはメールベースの Steam Guard のみをサポートしており、Mobile Authenticator のコードを取得できません。ボットアカウントから Steam Mobile Authenticator を削除し、メールベースの Steam Guard に切り替えてから再試行してください。
パスを入力した後、Hub に「SteamCMD not found」と表示される
パスが間違ったディレクトリを指しているか、SteamCMD がまだインストールされていません。指定したディレクトリに steamcmd.exe が存在することを確認してください。SteamCMD がインストールされていない場合は、Valve からダウンロードし、Hub でパスを構成する前に少なくとも 1 回実行してください。
「Promote to Steam」がトラックで「not configured」モーダルを開く トラックの depot またはブランチマッピングが Game Settings で設定されていません。モーダルにはどの設定が不足しているかが正確に表示され、それらを修正するための Game Settings → Steam へのリンクが直接示されます。
次のステップ
- Windows で Steam にビルドをプロモートする — Windows 上の ADT Hub から最初のプロモーションをトリガーします
- Steam へのビルドのプロモート — 機能概要 — この機能が概念的にどのように動作するかを理解します