Problembehebung bei Amazon GameLift Streams

Wenn die IAM-Rolle eine explizite „Deny-All“ -Richtlinie hat, müssen Sie Amazon GameLift Streams explizit als Ausnahme von dieser Richtlinie auflisten, indem Sie das Element "gameliftstreams:*" hinzufügen. NotAction Beispiel:

{
    "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"}
    }
}

Weitere Informationen finden Sie Identity and Access Management für Amazon GameLift Streams im Kapitel Sicherheit und im IAM-Benutzerhandbuch unter Behebung von Fehlermeldungen mit Zugriffsverweigerung.

Führen Sie Ihre Anwendung auf einem anderen Computer aus, um zu überprüfen, ob sie korrekt verpackt ist. Dadurch wird bestätigt, dass Ihr Anwendungsinhalt keine fest codierten Pfade, fehlenden Ressourcen, Bibliotheken oder Binärdateien enthält, die auf anderen Geräten möglicherweise nicht funktionieren.

Stellen Sie sicher, dass Ihre Anwendung mit Proton kompatibel ist. Testen Sie Ihre Anwendung in einer lokalen Umgebung ohne den Amazon GameLift Streams-Server, um sicherzustellen, dass sie mit Proton kompatibel ist. Detaillierte Anweisungen finden Sie unter Kompatibilität mit Proton für Amazon GameLift Streams testen und beheben.

Überprüfen Sie die Laufzeit. Vergewissern Sie sich in der Amazon GameLift Streams-Anwendungskonfiguration, dass die Datei, die Sie im Startpfad der ausführbaren Datei angegeben haben, eine ausführbare Datei oder ein ausführbares Skript ist und für die von Ihnen ausgewählte Laufzeitumgebung geeignet ist. Windows-Anwendungen sollten den Dateityp „.exe“, „.bat“ oder „.cmd“ haben und entweder auf die Windows- oder Proton-Laufzeiten abzielen. Native Linux-Anwendungen sollten ausführbare Dateien sein, die auf die Ubuntu 22.04 LTS-Laufzeit abzielen.

Überprüfen Sie die erforderlichen DLLs. In Ihrer Windows-Anwendung fehlen möglicherweise die erforderlichen DLLs. Wenn es sich bei Ihrer Anwendung beispielsweise um einen Debug-Build handelt, benötigt sie die Debug-Version der Microsoft C- und C++-Laufzeitbibliotheken (MSVC). Um dieses Problem zu lösen, empfehlen wir, dass Sie Ihren Build und Ihre DLLs Seite an Seite packen. Anweisungen finden Sie unter Vorbereiten eines Testcomputers für die Ausführung einer ausführbaren Debug-Datei von Microsoft.

Verwenden Sie die richtige ausführbare Datei. Damit Ihre Anwendung ordnungsgemäß mit Amazon GameLift Streams funktioniert, legen Sie den Anwendungspfad auf die vollständige ausführbare Datei fest, die sich im Binaries/Win64/ (oder einem ähnlichen) Unterordner befindet. Unreal Engine erzeugt zwei ausführbare Dateien: eine kleine Bootstrap-Datei im Stammverzeichnis des Ordners und eine ausführbare Plattform-Zieldatei im Unterordner. Binaries/Win64/ Die Bootstrap-Programmdatei im Stammverzeichnis versucht zu überprüfen, ob die Vorbedingungen korrekt sind, und kann in Amazon GameLift Streams zu Fehlalarmen führen, die den Anwendungsstart verhindern. Wenn die ausführbare Datei für das Plattformziel fehlt, wurde die Anwendung möglicherweise nicht korrekt erstellt. Sehen Sie sich zum Beispiel die folgende Ordnerstruktur einer Unreal-Beispielanwendung an:

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

Schalten Sie Unreal Engine Asserts aus. Deaktivieren Sie die check Makrosverify, undensure. Sie können verhindern, dass die Anwendung Crash-Dumps erstellt. Weitere Informationen finden Sie in der Dokumentation zu Asserts in Unreal Engine.

