2.4 KiB
2.4 KiB
YouTube 页面 JSON 契约
源文件必须是 JSON 对象,并包含以下七个顶层模块。字段可增加,但不能删除顶层模块。
site
brand、pageTitle、description、searchPlaceholder、createLabel:非空字符串。currentUser:当前账号,包含name、handle、initial、colors和非负notifications。
navigation
primary、library:桌面导航数组,每项{label, icon, href},各最多 12 项。mobile:移动端导航数组,每项{label, icon},最多 6 项。footer:侧栏页脚文字。- 可用图标:
i-home、i-shorts、i-subscriptions、i-history、i-playlist、i-clock、i-like、i-user。
categories
items:1–20 个非空字符串;第一项默认激活。
videos
sectionTitle:视频区标题。items:1–30 条,id唯一。- 每项包含
title、channel、channelInitial、channelColors、category、views、time、visual、verified、description。 - 不填写
duration;页面不展示 JSON 预设时长,旧 JSON 中的该字段会被兼容忽略。 visual仅使用city、studio、food、mountain、code、science、music、travel。- 可选
media会替换缩略图和观看区:图片{type:"image", mediaUrl, alt?, pageUrl?};视频{type:"video", mediaUrl, posterUrl?, alt?, pageUrl?};网页{type:"webpage", pageUrl, title, description?, mediaUrl?, embed?}。URL 只接受http(s);图片和视频也允许对应的data:URL。横屏和竖屏视频在观看区内均按原比例居中完整显示。 metrics为{likes, comments},均为非负数字。
shorts
sectionTitle:Shorts 区标题。items:0–20 条,每项包含唯一id、title、views、visual。visual使用与视频相同的预制视觉类型。- Shorts 同样可设置上述可选
media。
subscriptions
title:侧栏标题。items:0–20 项,每项{name, handle, initial, colors}。
comments
titleSuffix、inputPlaceholder:非空字符串。items:0–40 项,每项包含唯一id、name、initial、colors、text、time、非负likes。
示例边界
assets/default-data.json只提供结构和演示内容,不是事实来源。- JSON 使用双引号,不允许注释、Markdown 围栏或尾逗号。