抖音开放平台Logo
开发者文档
控制台

获取抖音视频信息

收藏
我的收藏

一、能力概况

开发者可使用此能力,在自己的小游戏内获取通过拍视频能力发布的视频信息,并在小游戏中做成排行榜/视频展示列表等的样式。点击播放后可以调起抖音原生播放器播放该视频。

二、宿主支持

目前仅支持抖音。

三、示例

使用过该小游戏发布的视频或用户在小游戏中形成一个排行榜/展示列表。点击用户头像/视频即可跳转到该用户发布的视频页面。

四、接入方法

获取 videoID

videoId 可在tt.shareAppMessage的 success 中获取。

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,就可以实现在小游戏中跳转到相应视频播放页面。

注:只能跳转到「在当前小游戏中使用拍摄器拍摄分享的视频」

t.navigateToVideoView({ videoId: "xxxxxx", success: (res) => { /* res结构: {errMsg: string } */ console.log("done") }, fail: (err) => { if (err.errCode === 1006) { tt.showToast({ title: "something wrong with your network", }) } }, })

获取视频点赞数、封面图

只需要修改 videoID,别的都按示例写即可,传入 videoID 就会输出相应数据

tt.request({ url: "https://gate.snssdk.com/developer/api/get_video_info", method: "POST", data: { alias_ids: ["[YOUR videoId]"], }, success: (res) => { // 从res中获取所需视频信息(videoId数组索引与返回数据数组索引一一对应) }, }) /*返回示例 [ { "alias_id": "xxxxxx", "video_info": { "digg_count": 0, "cover_url": "https://xxxx.jpeg", "AID": 1128 } } ] */

返回

名称

数据类型

描述

VideoData

Array[Object]

get_video_info 成功后返回的对象

VideoData

名称

数据类型

描述

alias_id

number

对应的 videoId

video_info

Object

视频信息

video_info

名称

数据类型

描述

digg_count

number

点赞数

cover_url

Object

视频封面图

AID

number

宿主端标识符,1128(抖音),1112(抖音火山),13(头条)

该文档是否有帮助?