設置指定設備的拉流模式，支持切換如下兩種模式；不設置時默認為“按需拉流”模式：
1. 按需拉流
有需要時才拉流，可以節省設備上行帶寬，但從開始拉流操作到實際取到碼流數據需數秒時間。
適用于成本敏感或計劃性較強的場景。
典型場景如存儲并分析工作日每天9:00~17:00的視頻。
2. 持續拉流
后臺維持拉流會話，會消耗設備上行帶寬，但可以立即獲得碼流數據。
適用于對首屏畫面顯示耗時容忍度較低的場景。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
| 名稱 | 類型 | 是否必選 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | SetStreamMode |
系統規定參數。取值：SetStreamMode。 |
| DeviceIdList | String | 是 | 1101050001132700**** |
設備編號,最大支持20個,以英文逗號分隔。 僅適用于IPC和虛擬數據源，不支持NVR、ABOX。 |
| StreamMode | String | 是 | 0 |
拉流模式，取值范圍： 0：按需拉流模式 1： 持續拉流模式 |
返回數據
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 46329898-489C-4E63-9BA1-C1DA5C5D0986 |
請求ID |
| Code | String | 200 |
返回編碼 |
| Message | String | success |
返回消息 |
示例
請求示例
http(s)://[Endpoint]/?Action=SetStreamMode
&DeviceIdList=1101050001132700****
&StreamMode=0
&公共請求參數正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<SetStreamModeResponse>
<RequestId>46329898-489C-4E63-9BA1-C1DA5C5D0986</RequestId>
<Code>200</Code>
<Message>success</Message>
</SetStreamModeResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "46329898-489C-4E63-9BA1-C1DA5C5D0986",
"Code" : "200",
"Message" : "success"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。