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

无