Résolution des problèmes liés à Amazon GameLift Streams

Si le rôle IAM dispose d'une politique explicite de « refus de tout », vous devez explicitement répertorier Amazon GameLift Streams comme exception à cette politique en ajoutant "gameliftstreams:*" à l'élément. NotAction Par exemple :

{
    "Sid": "DenyAllExceptListedIfNoMFA",
    "Effect": "Deny",
    "NotAction": [
        "iam:CreateVirtualMFADevice",
        "iam:EnableMFADevice",
        "iam:GetUser",
        "iam:ListMFADevices",
        "iam:ListVirtualMFADevices",
        "iam:ResyncMFADevice",
        "sts:GetSessionToken",        
        "gameliftstreams:*"                    // Add this
    ],
    "Resource": "*",
    "Condition": {
        "BoolIfExists": {"aws:MultiFactorAuthPresent": "false"}
    }
}

Pour plus d'informations, consultez Identity and Access Management pour Amazon GameLift Streams le chapitre sur la sécurité et consultez la section Résolution des messages d'erreur liés au refus d'accès dans le guide de l'utilisateur IAM.

Exécutez votre application sur un autre ordinateur pour vérifier qu'elle est correctement empaquetée. Cela confirme que le contenu de votre application ne contient aucun chemin codé en dur, aucun élément manquant, aucune bibliothèque ou aucun fichier binaire susceptible de ne pas fonctionner sur d'autres appareils.

Vérifiez que votre application est compatible avec Proton. Testez votre application dans un environnement local sans le serveur Amazon GameLift Streams pour vérifier qu'elle est compatible avec Proton. Pour obtenir des instructions, veuillez consulter Test et résolution des problèmes de compatibilité avec Proton pour Amazon GameLift Streams.

Vérifiez le temps d'exécution. Dans la configuration de l'application Amazon GameLift Streams, vérifiez que le fichier que vous avez spécifié dans le chemin de lancement du fichier exécutable est un fichier ou un script exécutable et qu'il est adapté à l'environnement d'exécution que vous avez sélectionné. Les applications Windows doivent avoir un type de fichier « .exe », « .bat » ou « .cmd » et cibler les environnements d'exécution Windows ou Proton. Les applications Linux natives doivent être des fichiers exécutables qui ciblent le runtime Ubuntu 22.04 LTS.

Vérification requise DLLs. Votre application Windows est peut-être manquante DLLs. Par exemple, si votre application est une version de débogage, elle nécessite la version de débogage des bibliothèques d'exécution Microsoft C et C++ (MSVC). Pour résoudre ce problème, nous vous recommandons d'empaqueter votre build et DLLs side-by-side. Pour obtenir des instructions, reportez-vous à la section Préparation d'une machine de test pour exécuter un exécutable de débogage de Microsoft.

Utilisez le bon fichier exécutable. Pour que votre application fonctionne correctement avec Amazon GameLift Streams, définissez le chemin de l'application vers le fichier exécutable complet situé dans le sous-dossier Binaries/Win64/ (ou un sous-dossier similaire). Unreal Engine produit deux exécutables : un petit exécutable bootstrap à la racine du dossier et un exécutable cible de plate-forme dans le sous-dossier. Binaries/Win64/ L'exécutable bootstrap à la racine tente de valider les conditions préalables correctement et peut créer des faux positifs sur Amazon GameLift Streams qui empêchent le lancement de l'application. Si le fichier exécutable cible de la plate-forme est absent, l'application n'a peut-être pas été créée correctement. Par exemple, consultez la structure de dossiers suivante d'un exemple d'application Unreal :

BuildApp
|-> MyUnrealApp.exe
|-> MyUnrealApp
            |-> Binaries
                    |-> Win64
                            |-> MyUnrealApp.exe 

Désactivez Unreal Engine Asserts. Désactivez check les ensure macrosverify, et. Ils peuvent empêcher l'application de créer des crash dumps. Pour plus d'informations, consultez la documentation Asserts in Unreal Engine.

Votre machine est peut-être dotée d'un matériel plus puissant qu'Amazon GameLift Streams. Assurez-vous de tester l'application sur une machine dont les performances sont similaires à celles du matériel utilisé par Amazon GameLift Streams :

