ネイティブセッション同期を設定する

Last updated on October 19, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

AccelByte Gaming Services(AGS)のセッションでは、Steam、Xbox、PlayStationなどのファーストパーティプラットフォームと同期するようにセッションを設定できます。この記事では、その設定方法について説明します。

前提条件

• AGS管理者ポータルへのアクセス権があること
• ゲームネームスペースがあること
• AGSセッションの設定に関する知識があること

• AGS CLI の手順に従う場合は、AGS CLI をインストールし、これらの機能へのアクセス権を持つアカウントでサインインしてください。詳細については、インストールとサインインを参照してください。例では Bash シェルを使用しています。

Steamのセッション同期を設定する

Admin Portal

1. AGS管理者ポータルにログインし、ゲームネームスペースを選択します。
2. サイドバーメニューで、ゲーム設定 > サードパーティ設定 > 認証とアカウントリンクに移動します。
3. ログイン方法ページで、+ 新規追加ボタンをクリックします。ログインプラットフォーム設定ページが表示されます。
4. 利用可能なログインプラットフォームから、Steam Webをクリックします。設定の作成フォームが表示されます。
5. Steam Web APIキーを入力します。
6. リダイレクトURIを入力します。
7. 作成をクリックします。

AGS CLI

1. Steam Web の設定を含む JSON ファイルを作成します。ファイル名は任意です。この例では steamopenid.json を使用します。

   {
     "Secret": "<YourSteamWebApiKey>",
     "RedirectUri": "<YourRedirectUri>",
     "IsActive": true
   }

   • Secret: Steam Web APIキー。
   • RedirectUri: リダイレクトURI。管理者ポータルの リダイレクトURI に入力する値と同じです。

2. Steam Web をログイン方法として追加します。<YourGameNamespace> をゲームネームスペースに置き換えます。@ の後に JSON ファイルのパスを指定します。

   ags iam platform-credentials create --namespace <YourGameNamespace> --platform-id steamopenid --json @steamopenid.json

   このファイルには Web API キーが含まれているため、コマンドの実行後に削除してください。

Xboxのセッション同期を設定する

Admin Portal

1. AGS管理者ポータルにログインし、ゲームネームスペースを選択します。
2. サイドバーメニューで、ゲーム設定 > サードパーティ設定 > 認証とアカウントリンクに移動します。
3. ログイン方法ページで、+ 新規追加ボタンをクリックします。ログインプラットフォーム設定ページが表示されます。
4. 利用可能なログインプラットフォームから、XBox Webをクリックします。設定の作成フォームが表示されます。
5. クライアントIDとクライアントシークレット(Xbox開発者ダッシュボードのアプリから取得)を入力します。
6. リダイレクトURIを入力します。
7. 作成をクリックします。
8. AGS管理者ポータルで、サードパーティストア統合に移動します。
9. Xboxタブを選択し、設定を追加をクリックします。
10. ビジネスパートナー証明書(BPC)をアップロードし、作成をクリックします。
11. https://partner.microsoft.com/en-US/xboxconfig/sessiontemplates/index?から新しいXboxセッションテンプレートを作成します。
12. 管理者ポータルで新しいセッションテンプレートを作成し、セッション同期を有効にします。
13. セッションテンプレート作成プロセスの最後に、Xboxテンプレート名と設定IDを入力します。

AGS CLI

1. Xbox Web の設定を含む JSON ファイルを作成します。ファイル名は任意です。この例では xblweb.json を使用します。

   {
     "ClientId": "<YourXboxClientId>",
     "Secret": "<YourXboxClientSecret>",
     "RedirectUri": "<YourRedirectUri>",
     "IsActive": true
   }

   • ClientId と Secret: Xbox 開発者ダッシュボードで確認できる、アプリのクライアントIDとクライアントシークレット。
   • RedirectUri: リダイレクトURI。管理者ポータルの リダイレクトURI に入力する値と同じです。

2. Xbox Web をログイン方法として追加します。<YourGameNamespace> をゲームネームスペースに置き換えます。@ の後に JSON ファイルのパスを指定します。

   ags iam platform-credentials create --namespace <YourGameNamespace> --platform-id xblweb --json @xblweb.json

   このファイルにはクライアントシークレットが含まれているため、コマンドの実行後に削除してください。

3. Admin Portal タブの手順 8～10 と同様に、管理者ポータルでビジネスパートナー証明書(BPC)をアップロードし、そのパスワードを入力します。AGS CLI では証明書のパスワードをコマンドラインフラグでしか指定できず、パスワードがシェル履歴に残ってしまうためです。

4. 証明書を Session サービスに同期します。

   ags session platform-credentials sync --namespace <YourGameNamespace> --platform-id XBOX

5. https://partner.microsoft.com/en-US/xboxconfig/sessiontemplates/index? から新しい Xbox セッションテンプレートを作成します。

6. セッション同期を有効にした新しいセッションテンプレートを作成します。セッションテンプレートの作成、設定、編集の AGS CLI の手順に従い、テンプレートの JSON ファイルに以下を追加します。

   "NativeSessionSetting": {
     "ShouldSync": true,
     "XboxSessionTemplateName": "<YourXboxTemplateName>",
     "XboxServiceConfigID": "<YourXboxConfigId>"
   }

   • XboxSessionTemplateName: 手順 5 で作成した Xbox セッションテンプレートの名前。
   • XboxServiceConfigID: Xbox サービス設定ID。

注記

readyRemovalTimeout(「準備完了」のメンバーが非アクティブに戻されるまでの時間)とsessionEmptyTimeout(セッションが空になってから削除されるまでの時間)は、必要に応じて調整できます。詳細については、マルチプレイヤーセッションに関するMicrosoftのドキュメントを参照してください。

