沉浸式短视频

Android端

源码说明

源码下载

下载地址请参见GitHub开源项目：沉浸式短视频性能模式（Android端）

源码结构

.
└── videoefunctionlist                                     # 根目录
    ├── AUIFunctionListPlayerActivity.java                 # 多实例页面
    ├── AUIVideoFunctionListController.java                # 多实例页面控制器
    ├── AUIVideoFunctionListView.java                      # 视频列表视图
    ├── adapter                                           
    │   ├── AUIVideoFunctionListAdapter.java               # 多实例面板适配器
    │   └── AUIVideoFunctionListLayoutManager.java         # 布局管理器
    └── player                                          
        ├── AliPlayerPool.java                             # 播放器池
        ├── AliPlayerPreload.java                          # 预加载
        └── AliyunRenderView.java                          # 视频渲染与播放

架构设计

编译运行

1. 接入已授权播放器的音视频终端SDK License。

   具体操作，请参见Android端接入License。

2. 将AUIVideoFunctionList模块，及其依赖的模块拷贝到您的项目工程中。

   工程地址：AUIVideoList

3. 修改您项目工程的引入方式。

   请根据您自身业务需求进行集成AUIVideoFunctionList等模块。

接口调用说明

1. 在播放界面布局的xml文件中引入沉浸式播放的View控件。

   <?xml version="1.0" encoding="utf-8"?>
   <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:app="http://schemas.android.com/apk/res-auto"
   xmlns:tools="http://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent">
   
   <com.alivc.player.videolist.auivideofunctionlist.AUIVideoFunctionListView
   android:id="@+id/aui_video_list_view"
   android:layout_width="match_parent"
   android:layout_height="match_parent" />
   
   </FrameLayout>

2. 在跳转播放View页面之前，调用如下示例代码添加数据源。

   AUIVideoFunctionListView mVideoFunctionListView = findViewById(R.id.aui_video_list_view);
   //清理并重新加载数据
   mVideoFunctionListView.loadSources(List<VideoInfo> list);
   //追加数据源
   mVideoFunctionListView.addSources(List<VideoInfo> list);

3. （可选）在跳转播放View页面之后，调用如下示例代码进行播放相关配置。

   //单视频循环播放
   mVideoFunctionListView.openLoopPlay(boolean enable);
   //视频播放完成后是否自动播放下一个视频（需要关闭循环播放）
   mVideoFunctionListView.autoPlayNext(boolean enable);
   //是否显示进度条
   mVideoFunctionListView.showPlayProgressBar(boolean enable);
   //是否显示播放标题展示文案
   mVideoFunctionListView.showPlayTitleContent(boolean enable);
   //是否开启屏幕上点击切换播放状态暂停/继续
   mVideoFunctionListView.showPlayStatusTapChange(boolean enable);

核心功能介绍

本地缓存

本地缓存可以提高短视频播放的加载速度和稳定性，使用户在网络不稳定或者断网的情况下依然能够流畅观看视频，提升用户的观看体验。更多信息，请参见本地缓存。

智能预加载

智能预加载可以提前加载视频数据，使视频播放更加流畅，减少加载等待时间，提升用户的观看体验。更多信息，请参见预加载。

智能预渲染

智能预渲染可以减少视频播放的启动延迟，让用户更快地看到画面，提升视频播放的加载速度和观看体验。更多信息，请参见预渲染。

HTTPDNS

HTTPDNS可以提供更快速和稳定的DNS解析服务，通过替换传统DNS解析，可以减少DNS解析时间，提高视频播放的加载速度和稳定性，从而提升用户的观看体验。更多信息，请参见HTTPDNS。

多实例播放器池

使用多个播放器实例，使上下滑切换更加流畅，减少加载等待时间，提升用户观看体验。

视频加密

音视频终端SDK和播放器SDK从6.8.0版本开始支持MP4私有加密播放能力。更多信息请参见阿里云视频加密（私有加密）。

经私有加密的MP4格式视频，需满足以下条件，才可正常播放：

1. 经私有加密的MP4视频传给播放器播放时，业务侧（App侧）需要为视频URL追加etavirp_nuyila=1，例如：原视频URL为https://example.aliyundoc.com/test.mp4，则需要传给播放器播放的视频URL为https://example.aliyundoc.com/test.mp4?etavirp_nuyila=1。

2. App的License对应的uid与产生私有加密MP4的uid是一致的。

如何校验私有加密视频是否正确，以私有加密的视频URL为例说明如下：

1. meta信息里面应带有AliyunPrivateKeyUri的tag。

2. ffplay不能直接播放。

防录屏

防录屏通过监听录屏和截屏行为及时阻断播放进程，有效保护视频内容的版权，防止未经授权的盗录和传播。

// Android特有功能，禁止App录屏和截屏
getWindow().setFlags(WindowManager.LayoutParams.FLAG_SECURE, WindowManager.LayoutParams.FLAG_SECURE);

Android接口调用说明

1. 在播放页面布局的XML文件中引入沉浸式播放View控件。

   <?xml version="1.0" encoding="utf-8"?>
   <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:app="http://schemas.android.com/apk/res-auto"
   xmlns:tools="http://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent">
   
   <com.alivc.player.videolist.auivideostandradlist.AUIVideoStandardListView
   android:id="@+id/aui_video_list_view"
   android:layout_width="match_parent"
   android:layout_height="match_parent" />
   
   </FrameLayout>

2. 跳转播放View页面之前，调用如下示例代码添加数据源。

   AUIVideoStandardListView mVideoStandardListView = findViewById(R.id.aui_video_list_view);
   //清理并重新加载数据
   mVideoStandardListView.loadSources(List<VideoInfo> list);
   //追加数据源
   mVideoStandardListView.addSources(List<VideoInfo> list);

3. （可选）在跳转播放View页面之后，调用如下示例代码进行播放相关配置。

   //单视频循环播放
   mVideoStandardListView.openLoopPlay(boolean enable);
   //视频播放完成后是否自动播放下一个视频（需要关闭循环播放）
   mVideoStandardListView.autoPlayNext(boolean enable);
   //是否显示进度条
   mVideoStandardListView.showPlayProgressBar(boolean enable);
   //是否显示播放标题展示文案
   mVideoStandardListView.showPlayTitleContent(boolean enable);
   //是否开启屏幕上点击切换播放状态暂停/继续
   mVideoStandardListView.showPlayStatusTapChange(boolean enable);

   说明

   您也可以按需进行如下配置：

   • 设置预加载个数。

     AliListPlayer在起播前可通过设置preloadCount值（默认值是2）修改预加载个数。具体计算实际的预加载数的规则是：1 + preloadCount * 2。示例代码如下：

     // 设置预加载个数。设置2时代表实际的预加载数为5条。
     mVideoStandardListView.setPreloadCount(int count);

   • 开启本地缓存。

     在播放起播前可以开启本地缓存功能。示例代码如下：

     /*
         enable -- 是否开启本地缓存
         path -- 本地缓存路径
     */
     mVideoStandardListView.enableLocalCache(boolean enable,String path);