GetPlayInfo_视频点播_API文档

Plugin DownloadLearn more
VS Code Plugin
Before installing the plugin, please install VS CodeBefore installing the plugin, please install VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains Plugin
Before installing the plugin, please install JetBrains IDEBefore installing the plugin, please install JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

Operation Description

  • Make sure that you understand the billing method and price of ApsaraVideo VOD before you call this operation. You are charged for outbound traffic when you download or play videos based on URLs in ApsaraVideo VOD. For more information about billing of outbound traffic, see Billing of outbound traffic. If you have configured an accelerated domain name, see Billing of the acceleration service. If you have activated the acceleration service, you are charged acceleration fees when you upload media files to ApsaraVideo VOD. For more information, see Billing of acceleration traffic.
  • Only videos whose Status is Normal can be played. For more information, see Overview .
  • If video playback fails, you can call the GetMezzanineInfo operation to check whether the video source information is correct.

Quotas Info

The current API request rate is 360/1(s).

Authorization Information

The following table shows the authorization information corresponding to this API, which can be used in the Action policy element to grant a RAM user or RAM role the permissions to call the API. Please use RAM to set up these permissions and refer to RAM documentation for more instructions.

Description:View Details...

ActionsAccess levelResource typeCondition keyAssociated operation
vod:GetPlayInfo
Get
All Resources
*
NoneNone

Request Parameters

Field NameField Details
VideoIdstring

The ID of the media file. You can specify only one ID. You can use one of the following methods to obtain the ID:View Details...

Example:93ab850b4f654b6e91d24d81d44****Reference Value Source:
    UpdateVideoInfos
    GetVideoList
    CreateUploadVideo
    RefreshUploadVideo
    ListLiveRecordVideo
Formatsstring

The format of the media stream. Separate multiple formats with commas (,). Valid values:View Details...

Example:mp4,m3u8
AuthTimeoutinteger<int64>

The validity period of the playback URL. Unit: seconds.View Details...

Notice The field type is Long, and the precision may be lost during serialization/deserialization. Please note that the value must not be greater than 9007199254740991.
Example:1800
OutputTypestring

The type of the output URL. Default value: oss. Valid values:View Details...

Example:cdn
StreamTypestring

The type of the media stream. Separate multiple types with commas (,). Valid values:View Details...

Example:video
ReAuthInfostring

The CDN reauthentication configuration. The value must be a JSON string. If CDN reauthentication is enabled, you can use this parameter to specify the UID and rand fields for URL authentication. For more information, see URL authentication.

Example:{"uid":"12345","rand":"abckljd"}
Definitionstring

The quality of the video stream. Separate multiple qualities with commas (,). Valid values:View Details...

Example:LD
ResultTypestring

The type of the data to return. Default value: Single. Valid values:View Details...

Example:Single
PlayConfigstring

The custom playback configuration. The value must be a JSON string. You can specify a domain name for playback. For more information, see PlayConfig .View Details...

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

The URL of the masked live comment data. Value: danmu.View Details...

Example:danmu
Tracestring

The custom digital watermark.View Details...

Example:test mark
DigitalWatermarkTypestring

The type of the digital watermark. Valid values:View Details...

Example:TraceMark

Response Parameters

Field NameField Details
RequestIdstring

The ID of the request.

Example:F552E596-967D-5500-842F-17E6364****
VideoBaseobject

The basic information about the audio or video file.

PlayInfoListobject

Sample Response

Change History

Change timeChange content summaryoperation
2024-12-09
changeresponse parameters
2024-10-11
changeresponse parameters
2023-10-18
addRequest parameter Trace
addRequest parameter DigitalWatermarkType
2023-09-05
changeresponse parameters
2021-12-23
changeresponse parameters
2021-11-16
changeresponse parameters

Examples