1.下载模块集成
视频下载功能通过单独模块media-player-sdk-addon-download提供，需要添加对应依赖
implementation("net.polyv.android:media-player-sdk-addon-download:${version}")
2.视频下载
视频下载的管理类为PLVMediaDownloaderManager，可以通过该类执行视频的下载、暂停、删除等操作
2.1 初始化
在使用视频下载功能前，需要调用初始化方法PLVMediaDownloaderManager.init
/**
* 初始化，调用其他方法前必须调用初始化方法
*/
@JvmStatic
@JvmOverloads
fun init(
setting: PLVMediaDownloadSetting,
onFinish: () -> Unit,
onFailed: (Throwable) -> Unit
)
其中，可以通过setting参数配置下载的相关设置：
data class PLVMediaDownloadSetting @JvmOverloads constructor(
/**
* 下载视频存放的根目录
*
* SDK 不会主动申请写入权限，外部调用需要确保 APP 具有对应目录的写入权限
*/
val downloadRootDirectory: File,
/**
* 同时下载的任务数量限制
*/
val concurrentDownloads: Int = Int.MAX_VALUE,
/**
* 清晰度降级
*
* 无法下载指定的清晰度时，自动下载较低的清晰度
*/
val allowBitRateFallback: Boolean = true
)
2.2 开始下载
首先，通过PLVMediaDownloaderManager.getDownloader获取对应视频的下载器
/**
* 获取下载器
*
* @param mediaResource 视频资源
* @param bitRate 指定下载的清晰度，可以通过 [updateSetting] 配置没有对应清晰度时自动降级。
* 启用自动降级时可以通过 [IPLVMediaDownloaderListenerRegistry.downloadBitRate] 监听实际下载的清晰度。
*/
@JvmStatic
@JvmOverloads
fun getDownloader(
mediaResource: PLVMediaResource,
bitRate: PLVMediaBitRate = PLVMediaBitRate.BITRATE_AUTO
): PLVMediaDownloader
然后，调用PLVMediaDownloaderManager.startDownloader传入对应的下载器，即开始视频的下载
/**
* 开始下载
*/
@JvmStatic
fun startDownloader(downloader: PLVMediaDownloader)
2.3 状态监听
下载过程中的进度、视频信息、下载速度等状态可以通过下载器的回调中心PLVMediaDownloader.listenerRegistry监听
val downloader = PLVMediaDownloaderManager.getDownloader(...)
// 监听下载速度
downloader.listenerRegistry.downloadBytesPerSecond.observe { bytesPerSecond ->
// 业务操作
}
2.4 暂停、删除
视频下载的暂停和删除也是通过下载管理类PLVMediaDownloaderManager实现：
/**
* 暂停下载
*/
@JvmStatic
fun pauseDownloader(downloader: PLVMediaDownloader)
/**
* 删除已下载的视频文件
*/
@JvmStatic
fun deleteDownloadContent(downloader: PLVMediaDownloader)
3.播放离线视频
为了播放下载到本地的视频，需要在构造视频资源PLVMediaResource时，传入视频下载的根目录路径（即下载时配置的 PLVMediaDownloadSetting.downloadRootDirectory）
data class PLVVodMediaResource(
// ...
// 视频下载的路径
val localVideoSearchPaths: List<String>
)
播放器会在localVideoSearchPaths下搜索对应的离线视频，在已下载对应视频到本地的情况下优先播放本地视频。
4.点播SDK下载的视频兼容
播放器支持兼容播放点播SDK已下载完成的视频，但在播放之前，需要调用 PLVMediaDownloaderVodMigrate.migrate以确保播放器SDK能正常识别点播SDK下载的视频：
object PLVMediaDownloaderVodMigrate {
/**
* 兼容播放在点播 SDK 下载的视频
*
* 只支持已经下载完成的视频。SDK 不会主动申请写入权限，外部调用需要确保 APP 具有对应目录的写入权限。
*
* @param searchRoots 搜索下载视频的根目录
*/
@JvmStatic
@JvmOverloads
fun migrate(
searchRoots: List<String>,
onFinish: () -> Unit,
onFailed: (Throwable) -> Unit
)
}
其中，searchRoots参数为点播SDK下载时配置的下载根目录。
通过migrate方法兼容的点播下载，只能兼容已下载完成视频的播放。播放器SDK不会接管下载进度管理，您仍需在点播SDK进行下载管理、删除等操作。
5.自定义传入token
视频下载支持加密视频版权保护的自定义传入token方式，配置如下：
val downloader = PLVMediaDownloaderManager.getDownloader(...)
downloader.listenerRegistry.vodTokenRequestListener = object : IPLVVodMediaTokenRequestListener {
override fun onRequestToken(
mediaResource: PLVVodMediaResource,
callback: (PLVVodVideoTokenVO?) -> Unit
) {
// 通过网络请求，向您的服务器请求视频播放token
var token: PLVVodVideoTokenVO
// 将token返回给播放器
callback(token)
}
}
