jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的视频监控静态模式

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口
>[获取流地址](https://developer.qiniu.com/qvs/api/6740/obtain-flow-address) > 静态模式

#  静态模式

最近更新时间: 2023-05-19 15:36:54

# **描述**

本接口用于获得使用配置域名的方式接入到七牛视频监控的推拉流地址。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}/domain`
  * 当空间类型为GBT28181时，设备类型为`摄像头`时，流ID就是设备国标ID；设备类型为`平台`时，流ID就是`设备国标ID_通道ID`的形式
  * 对于本地录像回放，如果希望播放任意时间段内的录像，需要手动构造流ID。当设备类型为`摄像头`时，流ID格式为`设备国标ID_history_开始时间戳_结束时间戳`；当设备类型为`平台`时，流ID格式为`设备国标ID_通道ID_history_开始时间戳_结束时间戳`；假设目前有一个NVR国标ID为`31011500991320020874`，通道ID为`34020000001310000001`，希望观看`2022-12-12 00:00:00`到`2022-12-12 23:59:59`时间段内的录像，则流ID为:`31011500991320020874_34020000001310000001_history_1671638400_1671724799`，通过请求此接口可以获取到回放的流地址。注意这里的时间戳指的是`unix时间戳`，单位秒。

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | [`流id规则详情参考` __](https://developer.qiniu.com/qvs/11878/use-the-stream-interface-is-required)  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
domain | 是 | string | 域名  
domainType | 是 | string | 域名类型,取值 “publishRtmp”:rtmp推流, “liveRtmp”:rtmp播放, “liveHls”:hls播放, “liveHdl”:flv播放, “liveWebrtc”:webrtc播放  
urlExpireSec | 否 | integer | 流地址过期时间(单位为秒)  
playExpireSec | 否 | integer | 播放过期时间(单位为秒)  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
publishUrl | string | rtmp推流地址  
playUrls.rtmp | string | rtmp播放地址  
playUrls.flv | string | flv播放地址  
playUrls.hls | string | hls播放地址  
playUrls.webrtc | string | webrtc播放地址  
publishUrlExpired | integer | 流地址过期时间点(unix时间戳，单位second)  
  
# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device005/domain \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"domain": "qvs-live-hdl.qiniu.com",
    	"domainType": "liveHdl"
    }'
    

**响应示例**

    
    
    {
      "playUrls": {
        "flv": "http://qvs-live-hdl.qiniu.com:2045/d102sni9zryu/device005.flv?e=1587956536&token=6301b0c1a5cfa6a67c2249c4f9eedfd2"
      },
      "publishUrlExpired": 1587956536
    }
    

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device005/domain \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"domain": "qvs-publish.qiniu.com",
    	"domainType": "publishRtmp"
    }'
    

**响应示例**

    
    
    {
      "publishUrl": "rtmp://qvs-publish.qiniu.com:2045/d102sni9zryu/device005",
      "publishUrlExpired": 1587956536
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控动态模式

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口
>[获取流地址](https://developer.qiniu.com/qvs/api/6740/obtain-flow-address) > 动态模式

#  动态模式

最近更新时间: 2023-05-24 16:14:40

# **描述**

本接口根据推流端和播放端的公网IP，计算最合适的推流和播放地址。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}/urls`
  * 当空间类型为GBT28181时，设备类型为`摄像头`时，流ID就是设备国标ID；设备类型为`平台`时，流ID就是`设备国标ID_通道ID`的形式
  * 对于本地录像回放，如果希望播放任意时间段内的录像，需要手动拼接流ID。当设备类型为`摄像头`时，流ID格式为`设备国标ID_history_开始时间戳_结束时间戳`；当设备类型为`平台`时，流ID格式为`设备国标ID_通道ID_history_开始时间戳_结束时间戳`；假设目前有一个NVR国标ID为`31011500991320020874`，通道ID为`34020000001310000001`，希望观看`2022-12-12 00:00:00`到`2022-12-12 23:59:59`时间段内的录像，则流ID为:`31011500991320020874_34020000001310000001_history_1671638400_1671724799`，通过请求此接口可以获取到回放的流地址。注意这里的时间戳指的是`unix时间戳`，单位秒。

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | [流id规则 __](https://developer.qiniu.com/qvs/11878/use-the-stream-interface-is-required)  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
publishIp | 否 | string | 推流端公网IP地址。注：gb28181类型的空间可以不传。rtmp接入的空间在无法获取推流客户端ip时，可填充为127.0.0.1  
playIp | 否 | string | 播放端公网IP。注：在无法获取播放端公网ip时，可以填充为127.0.0.1  
urlExpireSec | 否 | integer | 流地址过期时间(单位为秒)  
playExpireSec | 否 | integer | 播放过期时间(单位为秒)  
  
**备注** :

  1. 只传 publishIp,只返回推流地址。注：gb28181类型的空间，推流地址为空
  2. 只传 playIp, 只返回播放地址。注：在无法感知到播放端的对外ip时，可以填充为127.0.0.1
  3. 两个都传, 同时返回推拉流地址。注：gb28181类型的空间，推流地址为空。
  4. 若域名配置中设置了防盗链过期时间，优先以域名配置为主

# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
publishUrl | string | rtmp推流地址  
playUrls.rtmp | string | rtmp播放地址  
playUrls.flv | string | flv播放地址  
playUrls.hls | string | hls播放地址  
playUrls.webrtc | string | webrtc播放地址  
publishUrlExpired | integer | 流地址过期时间点(unix时间戳，单位second)  
onlineState | bool | 流的在线状态  
disabled | bool | 流是否被禁用  
  
# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device005/urls \
      --header 'authorization: QiniuStub j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"publishIp":"116.236.177.50",
    	"playIp":"116.236.177.50"
    }'
    

