普通小游戏开发
API
开放能力
数据分析
视频拍摄器
多端支持

tt.navigateToVideoView

基础库版本 1.40.0 开始支持本方法

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

语法

tt.navigateToVideoView(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
videoIdstring-tt.shareAppMessage分享视频成功后返回1.40.0
successfunction接口调用成功回调函数1.40.0
failfunction接口调用失败回调函数1.40.0
completefunction接口调用结束的回调函数(调用成功、失败都会执行)1.40.0

回调成功

Object 类型,属性如下:

参数参数类型说明
errMsgstring跳转成功信息,恒为'navigateToVideoView:ok'

回调失败

Object 类型, 属性如下:

参数参数类型说明
errMsgstring跳转失败信息,以'navigateToVideoView:fail'开头
errCodenumber错误代码

errCode 的可枚举值:

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

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

tt.shareAppMessage({
  channel: "video",
  title: "测试分享视频",
  desc: "测试描述",
  imageUrl: "",
  templateId: "", // 替换成通过审核的分享ID
  query: "",
  extra: {
    videoPath: "ttfile://temp/test.mp4", // 可替换成录屏得到的视频地址
    videoTopics: ["话题1", "话题2"],
    withVideoId: true,
  },
  success(res) {
    console.log(res.videoId);
    console.log("分享视频成功");
  },
  fail(e) {
    console.log("分享视频失败");
  },
});

tt.navigateToVideoView({
  videoId: "xxxxxx",
  success: (res) => {
    console.log("done");
  },
  fail: (err) => {
    if (err.errCode === 1006) {
      tt.showToast({
        title: "something wrong with your network",
      });
    }
  },
});

Bug & Tip

  • Tip:在 IOS 下的横屏模式小游戏,目前不支持跳转
点击纠错
评价此篇文档