新媒体时代，广告样式越来越丰富。相较于传统的图文信息，视频类广告更具有直观性，能够让消费者在了解产品知识和功能的同时加深对产品的印象。
因此在各类网站或 App 上投放视频类广告是个很好的宣传方式，但广告商们如果想在网站上展示视频广告，必须确保视频广告投放协议与发布渠道的播放器兼容；如果不能兼容，广告商或者视频广告投放平台必须创建不同的响应，来与特定视频播放器兼容。为此，互联网广告署（IAB）开发了视频广告投放模板 （VAST）这种 XML 模式，允许通过视频广告服务器提供流内视频广告，并在多个网站和设备上的视频播放器中播放，不仅解决兼容性问题，还提高了视频广告投放的效率和可扩展性。
为帮助广告商们更好投放广告，华为鲸鸿动能平台提供了HUAWEI VAST SDK的集成，目前仅支持符合 VAST 协议的线性广告（投放形式为前、中、后贴片广告）。
开发准备
集成 SDK
使用 VAST 协议时需要集成 HUAWEI VAST SDK。同时如果您需要使用默认的播放器，请集成 HUAWEI Player SDK。
配置 Maven 仓地址。
Android Studio 的代码库配置在 Gradle 插件 7.0 以下版本、7.0 版本和 7.1 及以上版本有所不同。请根据您当前的 Gradle 插件版本，选择对应的配置过程。
以 7.0 版本为例：
a) 打开 Android Studio 项目级“build.gradle”文件。
b) 添加 Maven 代码库。
在“buildscript > repositories”中配置 Maven 仓地址。
buildscript { repositories { google() jcenter() // 配置鲸鸿动能SDK的Maven仓地址 maven {url 'https://developer.huawei.com/repo/'} }}
复制代码
c) 打开项目级“settings.gradle”文件，配置 Maven 仓地址。
dependencyResolutionManagement { ... repositories { google() jcenter() // 配置鲸鸿动能SDK的Maven仓地址 maven {url 'https://developer.huawei.com/repo/'} }}
复制代码
配置网络权限
在 targetSdkVersion 28 及以上的手机上允许 HTTP(S)网络请求，在“AndroidManifest.xml”做以下配置。
<application ... android:usesCleartextTraffic="true" > ...</application>
复制代码
配置混淆脚本
您编译 APK 前需要配置混淆配置文件，避免混淆 HUAWEI VAST SDK 导致功能异常。
打开 Android 工程应用级根目录下的“proguard-rules.pro”混淆配置文件，加入排除 HUAWEI VAST SDK 的混淆配置。
-keep class com.huawei.openalliance.ad.** { *; }-keep class com.huawei.hms.ads.** { *; }
复制代码
初始化 SDK
初始化 HUAWEI VAST SDK
集成 HUAWEI VAST SDK 后，在应用的 DemoApplication 类中，初始化 HUAWEI VAST SDK。
// 当用户同意广告服务获取数据时，调用下面的方法SdkFactory.userAcceptAdLicense(true);
复制代码
开发步骤
实现 VAST 广告
使用默认播放器播放线性广告
播放线性广告可以使用默认的播放器，也可使用您实现的自定义播放器。
在 XML 文件中，初始化播放器的布局。示例代码如下：
<FrameLayout android:id="@+id/fl_linear_ad" android:layout_width="match_parent" android:layout_height="250dp" android:background="@android:color/black" android:visibility="gone" android:layout_alignParentEnd="true" android:layout_alignParentStart="true" android:layout_alignParentTop="true" />
复制代码
生成默认的广告播放控制器，注册线性广告视图。示例代码如下：
private void registerLinearAdView() { mLinearAdView = findViewById(R.id.fl_linear_ad); mProgressBar = findViewById(R.id.progress); VastAdPlayer.getInstance().registerLinearAdView(mLinearAdView, getController());}
private BaseVideoController getController() { return mAdConfig.isCustomVideoPlayer() ? new DefaultVideoController(this) : new CustomVideoController(this);}
复制代码
请求播放线性广告。示例代码如下：
VastAdPlayer.getInstance().startLinearAd(linearAdSlot, new AdsRequestListener() { @Override public void onSuccess(View view, int responseCode) { }
@Override public void onFailed(View view, int responseCode) { }
@Override public void playAdReady() { mLinearAdView.setVisibility(View.VISIBLE); }
@Override public void playAdFinish() { mLinearAdView.setVisibility(View.INVISIBLE); }
@Override public void onBufferStart() { mProgressBar.setVisibility(View.VISIBLE); }
@Override public void onBufferEnd() { mProgressBar.setVisibility(View.INVISIBLE); }});
复制代码
使用自定义播放器播放线性广告
在 XML 文件中，初始化播放器的布局。示例代码如下：
<FrameLayout android:id="@+id/fl_linear_ad" android:layout_width="match_parent" android:layout_height="250dp" android:background="@android:color/black" android:visibility="gone" android:layout_alignParentEnd="true" android:layout_alignParentStart="true" android:layout_alignParentTop="true" />
复制代码
实现自定义的广告播放器控制器。示例代码如下：
public class CustomVideoController extends BaseVideoController implements VastPlayerListener { public CustomVideoController(Context context) { this(context, null); } public CustomVideoController(Context context, AttributeSet attrs) { this(context, attrs, 0); } public CustomVideoController(Context context, AttributeSet attrs, int defStyleAttr) { super(context, attrs, defStyleAttr); initView(); } @Override public int getLayoutId() { return R.layout.activity_video_player; } private void initView(){ ... }}
复制代码
生成自定义的广告播放器控制器，注册线性广告视图。示例代码如下：
private void registerLinearAdView() { mLinearAdView = findViewById(R.id.fl_linear_ad); mProgressBar = findViewById(R.id.progress); VastAdPlayer.getInstance().registerLinearAdView(mLinearAdView, getController());}
private BaseVideoController getController() { return mAdConfig.isCustomVideoPlayer() ? new DefaultVideoController(this) : new CustomVideoController(this);}
复制代码
请求播放线性广告。示例代码如下：
VastAdPlayer.getInstance().startLinearAd(linearAdSlot, new AdsRequestListener() { @Override public void onSuccess(View view, int responseCode) { } @Override public void onFailed(View view, int responseCode) { } @Override public void playAdReady() { mLinearAdView.setVisibility(View.VISIBLE); } @Override public void playAdFinish() { mLinearAdView.setVisibility(View.INVISIBLE); } @Override public void onBufferStart() { mProgressBar.setVisibility(View.VISIBLE); } @Override public void onBufferEnd() { mProgressBar.setVisibility(View.INVISIBLE); }});
复制代码
播放广告荚
广告荚的播放与线性广告的播放，只在使用自定义播放器请求播放广告步骤 4 中有区别，请求播放广告荚的示例代码如下：
VastAdPlayer.getInstance().startAdPods(linearAdSlot, new AdsRequestListener() { @Override public void onSuccess(View view, int responseCode) { } @Override public void onFailed(View view, int responseCode) { } @Override public void playAdReady() { mLinearAdView.setVisibility(View.VISIBLE); } @Override public void playAdFinish() { mLinearAdView.setVisibility(View.INVISIBLE); } @Override public void onBufferStart() { mProgressBar.setVisibility(View.VISIBLE); } @Override public void onBufferEnd() { mProgressBar.setVisibility(View.INVISIBLE); }});
复制代码
测试 VAST 广告
您需要使用专门的测试广告位 ID 来获取测试广告，以避免在测试过程中产生无效的广告点击量。测试广告位 ID，仅可用于调测广告功能，不可用于广告变现，在应用正式发布前需替换为正式的广告位 ID。您应在应用发布前先进入流量变现官网，点击“开始变现”，登录鲸鸿动能媒体服务平台，申请正式的广告位 ID 并替换测试广告位 ID，具体操作详情请参见展示位创建。以下表格中提供了 VAST 广告的专用测试广告位 ID：
下载 VAST 广告的示例代码并运行，可以看到如下效果图：
了解更多详情>>
访问华为开发者联盟官网
获取开发指导文档
华为移动服务开源仓库地址：GitHub、Gitee
关注我们，第一时间了解 HMS Core 最新技术资讯~
评论