Azure Media Services v3：清单文件播放与URL构建问题排查

看起来你已经走完了核心流程，但播放失败大概率是几个容易忽略的细节出了问题，我帮你梳理下要检查的关键点：

• 确认编码作业的输出有效性：
  别只依赖Webhook的完成通知，去Azure Portal里查看编码作业的输出资产，确认里面生成了完整的流媒体文件集合——比如要有.ism、.ismc以及对应的分片MP4文件。有时候编码过程可能出现隐性错误（比如原始视频编码不兼容），虽然标记为完成，但输出文件不完整，自然没法播放。

• 检查流式定位器的策略配置：
  你创建流式定位器时用的流式策略，必须包含平滑流的支持。如果用的是预定义策略，要选Predefined_MultiBitrate_SmoothStreaming这类明确支持平滑流的；如果是自定义策略，要确保添加了平滑流的格式配置。另外，还要确认流式定位器的过期时间没有设成过去的时间，过期的定位器会直接拒绝访问。

• 验证内容的访问权限：
  如果你的流式定位器不是公开匿名访问的（比如用了签名令牌），那播放URL里必须带上有效的令牌参数；如果是公开访问，要确保流式定位器关联的策略是允许匿名访问的。可以先尝试创建一个公开的流式定位器测试，排除权限问题。

• 核对平滑流URL的准确性：
  你用的URL格式https://{StreamingEndpoint}/{StreamingLocator}/{filename}.ism/manifest里，{filename}必须是编码后生成的.ism文件的准确名称，不是你上传的原始AVI文件名。比如编码后生成的可能是Output.mp4.ism，你要去输出资产里核对这个文件名，不能想当然用原始文件名。另外，在Azure Media Player测试时，直接粘贴完整的HTTPS URL即可，不用转义开头的//，避免URL格式错误。

• 排查跨域（CORS）问题：
  如果在你自己的网站里无法播放，大概率是流式端点没配置正确的CORS规则。去Azure Portal的流式端点设置里，添加你的网站域名到CORS允许列表中，允许该域名发起跨域请求，否则浏览器会因为跨域策略阻止视频资源加载。

• 确认播放器的协议支持：
  在Azure Media Player测试页面里，可以手动指定播放协议为平滑流，有时候自动探测可能失效，手动指定能排除播放器协议适配的问题。

内容的提问来源于stack exchange，提问作者Ian Gleeson