Introdução

Antes de integrar o JOGOS_SDK, certifique-se de seguir nossas requisitos. Ele ajudará você a usar o JOGOS_SDK da melhor maneira e fornecerá orientações sobre requisitos de integração técnica, conteúdo do jogo, anúncios e 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 métodos para interagir com o JavaScript quando executados no navegador.

O JOGOS_SDK inclui os seguintes módulos:

Módulo	Descrição	Suporte ao SDK	Sugestões de integração
JOGOS_SDK.init	Inicializa o SDK	🟩 Totalmente suportado	☑️ Necessário integrar, detalhes abaixo
JOGOS_SDK.game	Comportamentos do jogo	🟩 Totalmente suportado	☑️ Necessário, informe-nos quando seu jogo carrega, inicia ou pausa
JOGOS_SDK.user	Interação com usuários logados	🟩 Totalmente suportado	🔳 Não necessário, apenas se usar o sistema de usuários
JOGOS_SDK.banner	Anúncios em banner no jogo	🟩 Totalmente suportado	🔳 Não necessário, apenas se houver anúncios Banner no jogo
JOGOS_SDK.ad	Vídeos incentivados e intersticiais	🟩 Totalmente suportado	🔳 Não necessário, apenas se houver anúncios em vídeo no jogo
JOGOS_SDK.data	Salvamento em nuvem	🟦 Em breve	🔳 Não necessário, apenas se precisar usar o salvamento em nuvem do Jogos
JOGOS_SDK.friend	Amigos e grupos	🟨 Não suportado temporariamente	🔳 Não necessário, apenas se precisar usar o sistema de interação entre jogadores no jogo
JOGOS_SDK.payment	Compras no aplicativo e modelo de compra única	🟦 Em breve	🔳 Não necessário, apenas se o jogo tiver compras no aplicativo ou modelo de compra única
JOGOS_SDK.active	Conquistas e rankings	🟩 Totalmente suportado	🔳 Não necessário, apenas se precisar usar o sistema de conquistas e rankings do Jogos
JOGOS_SDK.cdkey	Funcionalidade de código de resgate	🟦 Em breve	🔳 Não necessário, apenas se precisar que o Jogos gerencie os CDkeys para você

Início

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

Adicione o seguinte script dentro da tag body do arquivo index.html do seu jogo para importar o JOGOS_SDK：

<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：

let systemInfo = await window.JOGOS_SDK.init();

O método JOGOS_SDK.init é assíncrono, e nenhum outro método estará disponível antes que JOGOS_SDK.init seja executado com sucesso. Recomendamos veementemente que você faça isso antes do início do jogo.

Se outro método for chamado antes de JOGOS_SDK.init ser 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：

try {
  const user = await window.JOGOS_SDK.user.getUser();
  console.log(user);
} catch (err) {
  console.log('Get user error: ', err);
}

Também podem ser chamados usando Promise：

window.JOGOS_SDK.user
  .getUser()
  .then((user) => console.log(user))
  .catch((err) => console.log('Get user error: ', err));

Você pode baixar um exemplo de cena para referência：HTML5_Demo.zip

Informações do SysInfo

Após o sucesso da inicialização com retorno de chamada, você pode obter as informações do 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 pelo usuário da plataforma; Permita que os jogadores entrem no seu jogo com o idioma localizado automaticamente. Atualize o horário real do servidor no seu jogo, etc.

SysInfo{
    "gameId": number；//ID do jogo
    "hasGameGroup":bool；//Se o chat em grupo está ativado
    "deviceType": "desktop" ；// possible values: "desktop", "tablet", "mobile"
    "language": string；//Tipo de idioma
    "os":"Windows 10"；//Sistema 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 Durante a depuração e desenvolvimento locais, o JOGOS_SDK tentará simular comportamentos como anúncios em vídeo/banner e outros, sem interagir com o serviço ou carregar anúncios reais.
• Ferramenta de visualização Oferece funcionalidades de visualização e detecção reais em nosso ambiente QA. Após integrar o JOGOS_SDK ao jogo, crie um novo jogo no Portal do Desenvolvedor e faça upload dos arquivos de recursos relacionados ao jogo para visualizar o seu jogo.