PlayStationのセッション同期を設定する

Admin Portal

1. AGS管理者ポータルにログインし、ゲームネームスペースを選択します。
2. サイドバーメニューで、ゲーム設定 > サードパーティ設定 > 認証とアカウントリンクに移動します。
3. ログイン方法ページで、+ 新規追加ボタンをクリックします。ログインプラットフォーム設定ページが表示されます。
4. 利用可能なログインプラットフォームから、PSN 5 SDKをクリックします。設定の作成フォームが表示されます。
5. PSN製品ページからクライアントIDとクライアントシークレットを入力し、使用する環境を選択します。
6. リダイレクトURIを入力します。
7. 作成をクリックします。
8. サードパーティストア統合ページに移動します。管理者ポータルのサイドバーで、ゲーム設定 > サードパーティ設定 > マルチプレイヤーセッションに移動します。
9. マルチプレイヤーセッションページで、新規作成ボタンをクリックし、次のようにクライアントID、クライアントシークレット、スコープを入力します。
   • クライアントID: Auth Server(クライアントクレデンシャル)ClientID
   • クライアントシークレット: Auth Server(クライアントクレデンシャル)Secret
   • スコープ: psn:s2s.service(非PSNメンバーをPSNセッションに同期するため)
10. 新しいセッションテンプレートを作成し、セッション同期を有効にします。
11. セッションタイトル、言語とセッションタイトル(言語とセッションタイトル設定のために少なくとも1つのローカライゼーションを追加する必要があります)、PSNベースURL、サポートされているプラットフォーム、システムUIメニューを無効化、サービスラベルを入力します。
12. 追加をクリックします。

AGS CLI

1. PSN 5 SDK の設定を含む JSON ファイルを作成します。ファイル名は任意です。この例では ps5.json を使用します。

   {
     "ClientId": "<YourPsnClientId>",
     "Secret": "<YourPsnClientSecret>",
     "Environment": "<YourPsnEnvironment>",
     "RedirectUri": "<YourRedirectUri>",
     "IsActive": true
   }

   • ClientId と Secret: PSN製品ページから取得したクライアントIDとクライアントシークレット。
   • Environment: 使用する環境。DEV、CERT、np、sp-int、prod-qa のいずれかを使用します。各値は、管理者ポータルにある各環境オプション名の先頭の単語です。
   • RedirectUri: リダイレクトURI。管理者ポータルの リダイレクトURI に入力する値と同じです。

2. PSN 5 SDK をログイン方法として追加します。<YourGameNamespace> をゲームネームスペースに置き換えます。@ の後に JSON ファイルのパスを指定します。

   ags iam platform-credentials create --namespace <YourGameNamespace> --platform-id ps5 --json @ps5.json

   このファイルにはクライアントシークレットが含まれているため、コマンドの実行後に削除してください。

3. マルチプレイヤーセッションの認証情報を含む JSON ファイルを作成します。この例では psn-session.json を使用します。

   {
     "psn": {
       "clientId": "<YourAuthServerClientId>",
       "clientSecret": "<YourAuthServerClientSecret>",
       "scope": "psn:s2s.service"
     }
   }

   • clientId と clientSecret: Auth Server(クライアントクレデンシャル)のクライアントIDとシークレット。
   • scope: psn:s2s.service(非PSNメンバーをPSNセッションに同期するため)。

4. 認証情報を保存します。

   ags session platform-credentials update --namespace <YourGameNamespace> --json @psn-session.json

   このファイルにはクライアントシークレットが含まれているため、コマンドの実行後に削除してください。

5. セッション同期を有効にした新しいセッションテンプレートを作成します。セッションテンプレートの作成、設定、編集の AGS CLI の手順に従い、テンプレートの JSON ファイルに以下を追加します。

   "PSNBaseUrl": "<YourPsnBaseUrl>",
   "PSNEnvironment": "<YourPsnEnvironment>",
   "NativeSessionSetting": {
     "ShouldSync": true,
     "SessionTitle": "<YourSessionTitle>",
     "localizedSessionName": {
       "defaultLanguage": "en-US",
       "localizedText": {
         "en-US": "<YourSessionTitle>"
       }
     },
     "PSNSupportedPlatforms": ["ps5"],
     "PSNDisableSystemUIMenu": [],
     "PSNServiceLabel": 0
   }

   管理者ポータルのフィールド	リクエストボディのフィールド
   セッションタイトル	NativeSessionSetting.SessionTitle
   言語とセッションタイトル	NativeSessionSetting.localizedSessionName。localizedText に少なくとも 1 つの言語を追加し、defaultLanguage をそのいずれかに設定します。
   PSNベースURL	PSNBaseUrl と PSNEnvironment(下の表を参照)
   サポートされているプラットフォーム	NativeSessionSetting.PSNSupportedPlatforms: ps5、ps4、pspc の任意の組み合わせ
   システムUIメニューを無効化	NativeSessionSetting.PSNDisableSystemUIMenu: KICK、PROMOTE_TO_LEADER、UPDATE_JOINABLE_USER_TYPE、UPDATE_INVITABLE_USER_TYPE の任意の組み合わせ
   サービスラベル	NativeSessionSetting.PSNServiceLabel

   PSNベースURLのオプション	PSNBaseUrl	PSNEnvironment
   DEV	https://s2s.np.playstation.net	DEV
   CERT	https://s2s.np.playstation.net	CERT
   np	https://s2s.np.playstation.net	""
   sp-int	https://s2s.sp-int.playstation.net	""
   prod-qa	https://s2s.prod-qa.playstation.net	""