Integrações em Android e Unity de legado (antes da versão 3.3)

Última atualização:

Conteúdo


Integração básica

Abra o Unity e importe os arquivos de plug-in: clique com o botão direito em Conteúdos na seção Projeto, depois passe o mouse sobre Importar pacote e clique em Pacote personalizado:

Os arquivos C# que expõem os métodos do Chartboost SDK — ChartBoostAndroid.cs e ChartBoostAndroidManager.cs — estão localizados no diretório Chartboost (Conteúdos > Plug-ins > ChartboostAndroid). Os arquivos de SDK nativos e wrappers java estão localizados no diretório Android (Conteúdos > Plug-ins > Android).

Se você navegar para o novo diretório Demo (Conteúdos > Plug-ins > ChartboostAndroid > Demo), verá os dois scripts C# — ChartBoostGUIManager e ChartBoostEventListener. Estes scripts demonstram como conectar métodos expostos de ChartBoostAndroid.cs (para uma integração básica) e ChartBoostAndroidManager.cs (para usar métodos delegados) em qualquer um dos seus scripts:

ChartBoostAndroid.cs e ChartBoostAndroidManager.cs relacionam todos os métodos disponíveis do Chartboost, que também estão disponíveis para referência abaixo.

Nota importante: para que o plug-in Android funcione, você precisa adicionar a atividade CBDialogActivity e android.permission.INTERNET ao seu arquivo AndroidManifest. Basta copiar e colar a declaração de atividade e permissões do arquivo de manifesto em Conteúdos > Plug-ins > ChartBoostAndroid.

Ao abrir o aplicativo, certifique-se de chamar init com seu ID do app e assinatura do app para preparar o Chartboost, e onStart para informar o Chartboost que você está pronto. Após isso, você já pode mostrar intersticiais na página MoreApps.

ChartBoostAndroid.cs expõe os seguintes métodos:

// Métodos de ciclo de vida de atividade do Android
public static void onStart()

public static void onDestroy()

public static void onStop()

public static void onBackPressed()

// Inicia o Chartboost e grava uma instalação ou ativação
public static void init( string appId, string appSignature, bool shouldRequestInterstitialsInFirstSession = true )

// Coloca em cache um intersticial. O local é opcional; passe "null" se não quiser especificar um.
public static void cacheInterstitial( string location )

// Verifica se há um intersticial em cache. O local é opcional; passe "null" se não quiser especificar um.
public static bool hasCachedInterstitial( string location )

//Carrega um intersticial. O local é opcional; passe "null" se não quiser especificar um.
public static void showInterstitial( string location )

// Coloca a página MoreApps em cache.
public static void cacheMoreApps()

// Verifica se a página MoreApps está em cache
public static bool hasCachedMoreApps()

// Mostra a página MoreApps
public static void showMoreApps()
Melhores práticas
  • Init e onStart só precisam ser chamados uma vez por sessão; não devem ser chamados novamente ao alternar cenas
  • Uma "sessão" inclui ativações forçadas e suaves — Init e onStartdevem ser incluídos em métodos que disparam quando o jogo inicia pela primeira vez e cada vez que se torna ativo a partir do segundo plano

Integração avançada

ChartBoostAndroidManager.cs dispara os seguintes eventos:

// Dispara quando a página MoreApps deixa de carregar
public static event Action didFailToLoadMoreAppsEvent;

// Dispara quando um intersticial entra em cache
public static event Action didCacheInterstitialEvent;

// Dispara quando a página MoreApps entra em cache
public static event Action didCacheMoreAppsEvent;

// Dispara quando um intersticial é encerrado. Os motivos possíveis são "dispensar," "fechar" e "clique."
public static event Action didFinishInterstitialEvent;

// Dispara quando a página MoreApps é encerrada. Os motivos possíveis são "dispensar," "fechar" e "clique."
public static event Action didFinishMoreAppsEvent;

// Dispara quando a página MoreApps é fechada
public static event Action didCloseMoreAppsEvent;

// Dispara quando um intersticial não é carregado
public static event Action didFailToLoadInterstitialEvent;

// Dispara quando um intersticial é exibido
public static event Action didShowInterstitialEvent;

// Dispara quando a página MoreApps é exibida
public static event Action didShowMoreAppsEvent;