遗留 (3.3 以前) iOS Unity 集成

上次更新:

目录


基础集成

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

揭示 Chartboost SDK 方法的 C# 文件 — ChartBoostBinding.csChartBoostManager.cs — 位于 Chartboost 目录下 (素材 > 插件 > Chartboost)。原生 SDK 和 objective-c 包装文件位于 iOS 目录下 (素材 > 插件 > iOS)

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

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

ChartBoostBinding.cs 公开了下列方法:

// 启动 Chartboost 并记录一次启动或安装。不可依赖先前网络请求或用户操作。
public static void init( string appId, string appSignature, bool shouldRequestInterstitialsInFirstSession = true )

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

// 检查插页式广告是否成功缓存
public static bool hasCachedInterstitial( string location )

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

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

// 显示“更多应用”页面
public static void showMoreApps()

// 强制设定插页式广告的方向。(如果您的项目已经正确设置为自动旋转,动态本地视图将会生效,您应该不需要对此进行设置。)
public static void forceOrientation( ScreenOrientation orient )
最佳实践
  • InitonStart 每次会话只需调用一次;在交换场景时不应再次调用
  • 一次“会话”包括硬启动和软启动 — 游戏首次启动和每次从背景中激活时触发的方法中应包括 InitonStart

高级集成

ChartBoostManager.cs 会触发下列事项:

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

// 插页式广告完成后触发
public static event Action didDismissInterstitialEvent;

// 当插页式广告关闭时触发
public static event Action didCloseInterstitialEvent;

// 当点击插页式广告时触发
public static event Action didClickInterstitialEvent;

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

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

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

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