tt.navigateToVideoView
基础库 1.48.1 开始支持本方法，这是一个异步方法。
跳转到被分享视频的播放页面。
语法
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 | 客户端参数错误 |
扫码体验
请使用字节宿主APP扫码
代码示例
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：如果跳转后不能播放，请检查视频是否缺少公开访问权限，或账号是否被设为了抖音私密账号。
点击纠错
该文档是否对你的开发有所帮助？
有帮助
没帮助
该文档是否对你的开发有所帮助？
有帮助
没帮助