jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的视频监控光圈控制

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 >
[PTZ相关接口](https://developer.qiniu.com/qvs/api/7289/ptz-related-interface) >
光圈控制

#  光圈控制

最近更新时间: 2022-11-28 16:22:32

本接口用于摄像头的光圈控制

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

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
deviceId | 是 | string | 如果设备是普通摄像头，该字段置空字符串即可，如果设备是平台类型，该字段为子设备国标ID  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
cmd | 是 | string | irisin(光圈变小), irisout(光圈变大),stop(停止)  
speed | 是 | int | 调节速度(1~10, 默认位5)  
chId | 否 | string | 子设备国标ID  
  
# **响应参数**

200  
**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarxtmpned/devices/31011500991320000137/iris \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"cmd":"irisin",
    	"speed":1
    }'
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控预置位控制

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 >
[PTZ相关接口](https://developer.qiniu.com/qvs/api/7289/ptz-related-interface) >
预置位控制

#  预置位控制

最近更新时间: 2022-11-28 16:22:41

本接口用于预置位的管理

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

# **请求参数**

**路径参数**

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

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
cmd | 是 | string | set(新增预置位), goto(设置),remove(删除)  
name | 否 | string | 预置位名称(cmd为set时有效,支持中文)  
presetId | cmd为goto,remove 时必须指定 | int | 预置位ID  
chId | 否 | string | 如果设备是普通摄像头，该字段置空字符串即可，如果设备是平台类型，该字段为子设备国标ID  
presetToken | 设备类型为ONVIF是必须指定 | string | 预置位令牌  
  
# **响应参数**

200

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarxtmpned/devices/31011500991320000137/presets \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"cmd":"set",
    	"name":"test001"
    }'
    

