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 disponibles sur xbox.com/play, l’expérience web XBOX Cloud Gaming actuelle. Ces outils sont conçus pour Edge et Chrome sous Windows, et pour Safari sur Mac, iOS et iPadOS. Cet article traite de 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 développeur
• Chargement indépendant TAK
• Changer de disposition TAK pendant un flux
• Souris et clavier
• Essayer la nouvelle expérience

​

Choisir une expérience

La CTA web fonctionne sur deux expériences web XBOX Cloud Gaming : xbox.com/play et play.xbox.com, qui est 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 sandbox, 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 invite à vous connecter et comprend un champ sandbox.

• 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, saisissez l’ID de sandbox avant de vous connecter.

Une sandbox est un environnement de développement isolé pour votre titre, et chaque compte de test de sandbox appartient à une sandbox. L’ID de sandbox n’est pas votre ID d’offre ; obtenez-le auprès de la personne qui a créé vos comptes de test. Pour plus d’informations, consultez Vue d’ensemble des sandboxes des services XBOX. Si vous vous êtes connecté sans l’ID de sandbox, déconnectez-vous en visitant un autre site web Microsoft, tel que outlook.com. Reconnectez-vous ensuite avec l’ID de sandbox correct. Vous pouvez également ouvrir les paramètres développeur depuis le catalogue de xbox.com/play. Sélectionnez votre photo de profil, puis 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 développeur, Developer Tools Home permet de revenir à la page des outils de développement.

​

Sélectionner une 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 :

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 saisissez 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, vérifiez que vous êtes connecté avec un compte autorisé à utiliser cette offre spécifique.

​

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 démarrer un flux. Current region affiche votre sélection. 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.

​

IP Connect

Utilisez IP Connect pour diffuser en streaming directement depuis un kit de développement XBOX à l’aide de son adresse IP. Sur xbox.com/play, IP Connect nécessite un compte de test de sandbox, et la page des outils de développement ne contient pas de lien vers cette fonctionnalité. Avant d’utiliser IP Connect, remplissez les conditions préalables suivantes :

1. Configurez votre kit de développement XBOX pour le streaming. Pour plus d’informations, consultez Configurer un kit de développement XBOX.
2. Dans Dev Home > Streaming, vérifiez que Direct Connect est à l’écoute. L’écoute s’arrête à chaque redémarrage du kit.
3. Vérifiez que votre appareil client se trouve sur le même réseau que votre kit de développement XBOX, ou qu’il y est connecté via un VPN.
4. Vérifiez que votre réseau autorise le trafic TCP et UDP vers le port 9002 du kit de développement XBOX. Le navigateur utilise une connexion WebSocket pour la signalisation et UDP pour le flux.

Pour vous connecter à l’aide de l’adresse IP :

1. Accédez à xbox.com/play/dev-tools. Saisissez l’ID de sandbox, puis connectez-vous avec un compte de test de cette sandbox.
2. Accédez à xbox.com/play/dev-tools/ip-connect.
3. Saisissez l’adresse IP et le port du kit 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 exécutée sur le kit de développement XBOX apparaît dans le navigateur. Si vous êtes connecté avec un compte commercial, l’adresse IP Connect vous renvoie à la page des outils de développement.

​

Remote Connect

Remote Connect diffuse en streaming depuis votre kit de développement XBOX via Internet, par l’intermédiaire des services de lecture à distance XBOX. Il trouve le kit grâce au compte avec lequel vous êtes connecté ; vous n’avez donc pas à saisir d’adresse IP. Commencez par configurer le kit de développement XBOX :

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

Connectez-vous ensuite depuis 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 sandbox, saisissez l’ID de sandbox avant de vous connecter.
2. Sélectionnez Remote Connect. Cette option est disponible lorsque le compte avec lequel vous êtes connecté dispose d’un kit de développement configuré pour Remote Connect, ou lorsque vous êtes connecté avec un compte de test de sandbox.
3. Recherchez votre kit de développement XBOX dans la liste, puis sélectionnez Connect.

​

Paramètres développeur

Pour ouvrir les paramètres développeur, sélectionnez votre photo de profil, puis Settings > Developer. Les paramètres développeur comprennent l’offre actuelle et 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 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 CLI TAK au lieu des dispositions publiées pour votre titre.
• Sideload server address : adresse du serveur de chargement indépendant.
• Enable automatic refresh : met à jour les dispositions sur votre appareil lorsque vous les modifiez sur le serveur de chargement indépendant.
• Emulate touch with mouse : interprète les clics de souris comme des entrées tactiles.

​

Chargement indépendant TAK

Ces étapes concernent le streaming depuis une offre personnalisée ou un kit 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 indépendant depuis le même PC que le navigateur :

1. Ouvrez Settings > Developer et recherchez Touch adaptation.
2. Activez Enable sideload.
3. Dans Sideload server address, saisissez l’adresse de votre serveur de chargement indépendant, par exemple http://localhost:9269. Toute adresse autre que localhost doit utiliser https, comme décrit dans Chargement indépendant depuis un autre appareil.
4. Sous Network Status, vérifiez Network Permission. Si l’état indique Required, sélectionnez Request Permission. Lorsque le navigateur demande s’il faut 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, le flux n’affiche aucune commande tactile et le menu TAK n’est pas disponible.
6. Lorsque Server Connection indique Connected, démarrez un flux. S’il indique Not Reachable, vérifiez 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 un flux vous invite à changer de jeu. Pour vérifier que le flux utilise vos dispositions, recherchez-les sous Bundle layouts, comme décrit dans Changer de disposition TAK pendant un flux.

​

Chargement indépendant depuis 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 atteindre sur votre réseau local. Le serveur doit utiliser https :

1. Créez un certificat. Pour plus d’informations, consultez Instructions de génération de certificat.
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 la procédure, consultez Approbation du certificat sur différents clients.
4. Sur le téléphone ou la tablette, ouvrez Settings > Developer, activez Enable sideload et saisissez https://<your PC's IP address>:9269 dans Sideload server address.
5. Vérifiez Network Permission et Server Connection, comme décrit aux étapes 4 et 6 de Chargement indépendant TAK.

Pour exiger un mot de passe, utilisez l’option --password et saisissez le même mot de passe dans les paramètres développeur de l’appareil. Pour plus d’informations, consultez Commande serve.

​

Changer de disposition TAK pendant un flux

En mode développeur, vous pouvez changer la disposition active pendant le streaming :

1. Dans le flux, 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 ce flux. Lorsque le chargement indépendant fonctionne, il s’agit de 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) supprime les commandes tactiles.

​

Souris et clavier

Avant de commencer, ouvrez les outils de développement comme décrit dans 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 démarrer un flux.
2. Sous Touch adaptation, désactivez Emulate touch with mouse. Lorsque les deux options sont activées, les clics de souris sont interprétés comme des entrées tactiles.
3. Démarrez un flux.
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 Try the new experience > Try now. Pour revenir à xbox.com/play, ouvrez Account settings depuis votre profil et sélectionnez Exit preview.