HandyCafe Docs
owner it-admin

Pool de Contas de Jogos

O Pool de Contas de Jogos gerencia um conjunto compartilhado de contas de launchers de jogos que os clientes pegam emprestadas pela duração de uma sessão. Quando um cliente abre um jogo do pool, o HandyCafe entrega a ele uma conta livre do provedor correspondente, marca-a como ocupada e a devolve ao pool quando ele termina. Isso permite que um número limitado de contas pagas atenda muitos PCs sem que nenhuma conta seja usada em duas máquinas ao mesmo tempo.

Esta página é alcançada pela interface do servidor em Licenças, na aba Contas de Jogos. A outra aba da mesma página, Licenças de Aplicativos, é um recurso separado. Veja a distinção abaixo.

Contas de Jogos vs Licenças de Aplicativos

Esses dois recursos parecem semelhantes, mas resolvem problemas diferentes.

  • Contas de Jogos (esta página) gerencia contas de login reais (um nome de usuário e uma senha para Steam, Epic, Battle.net e launchers semelhantes). O HandyCafe empresta uma dessas contas ao cliente durante a sessão e depois a recupera.
  • Licenças de Aplicativos (Licenças de Software) acompanha chaves de licença simultâneas ou contagens de assentos. Conta quantos PCs podem executar um título ao mesmo tempo e bloqueia o uso excessivo. Não distribui credenciais de login.

Use o Pool de Contas de Jogos quando você compartilha um conjunto de contas pagas de launcher. Use Licenças de Software quando você possui um número fixo de assentos para um título e só precisa limitar o uso simultâneo.

Barra de Provedores

A barra à esquerda lista cada provedor configurado, como Steam, Epic, Ubisoft Connect, Battle.net e outros. Cada provedor mostra um indicador de capacidade no formato livres sobre o total de contas. Um provedor desativado é marcado com o rótulo Desativado e fica esmaecido. Selecione um provedor na barra para carregar suas contas e configurações na área de trabalho à direita.

O cabeçalho acima da área de trabalho mostra o nome do provedor selecionado, um interruptor mestre Ativado e contadores ao vivo: total, Livres, Ocupadas e Reservadas.

A área de trabalho tem quatro abas: Geral, Contas, Reservas e Eventos.

Aba Geral

A aba Geral configura o comportamento do provedor selecionado. As alterações aqui são salvas pelo botão Salvar no nível da página, não por um botão separado nesta aba.

Launcher

  • Argumentos de inicialização: o modelo de argumentos passado ao launcher. Ele aceita os placeholders {USERNAME}, {PASSWORD}, {EXECUTABLE}, {APP_ID} e {LAUNCH_URI}. Os valores de {APP_ID} e {LAUNCH_URI} vêm dos metadados de catálogo do aplicativo aberto.
  • Configurações avançadas do monitor: uma área expansível que revela o campo Processo monitor. Esta é uma verificação avançada de atividade. Provedores embutidos como Steam, Epic, Battle.net e GOG têm padrões. Se ficar em branco, o cliente recorre ao nome do executável do atalho do jogo.

O caminho do executável em si fica em cada atalho de jogo no catálogo, não no pool. O pool mantém as credenciais, o modelo de argumentos e o nome opcional do monitor.

Preços

  • Método de cobrança: como a conta emprestada é cobrada. As opções são Sem cobrança, Por sessão, Por minuto e Por troca de conta.
  • Valor por sessão: o valor cobrado. Este campo fica desabilitado quando o método de cobrança é Sem cobrança.

Comportamento da Sessão

  • Janela de suspensão: quando um jogo é encerrado enquanto a sessão do cliente ainda está ativa, a conta permanece reservada por esta quantidade de segundos antes de voltar ao pool. Definido com um controle deslizante de 0 a 1800 segundos.
  • Tempo limite de heartbeat: por quantos segundos o cliente pode ficar em silêncio antes de a conta ser tratada como inativa. Definido com um controle deslizante de 15 a 600 segundos.
  • Permitir durante sessões cronometradas: deixa a conta ser usada dentro de uma sessão cronometrada.
  • Transferir a conta quando a sessão é transferida entre PCs: move a conta emprestada junto com a sessão quando uma sessão é transferida para outro PC.

Acesso do Cliente

  • Permitir que clientes abram o launcher diretamente: deixa os clientes iniciarem o launcher por conta própria.
  • Capturar o launcher quando ele inicia manualmente: captura o launcher quando um cliente o inicia fora do fluxo normal.
  • Cobrar uma taxa a cada troca de conta: aplica uma cobrança sempre que o cliente troca de conta.
  • Marcar para rotação de senha após a liberação: sinaliza a conta para que um administrador possa rotacionar manualmente a senha dela assim que for liberada.
  • Mensagem de contas esgotadas: o texto mostrado a um cliente quando todas as contas estão ocupadas. Deixe vazio para usar o padrão.

