Integrações em iOS 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 > Chartboost). Os arquivos de SDK nativos e wrappers object-c estão localizados no diretório iOS (Conteúdos > Plug-ins > iOS).

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

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

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

// Inicia o Chartboost e grava uma instalação ou ativação. Não deve ser dependente de chamadas de rede ou ações de usuário anteriores.
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.
public static bool hasCachedInterstitial( string location )

// Mostra 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()

// Mostra a página MoreApps
public static void showMoreApps()

// Força a orientação de intersticiais. (Se o seu projeto está configurado corretamente para girar automaticamente, as exibições de animação nativas funcionarão conforme esperado e você não precisa configurar isto).
public static void forceOrientation( ScreenOrientation orient )
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

ChartBoostManager.cs dispara os seguintes eventos:

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

// Dispara quando um intersticial é encerrado
public static event Action didDismissInterstitialEvent;

// Dispara quando um intersticial é fechado
public static event Action didCloseInterstitialEvent;

// Dispara quando um intersticial é clicado
public static event Action didClickInterstitialEvent;

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

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

// 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 entra em cache
public static event Action didCacheMoreAppsEvent;