Skip to main content
Cette rubrique présente la liste des outils de développement disponibles sur xbox.com/play/dev-tools. Ces outils ont été conçus pour être utilisés avec les navigateurs Edge et Chrome sous Windows, et avec Safari sur Mac, iOS et iPadOS.

Page d’accueil développeur

Pour commencer à utiliser les outils de développement, il vous suffit de visiter xbox.com/play/dev-tools ou de lancer une expérience de streaming web telle que xbox.com/play, puis d’activer le mode développeur en procédant comme suit :
  1. Ouvrez les paramètres Capture d'écran de l'ouverture des paramètres
  2. Cliquez ou appuyez sur « Compte » 10 fois de suite rapidement pour faire apparaître l’onglet des paramètres développeur Capture d'écran d'un clic sur l'onglet Compte des paramètres
  3. Cliquez sur le bouton « Accueil des outils de développement ». Différentes options peuvent être disponibles dans l’onglet développeur selon l’état de connexion et l’accès du compte. Capture d'écran de l'onglet développeur des paramètres
Sur iOS ou iPadOS, vous pouvez enregistrer cette page en tant qu’application web progressive (PWA) en cliquant sur le bouton de partage et en sélectionnant « Sur l’écran d’accueil ». Une fois configurée, cette PWA mémorise votre compte et votre configuration, ce qui vous permet d’y revenir facilement plus tard pour poursuivre vos tests.
  • Pour les comptes commerciaux, laissez le champ sandbox vide et connectez-vous avec le même compte que celui connecté sur le kit de développement XBOX ou configuré pour accéder à une offre privée.
Pour les comptes de test de sandbox, n’oubliez pas de renseigner l’ID de la sandbox avant de vous connecter. Sinon, certaines fonctionnalités risquent de ne pas fonctionner correctement, car ces comptes n’ont pas accès aux fonctionnalités commerciales. Dans ce cas, il peut être nécessaire de vous déconnecter manuellement du compte en visitant un autre site web Microsoft tel que outlook.com, puis de réessayer avec l’ID de sandbox correct.
Capture d'écran de la boîte de dialogue de connexion Une fois connecté, cette page d’accueil propose des liens permettant d’accéder rapidement à la lecture à distance et à la sélection d’offres privées. Selon que le compte connecté a été associé à un kit de développement XBOX ou s’est vu accorder l’accès à une offre privée, certaines options peuvent être désactivées. Si le compte n’a accès à aucun scénario de développement, un message d’erreur s’affiche avec des informations sur la configuration à effectuer. Les sections ci-dessous décrivent plus en détail les exigences spécifiques de configuration des comptes. Capture d'écran de la page d'accueil Capture d'écran de l'erreur de la page d'accueil

Sélection de l’offre

Les offres sont des environnements de test privés utilisés pour valider les jeux exécutés sur le matériel des centres de données. Pour plus d’informations sur les offres, consultez la vue d’ensemble du Game Streaming. Pour utiliser une offre spécifique, accédez à xbox.com/play/dev-tools/select-offering ou cliquez sur « Sélectionner une offre » depuis la page d’accueil développeur. Sur la page de sélection de l’offre, les offres auxquelles vous avez accès sont préremplies dans la liste déroulante. Vous pouvez alors sélectionner l’offre et cliquer sur Se connecter. Si, pour une raison quelconque, l’offre souhaitée ne figure pas dans la liste déroulante, vous pouvez la saisir manuellement dans la zone de saisie ci-dessus, puis cliquer sur « Ajouter une offre ». Après avoir cliqué sur Se connecter, vous êtes redirigé vers la page principale du catalogue configurée pour votre offre. Un texte sur la page indique que vous utilisez désormais une offre personnalisée. Si vous ne parvenez pas à accéder à l’offre, vérifiez que vous êtes connecté avec un compte autorisé à utiliser cette offre spécifique.

Régions des offres

Comme les offres se connectent à un véritable centre de données, il est important de pouvoir tester dans différentes régions et de bénéficier de l’expérience de streaming représentative de chaque région. Actuellement, les offres n’acheminent pas automatiquement les utilisateurs vers le centre de données disponible le plus proche. Ce comportement peut plutôt être contrôlé manuellement à l’aide de la liste déroulante de la région de streaming dans le menu des paramètres développeur ou du paramètre de requête user.region. Notez que les régions disponibles doivent être configurées à l’avance ; contactez votre représentant de compte Microsoft pour ajuster les régions disponibles pour votre offre. Capture d'écran de la page de sélection de l'offre

Connexion à distance

La connexion à distance permet à l’utilisateur de se connecter à distance aux kits de développement XBOX sur lesquels les fonctionnalités à distance ont été activées pour cet utilisateur. Pour activer cette expérience, des étapes doivent d’abord être effectuées sur le kit de développement XBOX.

Configuration du kit de développement XBOX

  • Notez que vous devez effectuer cette partie avant de tenter de vous connecter au site web de connexion à distance ; si vous n’avez pas encore configuré de kit de développement XBOX pour une utilisation à distance avec votre compte, la page de connexion à distance vous redirigera vers la page d’accueil xbox.com/play.
  • Connectez-vous au kit de développement XBOX avec le compte (y compris un compte de sandbox) que vous utiliserez depuis le site web
  • Si vous le souhaitez, donnez un nom au kit de développement XBOX afin de pouvoir l’identifier facilement
  • Accédez à Dev Home -> Streaming -> sous « Remote Connect », sélectionnez votre compte.
    • Vous pouvez également activer la connexion à distance via les paramètres grand public : accédez à Dev Home -> Settings -> Launch Settings -> Devices & Connections -> Remote Features -> Enable Remote Features pour activer la connexion à distance
