火山引擎视频点播提供开源 Demo VEVodDemo-android，包含常见播放场景的完整源码。在集成点播 SDK 之前，建议您先参照本文跑通 Demo，体验点播 SDK 的功能。

Demo 介绍

播放场景

开源 Demo 中实现了以下播放场景：

• 短剧：每集时长从几十秒到 15 分钟左右，内容一般是连续和完整的故事情节，采用竖屏沉浸式全屏播放样式。用户可通过上下滑动切换剧集，也可通过点击集数切换到到指定剧集。
• 短视频：类似于抖音的场景，一屏只展示一个视频，用户可通过上下滑动来切换浏览不同的短视频内容。
• 中视频：类似于西瓜视频横屏播放的场景，Feed 流中同时存在 2 个以上的视频，用户可以快速滑动浏览多个视频，每次滑动可能划过多个视频。
• 长视频：提供沉浸式的全屏播放场景和播放页场景，适用于播放影视、综艺等长时间的视频内容。

目录结构

开源 Demo 对点播 SDK 进行了封装，抽象出播放控件层框架，以提供基础的播放功能。在播放控件层的基础上，根据常见播放场景的需求，提供场景控件层。您可以根据自身的业务需求，轻松地集成和使用这些控件层。开源 Demo 的具体目录结构如下：

|--VEVodDemo-android
|--|--app               // 主 app （壳工程）
|--|--vod-demo-api      // vod-demo 模块与壳工程交互接口（组件化）
|--|--vod-demo          // 业务层 demo 核心实现
|--|--vod-scenekit      // 场景控件层
|--|--vod-playerkit     // 播放控件层
|--|--vod-settingskit   // 播放设置模块

Demo 体验

请前往 Demo 体验页面，扫描二维码安装体验。

开发环境要求

• 安装 Android Studio，建议使用最新版本。
• Android 版本 5.0（API 级别 21）及以上。
• 仅支持 armv7 或 arm64 架构的设备。

前提条件

• 已注册火山引擎账号，并完成实名认证。
• 已开通视频点播服务。
• 在视频点播控制台完成以下操作：
  • 创建应用并获取应用 ID。具体步骤请见创建应用。
  • 购买测试版 License、绑定 License 与应用并下载 License 文件至本地。具体步骤请见 License 包管理。

操作步骤

1. 在终端中运行以下命令克隆仓库到本地，并进入项目文件夹：

   git clone https://github.com/volcengine/VEVodDemo-android.git
   cd VEVodDemo-android
   

2. 将下载至本地的 License 文件放置于 /VEVodDemo-android/app/src/main/assets 文件夹中。

3. 在 /VEVodDemo-android/app/src/main/java/com/bytedance/volc/voddemo/App.java 文件中，修改 APP_ID 和 LICENSE_URI 的值。

   public class App extends Application {
      // 替换成您在视频点播控制台中复制的应用 ID
      private static final String APP_ID = "your app id";
      // 替换成实际的 License 文件路径
      // 比如：VEVodDemo-android/app/assets/vod.lic 路径的 assets uri 应为 assets//:/vod.lic
      private static final String LICENSE_URI = "your license assets uri";
      // ... 
   }
   

4. 在 app/build.gradle 文件中，修改 applicationId 的值，确保与您在点播控制台创建应用时填写的 Package Name 保持一致。

   defaultConfig {
       applicationId "com.bytedance.volc.voddemo"
   }
   

5. 在 Android Studio 打开 VEVodDemo-android 文件夹，在顶部菜单栏中，单击 Sync Project with Gradle Files 按钮，更新 Gradle 配置。

6. 单击 Run 按钮，编译并运行项目。运行后，将在您的 Android 设备上自动打开如下界面。
   

后续集成方式

火山引擎提供点播 SDK、播放控件层、场景控件层三种方式实现播放场景。您可根据具体情况灵活选择适合自己的集成方式：

• 对于成熟的视频业务，您可复用已有业务层代码，直接集成点播 SDK，更换播放内核，以最小的改动来实现迁移。
• 对于全新的视频业务，建议接入播放控件层或场景控件层，快速搭建短、中、长视频的播放场景。