1 つのネームスペースで複数の Steam アプリを設定する
Last updated on November 6, 2026
注釈:本資料はAI技術を用いて翻訳されています。
概要
デフォルトでは、AccelByte Gaming Services (AGS) のネームスペースは 1 つの Steam アプリに対応します。Steam multiple apps を使用すると、1 つのネームスペースで最大 2 つの Steam App ID に同時に対応できます。同じネームスペースに接続する Steam アプリを複数リリースする場合に使用します。例:
- 製品版と並行して提供するデモ版。
- ゲームのリリース前に実施するプレイテスト用アプリ。
- 既存タイトルの再リリース版。
両方のアプリのプレイヤーは、1 つのプレイヤーベース、1 つのインベントリ、1 つの進行状況を共有します。
プレイヤーの識別方法
Steam ID はアプリではなく、プレイヤーの Steam アカウントに紐づいています。どちらのアプリを起動したプレイヤーも、同じ AGS アカウントに解決されます。Steam プレイヤーが異なれば、常に異なる AGS アカウントになります。
そのため、Steam multiple apps では、1 つのネームスペース内でアプリごとにプレイヤーのデータと進行状況を分けて管理することはできません。アプリごとに進行状況を分ける必要がある場合は、アプリごとに別のネームスペースを使用してください。この場合、プレイヤーは同じ AGS アカウントのままですが、ネームスペースごとに Game User ID、データ、進行状況が個別に管理されます。詳細については、アカウントの仕組みを参照してください。
備考
Steam multiple apps では、両方のアプリがネームスペース内のプレイヤー、エンタイトルメント、進行状況を共有します。後からこれらを分離することはできません。プレイヤーが一方のアプリで取得したエンタイトルメントは、もう一方のアプリでも表示され、使用できます。
サポートされる機能
| 機能 | 必要な対応 | セクション |
|---|---|---|
| ユーザー認証 (ログインとアカウントのリンク) | • 両方のアプリに Steam ログイン方式を設定します。 • ゲームクライアントは、すべてのログインおよびリンクリクエストで、実行中の Steam アプリの App ID を送信する必要があります。Unreal Engine Online Subsystem (OSS) では自動的に送信されます。 | ユーザー認証を設定する |
| E-commerce のアプリ内課金 (IAP) 同期 | • 両方のアプリに Steam IAP を設定します。 Inventory モードと Transaction モードのどちらでも動作します。 • ゲームクライアントの変更は不要です。 | Steam アプリ内課金を設定する |
| E-commerce のダウンロードコンテンツ (DLC) 同期 | 対応は不要です。 DLC 同期は影響を受けません。所有権は、アプリごとではなく Steam パブリッシャーレベルで確認されます。 | |
| 実績の同期 | ゲームサーバーまたは Extend アプリは、特定のプレイヤーアカウントに対して Steam 実績をアンロックするときに、App ID を送信する必要があります。 | Steam 実績を同期する |
| Steam ロビー同期 (Session) | 対応は不要です。 AGS が各アプリの Steam ロビー同期の処理を自動的に行います。 | Steam ロビーを同期する |
前提条件
- 両方のアプリを所有する Steam Publisher Web API Key。両方のアプリに対して 1 つのキーを入力します。
- AGS Admin Portal へのアクセス権。ゲームネームスペースで、サードパーティログイン方式とストア連携を更新する権限が必要です。
- AGS CLI の手順を使用する場合は、AGS CLI をインストールしてサインインします。詳細については、インストールとサインインを参照してください。例では Bash シェルを使用しています。
ガイド
- ユーザー認証を設定する: Steam ログイン方式を設定し、ゲームクライアントから App ID を送信します。
- Steam アプリ内課金を設定する: 両方のアプリに Steam IAP と IAP アイテムマッピングを設定します。
- Steam 実績を同期する: ゲームサーバーまたは Extend サービスから Steam 実績をアンロックします。
- Steam ロビーを同期する: 2 つのアプリがある場合に、AGS がセッション用の Steam ロビーを作成する仕組みを説明します。
- ライブゲーム向けに変更を安全に展開する: ライブ中のプレイヤーに影響を与えずに Steam multiple apps を有効にします。
トラブルシューティング
| 症状 | 原因 | 解決策 |
|---|---|---|
ログインまたはリンクが 10252 または appId must be specified explicitly when multiple App IDs are enabled で失敗する。 | Steam multiple apps が有効になっていますが、リクエストに appId が含まれていません。 | ゲームクライアントが App ID を送信するように更新するか、すべてのビルドが更新されるまで設定をオフにしてください。ゲームクライアントから App ID を送信するおよびライブゲーム向けに変更を安全に展開するを参照してください。 |
ログインまたはリンクが 10253 または the given appId is not permitted in this namespace で失敗する。 | appId が AppIds リストに含まれていないか、設定がオフで、appId が設定済みの App ID と異なっています。 | 実行中のアプリの App ID を、Steam ログイン方式の設定と照らし合わせて確認してください。Steam ログイン方式を設定するおよび AGS がユーザー認証時に App ID を検証する仕組みを参照してください。 |
ログインが app id not match the platform token で失敗する。 | リクエスト内の App ID とは別のアプリがチケットを発行しています。 | チケットを生成したアプリの App ID を送信してください。ゲームクライアントから App ID を送信するを参照してください。 |
実績のアンロックが 39223 で失敗する。 | Steam multiple apps が有効なときに、ゲームサーバーが appId を送信しませんでした。 | リクエストで appId を送信してください。Steam 実績を同期するを参照してください。 |
| Transaction モードで、一方のアプリの購入が同期されない。 | アプリが appIds リストに含まれていないか、Steam multiple apps がオフになりました。 | Steam IAP の設定に App ID を再度追加してください。AGS は、そのアプリの保存済みの同期位置から再開します。両方のアプリに Steam IAP を設定するを参照してください。 |
| 購入後にプレイヤーが誤ったアイテムを受け取る。 | 両方のアプリで、異なる商品に同じアイテム定義 ID を使用しています。 | IAP アイテムマッピングを設定するのルールに従って、マッピングを修正してください。 |