polyv-uniapp-vod-plugin-android: A Java repository from tomasky

本项目是针对保利威云点播的uni-app客户提供的打包工程，用于打包 uni-app 项目（包含云点播插件）的自定义基座，也可用于打正式包。使用该项目进行离线打包，可使你免受 uni-app 云打包的限制。支持在该工程的基础上添加其他uni-app插件。

开发环境

uni-app 开发环境：HBuilderX 2.8.0+

Android 开发环境：JDK 1.8+， AndroidStudio 3.0+

前提条件

保利威官网账号，需要在保利威视频云平台注册账号，并开通相关服务。

集成打包说明

通用插件集成云打包

购买插件，选择该插件绑定的项目。
在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
开发完毕后正式云打包

下载离线 SDK 包

本项目基于想正常运行，需先到 uni-app 的官网下载离线 SDK 包 —— 下载链接。

⚠️注意，SDK 包的与 HBuilderX 的版本一一对应，请根据你 HBuilderX 的版本下载对应的 SDK 包。本项目基于 v2.8.6 版本的 SDK 进行开发，建议不要使用跟该版本差异太大的版本。

将下载后的离线 SDK 包中的 SDK 文件夹放到当前项目的根目录下。

SDK 集成

为避免SDK更新导致的插件兼容问题，开发者应当根据集成的版本下载Android 离线SDK：https://nativesupport.dcloud.net.cn/AppDocs/download/android。

然后按照官方文档，更新 app/libs 下的对应sdk文件。

引入 App 资源

每个 uni-app 项目都有自己的应用标识，可在配置文件 mainfest.json 中的【基础配置】里看到。关于 AppID 的更多信息，详见 DCloud appid 用途/作用/使用说明。

生成本地打包 App 资源

打开 HBuilderX 项目，选择【发行】-【原生App-本地打包】-【生成本地打包App资源】。
拷贝 App 资源到插件工程

将该文件夹拷贝到工程的 app/src/main/assets/apps 路径下，确保该路径名称为你的 AppID文件夹
修改 app/src/main/assets/data/dcloud_control.xml 里面 app 节点的 appid 属性为你的 AppID。

Android 离线打包集成

由于 uni-app 的云端打包限制了每日免费打包的次数以及免费打包的包体的大小（超过40M每次打包需充值付费），使用离线打包的方式会更加自由、方便。

自定义基座

点击菜单栏【Build】-【Build Bundle(s) / APK(s)】-【Build Apk(s)】，将会在app/build/outputs/apk/debug 下生成 android_debug.apk 文件，这个就是自定义基座。

将生成的 android_debug.apk 文件放到 HBuilderX 项目下的 unpackage/debug 路径下，选择 HBuilderX 菜单栏【运行】-【运行到手机或模拟器】-【运行基座选择】-【自定义基座】。然后运行到对应的Android设备即可。

正式包

打开 app/build.gradle，修改【versionCode】和【versionName】为需要的版本号。

选择【Build】-【Generate Signed Bundle / APK...】，在弹窗中选择【APK】，点击 Next。

选择签名证书文件，如果没有请新建【Create New...】，按实际情况填写构建证书，相关信息和文件请保存下来，下一次打包迭代发版时也会用到。（如果证书不同，将会导致应用无法直接升级安装，需要卸载安装。）

按创建证书时填写的信息，输入Key的相关信息，点击Next，选择【release】，并将弹窗下方【Signature Version】一起勾选 V1 和 V2。点击Finish，将会生成正式包，位于 app/release/下。

项目配置

关于如何对 app 进行个性化配置，譬如 app 图标、app 名称、app 版本号、app 启动图等，uni-app 官方有详细的文档指导，见：Android 原生工程配置。

该项目还支持添加其他 uni-app 原生插件，添加方法详见 uni-app 官方的指引文档 Android 离线打包使用插件。

快速使用

播放器plv-player

播放器控件为 component，仅允许在 nvue 中声明使用。详细接口使用说明查看插件包里的README文档。

		<plv-player ref="vod" seekType=0 autoPlay=true disableScreenCAP=false rememberLastPosition=false @onPlayStatus="onPlayStatus" @onPlayError="onPlayError" @positionChange="positionChange" 
		style="background-color:#333333; height:300px;position:fixed; top:0px; left:0px; right:0px;">
		</plv-player>

//js方法，播放vid视频
setVid(){
  this.$refs.vod.setVid({
    vid:'c538856dde5bf6a7419dfeece53f83af_c',
    level:0
  },
  (ret) => {
    if (ret.errMsg != null) {
      uni.showToast({
        title: ret.errMsg,
        icon: "none"
      })
    }
  })
},

基本模块

通过 uni.requireNativePlugin("ModuleName") 获取 module ，就可以直接调用相关模块接口。目前有三个模块如下代码所示。其中ConfigModule用于点播的初始化，开发者必须在保利威官网注册以后，在点播后台获取到配置信息初始化，播放器才能正式使用。项目模块介绍和接口说明查看插件包里的README文档。

	var configModule = uni.requireNativePlugin("PLV-VodUniPlugin-ConfigModule")
	var infoModule = uni.requireNativePlugin("PLV-VodUniPlugin-InfoModule")
	var downloadModule = uni.requireNativePlugin("PLV-VodUniPlugin-DownloadModule")

//...
	configModule.setToken({
			'userid': '',
			'readtoken': '',
			'writetoken': '',
			'secretkey': ''
		},
		(ret) => {
			if (ret.isSuccess == true) {
				uni.showToast({
					title:'设置token成功',
					icon: "none"
				})
			} else {
				let errMsg = ret.errMsg;
				uni.showToast({
					title:'设置token失败：' + errMsg,
					icon: "none"
				})
			}
		})

tomasky/polyv-uniapp-vod-plugin-android