Solução de problemas do Amazon GameLift Streams

Se a função do IAM tiver uma política explícita de “negar tudo”, você deve listar explicitamente o GameLift Amazon Streams como uma exceção a essa política adicionando "gameliftstreams:*" ao elemento. NotAction Por exemplo:

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

Para obter mais informações, consulte o Identity and Access Management para Amazon GameLift Streams capítulo Segurança e consulte Solução de problemas de mensagens de erro de acesso negado no Guia do usuário do IAM.

Execute seu aplicativo em uma máquina diferente para verificar se ele está empacotado corretamente. Isso confirma que o conteúdo do seu aplicativo não contém caminhos codificados, ativos ausentes, bibliotecas ou binários que podem não funcionar em outros dispositivos.

Verifique se seu aplicativo é compatível com o Proton. Teste seu aplicativo em um ambiente local sem o servidor Amazon GameLift Streams para verificar se ele é compatível com o Proton. Para instruções, consulte Teste e solução de problemas de compatibilidade com o Proton para Amazon Streams GameLift.

Verifique o tempo de execução. Na configuração do aplicativo Amazon GameLift Streams, confirme se o arquivo que você especificou no caminho de execução do executável é um arquivo executável ou script e está correto para o ambiente de execução que você selecionou. Os aplicativos do Windows devem ter um tipo de arquivo “.exe”, “.bat” ou “.cmd” e ter como alvo os tempos de execução do Windows ou do Proton. Os aplicativos Linux nativos devem ser arquivos executáveis direcionados ao tempo de execução do Ubuntu 22.04 LTS.

Verifique as DLLs necessárias. Seu aplicativo do Windows pode não ter as DLLs necessárias. Por exemplo, se seu aplicativo for uma compilação de depuração, ele precisará da versão de depuração das bibliotecas de tempo de execução Microsoft C e C++ (MSVC). Para resolver isso, recomendamos que você empacote sua compilação e DLLs lado a lado. Para obter instruções, consulte Preparar uma máquina de teste para executar um executável de depuração da Microsoft.

Use o executável correto. Para que seu aplicativo funcione corretamente com o Amazon GameLift Streams, defina o caminho do aplicativo para o executável completo que está localizado na subpasta Binaries/Win64/ (ou similar). O Unreal Engine produz dois executáveis: um pequeno executável de bootstrap na raiz da pasta e um executável de destino de plataforma na subpasta. Binaries/Win64/ O executável bootstrap na raiz tenta validar as pré-condições corretas e pode criar falsos positivos no Amazon GameLift Streams que impedem o lançamento do aplicativo. Se o executável de destino da plataforma estiver ausente, o aplicativo pode não ter sido criado corretamente. Por exemplo, veja a seguinte estrutura de pastas de um aplicativo Unreal de amostra:

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

Desative o Unreal Engine Asserts. Desative check as ensure macrosverify, e. Eles podem impedir que o aplicativo crie dumps de falhas. Para obter mais informações, consulte Asserts na documentação do Unreal Engine.

Sua máquina pode ter um hardware mais poderoso do que o Amazon GameLift Streams. Certifique-se de testar o aplicativo em uma máquina com desempenho semelhante ao hardware que o Amazon GameLift Streams usa:

Isso verifica se as configurações de renderização do seu aplicativo são compatíveis com a GPU e se o desempenho atende às suas expectativas.

O problema pode ser devido à sua conexão de rede ou às configurações do Amazon GameLift Streams. Experimente as dicas de solução de problemas na Problemas de conectividade de streaming seção.

Para jogos da Unreal Engine, consulte. Definindo o perfil do desempenho do Unreal Engine

Driver-based armazenamento em cache — Essa abordagem é específica para a versão da GPU e do driver do ambiente de execução. Essa opção pode ser aplicada a todos os aplicativos e, portanto, é a abordagem padrão recomendada. As etapas dessa abordagem precisarão ser replicadas para cada GPU/driver combinação.

Engine-based armazenamento em cache — Essa abordagem permite o armazenamento em cache de sombreamento por meio do mecanismo de jogo, se disponível. Isso coloca a responsabilidade de criar um cache pré-configurado de objetos de estado de pipeline (PSO) sobre o desenvolvedor. Também pressupõe que o mecanismo seja capaz de lidar com o suporte de cache para drivers diferentes no mesmo hardware de GPU.

