Application de test de contenu (CTA) Web sur xbox.com/play

Les outils de développement de l’application de test de contenu (CTA) Web sont offerts sur xbox.com/play, l’expérience Web actuelle de XBOX Cloud Gaming. Ces outils ont été conçus pour Edge et Chrome sous Windows, et pour Safari sous Mac, iOS et iPadOS. Cet article porte sur xbox.com/play. Une nouvelle expérience est en préversion sur play.xbox.com. Pour utiliser ses outils de développement, consultez Vue d’ensemble de l’application de test de contenu (CTA) Web.

• Choisir une expérience
• Ouvrir les outils de développement
• Sélectionner une offre
• IP Connect
• Remote Connect
• Paramètres de développement
• Chargement latéral TAK
• Changer de disposition TAK pendant une diffusion
• Souris et clavier
• Essayer la nouvelle expérience

​

Choisir une expérience

La CTA Web fonctionne sur deux expériences Web de XBOX Cloud Gaming : xbox.com/play et play.xbox.com, actuellement en préversion. Utilisez ce tableau pour choisir celle qui convient à votre scénario : Les deux expériences prennent en charge les offres privées, les comptes de test de bac à sable, la sélection de la région ainsi que la souris et le clavier.

​

Ouvrir les outils de développement

Pour commencer à utiliser les outils de développement, accédez à xbox.com/play/dev-tools. Si vous n’êtes pas connecté, la page vous demande de vous connecter et comprend un champ pour le bac à sable.

• Pour les comptes de détail, laissez le champ du bac à sable vide et connectez-vous avec le même compte que celui qui est connecté sur la trousse de développement XBOX ou qui est configuré pour accéder à une offre privée.
• Pour les comptes de test de bac à sable, entrez l’ID du bac à sable avant de vous connecter.

Un bac à sable est un environnement de développement isolé pour votre titre, et chaque compte de test de bac à sable appartient à un bac à sable. L’ID du bac à sable n’est pas l’ID de votre offre; obtenez-le auprès de la personne qui a créé vos comptes de test. Pour en savoir plus, consultez Vue d’ensemble des bacs à sable des services XBOX. Si vous vous êtes connecté sans l’ID du bac à sable, déconnectez-vous en visitant un autre site Web de Microsoft, comme outlook.com. Connectez-vous ensuite de nouveau avec le bon ID de bac à sable. Vous pouvez aussi ouvrir les paramètres de développement à partir du catalogue de xbox.com/play. Sélectionnez votre photo de profil, puis sélectionnez Settings > Developer. Si Developer n’apparaît pas, sélectionnez Account 10 fois de suite rapidement pour le faire apparaître. Dans les paramètres de développement, Developer Tools Home vous ramène à la page des outils de développement.

​

Sélectionner une offre

Les offres sont les environnements de test privés utilisés pour valider les jeux qui s’exécutent sur le matériel des centres de données. Pour en savoir plus sur les offres, consultez Vue d’ensemble de la diffusion de jeux en continu. Pour utiliser une offre précise :

1. Accédez à xbox.com/play/dev-tools/select-offering.
2. Sélectionnez l’offre dans la liste déroulante, ou sélectionnez Custom offering ID et entrez l’ID de l’offre dans Enter offering ID for cloud connection.
3. Sélectionnez Connect.

Le catalogue de votre offre s’ouvre, et la page affiche Using custom offering suivi de l’ID de l’offre. Si vous ne parvenez pas à accéder à l’offre, assurez-vous d’être connecté à un compte autorisé à utiliser cette offre précise.

​

Régions des offres

Les offres ne vous acheminent pas automatiquement vers le centre de données le plus proche. Pour effectuer des tests dans une autre région, ouvrez Settings > Developer et choisissez une région sous Streaming Region. Choisissez-la avant de lancer une diffusion. Current region affiche votre sélection. Les régions disponibles doivent être configurées à l’avance. Communiquez avec votre représentant de compte Microsoft pour ajuster les régions disponibles pour votre offre.

​

IP Connect

