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ódulo | Descrição | HTML5 nativo | Cocos | Unity |
---|---|---|---|---|
JOGOS_SDK.user | Interação com usuários logados | 🟩 Totalmente suportado | 🟩 Totalmente suportado | 🟩 Totalmente suportado |
JOGOS_SDK.game | Comportamentos do jogo | 🟩 Totalmente suportado | 🟩 Totalmente suportado | 🟩 Totalmente suportado |
JOGOS_SDK.banner | Anúncios de banner no jogo | 🟩 Totalmente suportado | 🟩 Totalmente suportado | 🟩 Totalmente suportado |
JOGOS_SDK.ad | Anúncios em vídeo | 🟩 Totalmente suportado | 🟩 Totalmente suportado | 🟩 Totalmente suportado |
JOGOS_SDK.data | Salvamento em nuvem | 🟦 Em breve | 🟦 Em breve | 🟦 Em breve |
JOGOS_SDK.friend | Amigos e grupos | 🟨 Ainda não suportado | 🟨 Ainda não suportado | 🟨 Ainda não suportado |
JOGOS_SDK.purchase | Compras no aplicativo e compras únicas | 🟩 Totalmente suportado | 🟩 Totalmente suportado | 🟩 Totalmente suportado |
JOGOS_SDK.Active | Conquistas 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
:
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
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('Erro ao obter usuário: ', err);
}
Eles também podem ser chamados usando a abordagem Promise
:
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.
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, oJOGOS_SDK
tentará simular comportamentos comoanú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 ambienteQA
. Após o jogo ser integrado com oJOGOS_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.