关于android:投放视频广告时如何快速与第三方播放器兼容

新媒体时代，广告款式越来越丰盛。相较于传统的图文信息，视频类广告更具备直观性，可能让消费者在理解产品常识和性能的同时加深对产品的印象。

因而在各类网站或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 最新技术资讯~