01 它是干嘛的
Stream 是打包好的视频基础设施：上传、转码、存储、自适应播放、鉴权、统计一体。它把视频这件事里最复杂的部分（多清晰度转码与自适应码率）藏起来，只暴露一个上传接口和一个播放地址。
02 为什么会有它
为什么「把视频放上网」比想象中难十倍
视频的复杂性来自「设备与网络千差万别」。同样是播放一个视频，手机在 4G 弱网、电视在千兆宽带、电脑在办公室限速网络，需要的清晰度和码率完全不同。如果只准备一个 1080p 文件，弱网用户会一直卡顿缓冲，强网用户又浪费带宽。
解决方案是「同一视频转成多档清晰度，播放器根据实时网速自动切换」，这套机制叫自适应码率（ABR）。但转码本身极其耗算力，一个 1 小时的高清视频要转成 5 档分辨率，还要切片成几秒一个的小片段、生成索引清单，自己搭这套系统要买 GPU 集群、学 HLS/DASH 协议、做播放器兼容性测试。
Stream 的价值就是把这一切标准化：上传后自动完成转码切片，你拿到一个播放地址，嵌到网页里即可。定价上按「存储分钟数 + 播放分钟数」计费，无需预估流量规模。
03 它怎么工作
视频被切成几秒一个的分片，每一档清晰度都有一套自己的清单文件，播放器读取清单后根据当前网速挑选合适的分片下载，从而实现清晰度的无缝切换。
上传之后发生了什么：转码、切片与自适应播放
- 1① 上传原始文件
通过 API 或控制台上传，得到视频 ID；支持断点续传与大文件直传。
- 2② 多档转码
按预设输出 240p 到 4K 多档清晰度，每档用不同的编码参数压缩体积。
- 3③ 切片与索引
每档清晰度切成 2-6 秒的小片段，并生成清单文件（manifest），记录片段顺序与码率。
- 4④ 分发到边缘
片段存储在全球边缘，用户就近下载，减少卡顿与首屏等待。
- 5⑤ 播放器自适应切换
播放器实时监测下载速度，网速下降时切到低码率分片，自动平衡清晰度与流畅度。
04 谁在用它
课程上传后无需转码配置，学生弱网也能顺畅观看，并可按课程设置访问权限。
官网嵌入播放器，支持自定义封面与品牌化外观，加载速度优于第三方视频站。
支持 RTMPS/SRT 推流，自动转成可大规模观看的分发格式。
用户上传的视频通过 API 自动处理，并可按观看数据统计热度。
05 怎么用
最快 3 步即可播出一个视频，无需任何视频编解码知识。
- 01控制台进入 Stream，点击上传视频，等待处理完成（分钟级）。
- 02复制系统生成的播放地址，或使用 <stream> 播放器组件嵌入网页。
- 03（进阶）用 API 上传以接入自有业务系统，通过 webhook 接收转码完成通知。
- 04开启签名播放（Signed URLs）让视频只能被授权用户观看，防止盗链。
- 05在分析面板查看观看时长、地域与设备分布，用于优化内容与成本。
避坑提示
- !源文件质量决定上限：尽量上传高码率母版，不要上传已经被二次压缩的文件。
- !按需开启视频鉴权，公开课上与付费内容应使用不同的播放策略。
- !计算成本时以「播放分钟」为主而非存储，它通常才是账单大头。
06 关键概念
- 转码
- 把视频重新编码成不同分辨率与码率的过程，是视频上云最耗算力的一步。
- 自适应码率（ABR）
- 播放器根据网速在多个清晰度间自动切换，兼顾清晰与流畅。
- HLS / DASH
- 两种主流的流媒体传输协议，都基于「切片 + 清单」的思路。
- 首屏时间
- 点击播放到画面出现的时间，主要由分片大小与就近节点决定。