保利威文档中心

帮助中心

2-快速集成

更新时间:2026-06-15 14:33:49

1 账号准备

在集成播放器 SDK 项目之前,请先在Polyv 官网注册账号,并开通云点播服务。

为了播放您账号下的点播视频,播放器需要完成点播账号鉴权。基础接入可使用点播系统中的userId等账号参数,您可以登录点播后台,在API 接口中获取。

出于安全考虑,不建议将secretKey明文写入客户端代码或 APP 配置文件。生产环境更建议将secretKey保存在您的服务端,由服务端生成播放或下载所需的 token 后下发给客户端。播放场景请参考4-加密视频版权保护中的“配置传入token”,下载场景请参考5-视频下载中的“自定义传入token”。

2 环境要求

名称 要求
minSdkVersion 21 (Android 5.0)
abiFilters arm64-v8a、armeabi-v7a、armeabi、x86_64、x86

3 集成播放器项目

3.1 导入通用模块(必须)

拷贝 demo 项目中的common模块到您项目的根目录下,并修改项目的settings.gradle文件,添加对 common 模块的引用:

include(":common")

3.2 导入长视频场景模块(可选)

拷贝 demo 项目中的scenes-single-video模块到您项目的根目录下,并修改项目的settings.gradle文件,添加对长视频场景模块的引用:

include(":scenes-single-video")

3.3 导入短视频场景模块(可选)

拷贝 demo 项目中的scenes-feed-video模块到您项目的根目录下,并修改项目的settings.gradle文件,添加对短视频场景模块的引用:

include(":scenes-feed-video")

3.4 集成场景布局到页面当中

demo 模块中的activity文件夹下提供了场景布局的集成演示:

  • PLVMediaPlayerSingleVideoActivity 类演示了如何集成长视频场景的布局
  • PLVMediaPlayerFeedVideoActivity 类演示了如何集成短视频场景的布局

您可以参考这两个类的集成方式,将布局集成到您业务页面当中

3.5 配置maven仓库

播放器 SDK 存放在私有的仓库中,您需要在项目的settings.gradle文件(旧版本的 gradle 在build.gradle文件)中添加 maven 仓库的配置:

repositories {
    maven {
        credentials {
            username = "609cc5623a10edbf36da9615"
            password = "EbkbzTNHRJ=P"
        }
        url = uri("https://packages.aliyun.com/maven/repository/2102846-release-8EVsoM/")
    }
}

3.6 demo 参数修改

为了在 demo 项目中播放您账号下的视频,您需要对项目默认配置的参数进行修改。

demo 项目中,默认配置的视频数据在 mock 文件夹下的PLVMockMediaResourceData类当中,您可以对其中的参数进行修改:

  • mockAuthentication:配置账号信息
  • mockViewerParam:配置观看用户信息
  • setup():配置视频数据源
联系客服,在线咨询