日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

AI 助理
備案控制臺
文檔
輸入文檔關鍵字查找
首頁 視頻點播 開發參考 API參考 API目錄 音視頻播放 GetPlayInfo - 獲取音視頻播放地址

GetPlayInfo - 獲取音視頻播放地址

更新時間：
產品詳情
我的收藏

調用此接口并提供音視頻ID即可獲取播放地址，隨后可使用阿里云播放器或第三方播放器（如系統原生、開源或自研播放器）播放音視頻內容。

接口說明

  • 請確保在使用該接口前，已充分了解視頻點播產品的收費方式和價格。從點播的播放地址直接下載或播放視頻將產生下行流量費用，未配置加速域名時請參見存儲流出流量計費；已配置加速域名時請參見加速服務計費。如果您已開通了存儲傳輸加速，則從點播的播放地址直接下載或播放視頻還將涉及下載加速費用，計費詳情請參見存儲傳輸加速計費。

  • 只有狀態為正常（Status 字段值為 Normal）的視頻才能正常播放。關于播放地址的播放說明及使用限制等更多信息，請參見音視頻播放。

  • 當視頻播放異常時，您可以調用 GetMezzanineInfo 接口查詢視頻源文件信息是否正確。

  • 如需調用本接口生成 m3u8 溯源水印視頻流，請先提交工單，申請開通，如何提交工單，請參見聯系我們。更多溯源水印詳細信息，請參見數字水印。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：

  • 操作：是指具體的權限點。
  • 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
  • 資源類型：是指操作中支持授權的資源類型。具體說明如下：
    • 對于必選的資源類型，用背景高亮的方式表示。
    • 對于不支持資源級授權的操作，用全部資源表示。
  • 條件關鍵字：是指云產品自身定義的條件關鍵字。
  • 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
vod:GetPlayInfoget
*全部資源
*
    無
無

請求參數

名稱類型必填描述示例值
VideoIdstring是

音/視頻 ID，僅支持傳入單個音/視頻 ID。可通過以下方式獲取：

  • 通過控制臺上傳的音/視頻，可登錄視頻點播控制臺，選擇媒資庫 > 音/視頻查看音/視頻 ID。
  • 通過 CreateUploadVideo 接口上傳音/視頻時，音/視頻 ID 為返回參數 VideoId 的值。
  • 音/視頻上傳后，可通過 SearchMedia 接口查詢音/視頻 ID，為請求后返回參數 VideoId 的值。
93ab850b4f654b6e91d24d81d44****
Formatsstring否

媒體流格式。多個格式之間使用半角逗號（,）分隔。取值：

  • mp4
  • m3u8
  • mp3
  • flv
  • mpd