Ihr Computer verfügt möglicherweise über eine leistungsstärkere Hardware als Amazon GameLift Streams. Stellen Sie sicher, dass Sie die Anwendung auf einem Computer mit ähnlicher Leistung wie die von Amazon GameLift Streams verwendete Hardware testen:

Dadurch wird überprüft, ob die Rendering-Einstellungen Ihrer Anwendung mit der GPU kompatibel sind und ob die Leistung Ihren Erwartungen entspricht.

Das Problem könnte an Ihrer Netzwerkverbindung oder den Einstellungen von Amazon GameLift Streams liegen. Probieren Sie die Tipps zur Fehlerbehebung im Probleme mit der Stream-Konnektivität Abschnitt aus.

Unreal Engine-Spiele finden Sie unter. Profilierung der Leistung von Unreal Engine

Driver-based Caching — Dieser Ansatz ist spezifisch für die GPU- und Treiberversion der Laufzeitumgebung. Diese Option kann auf alle Anwendungen angewendet werden und ist daher der empfohlene Standardansatz. Die Schritte für diesen Ansatz müssen für jede GPU/driver Kombination repliziert werden.

Engine-based Caching — Dieser Ansatz ermöglicht das Shader-Caching über die Game-Engine, sofern verfügbar. Dadurch wird der Entwickler mit der Erstellung eines vorgefertigten Pipeline-State-Object-Caches (PSO) betraut. Außerdem wird davon ausgegangen, dass die Engine in der Lage ist, die Cache-Unterstützung für verschiedene Treiber auf derselben GPU-Hardware zu verarbeiten.

Wählen Sie eine Lösung, AWS-Region die dem Endbenutzer am nächsten kommt. Eine hohe Latenz zwischen Ihren Kunden und der Region, in der Ihr Stream gehostet wird, kann sich auf die Stream-Qualität auswirken. Eine Liste der Standorte, AWS-Regionen und Streaming-Standorte, die von Amazon GameLift Streams unterstützt werden von denen aus Sie streamen können, finden Sie unter. Sie können AWS Konsolenendpunkte in der Region anpingen, um eine ungefähre Latenzmessung zu erhalten.

Stellen Sie sicher, dass Ihre Stream-Gruppe Kapazität für neue Streams hat.

Stellen Sie sicher, dass diese Einstellung angemessen ConnectionTimeoutSeconds ist, sodass Endbenutzer genügend Zeit haben, eine Verbindung herzustellen, bevor ihr Webclient das Timeout erreicht.

Stellen Sie sicher, dass Firewalls den Zugriff auf den UDP-Portbereich 33435-33465 zulassen, um Streaming von Amazon Streams zu ermöglichen. GameLift Wenn Amazon GameLift Streams diese Ports nicht erreichen kann, kann dies zu Streaming-Problemen führen, z. B. zu einem schwarzen oder grauen Bildschirm.

Stellen Sie sicher, dass Ihre Internetverbindung eine Verbindungsgeschwindigkeit von mindestens 10 Mbit/s für einen 1080p-Stream aufrechterhalten kann. Wenn Sie beim Abspielen auf Amazon GameLift Streams Netzwerkprobleme feststellen, schwankt Ihre Internetgeschwindigkeit möglicherweise und Sie erhalten möglicherweise nicht durchgehend mindestens 10 Mbit/s. Führen Sie einen Internet-Geschwindigkeitstest durch und fahren Sie mit den Schritten zur Fehlerbehebung fort.

Verwenden Sie nach Möglichkeit ein verkabeltes Netzwerk. Stellen Sie Ihr Gerät bei der Verwendung Wi-Fi in die Nähe Ihres Routers, um eine stärkere Signalstärke zu erzielen.

Wenn Sie einen Wi-Fi Router sowohl mit dem 2,4-GHz- als auch mit dem 5-GHz-Band verwenden, versuchen Sie, eine Verbindung zu einem anderen Band herzustellen. Wenn Sie sich nicht sicher sind, wie Sie Ihren Router auf ein anderes Band umstellen sollen, besuchen Sie die Support-Seiten des Herstellers oder Anbieters Ihres Wi-Fi Routers. Sie können sich auch an den Kundendienst wenden.

