GetPlayInfo
调用此接口并提供音视频ID即可获取播放地址，随后可使用阿里云播放器或第三方播放器（如系统原生、开源或自研播放器）播放音视频内容
服务地址：
华东2（上海）
输入参数
只看必填
VideoId音/视频ID
Formats媒体流格式
AuthTimeout设置播放地址的有效时间
OutputType输出地址类型
StreamType媒体流类型
ReAuthInfoCDN二次鉴权参数
Definition视频流清晰度
ResultType返回数据类型
PlayConfig播放自定义设置
AdditionType获取弹幕蒙版数据URL地址
Trace用户自定义的数字水印信息
DigitalWatermarkType数字水印类型
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

  • 请确保在使用该接口前，已充分了解视频点播产品的收费方式和价格。从点播的播放地址直接下载或播放视频将产生下行流量费用，未配置加速域名时请参见存储流出流量计费；已配置加速域名时请参见加速服务计费。如果您已开通了存储传输加速，则从点播的播放地址直接下载或播放视频还将涉及下载加速费用，计费详情请参见存储传输加速计费。
  • 只有状态为正常（Status 字段值为 Normal）的视频才能正常播放。关于播放地址的播放说明及使用限制等更多信息，请参见音视频播放。
  • 当视频播放异常时，您可以调用 GetMezzanineInfo 接口查询视频源文件信息是否正确。
  • 如需调用本接口生成 m3u8 溯源水印视频流，请先提交工单，申请开通，如何提交工单，请参见联系我们。更多溯源水印详细信息，请参见数字水印。

请求参数

字段名称字段详情
VideoIdstring

音/视频 ID，仅支持传入单个音/视频 ID。可通过以下方式获取：展开详情

示例值:93ab850b4f654b6e91d24d81d44****参考取值来源:
    UpdateVideoInfos
    GetVideoList
    CreateUploadVideo
    RefreshUploadVideo
    ListLiveRecordVideo
Formatsstring

媒体流格式。多个格式之间使用半角逗号（,）分隔。取值：展开详情

示例值:mp4,m3u8
AuthTimeoutinteger<int64>

设置播放地址的有效时间。单位：秒。展开详情

注意 该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。
示例值:1800
OutputTypestring

输出地址类型。取值：展开详情

示例值:cdn
StreamTypestring

媒体流类型。多个类型之间用半角逗号（,）分隔。支持类型：展开详情

示例值:video
ReAuthInfostring

CDN 二次鉴权参数，为 JSON 字符串。当开启了 URL 鉴权的 A 方式鉴权功能时，可通过该参数设置鉴权 URL 的uid和rand，请参见鉴权方式 A 说明。

示例值:{"uid":"12345","rand":"abckljd"}
Definitionstring

视频流清晰度。多个清晰度之间用半角逗号（,）分隔。取值：展开详情

示例值:LD
ResultTypestring

返回数据类型。取值：展开详情

示例值:Single
PlayConfigstring

播放自定义设置。为 JSON 字符串，支持指定域名播放设置。参数构造详情，请参见 PlayConfig 。展开详情

示例值:{"PlayDomain":"vod.test_domain","XForwardedFor":"yqCD7Fp1uqChoVj/sl/p5Q==","PreviewTime":"20","MtsHlsUriToken":"yqCD7Fp1uqChoVjslp5Q"}
AdditionTypestring

获取弹幕蒙版数据 URL 地址，取值：danmu。展开详情

示例值:danmu
Tracestring

用户自定义的数字水印信息。展开详情

示例值:test mark
DigitalWatermarkTypestring

数字水印类型。取值：展开详情

示例值:TraceMark

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:F552E596-967D-5500-842F-17E6364****
VideoBaseobject

音/视频基本信息。

PlayInfoListobject
变更历史
变更时间变更内容概要操作
2024-12-09
变更返回参数
2024-10-11
变更返回参数
2023-10-18
新增请求参数Trace
新增请求参数DigitalWatermarkType
2023-09-05
变更返回参数
2021-12-23
变更返回参数
2021-11-16
变更返回参数