文档

支持

在 Android 中初始化 SDK

在 Android 应用程序中初始化 Unity Ads SDK。设置 Game ID(游戏 ID),配置监听器来处理初始化状态,并启用广告变现。
阅读时间2 分钟最后更新于 12 天前

要初始化该 SDK,必须为适当平台引用项目的 Game ID(游戏 ID)。在 Unity Ads Monetization(变现)后台的二级导航菜单中选择 CURRENT PROJECT(当前项目)> Project Settings(项目设置),即可找到该 ID。 在游戏脚本中,需要实现一个
IUnityAdsInitializationListener
接口来处理初始化回调。用于初始化 SDK 的 initialize 方法需要将此监听器作为参数。应在项目运行时的生命周期早期(在需要加载广告之前)初始化 SDK。例如:
注意
Unity Ads 需要访问当前正在运行的 Activity,所以下面的示例使用
getApplicationContext()
。由于这可能不适合所有实现,因此可能需要进行一些定制(具体取决于集成情况)。
import android.os.Bundle;import androidx.appcompat.app.AppCompatActivity;import com.unity3d.ads.example.R;import com.unity3d.ads.IUnityAdsInitializationListener;import com.unity3d.ads.UnityAds;public class InitializeAdsScript extends AppCompatActivity implements IUnityAdsInitializationListener { private String unityGameID = "1234567"; private Boolean testMode = true; @Override protected void onCreate (Bundle savedInstanceState) { super.onCreate (savedInstanceState); setContentView (R.layout.activity_main); // Initialize the SDK: UnityAds.initialize(getApplicationContext(), unityGameID, testMode, this); } @Override public void onInitializationComplete() { } @Override public void onInitializationFailed(UnityAds.UnityAdsInitializationError error, String message) { }}
对于
initialize
函数,
context
参数是当前的 Android
Context
unityGameID
参数是位于 Monetization(变现)后台中的项目的 Unity Game ID(Unity 游戏 ID),具体而言,此 ID 位于项目的 Settings(设置)页面中。
IUnityAdsInitializationListener
是初始化调用结果的监听器。
true
布尔值表示游戏处于测试模式,只会展示测试广告。
注意
必须在监听器接口中实现每个回调方法(即使目前它们是空函数)。在以下各部分中需要的地方,使用适当的逻辑填充这些方法。如需了解每个监听器回调方法的更多信息,请参阅有关
IUnityAdsInitializationListener
API 的文档。
后续步骤:请参阅关于在 Android 中实现插页式广告的文档以继续您的集成。