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 6 de outubro de 2026