遗留 (3.3 以前) Android Unity 集成

上次更新:

目录


基础集成

打开 Unity 并导入插件文件: 右键点击项目一栏的素材,然后移动鼠标至导入文件包然后点击自定义文件包:

揭示 Chartboost SDK 方法的 C# 文件 — ChartBoostAndroid.csChartBoostAndroidManager.cs — 位于 Chartboost 目录下 (素材 > 插件 > ChartboostAndroid)。原生 SDK 和 java 包装文件位于 Android 目录下 (素材 > 插件 > Android)

如果您点开新的演示目录 (素材 > 插件 > ChartboostAndroid > 演示),您会发现两个 C# 脚本 — ChartBoostGUIManagerChartBoostEventListener。这些脚本展示了如何在您的任一脚本中运用 ChartBoostAndroid.cs (适用于基础集成) 和 ChartBoostAndroidManager.cs (为使用代理方法) 中的公开方法:

ChartBoostAndroid.csChartBoostAndroidManager.cs 列出了所有可用的 Chartboost 方法,下述内容可供参考。

重要注意事项: 在 Android 插件开始工作之前,您需要为您的 AndroidManifest 文件添加 CBDialogActivity 活动和 android.permission.INTERNET 权限,只需复制粘贴素材 > 插件 > ChartBoostAndroid 清单文件中的活动声明和权限即可。

在应用程序启动时,记得使用您的 App ID 和 AppSignature 调用 init 为 Chartboost 做好准备,并调用 onStart 让 Chartboost 知道您已经准备好了。之后,您就能显示插页式广告或“更多应用”页面了。

ChartBoostAndroid.cs 公开了下列方法:

// Android 活动生命周期方法
public static void onStart()

public static void onDestroy()

public static void onStop()

public static void onBackPressed()

// 启动 Chartboost 并记录一次启动或安装
public static void init( string appId, string appSignature, bool shouldRequestInterstitialsInFirstSession = true )

// 缓存插页式广告。位置可选;若您不想指定,填入“null”。
public static void cacheInterstitial( string location )

// 检查缓存的插页式广告。位置可选;若您不想指定,填入“null”。
public static bool hasCachedInterstitial( string location )

// 加载插页式广告。位置可选;若您不想指定位置,填入“null”。
public static void showInterstitial( string location )

// 缓存“更多应用”页面
public static void cacheMoreApps()

// 查看“更多应用”页面是否成功缓存
public static bool hasCachedMoreApps()

// 显示“更多应用”页面
public static void showMoreApps()
最佳实践
  • InitonStart 每次会话只需调用一次;在交换场景时不应再次调用
  • 一次“会话”包括硬启动和软启动 — 游戏首次启动和每次从背景中激活时触发的方法中应包括 InitonStart

高级集成

ChartBoostAndroidManager.cs 会触发下列事项:

// 当“更多应用”页面加载失败时触发
public static event Action didFailToLoadMoreAppsEvent;

// 在插页式广告缓存时触发
public static event Action didCacheInterstitialEvent;

// 当“更多应用”页面缓存时触发
public static event Action didCacheMoreAppsEvent;

// 插页式广告完成后触发可能原因有“忽略”、“关闭”和“点击”。
public static event Action didFinishInterstitialEvent;

// “更多应用”页面完成后触发可能原因有“忽略”、“关闭”和“点击”。
public static event Action didFinishMoreAppsEvent;

// 在“更多应用”页面关闭时触发
public static event Action didCloseMoreAppsEvent;

// 当插页式广告加载失败时触发
public static event Action didFailToLoadInterstitialEvent;

// 在显示插页式广告时触发
public static event Action didShowInterstitialEvent;

// 在显示“更多应用”页面时触发
public static event Action didShowMoreAppsEvent;