# 广告接口

# 1、设置全局回调

TIP

参考接入准备文档中设置全局回调章节。

# 2、广告是否就绪

注意

播放广告前需要调用此接口获取广告状态,SDK会加载广告物料,请务必接入。

加载回调返回:

  • DHSDKConst.RET_OK:可调用播放广告接口
  • DHSDKConst.RET_FAIL:加载失败或其他,等一会儿再调用广告是否就绪
import com.dh.DHSDKHelper;
import com.dh.callback.IDHSDKCallback;

/**
 * @param activity    上下文
 * @param adUnitId    广告位ID,发行若未告知,此处传零即可
 * @param adType      广告类型,1 : 激励广告,2 : 全屏广告
 * @param sdkCallback 回调对象
 */
DHSDKHelper.getInstance().getAd().couldPlayAd(activity, adUnitId, adType, sdkCallback);

全局回调对象示例如下:

public class DHSDKCallback implements IDHSDKCallback {
    @Override
    public void onDHSDKResult(int requestCode, int resultCode, String resultData) {
        switch (requestCode) {
            case DHSDKConst.REQ_AD_READY:
                // 广告就绪结果
                // resultData:返回数据是文字提示
                if (resultCode == DHSDKConst.RET_OK) {
                    // 广告就绪成功
                } else if (resultCode == DHSDKConst.RET_FAIL) {
                    // 广告就绪失败
                }
                break;
            default:
                // 其他结果
                break;
        }
    }
}

# 3、执行播放广告

注意

播放广告后无论是否成功,下次播放前需重新再调用广告是否就绪以重新加载物料。

播放回调返回:

  • DHSDKConst.RET_OK:广告播放成功
  • DHSDKConst.RET_FAIL:播放失败或取消
import com.dh.DHSDKHelper;
import com.dh.callback.IDHSDKCallback;

/**
 * @param activity    上下文
 * @param adUnitId    广告位ID,发行若未告知,此处传零即可
 * @param adType      广告类型,1 : 激励广告,2 : 全屏广告
 * @param sdkCallback 回调对象
 */
DHSDKHelper.getInstance().getAd().playAd(activity, adUnitId, adType, sdkCallback);

全局回调对象示例如下:

public class DHSDKCallback implements IDHSDKCallback {
    @Override
    public void onDHSDKResult(int requestCode, int resultCode, String resultData) {
        switch (requestCode) {
            case DHSDKConst.REQ_AD:
                // 广告播放结果
                // resultData:返回数据是文字提示
                if (resultCode == DHSDKConst.RET_OK) {
                    // 广告播放成功
                } else if (resultCode == DHSDKConst.RET_FAIL) {
                    // 广告播放失败
                }
                break;
            default:
                // 其他结果
                break;
        }
    }
}
Last Updated: 2024/11/26 17:00:57