Fonctionnalités de QUIC
- Tous les paquets sont chiffrés et l’établissement de la liaison est authentifié au moyen de TLS 1.3.
- Flux parallèles de données d’application fiables et non fiables.
- Échange de données d’application dès le premier aller-retour (0-RTT).
- Contrôle de la congestion et récupération des pertes améliorés.
- Résiste à un changement de l’adresse IP ou du port du client.
- Équilibrage de charge sans état.
- Facilement extensible pour de nouvelles fonctionnalités et extensions.
Implémentation de MsQuic
En plus d’être adaptée aux titres GDK, MsQuic possède plusieurs fonctionnalités qui la distinguent des autres implémentations de QUIC :- Optimisée pour le client et le serveur.
- Optimisée pour un débit maximal et une latence minimale.
- E/S asynchrones.
- Prise en charge de la mise à l’échelle côté réception (RSS).
- Prise en charge du regroupement des envois et réceptions UDP.
Obtention de MsQuic
Microsoft héberge MsQuic dans un référentiel GitHub à code source ouvert. Vous devriez obtenir MsQuic au moyen de l’une de ses versions officielles, disponibles ici. La prise en charge de la console XBOX Series X|S a été ajoutée dans la préversion prerelease/1.9, mais nous vous recommandons d’utiliser la dernière version officielle lorsque c’est possible pour les titres GDK. Vous trouverez des fichiers binaires MsQuic prégénérés pour une version donnée dans la section Assets de cette version. Toutes les variantes de build d’une version donnée de MsQuic sont entièrement compatibles entre elles. Bien que MsQuic tente également de maintenir la rétrocompatibilité entre ses versions, consultez la documentation et les notes de version de MsQuic pour connaître les attentes en matière de compatibilité entre les différentes versions.Titres PC basés sur le GDK
Utilisez le fichier binaire prégénérémsquic_windows_x64_Release_openssl pour les titres PC basés sur le GDK.
Les titres GDK sur PC s’exécutent en tant qu’applications Win32 x64 natives. Utilisez la version de MsQuic générée pour la plateforme x64. Sur PC, utilisez la version de MsQuic générée avec OpenSSL, car elle prend en charge toutes les versions du système d’exploitation que le GDK prend en charge. La version qui utilise Schannel ne prend en charge que Windows 11 et les versions ultérieures.
Titres de console basés sur le GDK
Utilisez le fichier binaire prégénérémsquic_gamecore_console_x64_Release_schannel pour les titres de console basés sur le GDK.
MsQuic fournit une variante de build spéciale pour les titres basés sur le GDK sur les consoles XBOX. Cette variante limite MsQuic aux API de WINAPI_PARTITION_GAMES et fait en sorte que MsQuic soit lié à XGamePlatform.lib. Pour utiliser cette variante de build, vous devez installer le XGDK de la version d’octobre 2021 ou d’une version ultérieure. MsQuic utilise Schannel lors de la génération pour les titres de console basés sur le GDK.
Authentification du client et du serveur
MsQuic utilise automatiquement les mêmes chemins d’authentification et de vérification que ceux utilisés pour les requêtes web HTTPS afin d’authentifier votre serveur. L’authentification du client doit suivre les pratiques exemplaires décrites dans pratiques exemplaires pour une communication client/serveur sécurisée (rubrique sous NDA). Dans MsQuic, sur le client comme sur le serveur, vous devez utiliser l’API ConfigurationLoadCredential avec une structure QUIC_CREDENTIAL_CONFIG appropriée afin de configurer vos certificats. Toutes les suites de chiffrement incluses par défaut dans MsQuic sont considérées comme sécurisées, mais il est important de configurer correctement la façon dont MsQuic valide les certificats sur le client et sur le serveur pour garantir l’établissement d’un canal de communication sécurisé et authentifié. Sur le serveur, pour utiliser l’authentification du client par jeton XSTS, vous devez spécifier les indicateursQUIC_CREDENTIAL_FLAG_REQUIRE_CLIENT_AUTHENTICATION, QUIC_CREDENTIAL_FLAG_INDICATE_CERTIFICATE_RECEIVED et QUIC_CREDENTIAL_FLAG_NO_CERTIFICATE_VALIDATION. Lorsque vous spécifiez l’indicateur QUIC_CREDENTIAL_FLAG_NO_CERTIFICATE_VALIDATION, vous devez valider vous-même le certificat du client dans le rappel d’événement QUIC_CONNECTION_EVENT_PEER_CERTIFICATE_RECEIVED, comme décrit dans la section pratiques exemplaires pour une communication client/serveur sécurisée (rubrique sous NDA).
De plus, sur le serveur, vous devez fournir un certificat correctement enraciné afin de permettre au client d’authentifier votre serveur, tout comme vous le feriez pour un serveur web HTTPS.
Sur le client, vous ne devez jamais spécifier l’indicateur QUIC_CREDENTIAL_FLAG_NO_CERTIFICATE_VALIDATION, car le comportement par défaut de MsQuic pour l’authentification du serveur est la façon la plus simple et la plus sécurisée de valider l’identité. Pour l’authentification du client par jeton XSTS, vous devez plutôt spécifier l’indicateur QUIC_CREDENTIAL_FLAG_CLIENT avec le certificat généré par votre serveur, comme décrit dans la section pratiques exemplaires pour une communication client/serveur sécurisée (rubrique sous NDA). Nous recommandons de fournir le certificat du client en spécifiant le mode QUIC_CREDENTIAL_TYPE_CERTIFICATE_CONTEXT et en utilisant des API comme CertCreateContext pour générer le contexte directement à partir des données de réponse de votre requête web.
Initialisation du réseau
MsQuic ne gère pas automatiquement l’initialisation du réseau pour les titres GDK. Attendez que le réseau soit initialisé après le lancement de votre titre et après chaque reprise avant d’initialiser MsQuic à l’aide de MsQuicOpenVersion ou de MsQuicOpen.Suspension et reprise
Inscrivez-vous aux événements de suspension et de reprise à l’aide deRegisterAppStateChangeNotification. Lors de la suspension, fermez tous les flux ouverts, puis fermez MsQuic. Ensuite, lors de la reprise, attendez l’initialisation du réseau, puis rouvrez MsQuic.
Pour fermer rapidement tous les flux MsQuic dans le délai de suspension, appelez StreamShutdown pour chaque flux ouvert avec les indicateurs QUIC_STREAM_SHUTDOWN_FLAG_ABORT et QUIC_STREAM_SHUTDOWN_FLAG_IMMEDIATE. Cet appel déclenche immédiatement un événement QUIC_STREAM_EVENT_SHUTDOWN_COMPLETE. À ce moment, vous pouvez appeler StreamClose en toute sécurité pour fermer le flux. Une fois que tous les flux d’une connexion donnée sont fermés, appelez ConnectionShutdown avec l’indicateur QUIC_CONNECTION_SHUTDOWN_FLAG_SILENT, puis ConnectionClose. Après avoir fermé toutes les connexions, appelez RegistrationClose et ConfigurationClose pour les inscriptions et configurations restantes, puis MsQuicClose.
Port préféré
Utilisez le port multijoueur UDP local préféré pour le trafic de jeu principal dans les titres GDK. Définissez ce port dans MsQuic à l’aide de la fonction SetParam avec le paramètreQUIC_PARAM_CONN_LOCAL_ADDRESS sur un handle d’objet de connexion avant d’appeler ConnectionStart.
Lorsque vous définissez QUIC_PARAM_CONN_LOCAL_ADDRESS, spécifiez la famille AF_UNSPEC pour permettre l’utilisation de sockets à double pile IPv4 et IPv6. L’exemple suivant montre comment définir le port préféré lorsque MsQuicCallTable est retourné par MsQuicOpen et que MsQuicConnectionHandle est retourné par ConnectionOpen.