设置指定设备的拉流模式，支持切换如下两种模式；不设置时默认为“按需拉流”模式：
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"
}错误码
访问错误中心查看更多错误码。