QUIC の機能
- すべてのパケットは暗号化され、ハンドシェイクは TLS 1.3 を使用して認証されます。
- 信頼性のあるアプリケーション データと信頼性のないアプリケーション データの並列ストリーム。
- 最初のラウンド トリップ (0-RTT) でのアプリケーション データの交換。
- 輻輳制御と損失回復の改善。
- クライアントの IP アドレスやポートの変更に耐えます。
- ステートレスなロード バランシング。
- 新機能や拡張のために容易に拡張可能。
MsQuic の実装
GDK タイトルでの使用向けに調整されていることに加え、MsQuic には他の QUIC 実装とは異なるいくつかの特徴があります。- クライアントとサーバー向けに最適化されています。
- 最大スループットと最小レイテンシに最適化されています。
- 非同期 IO。
- Receive Side Scaling (RSS) のサポート。
- UDP の送受信の結合 (coalescing) のサポート。
MsQuic の取得
Microsoft は MsQuic をオープン ソースの GitHub リポジトリでホストしています。MsQuic は、こちら にある公式リリースの 1 つを通じて取得してください。XBOX Series X|S コンソールのサポートは prerelease/1.9 で追加されましたが、GDK タイトルには可能な限り最新の公式リリース バージョンを使用することをお勧めします。 特定のリリース用にビルド済みの MsQuic バイナリは、特定のリリースの Assets セクションの下で見つけることができます。特定のバージョンの MsQuic のすべてのビルド フレーバーは、互いに完全に互換性があります。MsQuic はまた、リリース間の後方互換性の維持も試みていますが、異なるバージョン間での互換性の期待については、MsQuic のドキュメントとリリース ノートを参照してください。GDK ベースの PC タイトル
GDK ベースの PC タイトルには、msquic_windows_x64_Release_openssl ビルド済みバイナリを使用してください。
PC の GDK タイトルはネイティブ x64 Win32 アプリケーションとして実行されます。x64 プラットフォーム向けにビルドされた MsQuic バージョンを使用してください。PC では、GDK がサポートするすべての OS バージョンをサポートしている OpenSSL でビルドされた MsQuic バージョンを使用してください。Schannel を使用するバージョンは Windows 11 OS 以降のみをサポートしています。
GDK ベースのコンソール タイトル
GDK ベースのコンソール タイトルには、msquic_gamecore_console_x64_Release_schannel ビルド済みバイナリを使用してください。
MsQuic は、XBOX コンソール上の GDK ベースのタイトル向けの特別なビルド フレーバーを提供しています。このフレーバーは MsQuic を WINAPI_PARTITION_GAMES 下の API に制限し、MsQuic が XGamePlatform.lib に対してリンクされるようにします。このビルド フレーバーを使用するには、2021 年 10 月リリース以降の XGDK をインストールする必要があります。MsQuic は、GDK ベースのコンソール タイトル向けにビルドする場合、Schannel を使用します。
クライアントとサーバーの認証
MsQuic は、サーバーを認証するために HTTPS Web リクエストに使用されるものと同じ認証および検証パスを自動的に利用します。クライアント認証は、安全なクライアント/サーバー通信のベスト プラクティス (NDA トピック) で概説されているベスト プラクティスに従うべきです。 MsQuic では、クライアントとサーバーの両方で、証明書を構成するために ConfigurationLoadCredential API を適切な QUIC_CREDENTIAL_CONFIG と共に使用する必要があります。MsQuic に既定で含まれるすべての暗号スイートは安全であると考えられていますが、安全で認証された通信チャネルが確立されることを確実にするために、クライアントとサーバーの両方で MsQuic が証明書を検証する方法を適切に設定することが重要です。 サーバー側では、XSTS トークン クライアント認証を使用するには、QUIC_CREDENTIAL_FLAG_REQUIRE_CLIENT_AUTHENTICATION、QUIC_CREDENTIAL_FLAG_INDICATE_CERTIFICATE_RECEIVED、および QUIC_CREDENTIAL_FLAG_NO_CERTIFICATE_VALIDATION フラグを指定する必要があります。QUIC_CREDENTIAL_FLAG_NO_CERTIFICATE_VALIDATION フラグを指定する場合、安全なクライアント/サーバー通信のベスト プラクティス (NDA トピック) セクションで説明されているように、QUIC_CONNECTION_EVENT_PEER_CERTIFICATE_RECEIVED イベント コールバック内でクライアント証明書を自分自身で検証する必要があります。
さらにサーバー側では、HTTPS Web サーバーと同様に、クライアントがサーバーを認証できるように、適切にルート付けされた証明書を提供する必要があります。
クライアント側では、QUIC_CREDENTIAL_FLAG_NO_CERTIFICATE_VALIDATION フラグを 絶対に 指定しないでください。サーバー認証に対する既定の MsQuic の動作が、ID を検証する最も簡単で最も安全な方法だからです。代わりに、XSTS トークン クライアント認証には、安全なクライアント/サーバー通信のベスト プラクティス (NDA トピック) セクションで説明されているように、QUIC_CREDENTIAL_FLAG_CLIENT フラグを、サーバーで生成された証明書と共に指定する必要があります。QUIC_CREDENTIAL_TYPE_CERTIFICATE_CONTEXT モードを指定し、CertCreateContext などの API を使用して Web リクエストの応答データから直接コンテキストを生成する方法で、クライアント証明書を提供することをお勧めします。
ネットワーク初期化
MsQuic は、GDK タイトルの ネットワーク初期化 を自動的に処理しません。タイトルが起動された後、および各再開の後、MsQuicOpenVersion または MsQuicOpen を使用して MsQuic を初期化する前に、ネットワークが初期化されるのを待ってください。サスペンドと再開
RegisterAppStateChangeNotification を使用してサスペンドおよび再開イベントを登録します。サスペンド時には、開いているすべてのストリームを閉じ、MsQuic を閉じます。その後、再開時には、ネットワーク初期化を待ってから MsQuic を再度開きます。
サスペンド タイムアウト内ですべての MsQuic ストリームを迅速に閉じるには、開いている各ストリームに対して、QUIC_STREAM_SHUTDOWN_FLAG_ABORT と QUIC_STREAM_SHUTDOWN_FLAG_IMMEDIATE フラグを付けて StreamShutdown を呼び出します。この呼び出しは、直ちに QUIC_STREAM_EVENT_SHUTDOWN_COMPLETE イベントをトリガーします。この時点で、StreamClose を呼び出してストリームを閉じるのが安全です。特定の接続に対するすべてのストリームが閉じられたら、QUIC_CONNECTION_SHUTDOWN_FLAG_SILENT フラグを付けて ConnectionShutdown を呼び出し、続いて ConnectionClose を呼び出します。すべての接続を閉じた後、未解決の登録および構成に対して RegistrationClose および ConfigurationClose を呼び出し、続いて MsQuicClose を呼び出します。
優先ポート
GDK タイトルのメイン ゲーム トラフィックには、優先ローカル UDP マルチプレイヤー ポート を使用してください。MsQuic では、ConnectionStart を呼び出す前に、接続オブジェクト ハンドル上でQUIC_PARAM_CONN_LOCAL_ADDRESS 設定と共に SetParam 関数を使用して、このポートを設定します。
QUIC_PARAM_CONN_LOCAL_ADDRESS を設定するときは、デュアル スタック IPv4 および IPv6 ソケットを許可するために AF_UNSPEC ファミリを指定します。次の例は、MsQuicCallTable が MsQuicOpen から返され、MsQuicConnectionHandle が ConnectionOpen から返された場合に、優先ポートを設定する方法を示します。