备案控制台
文档
产品文档
输入文档关键字查找
首页 视频点播 开发参考 客户端SDK 播放器SDK 最佳实践 沉浸式短视频

沉浸式短视频

更新时间：
一键部署
产品详情
相关技术圈
我的收藏

您可以集成基于阿里云播放器SDK封装的UI组件，快速开发出顺滑的短视频流体验业务场景。本文为您介绍如何实现短视频良好播放体验的方法。

应用场景

短剧

适用于微短剧场景的最佳实践，具有集成简单、良好播放体验等特点，助力开发者快速搭建微短剧业务。推荐开发者参考微短剧模式（推荐）快速实现。

短视频

类似《淘宝视频》的UGC/PGC内容的播放场景，全屏展示竖版短视频，上下滑动切换视频内容。推荐开发者参考标准模式快速实现。若您对播放鉴权方式有特殊需求，可以参考性能模式实现。

体验Demo

平台

获取Demo

效果展示

Android

iOS

源码结构

平台

模块名称

模块说明

Android

AUIVideoList/AUIVideoListCommon

沉浸式播放公共模块

AUIVideoList/AUIVideoStandradList

沉浸式播放（标准）功能封装模块

AUIVideoList/AUIVideoFunctionList

沉浸式播放（性能）功能封装模块

AUIVideoList/AUIVideoEpisode

沉浸式播放（短剧）功能封装模块

iOS

AUIVideoListCommon/AUIVideoListCommon

公共组件代码

AUIVideoListCommon/AUIVideoFunctionList

沉浸式短视频性能组件代码

AUIVideoListCommon/AUIVideoStandradList

沉浸式短视频标准组件代码

AUIVideoListCommon/AUIShortEpisode

短剧组件代码

微短剧模式（推荐）

基于阿里云在微短剧场景的实践经验，AUI Kits针对微短剧场景进行业务封装，沉淀了音视频终端SDK的本地缓存、智能预加载等最佳实践，提供低代码集成套件，帮助集成方快速搭建微短剧App并获得更好的视听体验。

平台

集成文档

Android

Android端集成

iOS

iOS端集成

快应用

快应用集成

标准模式

标准模式使用AliListPlayer的方式实现短视频列表播放，结合内置预加载和本地缓存机制可以达到更好的体验。

特点与适用场景

适用于多个点播短视频源连续切换，并且同一时刻只有一个视频播放的场景。标准模式主要特点如下：

  • 适用于简单的业务封装，可以满足大部分的列表播放场景。

  • 内置预加载机制（预加载时长固定为1秒），控制预加载个数（最多5个）。

  • 内部只有一个播放器实例。

说明

标准模式使用限制如下：

  • AliListPlayer全局唯一，不支持创建多个。

  • 不支持长视频源、直播场景。

  • 如果需要播放HLS格式的视频，需要开启本地缓存。

  • 支持STS和URL方式播放，不支持Auth方式播放。

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);

iOS接口调用说明

  1. 引入播放View控件。

    #pragma mark -- AUIVideoStandradListView.h

AUIVideoStandradListView *mVideoStandardListView = [[AUIVideoStandradListView alloc] init];
[self.navigationController pushViewController:mVideoStandardListView animated:YES];

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

    #pragma mark -- AUIVideoStandradListView.h

// 添加数据源
// sources是数组，装载AUIVideoInfo类型的数据，具体类型可参考AUIVideoListCommon/Models/AUIVideoInfo.h文件
NSArray<AUIVideoInfo *> *sources = xxxx;
[mVideoStandardListView loadSources:sources];

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

    #pragma mark -- AUIVideoStandradListView.h

// 是否开启页面上的播放进度条，默认开启
[mVideoStandardListView showPlayProgressBar:YES];
// 是否开启页面上的播放标题展示文案，默认开启
[mVideoStandardListView showPlayTitleContent:YES];
// 是否开启屏幕上点击切换播放状态暂停/继续，默认开启
[mVideoStandardListView showPlayStatusTapChange:YES];
// 是否开启自动单个视频循环播放, 默认开启。需要在开启画面前调用。
[mVideoStandardListView openLoopPlay:YES];
// 是否开启自动切换到下一个播放。需要在openLoopPlay:关闭的基础上开启或关闭。默认关闭。需要在开启画面前调用。
[mVideoStandardListView autoPlayNext:YES];

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

    #pragma mark -- AUIVideoStandradScrollView.m

// 追加数据源
// sources是数组，装载AUIVideoInfo类型的数据，具体类型可参考AUIVideoListCommon/Models/AUIVideoInfo.h文件
NSArray<AUIVideoInfo *> *sources = xxxx;
[mVideoStandardListView addSources:sources];
    说明

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

    • 设置预加载个数。

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

      // 设置预加载个数。设置2时代表实际的预加载数为5条。
self.listPlayer.preloadCount = 2;

    • 开启本地缓存。

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

      #pragma mark -- AUIVideoListCommon/Models/AUIVideoCachePreloadTool.h

[AUIVideoCachePreloadTool setLocalCacheConfig];

#pragma mark -- AUIVideoStandradScrollView.m
// 建议在AliListPlayer起播前配置开启单实例缓存功能，防止HLS流因不开启单实例缓存无法播放问题
AVPConfig *config = [self.listPlayer getConfig];
config.enableLocalCache = true;
[self.listPlayer setConfig:config];

性能模式

性能模式使用多个播放器实例（AliPlayer）+ 预加载（MediaLoader）+ 预渲染的方式实现短视频列表播放，结合本地缓存可以达到更好体验。相比标准模式，性能模式支持播放器所有功能，更为灵活，功能更为强大。

特点与适用场景

适用于多个点播、直播视频源连续切换，并且同一时刻只有一个或多个视频播放的场景，以及点播+直播连续切换的场景。性能模式的主要特点如下：

  • 支持多个AliPlayer实例，弱网播放切换时更加顺滑。

  • 不限制播放方式和格式。

  • 支持预加载自定义策略，支持预渲染。

说明

完整的实现逻辑及代码请参见Demo，下文仅对关键节点作出说明详解。

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.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);

iOS接口调用说明

  1. 引入播放View控件。

    #pragma mark -- AUIVideoFunctionListView.h

AUIVideoFunctionListView *mVideoFunctionListView = [[AUIVideoFunctionListView alloc] init];
[self.navigationController pushViewController:mVideoFunctionListView animated:YES];

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

    #pragma mark -- AUIVideoFunctionListView.h

// 添加数据源
// sources是数组，装载AUIVideoInfo类型的数据，具体类型可参考AUIVideoListCommon/Models/AUIVideoInfo.h文件
NSArray<AUIVideoInfo *> *sources = xxxx;
[mVideoFunctionListView loadSources:sources];

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

    #pragma mark -- AUIVideoFunctionListView.h

// 是否开启页面上的播放进度条，默认开启
[mVideoFunctionListView showPlayProgressBar:YES];
// 是否开启页面上的播放标题展示文案，默认开启
[mVideoFunctionListView showPlayTitleContent:YES];
// 是否开启屏幕上点击切换播放状态暂停/继续，默认开启
[mVideoFunctionListView showPlayStatusTapChange:YES];
// 是否开启自动单个视频循环播放, 默认开启。需要在开启画面前调用。
[mVideoFunctionListView openLoopPlay:YES];
// 是否开启自动切换到下一个播放。需要在openLoopPlay:关闭的基础上开启或关闭。默认关闭。需要在开启画面前调用。
[mVideoFunctionListView autoPlayNext:YES];
文档推荐
  • 本页导读 （1）
文档反馈