更新时间:2024-04-22 GMT+08:00

修改视频源

功能介绍

修改视频源

URI

PUT /v2/{project_id}/source/{video_source_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

用户项目ID,获取方法参见获取项目ID和名称

最大长度:64

video_source_id

String

已创建成功的视频源id,只能由小写英文字母(a~z,)、数字(0~9)、中划线(-)、下划线(_)长度范围为[4, 36]

最大长度:36

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,获取方法参见认证鉴权

表3 请求Body参数

参数

是否必选

参数类型

描述

video_source_name

String

视频源名称,只支持中文、英文字母(a-z,A-Z)、数字、特殊字符(空格.-_() ()),不能以空格开头和结尾

最小长度:0

最大长度:100

latitude

String

视频源的地理位置信息,纬度,-90.00000~90.00000

longitude

String

视频源的地理位置信息,经度,-180.00000~180.00000

type_config

String

视频源配置信息xml url形式: <type>URL</type> <config> <URL_ADDRESS></URL_ADDRESS> </config> vcn形式: <type>VCN</type> <config> <DATA_SOURCE_ID></DATA_SOURCE_ID> <STREAM_TYPE></STREAM_TYPE> <IP></IP> <PORT></PORT> <USER_NAME></USER_NAME> <PASSWORD></PASSWORD> </config> restful形式: <type>RESTFUL</type> <config> <HTTP_CHECK></HTTP_CHECK> <URL></URL> <RTSP_URL></RTSP_URL> </config> camera形式: <type>CAMERA</type> <config> <EDGE_CAMERA_ID></EDGE_CAMERA_ID> </config>

最大长度:1024

tag

Array of strings

视频源标签,标签最多选择4个,标签内容只能由中文, 英文字母(a~z, A~Z)、数字(0~9)、中划线(-)、下划线(_)组成, 最小长度:1 最大长度:10

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

video_source_name

String

视频源名称,只支持中文、英文字母(a-z,A-Z)、数字、特殊字符(空格.-_() ()),不能以空格开头和结尾 最小长度:1 最大长度:100

access_type

String

接入类型(cloud、edge)

status

VideoSourceStatusInfoDto object

数据源状态

type

String

类型:obs、vcn、url、restful、camera

latitude

String

视频源的地理位置信息,纬度,-90.00000~90.00000

longitude

String

视频源的地理位置信息,经度,-180.00000~180.00000

create_at

Long

创建时间

type_config

String

视频源配置信息xml

video_packages

Array of VideoGroupInfoDto objects

视频源所在分组

service_config_templates

Array of VideoServiceConfigTemplateDto objects

算法模板体

stream_path

String

流地址

image

String

视频源截图的base64转码

tag

Array of strings

视频源标签,标签最多选择4个,标签内容只能由中文, 英文字母(a~z, A~Z)、数字(0~9)、中划线(-)、下划线(_)组成, 最小长度:1 最大长度:10

scene_recommend

Array of strings

智能算法推荐的标签

video_source_quality

Array of strings

视频源的视频流质量: Blurry:画面模糊; ColorDistortion:画面颜色失真; AbnormalLight:画面光线异常; ScreenSplash:画面花屏异常; ScreenJitter:画面抖动; ScreenMovement:画面移动; SceneUpheaval:画面剧变; ScreenFreeze:画面冻结; BlackScreen:黑屏; SnowNoise:雪花噪声; Occlude:遮挡; GrayScreen:灰屏;ScreenSmudge:画面污迹

表5 VideoSourceStatusInfoDto

参数

参数类型

描述

status

String

视频源状态

name

String

状态中文名

level

String

状态等级(用于前端图片颜色匹配)

表6 VideoGroupInfoDto

参数

参数类型

描述

video_group_id

String

视频源所在分组id

video_group_name

String

视频源所在分组名称

description

String

视频源所在分组描述

access_type

String

接入方式(cloud、edge)

create_at

Long

创建时间

modify_at

Long

修改时间

num_video_source

Integer

视频源数量

group_status

GroupStatusDto object

视频源状态

num_batch_task

Integer

已配置批量作业数量

表7 GroupStatusDto

参数

参数类型

描述

num_online

Integer

在线视频源数量

num_exception

Integer

异常视频源数量

num_offline

Integer

离线视频源数量

表8 VideoServiceConfigTemplateDto

参数

参数类型

描述

name

String

算法服务名称

roi

String

公共roi

serviceConfig

String

算法服务公共配置

createAt

Long

创建时间

modifyAt

Long

修改时间

numTask

Integer

已运行算法数量

请求示例

修改视频源请求体

/v2/{project_id}/source/{video_source_id}

{
  "video_source_name" : "url_test",
  "access_type" : "cloud",
  "type" : "url",
  "longitude" : "",
  "latitude" : "",
  "tag" : [ "1" ],
  "video_group_ids" : [ ],
  "type_config" : "<type_config>        <url_address>rtsp://12.12.12.12:333</url_address>      </type_config>"
}

响应示例

状态码: 200

更新视频源响应体

{
  "video_source_name" : "url_test",
  "access_type" : "cloud",
  "status" : {
    "status" : "Online",
    "name" : "在线",
    "level" : "1"
  },
  "type" : "url",
  "latitude" : "",
  "longitude" : "",
  "create_at" : 1680772763191,
  "type_config" : "<type_config>        <url_address>rtsp://12.12.12.12:333</url_address>      </type_config>",
  "stream_path" : "rtsp://12.12.12.12:333",
  "tag" : [ "1" ],
  "device_id" : "1680772763191",
  "scene_recommend" : [ ],
  "video_source_quality" : [ ]
}

状态码

状态码

描述

200

更新视频源响应体

错误码

请参见错误码