Utilisez IP Connect pour diffuser en continu directement à partir d’une trousse de développement XBOX au moyen de son adresse IP. Sur xbox.com/play, IP Connect nécessite un compte de test de bac à sable, et la page des outils de développement n’y mène pas. Avant d’utiliser IP Connect, remplissez les conditions préalables suivantes :

1. Configurez votre trousse de développement XBOX pour la diffusion en continu. Pour en savoir plus, consultez Configurer une trousse de développement XBOX.
2. Dans Dev Home > Streaming, assurez-vous que Direct Connect est à l’écoute. Il cesse d’écouter chaque fois que la trousse redémarre.
3. Assurez-vous que votre appareil client se trouve sur le même réseau que votre trousse de développement XBOX, ou qu’il y est connecté au moyen d’un RPV.
4. Assurez-vous que votre réseau autorise le trafic TCP et UDP vers le port 9002 de la trousse de développement XBOX. Le navigateur utilise une connexion WebSocket pour la signalisation et UDP pour la diffusion.

Pour vous connecter au moyen d’une adresse IP :

1. Accédez à xbox.com/play/dev-tools. Entrez l’ID du bac à sable, puis connectez-vous avec un compte de test de ce bac à sable.
2. Accédez à xbox.com/play/dev-tools/ip-connect.
3. Entrez l’adresse IP et le port de la trousse de développement XBOX, par exemple 192.168.1.10:9002.
4. Sélectionnez Connect.
5. Si votre navigateur demande l’autorisation d’accéder aux appareils de votre réseau local, sélectionnez Allow.

Lorsque la connexion réussit, l’application qui s’exécute sur la trousse de développement XBOX apparaît dans le navigateur. Si vous êtes connecté avec un compte de détail, l’adresse IP Connect vous ramène à la page des outils de développement.

​

Remote Connect

Remote Connect diffuse en continu à partir de votre trousse de développement XBOX par Internet au moyen des services de lecture à distance XBOX. Il trouve la trousse au moyen de votre compte connecté; vous n’avez donc pas à entrer d’adresse IP. Configurez d’abord la trousse de développement XBOX :

1. Connectez-vous à la trousse de développement XBOX avec le compte que vous utiliserez sur xbox.com/play. Le compte doit être autorisé dans le bac à sable de la trousse.
2. Accédez à Dev Home > Streaming. Sous Remote Connect, sélectionnez votre compte.
3. Dans Dev Home > Streaming, assurez-vous que Direct Connect n’est pas à l’écoute. Direct Connect est un mode de connexion distinct pour IP Connect, et il bloque Remote Connect lorsqu’il est à l’écoute.

Connectez-vous ensuite à partir de xbox.com/play :

1. Accédez à xbox.com/play/dev-tools et connectez-vous avec le même compte. Pour un compte de test de bac à sable, entrez l’ID du bac à sable avant de vous connecter.
2. Sélectionnez Remote Connect. Cette option est offerte lorsqu’une trousse de développement est configurée pour Remote Connect avec votre compte connecté, ou lorsque vous êtes connecté avec un compte de test de bac à sable.
3. Trouvez votre trousse de développement XBOX dans la liste, puis sélectionnez Connect.

​

Paramètres de développement

Pour ouvrir les paramètres de développement, sélectionnez votre photo de profil, puis sélectionnez Settings > Developer. Les paramètres de développement comprennent l’offre actuelle et les paramètres de configuration de la diffusion. La Vue d’ensemble de la configuration de la diffusion fournit plus d’informations sur les paramètres de configuration de la diffusion précis qui peuvent être remplacés. Sous Stream Configuration > Touch adaptation, vous pouvez définir :

• Enable sideload : charge les dispositions tactiles à partir de la commande serve de l’interface de ligne de commande TAK au lieu des dispositions publiées pour votre titre.
• Sideload server address : l’adresse du serveur de chargement latéral.
• Enable automatic refresh : met à jour les dispositions sur votre appareil lorsque vous les modifiez sur le serveur de chargement latéral.
• Emulate touch with mouse : traite les clics de souris comme des touchers.

​

Chargement latéral TAK