Stellen Sie fest, ob andere Benutzer im selben Netzwerk (insbesondere zu Hause Wi-Fi) Anwendungen mit hoher Bandbreite wie Videostreaming, Herunterladen, Online-Spiele oder Backups ausführen.

Schließen Sie andere Anwendungen auf Ihrem Gerät, die Bandbreite beanspruchen.

Verwenden Sie beim Streamen kein VPN oder Proxy. Sie können zu höheren Latenzen führen und das Gameplay beeinträchtigen.

Vergewissere dich, dass du Wi-Fi statt Mobilfunknetze verwendest, wenn du auf einem iPad oder iPhone spielst. Die Verwendung eines Mobilfunknetzes kann zu Verbindungsproblemen führen.

MacOS-Benutzer sollten die Ortungsdienste deaktivieren, da sie Wi-Fi dadurch von Zeit zu Zeit unterbrochen werden, was zu einem schlechten Streaming-Erlebnis führen kann.

Testen Sie, ob das Problem browserspezifisch ist. Insgesamt empfehlen wir Google Chrome, Microsoft Edge oder eine benutzerdefinierte Chromium-based Desktop-Anwendung für das beste Endbenutzererlebnis und maximale Kompatibilität, insbesondere mit Gamecontrollern.

Protokollieren Sie Eingabeereignisse, die vom Client gesendet und von der Anwendung empfangen wurden, um festzustellen, wo ein Eingabefehler in Ihrem Frontend-Code vorliegt.

Suchen Sie unbedingt Unterstützte Browser und Eingaben nach zusätzlichen Informationen zu unterstützten Browsern und Eingabegeräten, einschließlich bekannter Probleme und Einschränkungen.

Problem: Die Befehlstaste auf macOS ist dem Metatasten-Ereignis zugeordnet, das der Windows-Taste unter Microsoft Windows zugeordnet ist. Das Problem ist ein Fehler, der sich auf macOS-Browser auswirkt, wenn Command und eine andere Taste gleichzeitig gedrückt werden. Dabei wird die Metataste zurückgesetzt, wenn sie losgelassen wird, aber die Pfeiltaste nicht zurückgesetzt, weil der Browser kein Keyup-Ereignis für die Pfeiltaste erfasst hat, sodass der Web SDK-Client kein Keyup-Ereignis an den Server sendet und die Streaming-Anwendung immer noch denkt, dass die Taste gedrückt wird.

Lösung: Wenn Sie die Befehlstaste nicht verwenden, können Sie sie mithilfe des Web-SDK-Tastaturfiltermechanismus (keyboardFilter) herausfiltern, der sich in der InputConfiguration Benutzeroberfläche des Web SDK befindet.

Problem: Wenn Sie bestimmte Elemente der OS-level Benutzeroberfläche öffnen (z. B. Browser-Menüleisten auf dem Desktop oder Control Center und Notification Center auf iOS), beendet der Browser die Auslösung von Eingabeereignissen, ohne dass Unschärfe- oder Fokusereignisse ausgelöst werden. Dies führt dazu, dass der Server weiterhin den letzten Eingabestatus empfängt. Dies ist eine Einschränkung auf Browserebene, die nicht zuverlässig erkannt werden kann.

Lösung: Verwenden Sie den Vollbildmodus in Desktop-Browsern, um den Zugriff auf die Browser-Menüleisten zu verhindern. Für iOS-Benutzer mit angeschlossenen Tastaturen empfehlen wir, einen nativen App-Wrapper mit einer Webansicht zu erstellen, in der die native App Fokusverlust besser erkennen und behandeln kann, wodurch explizit Fokus- und Unschärfeereignisse im Browserfenster ausgelöst werden. Verwenden Sie alternativ Frontend-HTML oder Elemente der Benutzeroberfläche im Spiel, um Benutzer darüber zu informieren, dass immer noch eine Taste gedrückt ist, und um Informationen zu dieser iOS-Einschränkung bereitzustellen.

