JavaScript

A versão JavaScript da API Click Jogos permite estender o seu jogo para se comunicar com o back­-end do Click Jogos.

Introdução
Documentação Específica
Download do jogo de exemplo

Introdução

Este é um guia de instrução passo-a-passo de como integrar a API do Click Jogos em seu game.

O funcionamento da versão JavaScript da API do Click Jogos é bastante semelhante à versão AS3, porém não é necessário instanciar a API, a classe padrão ‘CJAPI’ já estará instanciada e disponível.

Baixar o api.js

Cada função da API dispara eventos que precisam ser escutados para obtenção e utilização dos dados do back-end do Click Jogos. Na versão JavaScript para a API isto é feito através do bind(), que escuta a chegada de dados e distribui para qualquer função determinada.

Leia mais e veja o código de exemplo

Depois de adicionar todos os event listeners das funções que você pretende usar, você está apto a chamá-las. Lembrando que as funções de nossa API estão separadas em pacotes para facilitar a manipulação.

Vejo todas as funções da API

Agora qualquer evento em seu jogo pode ser enviado para o Click Jogos, então você precisa criar as estatísticas e os achievements que serão exibidos para o usuário.

Veja como criar e submeter stats Veja como criar achievements

O processo de cadastro de jogo é bastante simples, após inserir o nome e a descrição, criar as estatísticas e os achievements, você precisa selecionar o arquivo do seu jogo, preencher a largura e a altura da tela em que ele será mostrado, e por fim, ler e aceitar os termos e condições de uso da API.

Submit_ptbr

Logo após fazer upload do seu jogo com sucesso você verá um botão onde já vai ser possível ter um preview do seu game e testar o envio de stats e a liberação de achievements. Esse botão também pode ser visto no formulário de edição do seu game.

Congrats_ptbr

Carregando a API

Quando o seu jogo estiver dentro de nossa sandbox, a versão JavaScript já é carregada automaticamente, dessa forma não é necessária a inclusão de nenhum arquivo em seu jogo. A API JavaScript permite instanciar a API, utilizar suas funções e enviar ações de maneira simplificada e direta.

O funcionamento da versão JavaScript da API do Click Jogos é bastante semelhante à versão AS3, porém não é necessário instanciar a API, a classe padrão ‘CJAPI’ já estará instanciada e disponível.

Parâmetro Salt

Você precisa gerar um parâmetro salt em toda função que irá fazer requests em nosso servidor.

Todos as requests enviadas a partir do seu game para nosso servidor devem enviar com ela o parâmetro salt, que precisa ser encodado em base64 e gerado em todas as requests.

Event Listeners

Cada função da API dispara eventos que precisam ser escutados para obtenção e utilização dos dados do back-end do Click Jogos. Na versão JavaScript para a API isto é feito através do bind(), que escuta a chegada de dados e distribui para qualquer função determinada.

Códigos de exemplos para event listeners

Existem dois tipos de event listeners para cada função em nossa API, event listeners de sucesso, e event listeners de erro.

Users Stats Services

O evento onGetUsername() retorna ‘Guest’ se o usuário atual não estiver logado, ou, caso o usuário esteja logado retorna o nome do usuário. O evento onGetUsernameErrors() retorna false para success e um array contendo os erros.

O evento onSubmitStat() retorna true para sucess, retorna um array com os dados do achievement caso tenha um achievement para ser liberado, retorna também o tipo do stat e seu valor atual. O evento onSubmitStatError() retorna false para success e um array contendo os erros.

O evento onIsSignedIn() retorna ‘Guest’ se o usuário atual não estiver logado, caso contrário retorna 'Username logged', onde 'Username' é o nome do usuário logado. O evento onIsSignedInError() retorna false para success e um array contendo os erros.