**响应示例**

    
    
    {
      "publishUrl": "rtmp://47.105.118.51:2045/2akrars3vld9y/device009?e=1586922179&token=test123%3Al8rY2rRRKT182Hc7pymLMWX7how",
      "playUrls": {
        "rtmp": "rtmp://47.105.118.51:2045/2akrars3vld9y/device009?e=1586922179&token=test123%3Al8rY2rRRKT182Hc7pymLMWX7how",
        "flv": "http://47.105.118.51:1360/2akrars3vld9y/device009.flv?e=1586922179&token=test123%3A4JyGGXWy4OKOuXF2LYfs3inxt0k",
        "hls": "http://47.105.118.51:1370/2akrars3vld9y/device009.m3u8?e=1586922179&token=test123%3Ak6TOQ8vvsYnOTdjBcjnO6_m5uB0",
        "webrtc": "webtrtc://47.105.118.51:1240/2akrars3vld9y/device009"
      },
      "publishUrlExpired": 1586922179
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控启用流

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口 >启用流

#  启用流

最近更新时间: 2022-05-20 12:29:54

# **描述**

本接口用于启用流

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{id}/streams/{streamId}/enabled`
  * 当流为`禁用`状态时，需要`启用`后才能正常观看或推流；
  * 空间接入类型为`主动拉流`时，该接口会主动回源拉流。
  * 空间接入类型为`GB28181`时,该接口会重新开启设备推流。
  * 空间接入类型为`rtmp`时，我们提供如下功能，来满足按需拉流，节省客户流量: 一.持续1分钟无人观看,自动中断并禁用推流 二.当有观众观看请求触发时，流会被自动启用，推流断就可以恢复推流。体验改功能，客户可以提工单，我们将在后台定向为客户启用该功能。`GB28181`或者`主动拉流`类型的空间，自带“按需拉流”，客户可以在qvs控制台空间信息面板里，打开或者关闭[按需拉流 __](https://developer.qiniu.com/qvs/7703/on-demand-pull-flow-introduced)。

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流ID  
  
# **响应参数**

无

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device0059/enabled \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控禁用流

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口 >禁用流

#  禁用流

最近更新时间: 2022-11-28 11:15:03

# **描述**

本接口用于禁用流

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{id}/streams/{streamId}/disabled`
  * 执行本接口后, 既无法推流,也无关拉流观看; 正在推/观看的流也会被强制中断(同样适用于本地录像生成的历史流)。
  * 与[`启用流` __](https://developer.qiniu.com/qvs/6739/enable-the-flow)天生一对，相辅相成
  * 当需要恢复流操作时，可调用[`启用流` __](https://developer.qiniu.com/qvs/6739/enable-the-flow)。

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流ID  
  
# **响应参数**

无

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device0059/disabled \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控停止推流

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口 >停止推流

#  停止推流

最近更新时间: 2022-05-20 12:30:01

# **描述**

本接口用于停止推流，仅适用于类型为`RTMP`的空间

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：`POST`
  * 接口路径：`/v1/namespaces/{id}/streams/{streamId}/stop`
  * 使用场景：当需要强制终止推流时，可以调用此接口；本接口可以被[禁用流 __](https://developer.qiniu.io/qvs/6738/disable-the-flow)替代。

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流ID  
  
# **响应参数**

无

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device0059/stop \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控查询推流记录

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口 >查询推流记录

#  查询推流记录

最近更新时间: 2022-08-10 11:51:33

# **描述**

本接口用于查询推流历史记录

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}/pubhistories?start=<start>&end=<end>&offset=<offset>&line=<line>`
  * Get请求，通过`非SDK`方式调用的客户，http头部Content-Type`要么置空`, `要么不要携带`; [公共http header说明 __](https://developer.qiniu.com/qvs/6709/qvs-http-headers)

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流ID  
start | 是 | integer | 推流开始时间(unix timestamp in second)  
end | 是 | integer | 推流结束时间(unix timestamp in second)  
line | 否 | integer | 一次返回多少条, 最大值1000条，当超过1000条时，需要结合offset 循环读取。  
offset | 否 | integer | 偏移量。当数据较多，需要循环读取时使用。例如有2001条数据，初始值offset = 0, 第N次请求时offset = (N -1) * line  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
items | 推流历史记录数组 | 推流历史记录数组  
items.start | integer | 推流开始时间(unix timestamp in second)  
items.end | integer | 推流结束时间(unix timestamp in second)  
items.type | string | 推流记录类型，实时流/历史流  
items.duration | integer | 推流时长,单位为秒  
total | integer | 查询到历史记录总数  
  
# **示例**

**请求示例**

    
    
    curl --request GET \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device009/pubhistories?start=1586828400&end=1586828425 \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
     "items":[
      {
          "start": 1586828404,
          "end": 1586828420,
          "duration": 16,
      }
     ]
     "total":1
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控一对多语音对讲

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 设备管理相关接口 >一对多语音对讲

#  一对多语音对讲

最近更新时间: 2022-07-06 12:01:49

# **描述**

## 语音采集和发送的demo，可以参考[一对一语音对讲 __](https://developer.qiniu.com/qvs/8158/voice-
call)

## **接口分两个步骤进行**

## **`步骤1`:首先获取发送音频的url**

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/talks`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
gbids | 否 | string数组 | 需要对讲的国标id列表  
version | 否 | string | 对讲国标协议版本，取值"2014"或"2016"，默认为"2014"，例如大部分大华摄像头为GBT 28181-2014版本对讲模式  
transProtocol | 否 | string | 取值"tcp"或"udp"，流传输模式，默认"udp"  
  
# **响应参数**

参数名称 | 字段类型 | 说明  
---|---|---  
items | array | items结构的数组  
items.audioSendAddrForHttp | string | 用来发送音频数据的http地址，请求报文格式见`音频发送报文格式`  
items.audioSendAddrForHttps | string | 用来发送音频https地址，请求报文格式见`音频发送报文格式`  
items.gbid | string | 国标id  
  
**注意** ：此url地址列表在连续1min内没有收到语音数据时，地址无效，需要重新请求步骤1中`talks`接口，获取新地址

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/talks \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json'
    

**响应示例**

    
    
    {
        "items": [
            {
                "audioSendAddrForHttp":"http://1945028622.cloudvdn.com/api/v1/gb28181?action=append_audio_pcm&id=31011500991320003732&ssrc=1623567",
     	    "audioSendAddrForHttps":"https://1945028622.cloudvdn.com/api/v1/gb28181?action=append_audio_pcm&id=31011500991320003732&ssrc=1623567"
                "gbid": "31011500991320003732"
            },
            {
                "audioSendAddrForHttp":"http://1945028622.cloudvdn.com/api/v1/gb28181?action=append_audio_pcm&id=31011500991320003733&ssrc=1623568",
     	    "audioSendAddrForHttps":"https://1945028622.cloudvdn.com/api/v1/gb28181?action=append_audio_pcm&id=31011500991320003733&ssrc=1623568"
                "gbid": "31011500991320003732"
            }
        ]
    }
    

## **`步骤2`:向第一步返回的url地址发送音频。`从语音采集端可直接向改地址发送数据,不需要代理`**

## **音频发送报文格式**

  * 接口地址：`步骤1`中接口返回
  * 请求方式：POST

# **请求参数**

**路径参数**  
null

**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
base64_pcm | 是 | string | `base64`编码后的`g711a`格式音频数据,音频采样率务必`8000`, base64数据中不能有换行符\n  
  
# **示例**

**请求示例**

    
    
    curl --request POST \
      --url https://1945028622.cloudvdn.com/api/v1/gb28181?action=append_audio_pcm&id=31011500991320003732&ssrc=1623567 \
      --header 'content-type: application/json'
      --data-raw '{
        "base64_pcm":"1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1VVVVdXV1dVVVVVVVVTV1dTV1FRV1NRQV9TU1dfWVlXX0VJW11RX0NFW199IfXRcWlHawc32"
      }'
    

**响应示例**

    
    
    {
      "code":0
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控私有信令透传

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 设备管理相关接口 >私有信令透传

#  私有信令透传

最近更新时间: 2022-02-15 15:41:54

# **描述**

本接口用于信令透传，用户可以同设备侧实现一些私有定制化的信令。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/devices/{gbId}/sipraw`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间Id  
gbId | 是 | string | 设备国标Id  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
msg | 是 | string | 透传给设备的信令，可以是任意字符串  
  
# **响应参数**

200

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/devices/31011500991320000028/sipraw \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json'
      --data-raw '{
        "msg":"MESSAGE sip:31011500991320000815@3101150000 SIP/2.0\r\nVia: SIP/2.0/UDP 127.0.0.1:5061;rport;branch=QvsGbB90055266\r\nFrom: <sip:31011500002000000001@127.0.0.1:5061>;tag=QvsGbF17394556\r\nTo: <sip:31011500991320000815@3101150000>\r\nCall-ID: 202076370427\r\nCSeq: 1618 MESSAGE\r\nContent-Type: Application/MANSCDP+xml\r\nMax-Forwards: 70\r\nUser-Agent: QVS/2.0.0(Lion)\r\nContent-Length: 149\r\n\r\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n<Query>\r\n<CmdType>Catalog</CmdType>\r\n<SN>11112222</SN>\r\n<DeviceID>31011500991320000815</DeviceID>\r\n</Query>\r\n"
    }'
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控批量创建设备

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 设备管理相关接口 >批量创建设备

#  批量创建设备

最近更新时间: 2023-04-13 10:26:25

# **描述**

本接口用于批量创建设备。所有涉及设备的API，仅适用于接入类型为“GB/T 28181”的空间。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/batches`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
cameraNum | 是 | integer | 摄像头数量  
platformNum | 是 | integer | 平台数量  
BatchName | 是 | string | 批次名称  
pullIfRegister | 是 | bool | 注册后是否启用拉流  
alarmEnable | 是 | bool | 是否启用报警  
autoCreate | 是 | bool | true：自动生成，false：批量上传（**目前仅支持自动生成方式，批量上传正在开发中** ）  
alarmMethods | 否 | string | 报警的类型，当`alarmEnable`为true时需要  
devices | 否 | array | 批量上传时需要的设备数组  
devices.gbId | 是 | string | 设备国标id  
devices.name | 是 | string | 设备名称  
devices.username | 是 | string | 用户名  
devices.password | 是 | string | 密码  
devices.rtpAudio | 否 | boolean | 是否开启音频  
devices.rtpAudioTranscode | 否 | boolean | 是否开启音频转码  
devices.onDemandPull | 否 | boolean | 是否开启按需拉流  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
id | string | 批次ID  
cameraNum | integer | 摄像头数量  
platformNum | integer | 平台数量  
batchName | string | 批次名称  
autoCreate | bool | true：自动生成，false：批量上传  
nsId | string | 空间ID  
createTime | integer | 创建时间（单位秒）  
rtpAudio | boolean | 是否开启音频  
rtpAudioTranscode | boolean | 是否开启音频转码  
onDemandPull | boolean | 是否开启按需拉流  
  
# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/batches \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data-raw '{
        "cameraNum": 1,
        "platformNum": 1,
        "batchName": "batch_name",
        "pullIfRegister": false,
        "alarmEnable": false,
        "autoCreate": true
    }'
    

**响应示例**

    
    
    {
        "id": "3gzh7xdrfskl6",
        "cameraNum": 1,
        "platformNum": 1,
        "batchName": "batch_name",
        "nsId": "2akrarvzvyijd",
        "createTime": 1637652453,
        "autoCreate": true
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控获取批次列表

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 设备管理相关接口 >获取批次列表

#  获取批次列表

最近更新时间: 2022-08-10 11:17:55

# **描述**

本接口用于查询批次列表。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/namespaces/{namespaceId}/batches?offset=<offset>&line=<line>&name=<name>`
  * Get请求，通过`非SDK`方式调用的客户，http头部Content-Type `要么设置为application/x-www-form-urlencoded`,`要么置空`, `要么不要携带`; [公共http header说明 __](https://developer.qiniu.com/qvs/6709/qvs-http-headers)

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
line | 否 | integer | 一次返回多少条, 默认最大值为1000条,当超过1000条时，需要结合offset 循环读取。  
offset | 否 | integer | 在全部批次中的偏移量, 当需要循环读取时, 第N次请求时offset = (N -1) * line  
name | 否 | string | 搜索所有批次名包含`name`的批次  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
items | array | `Batch`结构的数组  
items.id | string | 批次ID  
items.cameraNum | integer | 摄像头数量  
items.platformNum | integer | 平台数量  
items.batchName | string | 批次名称  
items.autoCreate | bool | true：自动生成，false：批量上传  
items.nsId | string | 空间ID  
items.createTime | integer | 创建时间(单位秒)  
total | integer | 含有多少条  
  
# **示例**

**请求示例**

    
    
    curl --request GET \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akras1vdttwy/batches \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
    

**响应示例**

    
    
    {
        "items": [
            {
                "id": "3gzh7xdrfskl6",
                "cameraNum": 1,
                "platformNum": 1,
                "batchName": "batch_name",
                "nsId": "2akras1vdttwy",
                "createTime": 1637652453,
                "autoCreate": true
            }
        ],
        "total": 1
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控获取批次设备信息

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 设备管理相关接口 >获取批次设备信息

#  获取批次设备信息

最近更新时间: 2023-04-13 10:26:13

# 描述

本接口用于获取指定批次的所有设备信息。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/namespaces/{namespaceId}/batches/{id}/devices`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
id | 是 | string | 批次ID  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
devices | array | `device`类型数组，具体结构如下  
devices.name | string | 设备名称  
devices.desc | string | 设备描述  
devices.type | integer | 类型, 1: 摄像头, 2: 平台  
devices.nsId | string | 所属的空间ID  
devices.nsName | string | 所属的空间名称  
devices.gbId | string | 设备国标ID  
devices.state | string | 状态（offline: 离线, online: 在线,notReg: 未注册, locked: 锁定）  
devices.username | string | 用户名  
devices.password | string | 密码  
devices.pullIfRegister | boolean | 注册成功后启动拉流, 默认关闭  
devices.vendor | string | 厂商  
devices.createdAt | integer | 创建时间，Unix时间戳，秒  
devices.updatedAt | integer | 更新时间，Unix时间戳，秒  
devices.lastKeepaliveAt | integer | 最近心跳时间, Unix时间戳, 秒  
devices.lastRegisterAt | integer | 最近注册时间, Unix时间戳, 秒  
devices.alarmEnable | boolen | 是否开启国标报警  
devices.alarmMethods | string | 接收报警类型列表。 alarmEnable为`True`时，此字段有效。多个报警类型以`,`分隔。  
1为电话报警， 2为设备报警， 3为短信报警， 4为GPS报警， 5为视频报警， 6为设备故障报警，
7其他报警。例如同时接收`短信报警`和`视频报警`，传递参数为`"3,5"`  
devices.localRecordPushEnable | boolean | 本地录像上传开关，默认关闭。如果关闭此开关，本地录像上传云端接口无效  
devices.localRecordTemplate | string | 开启本地录像上传开关后，配置录制模板  
devices.batchId | string | 所属的批次id  
devices.rtpAudio | boolean | 是否开启音频  
devices.rtpAudioTranscode | boolean | 是否开启音频转码  
devices.onDemandPull | boolean | 是否开启按需拉流  
  
# **示例**

**请求示例**

    
    
    curl --request GET \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akras1vdttwy/batches/3gzh7xdrfskl6/devices \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
    

**响应示例**

    
    
    {
        "devices": [
            {
                "name": "31011500991320000212",
                "type": 1,
                "nsId": "2akras1vdttwy",
                "nsName": "gb-test1",
                "gbId": "31011500991320000212",
                "state": "notReg",
                "username": "31011500991320000212",
                "password": "iL-2",
                "pullIfRegister": false,
                "createdAt": 1637652453,
                "updatedAt": 1637652453,
                "channels": 1,
                "lastRegisterAt": 0,
                "lastKeepaliveAt": 0,
                "cruiseGroups": [],
                "alarmEnable": false,
                "alarmMethods": "",
                "localRecordPushEnable": false,
                "localRecordTemplate": "",
                "batchId": "3gzh7xdrfskl6"
            }
        ]
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控删除批次

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 设备管理相关接口 >删除批次

#  删除批次

最近更新时间: 2021-11-23 17:25:59

# **描述**

本接口用于删除批次下的所有设备。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：DELETE
  * 接口路径：`/v1/namespaces/{namespaceId}/batches/{id}`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
id | 是 | string | 批次ID  
  
# **响应参数**

无

# **示例**

**请求示例**

    
    
    curl --request DELETE \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akras1vdttwy/batches/3gzh7xdhhwi9k \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控删除设备

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 设备管理相关接口 >删除设备

#  删除设备

最近更新时间: 2022-11-28 16:21:36

# **描述**

本接口用于删除设备。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：DELETE
  * 接口路径：`/v1/namespaces/{namespaceId}/devices/{deviceId}`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
gbId | 是 | string | 设备Id  
  
# **响应参数**

无

# **示例**

**请求示例**

    
    
    curl --request DELETE \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/devices/31011500991320000028 \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？