Escolha o mais próximo Região da AWS possível do usuário final. A alta latência de seus clientes para a região que hospeda sua transmissão pode afetar a qualidade da transmissão. Consulte Regiões da AWS e locais de streaming suportados pelo Amazon GameLift Streams para obter uma lista de locais de onde você pode transmitir. Você pode executar ping nos endpoints do AWS console na região para obter uma medição aproximada da latência.

Verifique se seu grupo de streams tem capacidade para novos streams.

Verifique se ConnectionTimeoutSeconds está configurado de forma razoável para permitir que os usuários finais tenham tempo suficiente para se conectarem antes que o cliente web atinja o tempo limite.

Garanta que os firewalls permitam o acesso ao intervalo de portas UDP 33435-33465 para permitir o streaming do Amazon Streams. GameLift Se o Amazon GameLift Streams não conseguir acessar essas portas, isso poderá causar problemas de streaming, como uma tela preta ou cinza.

Verifique se sua conexão com a Internet pode sustentar uma velocidade de conexão de pelo menos 10 Mbps para um stream de 1080p. Se você detectar problemas de rede enquanto joga no Amazon GameLift Streams, sua velocidade de internet pode estar flutuando e você pode não estar recebendo pelo menos 10 Mbps de forma consistente. Execute um teste de velocidade da Internet e continue com as etapas de solução de problemas.

Use uma rede com fio, se possível. Ao usar Wi-Fi, mova o dispositivo para perto do roteador para aumentar a intensidade do sinal.

Se você estiver usando um Wi-Fi roteador com bandas de 2,4 GHz e 5 GHz, tente se conectar a uma banda diferente. Se você não tiver certeza de como mudar o roteador para uma banda diferente, visite as páginas de suporte do fabricante ou fornecedor do Wi-Fi roteador. Você também pode entrar em contato com o atendimento ao cliente.

Identifique se outras pessoas na mesma rede (especialmente quando estão em casa Wi-Fi) estão executando aplicativos de alta largura de banda, como streaming de vídeo, download, jogos on-line ou backups.

Feche outros aplicativos em seu dispositivo que ocupam largura de banda.

Não use VPN ou proxy durante a transmissão. Eles podem causar latências mais altas e afetar a jogabilidade.

Verifique se você está usando redes celulares Wi-Fi em vez de redes celulares ao jogar em um iPad ou iPhone. Usar uma rede celular pode resultar em problemas de conectividade.

Os usuários do macOS devem desativar os Serviços de Localização, pois isso fará com que Wi-Fi eles parem de tempos em tempos, o que resultará em uma experiência de streaming ruim.

Teste para ver se o problema é específico do navegador. No geral, recomendamos o Google Chrome, o Microsoft Edge ou um aplicativo de Chromium-based desktop personalizado para a melhor experiência do usuário final e máxima compatibilidade, especialmente com controladores de jogos.

Registre eventos de entrada enviados pelo cliente e recebidos pelo aplicativo para identificar onde há uma incompatibilidade de entrada em seu código de front-end.

Certifique-se de verificar se Navegadores e entradas compatíveis há informações adicionais sobre navegadores e dispositivos de entrada compatíveis, incluindo problemas e limitações conhecidos.

Problema: a tecla Command no macOS mapeia para o evento da chave Meta, que mapeia para a tecla Windows no Microsoft Windows. O problema é um bug que afeta os navegadores macOS quando o Command e outra tecla são pressionados simultaneamente, em que a tecla Meta é redefinida quando liberada, mas a tecla de seta não é redefinida porque o navegador não capturou um evento de tecla para a tecla de seta, então o cliente do Web SDK não enviará um evento de tecla para o servidor e o aplicativo de streaming ainda pensará que a tecla está sendo pressionada.

Solução: Se você não estiver usando a tecla Command, poderá filtrá-la usando o mecanismo de filtro de teclado do Web SDK (keyboardFilter) encontrado na interface do Web SDK. InputConfiguration

