button 组件跳转视频播放页

收藏
我的收藏
基础库 2.92.0 开始支持本能力。支持小程序跳转到视频播放页,需要将 button 组件 open-type 的值设置为 navigateToVideoView。​
button 组件常规属性请参考button 按钮。​
跳转到视频播放页。​

属性说明​

属性名​
类型​
默认值​
必填​
说明​
最低支持版本​
open-type​
string​
是​
用于调用开放能力,此场景下需要设置为 "navigateToVideoView"​
2.92.0​
data-video-id​
string​
否​
跳转的视频id ​
2.92.0​
data-video-type ​
string ​
'share' ​
否 ​
跳转的视频类型,默认为'share'。当视频为互动任务相关视频时,应填'task' ​
2.96.0 ​
bindnavigatetovideoview​
EventHandle​
否​
监听跳转的回调​
2.92.0​

data-video-type的枚举值 ​

枚举值
说明
最低支持版本
share ​
表示跳转到分享的视频。data-video-id为用户分享成功的回调参数中获取到的视频 id。开发者通过指定Page.onShareAppMessage 中返回值的 extra.withVideoId 字段为 true,就可在用户分享成功的回调参数中获取到视频的 id。详情请参考 onShareAppMessage - “拓展参数 extra 说明”部分及下方代码示例 ​
2.96.0 ​
task ​
表示跳转到互动营销任务相关视频。data-video-id为抖音视频item_id,可以通过【创建视频任务】能力获取。使用该枚举值,需要至开发者后台-设置-关联设置-抖音号管理为对应的抖音号申请 短视频自主挂载 能力 ​
2.96.0 ​

bindnavigatetovideoview 事件对象的 detail​

object 类型,属性如下:​
属性名
类型
说明
最低支持版本
errMsg
string
错误描述
2.92.0
errNo
number
错误码
2.92.0

错误说明​

errNo
errMsg
说明
最低支持版本
20000
invalid params %s, code=%s
开发者参数错误
2.92.0
10401
host cannot open schema, schema = %s
打开schema失败
2.92.0
10301
feature is not supported in app
宿主未实现
2.92.0
10401
internal error, code=%s, msg=%s
内部错误
2.92.0
21508 ​
the video id not support ​
不支持的data-video-id,关联设置中抖音号未开通相关能力 ​
2.96.0 ​
21509 ​
the video id invalid​
data-video-id对应的视频不存在或已删除​
2.96.0 ​

回调成功​

Object 类型,属性如下:​
参数
参数类型
说明
errMsg
string
跳转成功信息,恒为'navigateToVideoView:ok'

回调失败​

Object 类型, 属性如下:​
参数
参数类型
说明
errMsg
string
跳转失败信息,以'navigateToVideoView:fail'开头​
errNo​
number
错误代码

扫码体验​

代码示例​

<button open-type="navigateToVideoView" data-video-id="{{videoId}}" bindnavigatetovideoview="eventHandler" > 跳转视频播放页 </button>
Page({ data: { videoId: "13104110592cxxxxxxxxxxxxxxxxxxxxx514641007a", }, eventHandler(e) { if (e.detail.errNo) { console.log("跳转视频播放页失败", e.detail); } else { console.log("跳转视频播放页成功"); } }, });

Bug & Tip​

无​