HTML ` 标签通过原生 duration 和 poster 属性即可标记视频时长与封面,浏览器和搜索引擎(如 Google)可直接识别;时长需监听 loadedmetadata 事件获取并转为 ISO 8601 格式(如 PT2M8.45S),封面须用 poster` 属性指定可访问静态图且尺寸匹配。

直接用 HTML `
时长:靠 loadedmetadata 事件 + duration 属性
视频时长不能硬编码在 HTML 中,必须等元数据加载完成才能获取。`
- 在 `
- 若需对外暴露为机器可读格式(如被 Google 视频搜索抓取),建议将时长转为 ISO 8601 持续时间格式(如 `PT2M8.45S`),并写入 `` 标签或 JSON-LD
- 不要依赖 `onloadeddata`——它触发更晚,且不保证元数据已就绪;`loadedmetadata` 才是标准时机
封面:用 poster 属性 + 尺寸匹配
`poster` 是唯一被广泛支持的封面声明方式,Google Search、Bing Video、iOS Safari 等均识别它:
- 直接写 `
- 图片宽高比应与 `
- 不支持自动截帧,必须手动提供静态图;若首帧内容重要,可用 FFmpeg 提前导出:`ffmpeg -i input.mp4 -ss 0 -vframes 1 cover.png`
增强结构化:补充 JSON-LD(可选但推荐)
对 SEO 更友好、也便于第三方平台解析,可在页面 `
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
` 或 `
` 底部添加轻量 JSON-LD:{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "视频标题",
"description": "视频简介",
"thumbnailUrl": "cover.jpg",
"contentUrl": "video.mp4",
"duration": "PT2M8.45S",
"uploadDate": "2026-08-20"
}
注意:`thumbnailUrl` 必须与 `poster` 值一致;`duration` 必须是 ISO 8601 格式,不能填数字或字符串 `"128.45"`;该脚本不参与播放逻辑,纯作语义声明。
避坑要点
- 别把 `poster` 写成 CSS `background-image`——搜索引擎无法识别,也不响应播放状态
- 避免 `poster` 图片跨域但缺失 `Access-Control-Allow-Origin` 头,Firefox 会静默失败
- 移动端 Safari 在 `preload="none"` 下可能跳过 `poster`,设为 `preload="metadata"` 更稳妥
- 表格中嵌入 `
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










