本接口通過音視頻ID直接獲取媒體文件(支持視頻和音頻)的播放地址。集成阿里云播放器SDK(適用于URL播放方式)或第三方播放器后,可使用該地址進行音視頻播放。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
ice:GetPlayInfo | get | *全部資源 * |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
MediaId | string | 否 | 媒資 ID。 說明
MediaId 和 InputURL 字段中至少一個不能為空。
| 86434e152b7d4f20be480574439fe*** |
InputURL | string | 否 | 注冊媒資時填寫的 InputURL,詳情見 RegisterMediaInfo 。 說明
MediaId 和 InputURL 字段中至少一個不能為空。
| http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 或 vod://****20b48fb04483915d4f2cd8ac**** |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "******11-DB8D-4A9A-875B-275798******",
"MediaBase": {
"CreationTime": "2021-09-22T10:07:31+08:00",
"Status": "Normal",
"MediaId": "2eea77a61c7b4ddd95bec34a6f65b***",
"CoverURL": "https://***.oss-cn-shanghai.aliyuncs.com/cover/281c64d6-b5fb-4c57-97cd-84da56a8b151_large_cover_url.jpg",
"Title": "testTitle",
"MediaType": "video",
"MediaTags": "test,ccc",
"CateId": 4220,
"Description": "desc"
},
"PlayInfoList": [
{
"CreationTime": "2022-05-10T02:28:49Z",
"Status": "Normal",
"NarrowBandType": "0",
"Height": 1080,
"Bitrate": "20",
"ModificationTime": "2022-05-13T11:39:41.714+08:00",
"WatermarkId": "5bed88672b1e2520ead228935ed51***",
"Encrypt": 0,
"Definition": "HD",
"EncryptType": "AliyunVoDEncryption",
"StreamType": "video",
"Size": 418112,
"Width": 1024,
"Fps": "25",
"Duration": "9.0464",
"PlayURL": "https://***.aliyuncdn.com/sv/756bee1-17f980f0945/756bee1-17f980f0945.mp4",
"Format": "mp4",
"HDRType": "HDR",
"BitDepth": 8,
"FileURL": "http://outin-***.oss-cn-shanghai.aliyuncs.com/sv/43a68ee9-181809b6aba/43a68ee9-181809b6aba.mpeg",
"TransTemplateType": "Normal",
"StreamTags": "\"{\\\"ims.audioServiceType\\\": \\\"AudioEnhancement\\\"}\"",
"JobId": "36c9d38e70bf43ed9f7f8f48d6356***"
}
]
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2023-08-25 | OpenAPI 返回結構發生變更 | 查看變更詳情 |
2022-11-29 | OpenAPI 返回結構發生變更 | 查看變更詳情 |