A · 原生 video 标签
直接把访问地址写进 video 标签，代码最短、依赖最少。适合单段短视频、内部演示页与静态文档，缺点是播放器外观随浏览器而定，清晰度切换需要自己处理。
cos插入视频：把对象存储里的片子稳稳放进网页、文档与播放器
一段刚剪好的短片躺在存储桶里，文件名还带着导出时间戳。要让它在页面上真正播出来，中间要经过上传、转码、取链接、写嵌入代码这几道工序。本目录把 cos插入视频 的全流程拆成八个展区式条目：可播放地址的生成方式、四种嵌入路径的取舍、格式与参数对照、链接可见范围、移动端播放细节与故障排查，照着展签顺序走一遍，基本能让视频顺利落在页面上。
展区 01从文件到可播放地址：一条最短的工序线
展签说明
无论最终用哪种方式嵌入，视频都要先变成浏览器认得的一个地址。下面这条工序线适用于大多数对象存储场景，按顺序执行即可。
- 上传原片到存储桶选择与访问者地理位置较接近的地域，上传后记录对象键，例如 video/2026/demo-01.mp4。文件名尽量只用小写字母、数字与连字符，避免空格与中文导致链接转义出错。
- 设置对象的内容类型把 Content-Type 设为 video/mp4 或 video/webm。类型缺失时，部分浏览器会把它当作待下载文件，而不是边下边播的视频流。
- 按需转码源文件编码不一致时，先转成 H.264 + AAC 的 MP4，或切成 HLS 分片。前者兼容性最广，后者适合长视频与清晰度切换。
- 获取访问地址公开读的对象可直接拼出直链；私有桶需要签名 URL 或临时凭证。地址的域名、路径与参数三者都要完整保留。
- 写嵌入代码在页面里放入 video 标签或播放器初始化代码，把上一步的地址填进 src。若使用播放器库，还需补上容器元素与宽高比例。
- 校验播放效果分别用桌面浏览器与手机浏览器打开，确认能起播、能拖动进度条、音量与全屏按钮可用。
展区 02四种嵌入路径的取舍对照
B · 引入播放器脚本
页面只留一个容器，由播放器接管控件、海报图与多码率加载。适合需要统一样式与统计能力的站点，代价是多了外部依赖，脚本加载失败时要留好降级提示。
C · HLS 分片地址
把视频切成小的 TS 片段并提供索引文件，播放端按需拉取。适合时长较长或需要自适应清晰度的场景，通常配合支持 HLS 的播放器使用，原生兼容性因浏览器而异。
D · 画中画与外链分享
把播放地址交给协作方，或在支持画中画的浏览器里让视频悬浮播放。适合内部审片与素材分发，需要注意链接有效期与访问权限是否覆盖接收方。
选择顺序建议：先看播放时长与清晰度需求，再看是否需要统一视觉样式，最后考虑签到与统计等附加能力。路径越短，维护成本越低。
展区 03格式与参数展签
| 格式 | 编码组合 | 适用情形 |
|---|---|---|
| MP4 | H.264 + AAC | 兼容性最广，网页内嵌的首选，适合短视频与宣传片 |
| WebM | VP9 + Opus | 同画质下体积更小，适合现代浏览器环境 |
| HLS | H.264 分片 + 索引 | 长视频、多清晰度切换、边下边播 |
展签补充
嵌入时通常还需确认三个参数：容器宽高比（横屏用 16:9，竖屏用 9:16，避免画面被拉伸）、是否静音起播（多数浏览器禁止带声音自动播放）、以及是否循环。把海报图设为视频首帧或单独图片，可以在加载完成前挡住空白区域。
展区 04链接的可见范围与签名
公开读与私有读
公开读的地址任何人拿到即可访问，适合对外展示的页面。私有读需要签名，签名会把有效期与操作权限编码进参数里，过期后同一个链接会失效，这时要回到服务端重新签发，而不是反复刷新页面。
一段协作对白
「我把地址贴进文档了，同事打开却是空白。」「那是缓存加签名的链接，超过有效期就会失效，让他从页面里重新点一次播放。」这类往返常见于评审环节，把有效期写进交付说明，可以省掉一轮来回。
跨域访问时，还需在存储侧配置允许的来源与方法；来源写通配符方便调试，正式环境建议收窄到具体域名。
展区 05常见问题
- 页面里视频只有声音没有画面，或者反过来？
- 多半是编码组合不被浏览器支持。把视频轨改为 H.264、音频轨改为 AAC 后重新导出，再上传覆盖同名对象即可。
- 链接在浏览器里能打开，放进播放器却不动？
- 检查地址是否被截断、是否缺少协议前缀，以及播放器是否要求 HLS 索引而非单文件。签名链接还要确认签名参数没有被编辑器转义。
- 手机上点播放没有反应？
- 确认播放按钮没有被浮层遮挡，并检查是否要求用户手势才能起播。把预加载设为按需加载，等待时间会更短。
- 换了文件名之后旧页面全部失效？
- 对象键就是链接的一部分，重命名等于换地址。保留原对象或统一通过页面里的引用层取地址，可以避免逐页修改。