龙图安卓SDK 穿山甲广告功能接入说明

SDK说明

接入龙图安卓SDK的游戏及应用的android客户端开发者。
使用此文档内接口,需要先接入龙图安卓SDK。

SDK配置说明

1 接入龙图安卓SDK后,需要配置穿山甲 SDK需要的依赖库。
将 LTBytedanceLibrary/libs目录下的jar 和 aar 复制到你的工程的
Application Module/libs文件夹(没有的话须手动创建)

2 需要删除龙图base内的LongTuApplication-release-{version}.aar

3 添加穿山甲广告参数,配置到 AndroidManifest.xml 内 meta-data 参数
参数需要找运营同学获取

参考SDK/LTBytedanceLibrary/AndroidManifest.xml 文件

参数key 参数说明 是否必选 获取方式
LTBytedanceAppID 穿山甲平台申请的appID 必选 运营提供
LTBytedanceAppName 穿山甲后台配置的应用名称 必选 运营提供

1.0 设置视频激励回调

此接口需要在龙图SDK 初始化以后调用。
设置视频激励回调,在回调内处理视频播放结果

1.0.1 接口介绍

  1. /**
  2. * 视频激励回调
  3. */
  4. LTBytedance.getInstance().setLTBytedanceAdListener(mLTBytedanceAdListener);

1.0.2 功能回调说明

接收到的数据为激励视频 播放结果。

接口 接口说明
onLoadAdError 视频加载错误
onLoadAdComplete 视频加载完成,可以播放
onAdShowStart 视频开始播放
onAdVideoBarClick 用户点击了广告上的下载链接
onAdClose 激励视频视频关闭,用户点击视频上的关闭按钮
onVideoError 视频播放错误
onRewardVerify 激励视频发放奖励,奖励信息运营配置到广告后台。视频播放奖励验证回调,奖励将在播放到%90的时候触发。这个时候视频并没有关闭,关闭广告视频需要由玩家手动点击触发。
  1. /**
  2. * 视频激励回调
  3. */
  4. private LTBytedanceAdListener mLTBytedanceAdListener = new LTBytedanceAdListener() {
  5. @Override
  6. public void onLoadAdError(int code, String message) {
  7. Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "视频加载错误code:" + code + " " + message, Toast.LENGTH_LONG).show();
  8. }
  9. @Override
  10. public void onLoadAdComplete() {
  11. Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "视频加载完成", Toast.LENGTH_LONG).show();
  12. }
  13. @Override
  14. public void onAdShowStart() {
  15. Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "视频开始播放", Toast.LENGTH_LONG).show();
  16. }
  17. @Override
  18. public void onAdVideoBarClick() {
  19. Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "点击了广告上的下载", Toast.LENGTH_LONG).show();
  20. }
  21. @Override
  22. public void onAdClose() {
  23. Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "视频关闭", Toast.LENGTH_LONG).show();
  24. }
  25. @Override
  26. public void onVideoError() {
  27. Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "视频播放错误", Toast.LENGTH_LONG).show();
  28. }
  29. @Override
  30. public void onRewardVerify(boolean rewardVerify, int rewardAmount, String rewardName, int code, String msg) {
  31. Toast.makeText(LTBase_Demo_MainActivity.mMainActivity, "奖励发放:" + rewardVerify + " 数量:"
  32. + rewardAmount + " 名字:" + rewardName, Toast.LENGTH_LONG).show();
  33. }
  34. };

1.1 加载视频广告

1.1.1 功能介绍

缓存激励视频,研发可以先缓存一份广告,用于加速视频播放。

1.1.2 接口使用说明

  1. /**
  2. * 视频激励广告 加载
  3. *
  4. *@param activity 当前activity实列
  5. * @param adid 穿山甲平台创建的代码位ID
  6. * @param MediaExtra 用户透传信息 (预留参数,暂时没有作用)
  7. */
  8. public void LTLoadRewardAd(Activity activity, String adid, String MediaExtra);

1.1.3 接口使用说明

  1. /**
  2. *
  3. * 视频激励广告 加载
  4. * @param activity 当前activity实列
  5. * @param adid 穿山甲平台创建的代码位ID
  6. * @param MediaExtra 用户透传信息(预留参数,暂时没有作用)
  7. */
  8. LTBytedance.getInstance().LTLoadRewardAd(this, "视频广告id", "研发透传信息");

1.2 播放视频激励广告

1.2.1 功能介绍

视频上次加载完成广告。

1.2.2 接口使用说明

  1. /**
  2. * 播放视频激励广告
  3. * @param Activity 当前activity实列
  4. */
  5. public void LTShowRewardAd(Activity activity)

1.2.3 接口使用说明

  1. /**
  2. * 播放视频激励广告
  3. * @param Activity 当前activity实列
  4. */
  5. LTBytedance.getInstance().LTShowRewardAd(this);

1.3 视频加载并播放

1.3.1 功能介绍

调用此接口后视频先加载,加载完成以后自动播放。

1.3.2 接口使用说明

  1. /**
  2. * 视频激励广告 加载并播放
  3. * @param activity 当前activity实列
  4. * @param codeid 穿山甲平台创建的代码位ID
  5. * @param MediaExtra 用户透传信息(预留参数,暂时没有作用)
  6. */
  7. public void LTLoadAndShowRewardAd(Activity activity, String codeid, String MediaExtra) {

1.3.3 接口使用说明

  1. /**
  2. * 视频激励广告 加载并播放
  3. * @param activity 当前activity实列
  4. * @param codeid 穿山甲平台创建的代码位ID
  5. * @param MediaExtra 用户透传信息 (预留参数,暂时没有作用)
  6. */
  7. LTBytedance.getInstance().LTLoadAndShowRewardAd(this, "视频广告id", "研发透传信息");