OFICINA · GAMERS PELO BRASIL
Conquistas que acompanham o jogo
Ligue desafios reais à coleção central. Primeiro termine uma partida; depois acrescente troféus com o guia e o exemplo completos.
SDK 0.1.0-test.3, versão de testes. A API de testes está publicada em https://api.gamerspelobrasil.tech. Peça ao operador API, chave pública e origens cadastradas antes de integrar. Não há pacote publicado no npm; login Google depende da configuração do ambiente.
Dois caminhos de integração
Origem externa cadastrada
Copie exemplo.html e trofeus.js para a mesma pasta e sirva por localhost/HTTPS na origem combinada. Prepare o SDK com API/chave fornecidas. Troque os botões de simulação pelos callbacks que já indicam uma conquista real.
Preserve registrarConquista(slot), as linhas independentes, a intenção antes do envio, retry após falha/reload e renovação explícita. O jogo envia conquistas, sem score, diário, identidade ou cookies do jogador.
Hospedado em nova aba
O jogo abre diretamente em nova aba e mantém origem opaca. Não instale a integração externa diretamente esperando rede ou storage de uma origem comum. É necessária uma integração própria, ainda não implementada neste kit.
Essa integração precisa de revisão e validação da origem, do emissor e dos slots. Não libere Origin null, allow-same-origin nem rede do jogo para contornar a etapa. A skill ajuda a identificar e delimitar esse trabalho, sem inventar uma integração pronta.
Guia e arquivos reais
O dono do contrato continua sendo backend/sdk/README.md. A edição pública é gerada dele: apenas os links de distribuição são adaptados. O módulo e o HTML do exemplo são cópias exatas da fonte, sem um segundo exemplo simplificado.
- Baixar SDK, exemplo e guia juntos
- exemplo.html + trofeus.js
- Guia em Markdown · OpenAPI implementado localmente
Os arquivos individuais são oferecidos para baixar e servir na origem cadastrada. O exemplo não chama a API a partir destas páginas. Após extrair o kit, abra http://localhost:8093/sdk/exemplo.html usando o servidor do tutorial; o operador precisa cadastrar essa origem exata.
O que a prova cobre
A integração de testes exercita emissão, falha de transporte, retry, reload, vários slots, renovação e resgate central com API e PostgreSQL reais. Isso não é um piloto com jogo comunitário. A publicação não comprova a adaptação do seu jogo. Confira a edição do kit no manifesto.
Limites para explicar a quem joga
- Com Google habilitado na central, a coleção acompanha a conta. No modo de identidade de teste, perder ou expirar o cookie não recupera a coleção pela interface. Storage local do jogo não é conta.
- O link de resgate é uma prova ao portador e pode vencer; não compartilhe o link pessoal. Retry repete o envio; “Gerar novo link” é uma ação explícita diferente.
- A chave pública é copiável: o fluxo não comprova que a pessoa venceu o desafio. Critérios vêm do jogo, sem antifraude de servidor entregue.
- Sem storage, a intenção fica em memória e não sobrevive a reload. Cadastro, chaves, CORS e proxy são responsabilidade do operador; o envio de um jogo não concede credenciais.
Parâmetros e métodos completos estão no guia gerado do contrato canônico. Para ajuda por IA, use os prompts ou a skill pública.