呼叫 SubmitLiveRecordJob 提交即時錄製任務,對直播串流進行錄製。
介面說明
該介面目前支援阿里雲端直播或第三方 RTMP 直播串流錄製。建議先推流再呼叫本介面提交錄製任務。如果直播串流地址拉不到串流,任務會嘗試拉流 3 分鐘。逾時後錄製服務將停止錄製。
提交錄製任務前,需準備好阿里雲端 OSS 或 VOD 儲存空間。建議使用在智慧媒體服務中設定的儲存地址,便於對錄製產生的檔案進行管理和處理。
如果系統預設的錄製範本不符合需求,可自行建立客製化錄製範本。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ice:SubmitLiveRecordJob |
*全部資源。
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| NotifyUrl |
string |
否 |
回呼地址。 |
https://example.com/imsnotify |
| StreamInput |
object |
是 |
直播串流地址。 |
|
| Type |
string |
是 |
直播串流地址類型。目前支援 rtmp。 枚舉值:
|
rtmp |
| Url |
string |
否 |
直播串流地址。 |
rtmp://example.com/live/stream1 |
| RecordOutput |
object |
是 |
錄製儲存地址。 |
|
| Type |
string |
是 |
儲存地址類型。 |
oss |
| Bucket |
string |
否 |
儲存空間名稱。 |
imsbucket1 |
| Endpoint |
string |
否 |
儲存服務地址。 |
oss-cn-hangzhou.aliyuncs.com |
| TemplateId |
string |
是 |
錄製範本 ID。 |
69e1f9fe-1e97-11ed-ba64-0c42a1b73d66 |
| Name |
string |
是 |
錄製任務名稱。 |
live stream record 1 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| RequestId |
string |
請求 ID。 |
BEA98A0C-7870-15FE-B96F-8880BB600A2C |
| JobId |
string |
錄製任務 ID。 |
ab0e3e76-1e9d-11ed-ba64-0c42a1b73d66 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "BEA98A0C-7870-15FE-B96F-8880BB600A2C",
"JobId": "ab0e3e76-1e9d-11ed-ba64-0c42a1b73d66"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。