Cela permet de vérifier que les paramètres de rendu de votre application sont compatibles avec le GPU et que les performances répondent à vos attentes.

Le problème peut être dû à votre connexion réseau ou aux paramètres d'Amazon GameLift Streams. Suivez les conseils de résolution des problèmes présentés dans la Problèmes de connectivité au streaming section.

Pour les jeux Unreal Engine, reportez-vous à. Profilage des performances d'Unreal Engine

Mise en cache basée sur le pilote : cette approche est spécifique à la version du GPU et du pilote de l'environnement d'exécution. Cette option peut être appliquée à toutes les applications et constitue donc l'approche recommandée par défaut. Les étapes de cette approche devront être reproduites pour chaque GPU/driver combinaison.

Mise en cache basée sur le moteur : cette approche permet la mise en cache des shaders via le moteur de jeu, si disponible. Cela impose au développeur la charge de créer un cache d'objets d'état de pipeline (PSO) préconfiguré. Cela suppose également que le moteur est capable de gérer la prise en charge du cache pour différents pilotes sur le même matériel GPU.

Choisissez le plus proche Région AWS possible de l'utilisateur final. La latence élevée entre vos clients et la région hébergeant votre diffusion peut avoir un impact sur la qualité de la diffusion. Reportez-vous à Régions AWS et sites distants pris en charge par Amazon GameLift Streams pour obtenir une liste des emplacements à partir desquels vous pouvez diffuser. Vous pouvez envoyer un ping aux points de terminaison de AWS console de la région pour obtenir une mesure approximative de la latence.

Vérifiez que votre groupe de flux a la capacité d'accueillir de nouveaux flux.

Vérifiez qu'il ConnectionTimeoutSeconds est raisonnablement configuré pour laisser aux utilisateurs finaux suffisamment de temps pour se connecter avant l'expiration de leur client Web.

Assurez-vous que les pare-feux autorisent l'accès à la plage de ports UDP 33435-33465 pour autoriser le streaming depuis Amazon Streams. GameLift Si Amazon GameLift Streams ne parvient pas à accéder à ces ports, cela peut entraîner des problèmes de streaming, tels qu'un écran noir ou gris.

Vérifiez que votre connexion Internet peut maintenir une vitesse de connexion d'au moins 10 Mbits/s pour un flux 1080p. Si vous détectez des problèmes de réseau alors que vous jouez sur Amazon GameLift Streams, il est possible que votre débit Internet fluctue et que vous n'obteniez peut-être pas au moins 10 Mbits/s de manière régulière. Effectuez un test de vitesse Internet et poursuivez les étapes de résolution des problèmes.

Utilisez un réseau filaire si possible. Lorsque vous utilisez le Wi-Fi, rapprochez votre appareil de votre routeur pour augmenter la puissance du signal.

Si vous utilisez un routeur Wi-Fi doté à la fois de GHz bandes 2,4 GHz et 5, essayez de vous connecter à une autre bande. Si vous ne savez pas comment faire passer votre routeur à une autre bande, consultez les pages d'assistance du fabricant ou du fournisseur de votre routeur Wi-Fi. Vous pouvez également contacter leur service client.

Identifiez si d'autres utilisateurs du même réseau (en particulier lorsqu'ils utilisent un réseau Wi-Fi domestique) exécutent des applications à bande passante élevée, telles que le streaming vidéo, le téléchargement, les jeux en ligne ou les sauvegardes.

Fermez les autres applications de votre appareil qui consomment de la bande passante.

N'utilisez pas de VPN ou de proxy pendant le streaming. Ils peuvent entraîner des temps de latence plus élevés et avoir un impact sur le gameplay.

Vérifiez que vous utilisez le Wi-Fi plutôt que les réseaux cellulaires lorsque vous jouez sur un iPad ou un iPhone. L'utilisation d'un réseau cellulaire peut entraîner des problèmes de connectivité.

Les utilisateurs de macOS doivent désactiver les services de localisation, car cela provoquera une pause du Wi-Fi de temps en temps, ce qui nuira à l'expérience de streaming.

Vérifiez si le problème est spécifique au navigateur. Dans l'ensemble, nous recommandons Google Chrome, Microsoft Edge ou une application de bureau personnalisée basée sur Chromium pour une expérience utilisateur optimale et une compatibilité maximale, en particulier avec les manettes de jeu.

