Visão geral

O Painel Steam é uma parte da interface de usuário do Steam que pode se sobrepor à tela de qualquer jogo iniciado pelo Steam, permitindo acesso à lista de amigos, navegador web, conversa e aquisição de conteúdo adicional sem sair do jogo.

O atalho padrão para acessar o painel é SHIFT+TAB, que pode ser alterado por meio do menu Steam->Configurações/Preferências.

Requisitos

O seu jogo não precisa fazer nada de especial para o Painel Steam funcionar; ele é aplicado a qualquer jogo iniciado pelo Steam! Durante o desenvolvimento e ao executar o jogo por meio de um depurador, o painel é carregado ao chamar a função SteamAPI_Init. Dessa forma, não se esqueça de chamar a função SteamAPI_Init antes de inicializar o dispositivo OpenGL/D3D, caso contrário o painel não conseguirá se vincular à criação de dispositivo.

O painel é compatível com jogos que usam DirectX 7 a 12, OpenGL, Metal e Vulkan. O painel não estará ativo em jogos renderizados por software.

macOS: a compatibilidade do painel com a versão 10.15 (Catalina) requer a adição de direitos à configuração da versão. Detalhes estão disponíveis na documentação sobre plataformas.

Ativação do painel pelo aplicativo

Há um conjunto de funções na API do Steamworks que permitem ativar o Painel Steam pelo jogo.

• ISteamFriends::ActivateGameOverlay
  Abre o painel no jogo com a janela especificada aberta;
  
• ISteamFriends::ActivateGameOverlayToUser
  Abre o painel no jogo com a janela especificada aberta, com o usuário passado como contexto;
  
• ISteamFriends::ActivateGameOverlayToWebPage
  Carrega o URL especificado no navegador do Painel Steam. O URL deve estar completo, ex.: http://www.steamgames.com/;
  
• ISteamFriends::ActivateGameOverlayToStore
  Abre o painel no jogo para a compra de conteúdo adicional para o jogo atual (consulte Conteúdo adicional (DLC) para mais informações);
  
• ISteamUtils::SetOverlayNotificationPosition
  Define em qual canto da tela exibir notificações. O canto padrão é o canto inferior direito;
  
• ISteamUtils::IsOverlayEnabled
  Retorna true se o painel estiver em execução e o usuário puder acessá-lo. O processo do painel pode levar alguns minutos para ser iniciado e se vincular ao processo do jogo, então essa função retornará false enquanto o painel estiver sendo carregado.

Comunicação do painel com o jogo

Os sinais (retornos de chamada) a seguir são disparados do Steam ao jogo com base na ação do usuário no painel:

• GameOverlayActivated_t
  Disparado quando o painel é ativado ou desativado. O jogo pode usá-lo para pausar ou retomar jogos para um jogador;
  
• GameServerChangeRequested_t
  Disparado quando o usuário seleciona o jogo de um amigo para entrar; conterá detalhes do servidor no qual entrar.
  
• GameLobbyJoinRequested_t
  Disparado quando o usuário seleciona o jogo de um amigo para entrar; conterá detalhes da sala na qual entrar.

Perguntas frequentes

AVISO: há mais respostas disponíveis em tópicos do Suporte Steam, como: Painel da Comunidade Steam.

Por que o Painel Steam está fazendo o aplicativo travar?

O Painel Steam é usado em milhares de jogos, portanto ele já foi testado de forma extensa e raramente causa travamentos. Contudo, devido à forma em que é injetado ao jogo, ele costuma expor vazamentos de memória ou corrupção de memória no uso da sua API de renderização que não impactavam a jogabilidade.

Para diagnosticar travamentos do painel com DirectX, por exemplo, tente determinar como o D3D alcançou um estado de erro usando o depurador de tempo de execução do d3d com todos os níveis de relatório (info/warning/error/notice) ativados. O depurador pode indicar recursos d3d órfãos. Se não encontrar nada dessa forma, pode haver um problema de corrupção de memória mais generalizado. Se o travamento sempre ocorrer no encerramento, possivelmente, é um problema com a ordem de encerramentos impedindo que o jogo seja encerrado corretamente.

Caso o aplicativo continue travando com o painel depois de depurá-lo, entre em contato conosco pelo grupo de desenvolvedores Steamworks.

Por que o Painel Steam não aparece no aplicativo?

Primeiro, confirme que você atende aos Requisitos acima. Se atender e mesmo assim o painel não aparecer, confirme que está iniciando o aplicativo pelo cliente Steam, seja diretamente pela biblioteca ou por uma lista de salas/início rápido, ou está chamando a função SteamAPI_RestartAppIfNecessary.

O meu jogo usa a API D3D12 no Windows 7, mas o Painel Steam não funciona. Por quê?

Para mais informações sobre como fazer o Painel Steam funcionar, consulte a documentação da Microsoft (em inglês).