Capture d'écran de la page Streaming Remote Connect

Configuration de l’application de test de contenu web

Assurez-vous d’avoir effectué l’étape ci-dessus de configuration de votre kit de développement XBOX avant de continuer. Si vous n’avez pas activé les fonctionnalités à distance sur votre kit de développement XBOX, la fonctionnalité de connexion à distance peut être désactivée sur la page d’accueil des outils de développement. Suivez les étapes en haut de cette page pour vous connecter avec le même compte que celui configuré pour la lecture à distance sur le kit de développement XBOX. N’oubliez pas de saisir l’ID de sandbox pour un compte de test de sandbox. Une fois connecté et sur l’accueil des outils de développement, sélectionnez l’option de connexion à distance pour afficher la liste des appareils auxquels l’utilisateur peut se connecter. Les instructions pour ajouter un nouvel appareil sont également disponibles sur cette page en cliquant sur le bouton « Configurer une nouvelle XBOX ». Capture d'écran de la connexion à distance présentant les options permettant de se connecter à un appareil et de configurer une nouvelle Xbox
Assurez-vous que l’appareil client à partir duquel vous vous connectez à votre kit de développement XBOX se trouve sur le même réseau que celui-ci. Les connexions fonctionnent également via un VPN. Le trafic réseau vers le kit de développement XBOX transite par le port UDP 9002 ; ce port doit donc également être débloqué dans la configuration réseau.
Lorsque vous utilisez une offre personnalisée ou que vous vous connectez à un kit de développement XBOX distant, un ensemble de paramètres développeur est accessible depuis le menu des paramètres. Pour accéder au menu des paramètres, cliquez sur la photo de profil de l’utilisateur dans le coin supérieur droit, puis sélectionnez Paramètres. Ces paramètres développeur permettent notamment de revenir à la page d’accueil des outils de développement, de changer d’offre privée et d’ajuster les paramètres de configuration du flux. La vue d’ensemble de la configuration du flux fournit plus d’informations sur les paramètres de configuration du flux spécifiques qui peuvent être remplacés.
  • Activer le chargement indépendant TAK
  • Adresse du serveur de chargement indépendant
  • Activer l’actualisation automatique : active l’actualisation automatique pour le chargement indépendant TAK
  • Autoriser l’interaction avec la souris : autorise l’interaction avec la souris lors du streaming avec TAK
Ce menu des paramètres de développement est en outre toujours activé sur les pages xbox.com/play/dev-tools/select-offering et xbox.com/play/dev-tools/direct-connect. Capture d'écran de l'ouverture des paramètres Capture d'écran du mode développeur Lorsque vous diffusez en streaming à partir d’une offre personnalisée ou d’un kit de développement XBOX, vous avez accès au menu développeur, situé dans le coin inférieur gauche du flux. Après avoir cliqué sur ce menu, vous pouvez changer la disposition TAK active si vous utilisez l’interface CLI TAK pour charger vos dispositions de manière indépendante. Capture d'écran du menu développeur

Souris et clavier

La prise en charge de la souris et du clavier offre l’expérience de jeu à laquelle les utilisateurs sont habitués et leur permet de jouer à des jeux qui ne prennent en charge que la souris et le clavier. De plus, elle permet aux utilisateurs de jouer à des titres compatibles souris et clavier lorsqu’ils n’ont pas de manette. Pour les développeurs, la prise en charge du clavier leur permet d’accéder aux commandes de débogage internes. Assurez-vous que votre CTA est configurée pour les tests ; vous pouvez suivre les instructions ici : Configurer votre CTA web

Comment tester la souris et le clavier

Une fois votre application de test de contenu (CTA) configurée, vous pouvez tester votre implémentation de la souris et du clavier en accédant à l’icône du compte, puis à l’onglet Développeur, comme illustré dans la capture d’écran suivante. Page d'accueil de la CTA web Après avoir accédé à l’onglet Développeur, activez « Souris et clavier » pour activer la fonctionnalité.
Il est recommandé de laisser l’option « Émuler l’écran tactile avec la souris » de la section d’adaptation tactile DÉSACTIVÉE lors du test de la souris et du clavier. Pendant un flux, si les deux sont activés, les clics de souris sont interprétés comme des entrées tactiles. Toutefois, appuyer sur F9 permet toujours d’entrer en mode souris et clavier et d’en sortir.
Paramètres de la CTA web
Les joueurs peuvent utiliser une touche de raccourci, généralement F9, pour entrer en mode clavier et en sortir. Bien que les joueurs puissent remapper cette touche, évitez si possible d’utiliser F9 pour des fonctionnalités de jeu essentielles, ou permettez aux joueurs de remapper les touches dans le jeu.
Pour entrer en mode souris et clavier, vous pouvez cliquer avec le bouton gauche sur l’écran une fois le flux lancé, ou appuyer sur F9. Pour quitter le mode souris et clavier, appuyez sur F9. Contactez votre représentant de compte Microsoft lorsque vous avez terminé les tests et que vous êtes prêt à activer la souris et le clavier pour tous les utilisateurs.
Last modified on October 6, 2026