340 字
2 分钟
YouTube 视频
Shirone 支持嵌入 YouTube 视频,遵循严格的 Facade 占位与预加载控制规范。
语法格式
使用 ::youtube 指令并配置参数:
::youtube{id="5gIf0_xpFPI" title="YouTube 演示视频" preload="auto"}渲染效果:
属性参数列表
| 属性名 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
id | string | 必填 | 无 | YouTube 视频链接中的 11 位唯一 ID |
title | string | 必填 | 无 | 视频标题描述 |
preload | string | 可选 | "none" | 预加载策略:"none"(默认)或 "auto"(视口临近预热) |
视频 ID 就是观看链接 https://www.youtube.com/watch?v=xxxxxxxxxxx 中 v= 后面的部分,也等同于短链 https://youtu.be/xxxxxxxxxxx 的路径段。
预加载与隐私策略
preload="none":未点击前不下载 YouTube 播放器脚本与第三方 Cookie。preload="auto":临近视口时提前加载容器占位,提高点击后的响应速度。
::youtube{id="5gIf0_xpFPI" title="默认占位模式"}渲染效果(默认 none):
与 Bilibili 嵌入的差异
| 对比项 | ::bilibili | ::youtube |
|---|---|---|
| 必填标识 | bvid | id |
| 分 P 支持 | 有(p 参数) | 无 |
| 默认预加载 | none | none |
| 点击前的外部请求 | 0 | 0 |
两个平台共用同一套 16:9 响应式容器,因此混排时卡片高度完全一致,不会破坏文章节奏。
Markdown 语法
已完结分享文章
生成精美分享图或复制链接,与更多人分享本文。
继续阅读
换条路线
从其他文章中稳定抽取
最后更新于 ,距今已过 3 天
部分内容可能已过时
评论