Pular para o conteúdo principal
Este tópico aborda as considerações especiais necessárias para lidar com os modos de exibição de janela no PC e exibir com êxito as caixas de diálogo de UI chamável pelo título (TCUI). Verifique se a janela do jogo está visível antes de invocar qualquer API que possa exibir a TCUI. Além disso, a janela do jogo deve usar o modo Janela em Tela Inteira/Sem Bordas ou Em Janela/Não Maximizada, em vez de Tela Inteira Exclusiva. Os jogos devem ser executados na resolução nativa da tela, em vez de uma resolução personalizada do aplicativo/jogo. Algumas tecnologias (como DirectX 9) não lidam bem com a mudança de resolução quando a caixa de diálogo da TCUI é exibida. Além disso, alguns mecanismos e wrappers de middleware, bem como o DirectX 9, minimizam automaticamente uma janela de jogo em tela inteira quando o foco em primeiro plano é perdido para a caixa de diálogo da TCUI. Para contornar esse comportamento indesejável para os jogadores, a plataforma nega explicitamente a minimização da janela ao exibir caixas de diálogo da TCUI. Para obter mais detalhes, consulte a seção Impedir a minimização da janela do jogo mais adiante neste tópico. Para títulos de jogos que usam tecnologias gráficas que não são DirectX, nossas práticas recomendadas variam, conforme mostrado a seguir. Se o título do jogo usar OpenGL ou Vulkan, será necessário um modo “em janela” que mostre uma borda de janela pertencente à área de trabalho para permitir que as caixas de diálogo da TCUI sejam renderizadas sobre o jogo. Isso ocorre porque, dependendo da implementação do driver da placa de vídeo, um jogo executado em qualquer tipo de modo de tela inteira pode ser renderizado sem o envolvimento do Gerenciador de Janelas da Área de Trabalho. Isso impede que a caixa de diálogo da TCUI seja exibida sobre a janela do jogo. Para outras tecnologias gráficas, entre em contato com seu representante de suporte do XBOX.

​
Impedir a minimização da janela do jogo

Alguns mecanismos de middleware e sistemas de camadas (por exemplo, Unity e Simple DirectMedia Layer (SDL)) minimizam automaticamente a janela de tela inteira do jogo quando o foco em primeiro plano é perdido para a caixa de diálogo da TCUI. Para impedir esse comportamento, o Gaming Runtime usa CBTProc para negar quaisquer solicitações de minimização da janela do jogo. O Gaming Runtime só aplica esse padrão quando detecta que as sobreposições podem ser renderizadas sobre a janela de jogo DirectX em tela inteira e que a caixa de diálogo da TCUI está visível. Além disso, o Gaming Runtime intercepta e modifica quaisquer mensagens de janela de alteração de estilo antes de exibir as caixas de diálogo da TCUI, para impedir que a janela do jogo renderize uma borda ou uma barra de título. Os estilos do grupo WS_OVERLAPPEDWINDOW não são aplicados em uma alteração de estilo, a menos que já existissem no estilo antigo. Essa modificação só é implementada durante o tempo de vida da caixa de diálogo da TCUI.

​
Considerações sobre o DirectX 9 com caixas de diálogo da TCUI

Embora o Gaming Runtime impeça que jogos DirectX 9 sejam minimizados, conforme descrito em Impedir a minimização da janela do jogo (anteriormente neste tópico), eles ainda perdem o foco em primeiro plano quando uma caixa de diálogo da TCUI é exibida. Seu jogo deve lidar com essa perda de foco de forma adequada, exatamente da mesma maneira que responderia a um jogador minimizando a janela do jogo durante a execução em tela inteira.

​
Considerações sobre o Unity com caixas de diálogo da TCUI

Defina Application.runInBackground como true para qualquer jogo que pretenda exibir uma caixa de diálogo da TCUI.
Última modificação em 20 de outubro de 2026