短视频 News DCloud 5+原生插件接入文档

概述

本文档描述了 DCloud 5+app 和 wap2app 开发者如何集成 Video 原生插件（后面简称为插件），通过集成插件引入类似抖音的短视频服务。

如果需要在视频流中展示广告，则需集成 AD 插件。本文档默认需要展示广告，展示广告可以创造收益。

CDN 加速域名配置请参考 CDN 加速域名配置文档。

术语介绍

AppId：应用 id，18位 hex 字符串。【注意】调试时请使用测试 appId：ba0063bfbc1a5ad878；外发版本请替换成正式 appId，否则不会产生收益。

UnitId：广告位 id，广告类型缩写后紧跟从1开始的编号，如开屏广告位 s1，激励视频广告位 rv1。

插件集成

DCloud 5+app 和 wap2app 接入5+原生插件扩展原生能力，不支持云端打包，仅支持本地离线打包。（请参考 DCloud 官方文档 https://nativesupport.dcloud.net.cn/AppDocs/README）

插件集成步骤如下：

  1. 将 videoSdk.js 拷贝到项目中，并在需要调用广告的文件中引入此文件；

videoSdk.js:

document.addEventListener("plusready", function() {
	plus.videoSdk = {
		setUserId : function (userId) {
			return plus.bridge.execSync("VideoSdk", "setUserId", [userId])
		},
		showDrawVideo : function (params) {
			return plus.bridge.execSync("VideoSdk", "showDrawVideo", [params.margins])
		},
		hideDrawVideo : function () {
			return plus.bridge.execSync("VideoSdk", "hideDrawVideo", [])
		},
		startDrawVideo : function () {
			return plus.bridge.execSync("VideoSdk", "startDrawVideo", [])
		}
	}
}, true)
  1. 前端页面接入短视频；
  2. 打开 demo 提供的原生代码框架，拷贝 HBuilderX 生成的本地打包 App 资源，进行本地离线打包。

插件初始化

初始化已在原生代码中完成，请参考插件集成。

登录时请设置 userId：

plus.videoSdk.setUserId("uid")

退出登录请重置 userId：

plus.videoSdk.setUserId(null)

视频流接入

方式一

显示视频流代码如下：

plus.videoSdk.showDrawVideo({
    margins: [0, 200, 0, 0] // [left, top, right, bottom]
})

隐藏视频流代码如下：

plus.videoSdk.hideDrawVideo()

方式二

跳转新打开的视频流页面代码如下：

plus.videoSdk.startDrawVideo()