說明
  • 默認獲取所有格式的流。
  • mpd 格式僅當轉碼模板中配置了dash封裝格式時才會輸出。更多詳情，請參見Container：封裝格式。
    •
    		mp4,m3u8
    AuthTimeoutlong否

    設置播放地址的有效時間。單位：秒。

    • 當 OutputType 取值為 cdn 時：

      • 只有開啟了 URL 鑒權，播放地址才會定期失效，否則會永久有效。URL 鑒權的開啟及配置方法，請參見 URL 鑒權。
      • 最小值：1。
      • 最大值：無限制。
      • 默認值：未設置時，取值為 URL 鑒權中設置的默認有效時長。

    • 當 OutputType 取值為 oss 時：

      • 只有存儲權限為私有，播放地址才會定期失效，否則會永久有效。
      • 最小值：1。
      • 最大值：為降低源站安全風險，當音視頻存儲在點播系統 Bucket 上時，最大值為 2592000（即 30 天），當音視頻存儲在 OSS 自有 Bucket 上時，最大值為 129600（即 36 小時）。如果此處設置的最大值不能滿足您的需求，您可以設置 OutputType 為 cdn，通過設置 URL 鑒權來設置更長的有效期。
      • 默認值：未設置時，取值為 3600。
    		1800
    OutputTypestring否

    輸出地址類型。取值：

    • oss：回源地址。
    • cdn（默認）：加速地址。
    		cdn
    StreamTypestring否

    媒體流類型。多個類型之間用半角逗號（,）分隔。支持類型：

    • video：視頻。
    • audio：音頻。

    默認獲取所有類型的流。

    		video
    ReAuthInfostring否

    CDN 二次鑒權參數，為 JSON 字符串。當開啟了 URL 鑒權的 A 方式鑒權功能時，可通過該參數設置鑒權 URL 的uid和rand，請參見鑒權方式 A 說明。

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

    視頻流清晰度。多個清晰度之間用半角逗號（,）分隔。取值：

    • FD：流暢。
    • LD：標清。
    • SD：高清。
    • HD：超清
    • OD：原畫。
    • 2K：2K。
    • 4K：4K。
    • SQ：普通音質。
    • HQ：高音質。
    • AUTO：自適應碼率。
    說明
  • 默認獲取所有清晰度的流。
  • 生成溯源水印時，本參數必填，需與溯源水印轉碼時所設置的清晰度保持一致。
  • AUTO 格式僅當轉碼模板中配置了轉碼打包時才會有該清晰度輸出，請參見PackageSetting：轉碼打包設置。
    •
    		LD
    ResultTypestring否

    返回數據類型。取值：

    • Single（默認）：每種清晰度和格式只返回一路最新轉碼完成的流。
    • Multiple：每種清晰度和格式返回所有轉碼完成的流。
    		Single
    PlayConfigstring否

    播放自定義設置。為 JSON 字符串，支持指定域名播放設置。參數構造詳情，請參見 PlayConfig 。

    說明
  • PlayConfig 不設置或者其中PlayDomain不設置時，接口默認使用點播配置的默認域名；如果沒有設置默認域名，則會根據域名的修改時間倒序查詢，使用最新修改過的域名作為播放域名。為防止返回的不是想要的域名，建議設置默認播放域名（可登錄視頻點播控制臺，選擇配置管理 > 媒資管理配置 > 存儲管理 > 管理 > 回源到此存儲地址的域名設置默認播放域名）。
  • 當 PlayConfig 中的EncryptType參數設置為AliyunVoDEncryption時，為了保障您的視頻安全，默認不返回私有加密流播放地址，若需要返回私有加密流播放地址，需要同時設置ResultType參數為Multiple。
    •
    		{"PlayDomain":"vod.test_domain","XForwardedFor":"yqCD7Fp1uqChoVj/sl/p5Q==","PreviewTime":"20","MtsHlsUriToken":"yqCD7Fp1uqChoVjslp5Q"}
    AdditionTypestring否

    獲取彈幕蒙版數據 URL 地址，取值：danmu。

    說明 僅當outputType取值為cdn時才會生效。
    		danmu
    Tracestring否

    用戶自定義的數字水印信息。

    • 當DigitalWatermarkType取值為TraceMark時，通過傳入本參數，可以為視頻設置溯源水印的水印信息，并返回包含水印信息的視頻流。僅支持傳入英文字母、數字及中文字符，最多支持 1024 個字符。
    • 當DigitalWatermarkType取值為CopyrightMark時，Trace對應創建水印模板時所設置的水印文字。通過傳入本參數，可以查詢并返回指定水印文字的視頻流。
    		test mark
    DigitalWatermarkTypestring否

    數字水印類型。取值：

    • TraceMark：溯源水印。
    • CopyrightMark：版權水印。
    		TraceMark

    返回參數

    名稱類型描述示例值
    object

    返回結果。

    RequestIdstring

    請求 ID。

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

    音/視頻基本信息。

    CreationTimestring

    音/視頻創建時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    		2017-06-26T06:38:48Z
    Statusstring

    音/視頻狀態。各取值及描述，請參見Status：音視頻狀態。

    		Normal
    VideoIdstring

    音/視頻 ID。

    		93ab850b4f654b6e91d24d81d44****
    CoverURLstring

    音/視頻封面地址。

    		http://example.aliyundoc.com/sample.jpg?auth_key=2333232-atb****
    Durationstring

    音/視頻時長。單位：秒。

    		3.1667
    Titlestring

    音/視頻標題。

    		阿里云VOD
    MediaTypestring

    媒體文件類型，取值：

    • video：視頻。
    • audio：純音頻。
    		video
    DanMuURLstring

    彈幕蒙版數據的地址。

    		http://example.aliyundoc.com/****?auth_key=abdf2123-6783232****
    StorageClassstring

    媒資存儲類型。取值：

    • Standard：標準。
    • IA：媒資低頻。
    • Archive：媒資歸檔。
    • ColdArchive：媒資冷歸檔。
    • SourceIA：源文件低頻。
    • SourceArchive：源文件歸檔。
    • SourceColdArchive：源文件冷歸檔。
    • Changing：媒資存儲類型變更中。
    • SourceChanging：源文件存儲類型變更中。
    		Standard
    PlayInfoListarray<object>

    音/視頻播放信息（流信息）。

    PlayInfoobject

    音/視頻詳細信息。

    CreationTimestring

    創建時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    		2022-04-18T07:37:15Z
    Statusstring

    媒體流狀態，取值：

    • Normal：正常狀態，標記的是每種清晰度和格式的一路最新轉碼完成的流的狀態。
    • Invisible：不可見狀態，當每種清晰度和格式有多路重復的轉碼流時，除了最新的一路流會被標記為正常狀態，其他流會被標記為不可見狀態。
    		Normal
    Specificationstring

    音視頻轉碼輸出規格。各取值及描述，請參見輸出規格：Specification。

    		H264.LD
    NarrowBandTypestring

    轉碼類型。取值：

    • 0：普通轉碼。
    • 1.0：窄帶高清 1.0 轉碼。
    • 2.0：窄帶高清 2.0 轉碼。
    		0
    Heightlong

    媒體流高度。單位：px。

    		640
    Bitratestring

    媒體流碼率。單位：Kbps。

    		450.878
    ModificationTimestring

    更新時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    		2022-04-20T06:32:19Z
    WatermarkIdstring

    當前媒體流關聯的水印模板 ID。

    		dgfn26457856****
    Encryptlong

    媒體流是否加密流，取值：

    • 0：否。
    • 1：是。
    		1
    Definitionstring

    視頻流清晰度定義。取值：

    • FD：流暢。
    • LD：標清。
    • SD：高清。
    • HD：超清
    • OD：原畫。
    • 2K：2K。
    • 4K：4K。
    • SQ：普通音質。
    • HQ：高音質。
    • AUTO：自適應碼率。
    		LD
    EncryptTypestring

    媒體流加密類型。取值：

    • AliyunVoDEncryption：阿里云視頻加密。
    • HLSEncryption：HLS 標準加密。
    說明 如果加密類型為 AliyunVoDEncryption，則只能使用阿里云播放器 SDK 才能正常播放。
    		AliyunVoDEncryption
    EncryptModestring

    媒體流加密模式。取值：

    • License：本地解密模式。
    說明 如果加密模式為 License，則只能使用阿里云播放器 SDK 才能正常播放。
    		License
    StreamTypestring

    媒體流類型。 若媒體流為視頻則取值：video，若是純音頻則取值：audio。

    		video
    JobIdstring

    媒體流轉碼的作業 ID。作為媒體流的唯一標識。

    		80e9c6580e754a798c3c19c59b16****
    Sizelong

    媒體流大小。單位：Byte。

    		418112
    Widthlong

    媒體流寬度。單位：px。

    		360
    Fpsstring

    媒體流幀率。單位：幀/每秒。

    		25
    Durationstring

    媒體流長度。單位：秒。

    		9.0464
    PlayURLstring

    視頻流的播放地址。

    		https://example.aliyundoc.com/d52ee123f331466aabf6ab32a93d****/a777f9e24e6e47a2a942467d5c38ea37-8ee8e04293c6657fdda282bc422704****.m3u8
    Formatstring

    媒體流格式。

    • 若媒體文件為視頻則取值： mp4、 m3u8。
    • 若是純音頻則取值：mp3。
    		m3u8
    HDRTypestring

    媒體流 HDR 類型。取值：

    • HDR
    • HDR10
    • HLG
    • DolbyVision
    • HDRVivid
    • SDR+
    		HLG
    BitDepthinteger

    顏色位深。取值為整數。

    		8
    JobTypeinteger

    數字水印類型。取值：

    • 1：溯源水印。
    • 2：版權水印。
    		2
    JobExtstring

    版權水印的自定義水印信息。僅當JobType為2時返回該字段。

    		CopyrightMarkTest

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "F552E596-967D-5500-842F-17E6364****",
  "VideoBase": {
    "CreationTime": "2017-06-26T06:38:48Z",
    "Status": "Normal",
    "VideoId": "93ab850b4f654b6e91d24d81d44****",
    "CoverURL": "http://example.aliyundoc.com/sample.jpg?auth_key=2333232-atb****",
    "Duration": "3.1667",
    "Title": "阿里云VOD",
    "MediaType": "video",
    "DanMuURL": "http://example.aliyundoc.com/****?auth_key=abdf2123-6783232****",
    "StorageClass": "Standard"
  },
  "PlayInfoList": {
    "PlayInfo": [
      {
        "CreationTime": "2022-04-18T07:37:15Z",
        "Status": "Normal",
        "Specification": "H264.LD",
        "NarrowBandType": "0",
        "Height": 640,
        "Bitrate": "450.878",
        "ModificationTime": "2022-04-20T06:32:19Z",
        "WatermarkId": "dgfn26457856****",
        "Encrypt": 1,
        "Definition": "LD",
        "EncryptType": "AliyunVoDEncryption",
        "EncryptMode": "License",
        "StreamType": "video",
        "JobId": "80e9c6580e754a798c3c19c59b16****",
        "Size": 418112,
        "Width": 360,
        "Fps": "25",
        "Duration": "9.0464",
        "PlayURL": "https://example.aliyundoc.com/d52ee123f331466aabf6ab32a93d****/a777f9e24e6e47a2a942467d5c38ea37-8ee8e04293c6657fdda282bc422704****.m3u8",
        "Format": "m3u8",
        "HDRType": "HLG",
        "BitDepth": 8,
        "JobType": 2,
        "JobExt": "CopyrightMarkTest",
        "CodecName": ""
      }
    ]
  }
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    變更時間變更內容概要操作
    2024-12-09OpenAPI 返回結構發生變更查看變更詳情
    2024-10-11OpenAPI 返回結構發生變更查看變更詳情
    2023-10-18OpenAPI 入參發生變更查看變更詳情
    2023-09-05OpenAPI 返回結構發生變更查看變更詳情
    2021-12-23OpenAPI 返回結構發生變更查看變更詳情
    2021-11-16OpenAPI 返回結構發生變更查看變更詳情

    接口錯誤碼

    下表列舉了本接口特有的錯誤碼。

    錯誤代碼錯誤信息HTTP 狀態碼說明
    Forbidden.IllegalStatusStatus of the video is illegal. Current Status is %s.403視頻狀態無效，當前狀態為%s。只有 Normal 狀態的視頻才能播放。
    InvalidVideo.NotFoundThe video does not exist.404視頻不存在。
    InvalidVideo.NoneStreamThe video has no stream to play for the request parameter ‘Formats : mp4, Definition : LD, StreamType : video’.404根據您的篩選條件找不到可以播放的轉碼輸出流，請檢查您的轉碼配置與篩選條件是否匹配。
    Forbidden.AliyunVoDEncryptionCurrently only the AliyunVoDEncryption stream exists, you must use the Aliyun player to play or set the value of ResultType to Multiple.403當前僅存在阿里云視頻加密的轉碼輸出流，必須使用阿里云播放器進行播放或者設置請求參數 ResultType 值為 Multiple。