Enregistrez les événements d'entrée envoyés par le client et reçus par l'application pour identifier les incohérences d'entrée dans votre code frontal.

Assurez-vous de consulter des informations supplémentaires sur Navigateurs et saisie pris en charge les navigateurs et les périphériques de saisie pris en charge, y compris les problèmes et limitations connus.

Problème : La touche Commande de macOS correspond à l'événement Meta key, qui correspond à la touche Windows de Microsoft Windows. Le problème provient d'un bogue affectant les navigateurs macOS lorsque l'on appuie simultanément sur Commande et sur une autre touche. La touche méta est réinitialisée lorsqu'elle est relâchée, mais la touche flèche n'est pas réinitialisée car le navigateur n'a pas capturé d'événement de saisie pour la touche flèche. Le client du SDK Web n'envoie donc pas d'événement de retouche au serveur et l'application de streaming pensera toujours que la touche est enfoncée.

Solution : Si vous n'utilisez pas la touche Commande, vous pouvez la filtrer à l'aide du mécanisme de filtrage du clavier du SDK Web (keyboardFilter) disponible dans l'interface du InputConfiguration SDK Web.

Problème : Amazon GameLift Streams utilise une heuristique pour déterminer s'il convient de transmettre les événements relatifs à la souris en mode « relatif » ou « absolu ». En mode relatif, les nouvelles mises à jour de la souris sont fournies sous forme de petites différences incrémentielles par rapport à la mise à jour précédente. En mode absolu, le curseur de la souris est continuellement amené à une position d'écran synchronisée avec le client. Lorsque le curseur du système d'exploitation est visible au-dessus du contenu diffusé, l'heuristique sélectionne toujours les coordonnées absolues. Cela peut entraîner des deltas de mouvement étonnamment importants si votre application attend de petites mises à jour relatives.

Solution : si votre application prévoit un mouvement relatif de la souris (par exemple, des commandes de caméra de type FPS ou des interactions basées sur le glisser-déplacer), masquez le curseur du système d'exploitation lors des interactions avec la souris. Par exemple, masquez le curseur lorsque vous passez la souris vers le bas et affichez-le à nouveau en haut de la souris. Cela garantit que les mouvements de déplacement utilisent des coordonnées relatives, la position absolue étant synchronisée uniquement lorsque le bouton est relâché.

L'application est bloquée ou se bloque. Reportez-vous à la Problèmes liés à l'application section pour les instructions de dépannage.

Le statut du groupe de flux ne l'est pasActive. Vérifiez l'état du groupe de flux.

La capacité à la demande met plus de temps à s'activer que le délai d'expiration spécifié ConnectionTimeoutSeconds dans l'StartStreamSessionAPI. Sur le moteur d'exécution Windows, le temps de démarrage à la demande peut prendre 5 minutes ou plus.

Aucune capacité disponible sur le site de diffusion. Vérifiez que la capacité allouée est supérieure à votre capacité en cours d'utilisation ou que vous disposez d'une capacité à la demande qui n'est pas utilisée (la capacité allouée est inférieure à la capacité permanente plus la capacité à la demande). Dans la console, vous pouvez trouver ces valeurs dans la liste des groupes de flux ou sur la page détaillée des groupes de flux. À l'aide de l'API de service, vous pouvez trouver ces valeurs en utilisant GetStreamGroup. Voici quelques scénarios dans lesquels la capacité disponible est temporairement nulle :

Les conditions du réseau sont si mauvaises que les trames, en particulier la première, ne sont pas envoyées. Vérifiez l'état du réseau entre le client et le lieu de diffusion, puis ajustez ou essayez un autre emplacement.

Délai de placement : valeur du délai d'attente permettant à Amazon GameLift Streams de trouver les ressources de calcul nécessaires pour héberger une session de streaming.

Délai de connexion : valeur du délai d'attente pour qu'un client se connecte ou se reconnecte à une session de streaming.

Délai d'inactivité : durée maximale pendant laquelle une session de streaming peut être inactive sans intervention de l'utilisateur.

Délai d'expiration de la session : durée maximale d'une session de diffusion.