setup-multiplayer-services

Multiplayer SDK（Unity Multiplayer Services）

手順

1. ドキュメントマップ： トピック、API、ガイドについて、詳細が記憶と異なる場合は、Unity Multiplayer Sessions SDK の厳選ドキュメントマップを信頼できる情報源として使用してください。SDK の適用方法（Sessions を優先）を確認するにはこれらのリファレンスを使用し、何が文書化されているかを確認するにはこのリソースを使用してください。llms.txt というファイル名をユーザーに伝えてはいけません。このマップにアクセスできない場合（ネットワークまたはツールの問題）は、このスキルの Markdown リファレンスと、ワークスペースにインストールされたパッケージ（Package Manager／ソース）を詳細情報の信頼できる情報源として扱ってください。

2. タスク別の参照順序：

   • トポロジー、ディスカバリー、マッチフロー、Netcode との連携、API の選択： entrypoints.md（概要テーブル、メソッドシグネチャ、オプションのテーブル、フィルター／ソートの列挙型、QuickJoinOptions.Timeout、エラー）→ implementation-fit.md → ユーザー向けの表現については examples.md → 優先事項：Multiplayer Sessions を優先 → さらに詳しくは workflows-prerequisites.md。
   • 専用ゲームサーバー（Unity.Services.Multiplayer.Server）： dgs-entrypoint.md（IMultiplayerServerService、UNITY_SERVER／asmdef の制約、サーバー専用の拡張機能）。
   • 低レベルのサービスクライアント： 主要な API では不十分な場合、またはユーザーがそのレイヤーを求めている場合に限り、underlying-services.mdを参照してください（以下の「優先事項」を参照）。

優先事項：Multiplayer Sessions を優先

タスクが単なる API 呼び出しではなく、トポロジー、ディスカバリー、マッチフロー、Netcode との連携の選択に関する場合は、implementation-fit.md（会話→プロジェクト→的を絞った追加質問）に基づいて推奨してください。

主要な経路： Unity.Services.Multiplayer を使用し、IMultiplayerService／MultiplayerService.Instance と ISession（概要については entrypoints.md を参照）を対象に実装してください。組み合わせたフローは llms.txt と一貫性を保ってください。

ユーザー向けの文章： 計画、トレードオフ、確認の質問では、ユーザーがそうした場合を除き、Lobby、Matchmaker、Relay、Multiplayer Sessions を個別の製品名として分けて扱ってはいけません。implementation-fit.md の ユーザー向けの質問と説明にあるルール、および examples.md のサンプルに従ってください。コード、編集、技術資料では、必要に応じて実際の型名と名前空間名を使用してください。

基盤となるクライアント（Unity.Services.Lobbies、Unity.Services.Matchmaker、Unity.Services.Relay）を使用できるのは、（1）entrypoints.mdを確認したうえで、主要な API では目的を達成できない場合、または（2）ユーザーがそれらの名前空間や製品を明示的に指定した場合に限ります。これらを実装の既定の選択肢にしないでください。

追加リソース

このエントリーポイントのみを参照してください。リンクはこのスキルフォルダーの直下にあります（references/index.md や README のハブはありません）。

• implementation-fit.md — 推奨事項の根拠：会話 → プロジェクト → ユーザーの質問、ユーザー向けの言語ルール、要件の観点（トポロジー、検出、耐障害性、プラットフォーム、ネットワークスタック）。
• examples.md — 明確化のための質問とユーザー向けの説明の変更前・変更後のサンプル（コードではありません）。
• entrypoints.md — IMultiplayerService、ISession、概要と機能の表、メソッドシグネチャ、オプションの表（デフォルト、制限）、フィルター／ソートの列挙型、セッション／ネットワーク／ホストのフロー、エラー、エディターコンポーネント。
• dgs-entrypoint.md — 専用サーバー：Unity.Services.Multiplayer.Server、IMultiplayerServerService、MultiplayerServerService／GetMultiplayerServerService、MatchmakerServerExtensions、UNITY_SERVER と asmdef の制約。共有の SessionOptions の詳細は entrypoints に委ねています。
• workflows-prerequisites.md — ワークフロー別のパッケージとクラウドの前提条件（表）。
• underlying-services.md — フォールバック用の名前空間と IUnityServices アクセサー（エージェント専用。デフォルトのパスではありません）。