Aba Contas

A aba Contas lista cada conta no pool do provedor selecionado. Use a caixa de busca para filtrar por nome de usuário ou rótulo.

Cada linha mostra o número da linha, Nome de usuário, Rótulo, Cobrança personalizada, um marcador de visibilidade para o cliente, Status, Adicionada em e uma coluna de Ações. O status pode ser Livre, Ocupada, Reservada ou Desativada. Quando uma conta está em uso, o nome do cliente atribuído aparece abaixo do status dela.

Adicionando e Editando uma Conta

Use Adicionar licença para criar uma conta ou a ação de edição em uma linha para alterar uma. O editor tem estes campos:

  • Nome de usuário: o nome de login da conta. Obrigatório.
  • Senha: a senha da conta. Obrigatória ao adicionar. Ao editar, deixe em branco para manter a senha atual.
  • Rótulo: uma observação em texto livre, por exemplo, um título de jogo.
  • Valor de cobrança personalizada: uma cobrança por conta que substitui a cobrança do provedor.
  • Visível para os clientes nos dispositivos clientes: controla se a conta é oferecida aos clientes nos dispositivos clientes.
  • Observações: observações em texto livre.

Salvar fica à esquerda e Cancelar à direita.

Importação CSV

Use Importar CSV para adicionar muitas contas de uma vez. Cole uma conta por linha no formato username,password,label. Após a importação, o HandyCafe informa quantas contas foram importadas, quantas duplicatas foram ignoradas e quantas linhas falharam.

Liberando uma Conta

Quando uma conta está Ocupada ou Reservada, uma ação Forçar liberação aparece na linha dela. Use-a para devolver a conta ao pool imediatamente. A linha também tem ações de edição e exclusão.

Aba Reservas

A aba Reservas trata das contas prometidas a membros específicos. Ela tem duas listas.

Reservas Ativas

Reservas Ativas lista as contas reservadas para um membro. Cada linha mostra o Provedor, o Membro, a Licença, o Vencimento, as Observações e uma ação para remover a reserva. Uma reserva sem vencimento mostra Ilimitada.

Reservas na Fila

Reservas na Fila lista os pedidos que estão aguardando porque todas as contas do pool estavam ocupadas no momento. Cada linha mostra o Provedor, o Membro, Enfileirado em, Vencimento e uma ação de cancelamento. Quando uma conta fica livre, a próxima reserva da fila é atribuída a ela automaticamente.

Criando uma Reserva

Use Nova reserva para abrir o editor de reservas.

  • Provedor: o pool do provedor de onde reservar.
  • Membro: busque o membro pelo nome ou nome de usuário e depois selecione um nos resultados.
  • Selecionar automaticamente a primeira licença disponível: quando ligado, o HandyCafe escolhe a primeira conta livre do pool. Quando desligado, você escolhe uma Licença específica na lista.
  • Enfileirar a reserva se todas as licenças estiverem ocupadas: aparece quando a seleção automática está ligada. Quando ligado, um pedido que não pode ser atendido agora é enfileirado em vez de recusado.
  • Definir um vencimento: quando ligado, revela Vence em (horas) para que a reserva expire após o número de horas escolhido.
  • Observações: observações em texto livre.

Se todas as contas estiverem ocupadas e o enfileiramento estiver desligado, o HandyCafe informa que todas as licenças estão ocupadas.

Aba Eventos

A aba Eventos é o log de auditoria do provedor selecionado. Ela registra a atividade das contas ao longo do tempo.

Filtre o log com a lista de tipos de evento e a lista de limite de linhas (50, 200, 500 ou 1000 linhas), depois use Atualizar para recarregar. Cada linha mostra Quando, Provedor, Licença, Evento, o PC e Membro.

Os tipos de evento registrados incluem Atribuída, Retomada, Liberação, Reservada, Suspensão expirada, Senha rotacionada, Reservada para membro, Reserva liberada, Negada por falta de capacidade, Processo encerrado, Liberação manual, Configuração alterada, Importada e Criada. Os eventos Atribuída e Retomada ficam agrupados no filtro porque uma retomada é registrada como uma retirada que dá continuidade a uma atribuição anterior.

Onde os Membros Veem as Reservas

As contas reservadas de um membro aparecem no cadastro dele, na seção Reservas de Licenças de Jogos. Veja Membros para gerenciamento de membros. A própria página de Contas de Jogos fica dentro da interface de configurações do servidor, abordada em Configurações.