**响应示例**

    
    
    {
      "name":"test001",
      "id":1
    }
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 >
[PTZ相关接口](https://developer.qiniu.com/qvs/api/7289/ptz-related-interface) >
获取预置位列表

#  获取预置位列表

最近更新时间: 2022-11-28 16:22:48

本接口用于获取预置位列表

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

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
gbId | 是 | string | 设备国标ID  
chId | 否 | string | 如果设备是普通摄像头，该字段置空字符串即可，如果设备是平台类型，该字段为子设备国标ID  
fetch | 否 | bool | 是否强制从设备获取预置位  
  
# **响应参数**

参数名称 | 必填 | 类型 | 说明  
---|---|---|---  
items | 是 | 预置位数组 | 预置位数组  
items.id | gb28181设备需指定 | int | 预置位ID  
items.name | 是 | string | 预置位名称  
items.token | onvif设备需指定 | string | 预置位token  
      
    
    curl --request GET \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarxtmpned/devices/31011500991320000137/presets \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "items": [
        {
          "id": 1,
          "name": "东南方向2点"
        },
        {
          "id": 2,
          "name": "预置点2"
        }
      ]
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控获取国标报警事件列表

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 国标报警相关接口 >获取国标报警事件列表

#  获取国标报警事件列表

最近更新时间: 2022-08-10 11:18:47

# **描述**

本接口用于获取设备国标报警事件列表

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/namespaces/{namespaceId}/devices/{deviceId}/alarms?start=<start>&end=<end>&chId=<chId>&alarmMethod=<alarmMethod>&alarmType=<alarmType>&offset=<offset>&line=<line>&sortBy=<sortBy>`
  * http body为空时, 例如Get请求, 通过`非SDK`方式调用的客户，http头部Content-Type,`要么设置为application/x-www-form-urlencoded`,`要么置空`, `要么不要携带`; [公共http header说明 __](https://developer.qiniu.com/qvs/6709/qvs-http-headers)
  * 告警事件默认`保存1天`，如果需要延长，请提工单

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
deviceId | 是 | string | 国标ID  
start | 是 | integer | 查询开始时间(unix时间戳,单位为秒)  
end | 是 | integer | 查询结束时间(unix时间戳,单位为秒)  
chId | 否 | string | 网关设备时为通道ID(普通设备可以忽略)  
alarmMethod | 否 | integer | 报警方式：1为电话报警， 2为设备报警， 3为短信报警， 4为GPS报警， 5为视频报警， 6为设备故障报警， 7其他报警  
alarmType | 否 | integer | 报警类型，详见`报警类型说明`  
offset | 否 | integer | 在全部报警事件中的偏移量  
line | 否 | integer | 一次返回多少条  
sortBy | 否 | string | 排序方式， asc: 按报警时间升序 desc: 按报警时间降序  
  
## **报警类型说明**

  * 报警方式（alarmMethod）为2时，  
不携带alarmType为默认的报警设备报警；  
携带alarmType取值及对应报警类型：1-视频丢失报警； 2-设备防拆报警； 3-存储设备磁盘满报警； 4-设备高温报警； 5-设备低温报警。

  * 报警方式（alarmMethod）为5时，  
取值如下：1-人工视频报警； 2-运动目标检测报警； 3-遗留物检测报警； 4-物体移除检测报警； 5-绊线检测报警；6-入侵检测报警； 7-逆行检测报警；
8-徘徊检测报警； 9-流量统计报警； 10-密度检测报警； 11-视频异常检测报警； 12-快速移动报警。

  * 报警方式（alarmMethod）为6时，  
取值如下： 1-存储设备磁盘故障报警； 2-存储设备风扇故障报警。

# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
total | integer | 报警条数  
items | 事件数组 | 事件数组  
items.chId | string | 通道id  
items.chName | string | 通道名称  
items.deviceState | string | 设备状态 “online”/“offline”  
items.alarmTime | integer | 报警时间，Unix时间戳,单位秒  
items.alarmMethod | integer | 报警方式：1为电话报警， 2为设备报警， 3为短信报警， 4为GPS报警， 5为视频报警， 6为设备故障报警， 7其他报警  
items.alarmType | integer | 报警类型,详见`报警类型说明`  
items.alarmPriority | integer | 报警级别。 取值：1(一级警情),2(二级警情),3(三级警情),4(四级警情)  
  
# **示例**

**请求示例**

    
    
    curl --request GET \
      --url 'qvs.qiniuapi.com/v1/namespaces/2akrarrzns76w/devices/31011500991180000083/alarms?start=1587899020&end=1587968104&chId=34020000001310000034&alarmMethod=5&alarmType=2&' \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "items": [
        {
          "chId": "34020000001310000034",
          "chName": "ipc1",
          "deviceState: "online",
          "alarmTime": "1607311045",
          "alarmMethod": 5,
          "alarmType":2,
          "alarmPriority":3
        },
        {
          "chId": "34020000001310000035",
          "chName": "ipc2",
          "deviceState: "offline",
          "alarmTime": "1607311045",
          "alarmMethod": 2,
          "alarmType":3,
          "alarmPriority":4
        }
      ],
      "total": 2
    }
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 国标报警相关接口 >布防撤防

#  布防撤防

最近更新时间: 2023-02-21 11:38:36

# **描述**

本接口用于控制设备的布防与撤防，如果要开启或关闭GB28181报警，需要请求此接口。

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

# **请求参数**

**路径参数**

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

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
cmd | string | 是 | 命令类型，布防:“SetGuard”,撤防:“ResetGuard”  
chId | 否 | string | 设备为`平台`类型：指定需要启动的通道ID, 设备为`摄像头`类型，无需指定  
  
# **响应参数**

200

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/devices/31011500991320000028/guard \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json'
      --data '{
    	"cmd":"SetGuard"
       }'
    

**响应示例**

    
    
    {
      "code": 200
    }
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 数据统计相关接口 >查询流量数据

#  查询流量数据

最近更新时间: 2022-08-05 11:16:08

# **描述**

本接口用于查询用户或者空间下的流量数据

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/stats/flow?nsId=<nsId>&streamId=<streamId>&start=<start>&end=<end>&tu=<Tu>`
  * Get请求，通过`非SDK`方式调用的客户，http头部Content-Type`要么置空`, `要么不要携带`,否则鉴权会失败; [公共http header说明 __](https://developer.qiniu.com/qvs/6709/qvs-http-headers)

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
nsId | 是 | string | 空间ID  
streamId | 否 | string | 流ID，可以输入多个  
start | 是 | integer | 年月日模式(20191001)或者年月日时分秒模式(20201012204005)  
end | 是 | integer | 年月日模式(20191002)或者年月日时分秒模式(20201012204005)  
tu | 是 | string | 时间粒度 可以是 5min, hour, day  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
time | integer 数组 | 时间点数组(unix timestamp)  
data | object | 上下行数据  
data.up | integer 数组 | 上行流量数据，单位：bytes，换算单位为1024  
data.down | integer 数组 | 下线流量数据，单位：bytes，换算单位为1024  
  
# **示例**

**请求示例**

  * 查询空间下某几路流的流量数据

    
    
    curl --request GET \
      --url 'http://qvs.qiniuapi.com/v1/stats/flow?tu=day&nsId=3nm4x0vyz7xlu&start=20201015&end=20201016&streamId=31011500991320000580&streamId=31011500991320001037' \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "time": [
        1602691200
      ],
      "data": {
        "up": [
          250225168
        ],
        "down": [
          169983762
        ]
      }
    }
    

  * 查询整个空间下总共流量数据

    
    
    curl --request GET \
      --url 'http://qvs.qiniuapi.com/v1/stats/flow?tu=day&nsId=3nm4x0vyz7xlu&start=20201015&end=20201016' \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "time": [
        1602691200
      ],
      "data": {
        "up": [
          250225168
        ],
        "down": [
          169983762
        ]
      }
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控查询带宽数据

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 数据统计相关接口 >查询带宽数据

#  查询带宽数据

最近更新时间: 2022-08-05 11:16:18

# **描述**

本接口用于查询用户或者空间下的带宽数据

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/stats/bandwidth?nsId=<nsId>&streamId=<streamId>&start=<start>&end=<end>&tu=<Tu>`
  * Get请求，通过`非SDK`方式调用的客户，http头部Content-Type`要么置空`, `要么不要携带`,否则鉴权会失败; [公共http header说明 __](https://developer.qiniu.com/qvs/6709/qvs-http-headers)

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
nsId | 是 | string | 空间ID  
streamId | 否 | string | 流ID，可以输入多个  
start | 是 | integer | 年月日模式(20191001)或者年月日时分秒模式(20201012204005)  
end | 是 | integer | 年月日模式(20191002)或者年月日时分秒模式(20201012204005)  
tu | 是 | string | 时间粒度 可以是 5min, hour, day  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
time | integer 数组 | 时间数组(unix timestamp)  
data | object | 上下行数据  
data.up | integer 数组 | 上行带宽数据(bps)，单位：bit/second。  
data.down | integer 数组 | 下线带宽数据(bps)，单位：bit/second。  
  
# **示例**

**请求示例**

  * 查询空间某几路流的带宽数据

    
    
    curl --request GET \
      --url 'http://qvs.qiniuapi.com/v1/stats/bandwidth?tu=day&nsId=3nm4x0vyz7xlu&start=20201015&end=20201016&streamId=31011500991320000580&streamId=31011500991320001037' \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "time": [
        1602691200
      ],
      "data": {
        "up": [
          1441429
        ],
        "down": [
          1103964
        ]
      }
    }
    

  * 查询整个空间下的带宽数据

    
    
    curl --request GET \
      --url 'http://qvs.qiniuapi.com/v1/stats/bandwidth?tu=day&nsId=3nm4x0vyz7xlu&start=20201015&end=20201016' \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "time": [
        1602691200
      ],
      "data": {
        "up": [
          1441429
        ],
        "down": [
          1103964
        ]
      }
    }
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 数据统计相关接口 >推流路数统计

#  推流路数统计

最近更新时间: 2023-06-21 09:01:13

# **描述**

本接口用于推流路数统计

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/stats/streamcount?nsId=<nsId>&start=<start>&end=<end>&tu=<Tu>`
  * Get请求，通过`非SDK`方式调用的客户，http头部Content-Type`要么置空`, `要么不要携带`,否则鉴权会失败; [公共http header说明 __](https://developer.qiniu.com/qvs/6709/qvs-http-headers)

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
start | 是 | integer | 年月日模式(20191001)或者年月日时分秒模式(20201012204005)  
end | 是 | integer | 年月日模式(20191002)或者年月日时分秒模式(20201012204005)  
tu | 是 | string | 时间粒度 可以是 5min, hour, day  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
time | integer 数组 | 时间数组(unix timestamp)  
count | integer 数组 | 流数量  
  
# **示例**

**请求示例**

    
    
    curl --request GET \
      --url 'http://qvs.qiniuapi.com/v1/stats/streamcount?tu=day&start=20210201&end=20210205' \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "time": [
        1612108800,
        1612195200,
        1612281600,
        1612368000
      ],
      "count": [
        0,
        0,
        1,
        0
      ]
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控查询国标接入设备数

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 数据统计相关接口 >查询国标接入设备数

#  查询国标接入设备数

最近更新时间: 2022-08-05 11:16:34

# **描述**

本接口用于查询国标接入设备数量。最小粒度一天，数据延迟一天。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/stats/gbcount?nsId=<nsId>&start=<start>&end=<end>&tu=<Tu>`
  * Get请求，通过`非SDK`方式调用的客户，http头部Content-Type`要么置空`, `要么不要携带`,否则鉴权会失败; [公共http header说明 __](https://developer.qiniu.com/qvs/6709/qvs-http-headers)

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
nsId | 否 | string | 空间ID。如果不填，则查询名下所有的国标设备  
start | 是 | integer | 年月日模式(20191001)或者年月日时分秒模式(20201012204005)  
end | 是 | integer | 年月日模式(20191002)或者年月日时分秒模式(20201012204005)  
tu | 是 | string | 时间粒度 可以是day, month  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
time | integer 数组 | 时间数组(unix timestamp)  
count | integer 数组 | 设备数量  
  
# **示例**

**请求示例**

    
    
    curl --request GET \
      --url 'http://qvs.qiniuapi.com/v1/stats/gbcount?start=20210201&end=20210205&tu=day' \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "time": [
        1612108800,
        1612195200,
        1612281600,
        1612368000
      ],
      "count": [
        39,
        41,
        27,
        25
      ]
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控播放端SDK

gpt: [视频监控](https://developer.qiniu.com/qvs) > SDK 下载 > 播放端SDK

#  播放端SDK

最近更新时间: 2023-12-13 16:01:31

# 产品简介

七牛云播放器 SDK 是一款全自研内核的跨平台 多媒体播放器，该播放器内核由有着18年播放器经验的音视频专家团队研发。目前支持 Android 和 iOS
平台。七牛云播放器 SDK 具有包体小、首开快、播放流畅、使用简单等明显优势可支持直播、点播 场景下的多种视频格式及流媒体协议。

播放器完全免费，不强制绑定任何其他产品，下载地址如下：  
[Android 播放器 SDK __](https://developer.qiniu.com/pili/sdk/1210/the-android-
client-sdk)  
Android Github 地址：https://github.com/pili-
engineering/PLDroidPlayer`除支持h264外，也支持rtmp和http-flv的h265播放`

[iOS 播放器 SDK __](https://developer.qiniu.com/pili/sdk/1211/ios-playback-end-
the-sdk)  
iOS Github 地址：https://github.com/pili-
engineering/PLPlayerKit`除支持h264外，也支持rtmp和http-flv的h265播放`

[小程序播放器]  
[推荐小程序原生播放器
__](https://developers.weixin.qq.com/miniprogram/dev/component/live-
player.html#%E7%A4%BA%E4%BE%8B%E4%BB%A3%E7%A0%81)`仅支持视频编码h264`

[web播放器]  
推荐西瓜播放器  
[web http播放器
__](http://v3.h5player.bytedance.com/generate/)适用于http地址`限定hls和flv,支持视频编码h264和h265
`  
[web https 播放器
__](https://v3.h5player.bytedance.com/generate/)适用于https地址`限定hls和flv,支持视频编码h264和h265`

**webrtc 快直播低延迟专用播放器SDK：** `仅支持视频编码格式h264`  
以下3种播放器SDK仅仅支持webrtc协议，如果是非webrtc协议请参考上面的SDK  
[低延时 Web SDK __](https://developer.qiniu.com/pili/7730/geek-web-sdk)  
[低延时 Android SDK __](https://developer.qiniu.com/pili/7731/geek-android-sdk)  
[低延时 iOS SDK __](https://developer.qiniu.com/pili/7732/geek-ios-sdk)  
[webrtc接入最佳实践 __](https://developer.qiniu.com/qvs/7812/low-latency-will-
broadcast-live-webrtc-access-process)

**七牛QVS控制台播放器展示**  
其中播放器1，是采用hls播放拉流地址，延迟8s左右；播放器2，采用的是webrtc
低延迟播放拉流地址，延迟在500ms；客户可以根据自身场景选择不同的播放拉流协议。  
![播放协议](https://dn-odum9helk.qbox.me/Fk_5GqWShIoGyn1rXezTJDfAsCek)

**注意：各端 Gihub 地址下的 repo 中，有相应的 demo 文件，用户可以体验并参考使用。**

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控设备本地录像上传云端存储

gpt: [视频监控](https://developer.qiniu.com/qvs) > 最佳实践 > 设备本地录像上传云端存储

#  设备本地录像上传云端存储

最近更新时间: 2023-11-08 14:52:13

本文讲述如何将设备本地录像上传到云端进行存储。本地录像上传需要提前在设备上开启开关，并配置独立的录制模板。平台通过国标协议拉取本地录像文件到云端后，并根据设备上设置的录制模板录制存放到云端。

# 前期准备

## **设备注册**

设备已成功注册到七牛云视频监控平台，并且设备本地已存在录像文件。

## **设置录制模板**

1.登录[七牛开发者平台
__](https://sso.qiniu.com/?client_id=PIapUKqa3u6S24H868BelwrG0OFu8dS7AxVQ8oz8HznLXhgrl2BnjaO9cs9LzxK2&redirect_url=https:%2F%2Fportal.qiniu.com%2Fapi%2Fgaea%2Fsso%2Fsignin%3Fredirect%3D%252Fcreate)  
2.选择**视频监控** 产品，进入产品控制台，选择**设备管理** ，进入设备管理页面，检索对应的设备，点击**查看**
，进入设备详情页面选择**编辑** ，开启本地录像开关并绑定对应的录制模板。如未创建录制模板请先创建录制模板在进行绑定录制模板操作。[【如何创建录制模板】
__](https://developer.qiniu.com/qvs/6789/recording-the-template)  
_注：_  
_1\. 需要做两件事，1. 空间上绑定按需录制的模版, 2. 设备上绑定实时录制的模版_  
_2.在空间中绑定的模版，录制方式选项选择`按需录制`_  
_3.在设备本地录像开关里配置的录制模板中，录制方式选项只能是`实时录制`的模板。_  
![设备列表](https://dn-odum9helk.qbox.me/Fk4wzi_TQGFxHWoUJ956ksqRu02c)  
![编辑设备](https://dn-odum9helk.qbox.me/FrkMsw2oVyop5exYigwGr3oF2sli)

# 本地录像上传

做完以上准备工作后可以开始本地录像上传操作。

## **1.开始本地录像上传**

调用[【本地录像上传云端API】 __](https://developer.qiniu.com/qvs/7765/uploaded-to-the-
cloud)  
**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/devices/31011500991320000028/sdcardsave/start \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json'
      --data '{
    	"channelId": "34020000001310000003",
    	"start":1612191900,
    	"end":1612191960
    }'
    

**请求参数说明**  
路径参数：

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

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
channelId | 否 | string | 平台设备指定需要启动的通道国标ID  
start | 是 | integer | 开始时间(unix时间戳,单位为秒)  
end | 是 | integer | 结束时间(unix时间戳,单位为秒)  
  
## 注意事项：

## **1.新建两个模板，模板A(按需)和模板B(实时),模板A和模板B设置的bucket保持一致即可;分别在空间上绑定A，在设备上绑定B；
就可以`只录制本地视频，不录制实时视频`, 如果需要同时录制本地和实时视频, 则把模板A和模板B都设置为“实时录制”**

## **2.上述中的API操作，会触发设备上传本地视频，若收到流状态回调，代表本地视频成功推流；也可以在流管理页面，查询到对应的流状态在线。**

## **3.在`需要提前终止录像上传`时，触发[终止本地录像上传
__](https://developer.qiniu.com/qvs/7766/stop-uploaded-to-the-
cloud/)接口即可终止本地录像上传；否则等待视频上传结束即可**

##
**4.本地录像上传时生成的流id为`31011500991320005819_history_1677744290_1677747005`类似形式，上传成功后只需要去QVS控制台打开id为`31011500991320005819`的流管理页面，然后选择对应日期检索(如上面1677744290_1677747005时间戳对应的日期)即可找到上传成功的录像**

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控配置域名的CNAME

gpt: [视频监控](https://developer.qiniu.com/qvs) > 最佳实践 > 配置域名的CNAME

#  配置域名的CNAME

最近更新时间: 2021-08-30 19:28:52

本文主要讲述使用静态方式接入时，如何配置域名的CNAME。

# CNAME 概述

CNAME 即指别名记录，也被称为规范名字。一般用来把域名解析到别的域名上，当需要将域名指向另一个域名，再由另一个域名提供 ip 地址，就需要添加
CNAME 记录。

# CNAME 配置

如果需要对域名进行 CNAME 配置，您可以在配置完域名后，通过以下方式为您的域名添加解析。

## 一. 获取CNAME值

在 **七牛开发者平台** 页面选择 [**视频监控**
__](https://portal.qiniu.com/qvs/overview)，选择[**空间管理**
__](https://portal.qiniu.com/qvs/namespace)，然后选择对应的空间并进入，选择**域名管理** 模块，如下图所示：  
_注：域名管理只支持静态接入的空间。_  
![1.png](https://dn-odum9helk.qbox.me/FrEdQKV3v3eO3Y8EtUrgsyUK-Gqx)

## 二. 添加CNAME记录

添加CNAME记录需要在您的**域名厂商** 处配置，比如您在 阿里云 / 腾讯云 / 新网 等处购买的域名，您需要前往**购买域名的厂商**
相应管理控制台，添加域名解析。  
1.打开您购买域名的厂商官网，登陆后在页面右上角找到 **`控制台`** 或 相关管理后台入口。  
如果您不清楚域名解析的入口，建议查看您域名厂商的产品文档，或者寻求域名厂商的售后支持。  
2\. 在域名厂商的控制台中，找到您的域名解析添加页面，例如：  
a. 阿里云：在控制台页面的左侧，产品与服务栏中选择 **域名** 。  
b. 腾讯云：在控制台的云产品中，搜索并选择 **云解析** 。  
c. DNSPOD：在控制台页面左侧，选择 **域名** 。  
其他域名厂商请参考产品文档说明或咨询产品售后。  
3\. 在域名产品的列表中找到您域名对应的`主域名`，点击域名后面的 **`解析设置`** 或 `解析`，进入解析设置页。  
4\. 选择 `添加记录` ，依次填写 **主机记录** ，**记录类型** 以及 **记录值** ，其他可设为默认值。  
如果您不清楚如何填写主机记录，请参考下文第5步提供的示例。

![](https://dn-odum9helk.qbox.me/Fn5LvRsKMEUgBQM4PvvAccI-ISyO)

参数 | 填写说明 | 注意事项  
---|---|---  
主机记录 | 填写域名对应的主机前缀 | 该参数唯一，请勿自定义  
记录类型 | 选择 CNAME 类型 | 该参数唯一，请勿自定义  
线路类型 | 保持默认 | 该参数可以根据需求自行调整  
记录值 | 域名创建后，七牛提供的CNAME | 该参数唯一，请勿自定义  
TTL | 保持默认 | 该参数可以根据需求自行调整  
  
  
5.解析示例：

假设您购买的一级域名为 qiniu.com  
您需要先在七牛视频监控控制台创建域名，比如您创建了 cdn.qiniu.com 或 img.qiniu.com 之类的自定义二级域名。  
创建完成后，在域名厂商后台添加解析记录时，您需要填写主机记录为域名对应的前缀，如 cdn 或 img 即可。

常见的普通域名主机记录填写方式举例：

创建的域名 | 域名类型 | 主机记录  
---|---|---  
qiniu.com | 普通域名 | @  
www.qiniu.com | 普通域名 | www  
cdn.qiniu.com | 普通域名 | cdn  
video.cdn.qiniu.com | 普通域名 | video.cdn  
  
# 如何判断 CNAME 是否正确配置？

  * linux/mac系统您可以通过如图所示的命令 `dig 您的域名` 查看，第一条是否解析到您配置的CNAME值。  
![](https://dn-odum9helk.qbox.me/FhZC_DzsNzPA6PzpD2ApNdy1udEE)

  * windows系统可以通过Win+R 或 点击左下角的“开始”按钮打开“开始”菜单，打开“运行”，输入cmd回车。  
在命令行模式下输入`nslookup 您的域名`，例如 nslookup qn.vinchi.club,在结果中可以看到您复制的cname值即可。

![](https://dn-odum9helk.qbox.me/FpCsAmZwHyxWvWpIUSQE59GXgGpV)

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控利用国标告警大幅减少云存储成本

gpt: [视频监控](https://developer.qiniu.com/qvs) > 最佳实践 > 利用国标告警大幅减少云存储成本

#  利用国标告警大幅减少云存储成本

最近更新时间: 2022-07-13 11:50:03

# **前置准备**

  * 设备必须通过gb28181接入，并具备告警能力(登录到设备的web配置界面，能看到告警配置，代表有告警能力)![test.png](https://dn-odum9helk.qbox.me/FipySAV3S7DdkIYmNkwI0mGVLUwf)
  * 打开设备的告警事件通知(qvs控制台“设备管理”->查看或编辑“设备信息”,以控制告警开关),[控制台告警配置详细步骤 __](https://developer.qiniu.com/qvs/7999/alarm-event-notification)
  * 设置回调地址(控制台“空间管理”->选择某个空间点击“配置”->`基本信息`界面中点击`编辑`，可配置回调地址)。平台会把设备上的告警回调给客户
  * 空间绑定录制模板。(控制台“空间管理”->选择某个空间点击“配置”->“模版配置”)，录制模板`录制方式务必为“按需录制”`

# **使用流程**

  * 当客户收到qvs的回调通知时，解析回调[回调数据示例 __](https://developer.qiniu.com/qvs/10240/the-message-callback)
  * 回调数据 “type”: “alarm”，代表是来自设备的告警消息；客户可根据具体的告警类型，[触发云端录制 __](https://developer.qiniu.com/qvs/6743/start-record-stream)，一段时间后(例如录制6s的视频后)或者一段时间内，无新的告警时，[终止云端录制 __](https://developer.qiniu.com/qvs/6744/stop-record-stream)
  * 通过以上功能组合，客户可以只保存告警发生时的视频，例如摄像头有画面移动时触发的`移动侦测，入侵检测等`，而不必7 * 24小时录制，从而消减存储成本

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控摄像头ONVIF接入流程

gpt: [视频监控](https://developer.qiniu.com/qvs) > 最佳实践 > 摄像头ONVIF接入流程

#  摄像头ONVIF接入流程

最近更新时间: 2022-12-13 10:49:56

**本文简述了使用ONVIF协议接入时配置流程** 。

# 1\. 添加ONVIF用户名和密码

## **大华设备添加ONVIF用户名和密码示例**

（1） 登录摄像头web页面  
（2） 依次点击"系统管理"→"用户管理"→"ONVIF用户"  
（3）点击"增加用户"  
![增加用户.png](https://dn-odum9helk.qbox.me/FsOChR7Qe4x5y53AfprS-cvSy0uA)  
（4） 输入用户名和密码  
![用户名密码.png](https://dn-odum9helk.qbox.me/FrfcPZfjIdgmer-mGIeI6d2Kqpsp)

# 2\. 七牛控制台创建ONVIF空间

创建空间时接入类型选择`ONVIF`  
![创建空间.png](https://dn-odum9helk.qbox.me/FmecmPBlJUaR98Q3EX9t43JrYrRb)

# 3\. 创建ONVIF设备

在第2步创建好的`ONVIF`空间，创建一个设备

（1）设备ip地址，填入设备的`公网IP`（内网设备可以使用内映射工具，比如花生壳）。  
（2）填入设备ONVIF的端口，一般是80。如果设备没有公网ip，也可以将80端口映射到公网的某个端口，比如`8080`,则这里需要填入映射后的端口`8080`。  
（3）填入流端口号，如果设备有`公网IP`，一般这个端口默认是`554`；如果设备没有公网IP，需要将该设备的`554`端口映射到公网的某个端口，例如映射到`8554`端口，则这里的流端口号填入`8554`。  
（4）填入第1步在摄像头添加的ONVIF用户名和密码。  
![创建onvif设备.png](https://dn-odum9helk.qbox.me/FvWCd_6blNETdEq9-Tig9ks2tsIC)

# 4\. 实时预览

（1） 在设备列表页面，选择添加好的设备，点`实时预览`，进入到实时预览页面。  
![设备列表.png](https://dn-odum9helk.qbox.me/FpAkrkIxvTBoIXY-J3F_NkksU7RW)  
（2）点`启动拉流`，观看摄像头的实时流。  
![实时预览.png](https://dn-odum9helk.qbox.me/FvowrYQXDPsNcUPQne8o25Termfy)

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