按需完成手動錄制。例如動態啟動錄制、動態停止錄制。

使用說明

  • 如果某條直播流正在錄制（自動錄制或手動錄制啟動），您可以調用此接口停止該直播流的錄制。
  • 手動啟動錄制的直播流如果發生斷流，即會停止錄制。
  • 如果沒有配置自動錄制，重新推流后不會自動啟動錄制。

QPS限制

本接口的單用戶QPS限制為50次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。更多信息，請參見QPS限制。

調試

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

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 RealTimeRecordCommand

系統規定參數。取值：RealTimeRecordCommand。
Command String 是 start

操作行為。取值：

  • start：強制啟動錄制。
  • stop：強制暫停錄制。斷流延遲時間到達后，生成錄制文件。
  • cancel_delay：重置斷流延遲時間，完全停止錄制。如果任務已停止，立即生成錄制文件。
  • restart：強制重新開始錄制。如果restart之前在錄制，立即生成文件。
    說明 stop會強制暫停錄制，默認等待180秒后生成錄制文件。cancel_delay會將斷流等待時間從默認180秒改為0，即立刻生成錄制文件。
DomainName String 是 example.com

主播流域名。
AppName String 是 liveApp****

播流所屬應用名稱。
StreamName String 是 liveStream****

播流名稱。

返回數據

名稱 類型 示例值 描述
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

請求ID。

示例

請求示例

http(s)://live.aliyuncs.com/?Action=RealTimeRecordCommand
&AppName=liveApp****
&Command=start
&DomainName=example.com
&StreamName=liveStream****
&<公共請求參數>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<RealTimeRecordCommandResponse>
	<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</RealTimeRecordCommandResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RealTimeRecordCommandResponse" : {
    "RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  }
}

錯誤碼

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

注意事項：

  • 視頻直播支持觸發拉流，當使用觸發拉流域名對應的播放地址進行播放時，會自動觸發阿里云視頻直播服務進行拉流直播，無人播放時則不會回源站進行拉流。自動錄制、按需錄制、手動錄制功能應用在觸發拉流場景時，如果觸發拉流無人播放，則不會回源站拉流，自動錄制、按需錄制、手動錄制同樣也不會進行錄制。