chinese_sdk_android_transition_guide - unity-cn/unityads-help-cn GitHub Wiki

Unity Ads SDK 2.0 - Android Transition Guide from Unity Ads 1.5

Unity Ads SDK 2.0 并不与 Unity Ads SDK 1.5 API 兼容. 但是两个版本的思想大同小异. 在您的游戏开始时, 您使用 Game ID 初始化 Unity Ads. 您想要展示广告是, 需要先检查广告可用性. 如果有可用的广告, 就可以展示啦.

Initializing and test mode

Unity Ads 只初始化一次. SDK 2.0 拥有一套更可靠的网络重连机制, 所以您可以在没有网络的情况下初始化, 一旦再有网络可用了, SDK会安全的请求广告.

测试模式 (Test mode) 现在只能作为初始化参数进行设置了, 并不可以在后来再设.

Placements and zones

Zone 和 Placement 同样是指广告位.

在新的 API 中, 使用 getPlacementState 方法代替了 canShow 和 isReady. getPlacementState 会返回一个更具体的广告位状态, 如果一个广告位没准备好, getPlacementState 会告诉开发者它是在 等待(waiting (caching)), 关闭了 (disabled) 又或是 没有填充 (fill).

Show method and activity handling

Unity Ads SDK 2.0 的展示 (show) 方法 需要一个 Activity 作为参数. 您应该使用当前的Activity. 不再需要调用 changeActivity 方法了!

Changes to IUnityAdsListener

在广告位准备好广告用于展示的时候, onUnityAdsReady 方法取代了过去的 与初始化状态有关的 onFetchComplete 和 onFetchFailed 回调方法, onUnityAdsReady 回调方法会携带一个广告位 ID, 之后开发者就可以展示广告啦.

广告开始和关闭事件可以使用 onUnityAdsStart 和 onUnityAdsFinish 回调来处理. 如果您想要在观看完成后奖励 (reward) 玩家, 您应该在 onUnityAdsFinish 回调里检查 UnityAds.FinishState, 在这里您可以检查玩家是看完了视频还是选择了跳过.

⚠️ **GitHub.com Fallback** ⚠️