Ces étapes couvrent la diffusion en continu à partir d’une offre personnalisée ou d’une trousse de développement XBOX. Pour utiliser une offre, consultez Sélectionner une offre. Avant de commencer, exécutez tak serve sur le PC qui sert vos dispositions. Pour effectuer un chargement latéral à partir du même PC que le navigateur :

1. Ouvrez Settings > Developer et trouvez Touch adaptation.
2. Activez Enable sideload.
3. Dans Sideload server address, entrez l’adresse de votre serveur de chargement latéral, par exemple http://localhost:9269. Toute adresse autre que localhost doit utiliser https, comme le décrit Chargement latéral à partir d’un autre appareil.
4. Sous Network Status, vérifiez Network Permission. Si Required s’affiche, sélectionnez Request Permission. Lorsque le navigateur demande d’autoriser le site à Access other apps and services on this device, sélectionnez Allow.
5. Sur un PC sans écran tactile, activez Emulate touch with mouse. Sans cette option, la diffusion n’affiche aucune commande tactile et le menu TAK n’est pas disponible.
6. Lorsque Server Connection indique Connected, lancez une diffusion. Si Not Reachable s’affiche, assurez-vous que tak serve est en cours d’exécution, puis sélectionnez Recheck.

La modification de Enable sideload ou de Emulate touch with mouse pendant une diffusion vous invite à changer de jeu. Pour confirmer que la diffusion utilise vos dispositions, vérifiez qu’elles figurent sous Bundle layouts, comme le décrit Changer de disposition TAK pendant une diffusion.

​

Chargement latéral à partir d’un autre appareil

Pour effectuer des tests sur un téléphone ou une tablette, exécutez tak serve sur un PC que l’appareil peut joindre sur votre réseau local. Le serveur doit utiliser https :

1. Créez un certificat. Pour en savoir plus, consultez Instructions de génération de certificats.
2. Sur le PC, exécutez tak serve avec les options --certificate-file et --certificate-password.
3. Installez le certificat sur le téléphone ou la tablette et approuvez-le. Pour connaître les étapes, consultez Approbation du certificat sur différents clients.
4. Sur le téléphone ou la tablette, ouvrez Settings > Developer, activez Enable sideload et entrez https://<your PC's IP address>:9269 dans Sideload server address.
5. Vérifiez Network Permission et Server Connection, comme le décrivent les étapes 4 et 6 de Chargement latéral TAK.

Pour exiger un mot de passe, utilisez l’option --password et entrez le même mot de passe dans les paramètres de développement de l’appareil. Pour en savoir plus, consultez Commande Serve.

​

Changer de disposition TAK pendant une diffusion

En mode développeur, vous pouvez changer la disposition active pendant la diffusion en continu :

1. Dans la diffusion, ouvrez Developer Tools Menu dans le coin inférieur gauche, puis sélectionnez TAK.
2. Sous Select touch controls layout, sélectionnez une disposition sous Bundle layouts ou System layouts. Bundle layouts affiche les dispositions chargées pour cette diffusion. Lorsque le chargement latéral fonctionne, ce sont vos dispositions.
3. Sélectionnez Close.

Les System layouts sont Standard et Native Touch Only (Blank). Standard affiche la superposition de manette standard. Native Touch Only (Blank) retire les commandes tactiles.

​

Souris et clavier

Avant de commencer, ouvrez les outils de développement comme le décrit Ouvrir les outils de développement.

1. Dans Settings > Developer, sous Stream Configuration > Enabled input types, activez Mouse and keyboard. Modifiez ce paramètre avant de lancer une diffusion.
2. Sous Touch adaptation, désactivez Emulate touch with mouse. Lorsque les deux options sont activées, les clics de souris sont traités comme des touchers.
3. Lancez une diffusion.
4. Si une bannière indique Enter fullscreen mode to play with mouse and keyboard, sélectionnez Enter fullscreen.

Pour libérer la souris, appuyez sur la touche indiquée dans la notification Press key to release your mouse.

​

Essayer la nouvelle expérience

Pour passer à la nouvelle expérience sur play.xbox.com, sélectionnez votre photo de profil, puis sélectionnez Try the new experience > Try now. Pour revenir à xbox.com/play, ouvrez Account settings à partir de votre profil et sélectionnez Exit preview.