tt.navigateToVideoView

我的收藏

基础库 1.48.1 开始支持本方法，这是一个异步方法。

警告

此接口将逐步废弃，请切换使用button(open-type=navigateToVideoView)。请及时修改下线，避免影响小程序使用

跳转到被分享视频的播放页面。

语法

tt.navigateToVideoView(options)

参数说明

options 为 object 类型，属性如下：

属性名	类型	默认值	必填	说明	最低支持版本
videoId	string		否	被分享视频的 id。开发者通过指定Page.onShareAppMessage 中返回值的 `extra.withVideoId` 字段为 `true`，就可在用户分享成功的回调参数中获取到视频的 id。详情请参考 onShareAppMessage - “拓展参数 extra 说明”部分及下方代码示例	1.48.1
encryptedId	string		否	加密后的抖音开放平台的视频 id	2.18.0
success	function		否	接口调用成功回调函数	1.48.1
fail	function		否	接口调用失败回调函数	1.48.1
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）	1.48.1

回调成功

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	跳转成功信息，恒为`'navigateToVideoView:ok'`	1.48.1

回调失败

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	跳转失败信息，以`'navigateToVideoView:fail'`开头	1.48.1
errCode	number	错误代码	1.48.1

errCode 的可枚举值：

值	描述
1001	videoId 类型不正确
1002	视频已经被删除
1003	videoId 不正确
1004	获取视频信息错误
1005	其他错误
1006	网络错误
1007	客户端其他错误
1008	客户端参数错误

扫码体验

代码示例

开发者工具中预览

Page({ 
  onShareAppMessage: function () {
    return {
      channel: "video",
      title: "分享标题",
      desc: "分享描述",
      extra: {
        videoTopics: ["hello", "hi"],
        withVideoId: true,
      },
      success(res) {
        // 分享成功后，通过 videoId 跳转到被分享视频的播放页面
        tt.navigateToVideoView({
          videoId: res.videoId,
          success() {
            console.log("跳转被分享视频播放页成功");
          },
          fail(err) {
            console.log("跳转被分享视频播放页失败", err.errMsg, err.errCode);
          },
          complete() {
            console.log("navigateToVideoView 调用完成");
          },
        });
      },
    };
  },
});

Bug & Tip

•

Tip：encryptedId 和 videoId 两者只需要传一个，当两个都传时，会按照 encryptedId 处理；

•

Tip：如果跳转后不能播放，请检查视频是否缺少公开访问权限，或账号是否被设为了抖音私密账号。

tt.navigateToVideoView

​语法​

​参数说明​

​回调成功​

​回调失败​

​扫码体验​

​代码示例​

​Bug & Tip​