Problem: Amazon GameLift Streams verwendet eine Heuristik, um auszuwählen, ob Mausereignisse im „relativen“ oder „absoluten“ Modus übertragen werden sollen. Im relativen Modus werden neue Maus-Updates als kleine, inkrementelle Unterschiede zum vorherigen Update bereitgestellt. Im absoluten Modus wird der Mauszeiger kontinuierlich an eine Bildschirmposition gedrückt, die mit dem Client synchronisiert ist. Wenn der Betriebssystem-Cursor über dem gestreamten Inhalt sichtbar ist, wählt die Heuristik immer absolute Koordinaten aus. Dies kann zu unerwartet großen Bewegungsdeltas führen, wenn Ihre Anwendung kleine, relative Aktualisierungen erwartet.

Lösung: Wenn Ihre Anwendung relative Mausbewegungen erwartet (z. B. FPS-style Kamerasteuerung oder Interaktionen durch Ziehen), blenden Sie den Betriebssystem-Cursor bei Mausinteraktionen aus. Sie können den Cursor beispielsweise bei gedrückter Maus ausblenden und bei gedrückter Maus wieder einblenden. Dadurch wird sichergestellt, dass beim Ziehen relative Koordinaten verwendet werden und die absolute Position nur synchronisiert wird, wenn die Taste losgelassen wird.

Die Anwendung hängt oder ist abgestürzt. Anweisungen zur Fehlerbehebung finden Sie Probleme mit der Anwendung im Abschnitt.

Der Status der Stream-Gruppe ist nichtActive. Überprüfen Sie den Status der Stream-Gruppe.

On-demand Das Hochfahren der Kapazität dauert länger als das ConnectionTimeoutSeconds in der StartStreamSessionAPI angegebene Timeout. In der Windows-Runtime kann die On-Demand-Hochlaufzeit 5 Minuten oder länger dauern.

Am Streaming-Standort ist keine Kapazität verfügbar. Stellen Sie sicher, dass Ihre zugewiesene Kapazität größer ist als Ihre genutzte Kapazität oder ob Sie über On-Demand-Kapazität verfügen, die nicht genutzt wird (die zugewiesene Kapazität ist geringer als die ständig verfügbare Kapazität plus On-Demand-Kapazität). In der Konsole finden Sie diese Werte in der Liste der Stream-Gruppen oder auf der Detailseite der Stream-Gruppe. Mithilfe der Service-API finden Sie diese Werte unter GetStreamGroup. Zu den Szenarien, in denen die verfügbare Kapazität vorübergehend bei Null liegt, gehören die folgenden:

Die Netzwerkbedingungen sind so schlecht, dass Frames, insbesondere der erste Frame, nicht gesendet werden. Überprüfen Sie die Netzwerkbedingungen zwischen dem Client und dem Streaming-Standort und passen Sie einen anderen Standort an oder versuchen Sie es mit einem anderen.

Platzierungs-Timeout: Timeout-Wert für Amazon GameLift Streams, um Rechenressourcen für das Hosten einer Stream-Sitzung zu finden.

Verbindungs-Timeout: Timeout-Wert für einen Client, um sich mit einer Stream-Sitzung zu verbinden oder erneut zu verbinden.

Timeout im Leerlauf: Maximale Zeit, während der eine Stream-Sitzung ohne Benutzereingabe inaktiv sein kann.

Timeout für die Sitzungslänge: Maximale Zeit für eine Stream-Sitzung.

Stellen Sie sicher, dass die muted Eigenschaft des Video- oder Audioelements auf eingestellt istfalse.

Stellen Sie sicher, dass die Lautstärke des Medienelements nicht auf eingestellt ist0.

Überprüfen Sie die Autoplay-Richtlinie Ihres Browsers. Viele Browser erfordern eine Benutzerinteraktion, z. B. einen Klick, bevor sie die Medienwiedergabe ohne Stummschaltung ermöglichen.

Wenn Sie einen Rückruf benötigen, wenn die Sitzung verbunden ist, verwenden Sie clientConnection.connectionState in dem Objekt. GameLiftStreams Dies bietet einen Rückruf für den Fall, dass die Peer-Verbindung in einen verbundenen Zustand übergeht.