Problema: quando você abre determinados elementos da OS-level interface do usuário (como barras de menu do navegador no desktop ou Central de Controle e Central de Notificações no iOS), o navegador para de disparar eventos de entrada sem acionar eventos de desfoque ou foco. Isso faz com que o servidor continue recebendo o último estado de entrada. Essa é uma limitação no nível do navegador que não pode ser detectada de forma confiável.

Solução: use o modo de tela cheia em navegadores de desktop para impedir o acesso às barras de menu do navegador. Para usuários de iOS com teclados conectados, recomendamos criar um wrapper de aplicativo nativo com uma visualização na web em que o aplicativo nativo possa detectar e lidar melhor com a perda de foco, acionando explicitamente os eventos de foco e desfoque da janela do navegador. Como alternativa, use HTML de front-end ou elementos de interface do usuário do jogo para informar aos usuários que uma tecla ainda está pressionada e fornecer informações sobre essa limitação do iOS.

Problema: o Amazon GameLift Streams usa uma heurística para escolher se deseja transmitir eventos do mouse no modo “relativo” ou “absoluto”. No modo relativo, as novas atualizações do mouse são fornecidas como pequenas diferenças incrementais em relação à atualização anterior. No modo absoluto, o cursor do mouse é continuamente forçado para uma posição na tela que é sincronizada com o cliente. Quando o cursor do sistema operacional está visível sobre o conteúdo transmitido, a heurística sempre escolhe coordenadas absolutas. Isso pode causar deltas de movimento inesperadamente grandes se seu aplicativo estiver esperando atualizações pequenas e relativas.

Solução: Se seu aplicativo espera um movimento relativo do mouse (por exemplo, controles de FPS-style câmera ou interações baseadas em arrastar), oculte o cursor do sistema operacional durante as interações com o mouse. Por exemplo, esconda o cursor com o mouse para baixo e mostre-o novamente com o mouse para cima. Isso garante que os movimentos de arrasto usem coordenadas relativas, com a posição absoluta sincronizada somente quando o botão é solto.

O aplicativo está travado ou travado. Consulte a Problemas do aplicativo seção para obter instruções de solução de problemas.

O status do grupo de transmissão não éActive. Verifique o status do grupo de streams.

On-demand a capacidade está demorando mais para aumentar do que o tempo limite especificado ConnectionTimeoutSeconds na StartStreamSessionAPI. No tempo de execução do Windows, o tempo de inicialização sob demanda pode levar 5 minutos ou mais.

Não há capacidade disponível no local de streaming. Verifique se a capacidade alocada é maior do que a capacidade em uso ou se você tem capacidade sob demanda que não está em uso (a capacidade alocada é menor do que a capacidade sempre ativa mais a capacidade sob demanda). No console, você pode encontrar esses valores na lista de grupos de stream ou na página de detalhes do grupo de stream. Usando a API de serviço, você pode encontrar esses valores usando GetStreamGroup. Alguns cenários em que a capacidade disponível está temporariamente em zero incluem o seguinte:

As condições da rede são tão ruins que os quadros, especialmente o primeiro quadro, não estão sendo enviados. Verifique as condições da rede entre o cliente e o local de streaming e ajuste ou experimente um local diferente.

Tempo limite de posicionamento: valor de tempo limite para o Amazon GameLift Streams encontrar recursos computacionais para hospedar uma sessão de streaming.

Tempo limite de conexão: valor de tempo limite para um cliente se conectar ou se reconectar a uma sessão de streaming.

Tempo limite de inatividade: tempo máximo em que uma sessão de streaming pode ficar ociosa sem a intervenção do usuário.

Tempo limite da duração da sessão: tempo máximo para uma sessão de streaming.

Verifique se a muted propriedade do elemento de vídeo ou áudio está definida comofalse.

Certifique-se de que o volume no elemento de mídia não esteja definido como0.

Verifique a política de reprodução automática do seu navegador. Muitos navegadores exigem uma interação do usuário, como um clique, antes de permitirem a reprodução de mídia sem áudio.

Se você precisar de um retorno de chamada para quando a sessão estiver conectada, use clientConnection.connectionState no GameLiftStreams objeto. Isso fornece um retorno de chamada para quando a conexão entre pares faz a transição para um estado conectado.