Skip to content

Introdução

Antes de integrar o JOGOS_SDK, certifique-se de seguir nossos requisitos. Ele ajudará você a usar o JOGOS_SDK da melhor maneira possível e fornecerá orientações sobre requisitos técnicos, conteúdo do jogo, publicidade e integração de contas. Além de Unity e Cocos, que podem usar SDKs exclusivos, outros motores podem integrar essas funcionalidades por meio da versão HTML5, pois a maioria dos motores de jogo que suportam WebGL possuem maneiras de interagir com o JavaScript quando executados no navegador.

O JOGOS_SDK inclui os seguintes módulos:

MóduloDescriçãoHTML5 nativoCocosUnity
JOGOS_SDK.userInteração com usuários logados🟩 Totalmente suportado🟩 Totalmente suportado🟩 Totalmente suportado
JOGOS_SDK.gameComportamentos do jogo🟩 Totalmente suportado🟩 Totalmente suportado🟩 Totalmente suportado
JOGOS_SDK.bannerAnúncios de banner no jogo🟩 Totalmente suportado🟩 Totalmente suportado🟩 Totalmente suportado
JOGOS_SDK.adAnúncios em vídeo🟩 Totalmente suportado🟩 Totalmente suportado🟩 Totalmente suportado
JOGOS_SDK.dataSalvamento em nuvem🟦 Em breve🟦 Em breve🟦 Em breve
JOGOS_SDK.friendAmigos e grupos🟨 Ainda não suportado🟨 Ainda não suportado🟨 Ainda não suportado
JOGOS_SDK.purchaseCompras no aplicativo e compras únicas🟩 Totalmente suportado🟩 Totalmente suportado🟩 Totalmente suportado
JOGOS_SDK.ActiveConquistas e tabelas de classificação🟦 Em breve🟦 Em breve🟦 Em breve

Início

Esta seção descreve como iniciar e executar o JOGOS_SDK no motor.

Adicione o seguinte script no body do arquivo index.html do seu jogo para importar o JOGOS_SDK:

html
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
Inicialização manual

O JOGOS_SDK precisa ser inicializado antes de ser usado. Complete a inicialização chamando o método JOGOS_SDK.init:

javascript
await window.JOGOS_SDK.init();

O método JOGOS_SDK.init é assíncrono, e nenhum outro método pode ser usado até que o método JOGOS_SDK.init seja executado com sucesso. Recomendamos fortemente que você faça isso antes do início do jogo.

Se outros métodos forem chamados antes que JOGOS_SDK.init seja chamado com sucesso, a exceção "460 Can only be called after the successful call of the JOGOS_SDK.init method" será lançada.

Promise

A maioria dos métodos no JOGOS_SDK são assíncronos e podem ser chamados usando await:

javascript
try {
  const user = await window.JOGOS_SDK.user.getUser();
  console.log(user);
} catch (err) {
  console.log('Erro ao obter usuário: ', err);
}

Eles também podem ser chamados usando a abordagem Promise:

javascript
window.JOGOS_SDK.user
  .getUser()
  .then((user) => console.log(user))
  .catch((err) => console.log('Erro ao obter usuário: ', err));

Você pode baixar a cena de exemplo para referência: HTML5_Demo.zip

Informações importantes

Após o callback de inicialização bem-sucedido, você pode obter as informações SysInfo. Não perca esta parte, que contém informações importantes sobre o motor de jogo que você está usando; você pode obter o tipo de idioma atual usado pelos usuários da plataforma; fazer com que os jogadores correspondam automaticamente ao idioma localizado ao entrar no seu jogo. Atualize o horário real do servidor no seu jogo, etc.

javascript
SysInfo{
    "gameId": number;//ID do jogo
    "hasGameGroup":bool;//Se o chat em grupo está habilitado
    "deviceType": "desktop"// valores possíveis: "desktop", "tablet", "mobile"
    "language": string;//Tipo de idioma
    "os":"Windows 10"//Sistema operacional e versão
    "browser":"Chrome 10.0"//Navegador e versão
    "serverTime": number;//Horário atual do servidor
}

Desenvolvimento e teste

Durante o desenvolvimento, você executará o JOGOS_SDK em diferentes ambientes:

  • localhost Ao depurar e desenvolver localmente, o JOGOS_SDK tentará simular comportamentos como anúncios em vídeo/banners e outros, e não interagirá com o serviço ou carregará anúncios reais.
  • A Ferramenta de visualização fornece funções reais de visualização e detecção em nosso ambiente QA. Após o jogo ser integrado com o JOGOS_SDK, você pode visualizar seu jogo após criar um novo jogo no Portal do Desenvolvedor e fazer upload dos arquivos de recursos do jogo relevantes.