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.

Verificação necessária DLLs. Seu aplicativo do Windows pode não ser necessário DLLs. 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 DLLs side-by-side e. 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

Cache baseado em driver — Essa abordagem é específica para a GPU do ambiente de tempo de execução e para a versão do driver. 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.

Cache baseado em mecanismo — 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 de objeto de estado de pipeline (PSO) pré-preparado no 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 remotos 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, a velocidade da sua 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 o Wi-Fi, aproxime o dispositivo do roteador para obter uma intensidade de sinal mais forte.

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

Identifique se outras pessoas na mesma rede (especialmente quando estão usando Wi-Fi doméstico) estão executando aplicativos de alta largura de banda, como streaming de vídeo, download, jogos online 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 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 o Wi-Fi seja pausado 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 desktop personalizado baseado no Chromium 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: 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 câmera no estilo FPS ou interações baseadas em arrasto), oculte o cursor do sistema operacional durante as interações do 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.

A capacidade sob demanda está demorando mais para ser ativada 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.