SDK接口说明
2.1 获取Sdk实例方法
ULUAdsSDKManage.getInstance().xxxxx;
2.2 Sdk初始化接口(必接)
首先,您需要在程序开始的地方通过调用init方法初始化广告SDK。 在初始化失败的状态下,游戏 不应 继续调用SDK的其余API,此方法必须在UI线程中调用。 游戏启动后,除初始化失败或异常情况下, 不允许多次调用初始化接口 。
2.2.1 方法定义
void init(Activity activity, String gameId, ULURewardedAdCallback uluRewardedAdCallback)
2.2.2 参数说明
参数 | 说明 |
---|---|
activity | 游戏的Activity对象,不可为null。 |
gameId | 游戏gameId,请参考参数表 |
ULURewardedAdCallbackWithRewardInfo | 初始化成功回调:onAdInitSuccess 初始化失败回调:onAdInitFailed,返回参数:erroMsg(错误信息) 广告加载完成回调:onRewardedAdLoaded 广告加载失败回调:onRewardedAdFailedToLoad,返回参数:erroMsg(错误信息) 用户打开广告回调:onRewardedAdOpened 用户关闭广告回调:onRewardedAdClosed 用户获得广告奖励回调: onUserEarnedReward 广告播放失败回调: onRewardedAdFailedToShow,返回参数:erroMsg(错误信息) 广告播放结束回调: onRewardedVideoAdPlayEnd 用户点击广告内容回调: onRewardedVideoAdPlayClicked |
2.2.3 代码示例
String gameId="1"; //参数请查阅项目参数表-游戏ID
ULUAdsSDKManage.getInstance().init(MainActivity.this, gameId, new ULURewardedAdCallbackWithRewardInfo() {
@Override
public void onAdInitSuccess() {
//广告 SDK 初始化成功
}
@Override
public void onAdInitFailed(String errMsg) {
//广告 SDK 初始化失败,请重新初始化
}
@Override
public void onRewardedAdLoaded() {
//广告加载完成回调
//建议游戏在广告加载完成前将广告按钮设置为不可用;
}
@Override
public void onRewardedAdFailedToLoad(String error) {
//广告加载失败回调,禁止在此回调中执行广告的加载方法进行重试,否则过多无用请求可能导致应用卡顿
}
@Override
public void onRewardedAdOpened() {
//用户打开广告回调
}
@Override
public void onRewardedAdClosed() {
//用户关闭广告回调,此时会自动加载广告并在加载完成后
//回调加载完成,开发需要在加载完成前将广告播放按钮置灰
}
@Override
public void onUserEarnedReward(String type, String amount, Object extra) {
//用户获得广告奖励回调,请在此回调中处理用户奖励逻辑
//一般情况下type为种类 amount为数量 extra为额外参数,仅在前两个参数无法满足需求时使用,一般不处理extra
}
@Override
public void onRewardedAdFailedToShow(String error) {
//广告播放失败回调
}
@Override
public void onRewardedVideoAdPlayEnd() {
//广告播放结束回调
}
@Override
public void onRewardedVideoAdPlayClicked() {
//用户点击广告内容回调
}
});
2.3 加载广告(必接)
请务必在初始化成功后再调用此接口,必须在UI线程中调用。
2.3.1 方法定义
void loadRewardedAd(String placement)
2.3.2 参数说明
参数 | 说明 |
---|---|
placement | 广告ID,注意不同渠道的广告ID不相同,请自行根据渠道区分 |
2.3.3 代码示例
ULUAdsSDKManage.getInstance().loadRewardedAd(uluAdId);
2.4 显示广告(必接)
请务必在广告加载完成后崽调用此接口,必须在UI线程中调用。
2.4.1 方法定义
void showRewardedVideo()
2.4.2 代码示例
ULUAdsSDKManage.getInstance().showRewardedVideo();
2.5 自检接口,游戏正式上线时关闭(选接)
2.5.1 方法定义
void testSuite()
2.5.2 代码示例
ULUAdsSDKManage.getInstance().testSuite();