接入视频功能,表面上是把文件传上去、再交给播放器播放。落到业务里,还要处理上传凭证、媒资状态、转码结果、访问权限和失败恢复。阿里云点播SDK负责链路中的客户端操作,但上传任务怎么创建、视频何时开放播放,仍需要业务系统明确规则。
常见的点播流程由客户端、业务服务端和点播服务配合完成:客户端选择或录制视频并发起上传;业务服务端校验用户和业务权限,申请上传所需信息;点播服务接收文件并管理媒资,按配置执行转码、截图等处理。播放时,客户端向业务服务端请求视频信息,由服务端判断用户是否有权访问,再返回适合当前场景的播放地址或鉴权信息。
接入前先划清客户端和服务端的职责
SDK能简化上传和播放操作,却不能替代业务后端。用户是否能上传、视频属于哪个账号、谁能观看,都应由业务系统判断。上传凭证和播放鉴权信息也应由服务端按业务规则签发,客户端只在有效期内使用。长期访问密钥不要放进前端代码、移动端安装包或客户端日志中,否则很难控制泄露后的影响。
设计接入方案前,先确认几项实际需求:
- 客户端平台:确认使用Web、iOS、Android还是其他终端,再按对应平台选择SDK和集成方式。接口能力、调用方式及兼容范围应以当前文档和SDK版本为准。
- 上传条件:如果文件较大,或用户经常在移动网络下上传,测试分片上传、断点续传和失败重试是否符合业务需要。不要只在稳定的办公网络里验证。
- 媒体处理:提前确定是否需要转码、多清晰度、截图、审核或内容保护。这些配置会影响处理流程,相关服务和用量也需要纳入成本评估。
- 播放权限:公开内容和会员内容的访问规则不同。应明确凭证有效期、用户权限变化后的处理方式,以及凭证过期时客户端如何重新获取。
有个状态容易被混淆:文件上传完成,不代表视频已经可以播放。后续的转码、审核或媒资处理可能还在进行。业务端应根据服务端回调或主动查询结果更新状态,不能单凭客户端进度条到达100%就把视频标记为已发布。
按顺序接通上传与播放流程
1. 服务端校验并创建上传任务
用户发起上传后,业务服务端先检查登录状态、用户是否有上传权限,以及文件类型、大小和所属业务是否符合要求。校验通过后,再向点播服务申请上传所需信息,并将必要的临时凭证返回客户端。这里要避免把长期密钥交给客户端;临时凭证的有效期和使用范围,也应与实际上传流程相匹配。
2. 客户端调用SDK传输文件
客户端按所用SDK的要求设置文件和上传参数,注册进度、成功及失败回调。进度回调可以用来展示上传情况,但不能代替任务状态管理。用户可能中途取消,网络可能断开,凭证也可能在上传过程中失效;客户端需要给出明确反馈,并按业务规则处理重试或重新申请凭证。
大文件上传时,可核对当前平台和SDK版本是否支持分片、续传等能力,并在网络中断后实际测试恢复效果。不要假设不同平台的SDK表现完全一致,也不要在重试时无条件重复创建业务记录,否则可能出现重复媒资或状态对不上。
3. 服务端确认媒资处理状态
上传完成后,业务系统应保存对应的媒资标识,再通过回调或主动查询确认转码等处理是否结束。回调接口需要验证来源,并考虑同一通知重复到达的情况;状态更新应具备幂等性,重复处理同一结果也不会造成错误。
处理失败时,保留任务标识、媒资标识和错误信息,方便定位问题及判断是否可以重试。客户端不适合一直等待处理结果,更不应把“上传成功”直接显示成“视频已发布”。
4. 播放前由业务端检查权限
播放时,客户端先向业务服务端请求视频信息。服务端确认用户可以访问后,再返回当前场景需要的播放地址或鉴权信息。播放器负责加载视频、处理播放错误;如果凭证过期,应用应根据业务规则重新请求,而不是把长期有效的播放地址写死在页面或客户端配置里。
案例:课程视频上传后不要立即开放播放
一家在线课程平台允许讲师上传课程视频。早期流程中,客户端一显示上传完成,系统就把课程标记为已发布。部分视频还在转码,学员打开课程时便无法播放。遇到网络波动时,讲师还得从头重传,上传过程也容易中断。
调整后,平台把视频状态拆成“待上传、上传中、处理中、可播放、失败”。服务端先校验讲师权限并创建上传任务,客户端调用阿里云点播SDK传输文件,展示进度并处理异常。上传结束后,服务端继续确认处理结果;只有状态达到可播放,课程才开放播放入口。学员请求播放时,业务后端仍会检查课程权限,再返回相应的播放信息。
这类调整把文件传输和课程发布分开了:上传完成后,视频可以继续处于处理中;发生失败时,系统也能根据任务信息定位问题,而不是让用户面对一个无法解释的播放错误。保存媒资标识、处理结果和失败原因,还能帮助运营或技术人员追查具体是哪一步出了问题。
上线前核对这些环节
- 检查权限边界:长期密钥留在服务端;上传时校验用户身份和文件归属,播放时重新检查内容权限。
- 模拟异常情况:在测试中覆盖弱网、超时、用户取消、凭证过期和重复回调,确认客户端提示与服务端状态一致。
- 核对状态转换:分别记录上传完成、媒体处理完成和业务发布,避免文件还未就绪就开放播放。
- 留下排查线索:记录任务标识、媒资标识、处理耗时和错误信息,便于串起上传、处理与播放环节。
- 验证SDK版本:升级前在测试环境跑通创建任务、上传、处理确认和播放鉴权,确认平台兼容及接口变化不会影响现有流程。
接入阿里云点播SDK时,可以先跑通“创建任务—客户端上传—服务端确认处理—授权播放”这条链路,再按业务需要加入转码、审核和内容保护。把职责和状态先理清,出现上传中断或播放失败时,才有明确的位置检查和恢复。