修改设备信息。如果您需要添加NVR设备下的IPC,可以调用 CreateDevice并传入ParentId。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyDevice |
系统规定参数。取值:ModifyDevice。 |
DeviceId | String | 是 | 3200000099118700**** |
指定需要修改的设备ID |
DeviceName | String | 否 | 某公司门口 |
所要修改的设备的名称,便于分类。 长度限制64位。 |
DeviceAddress | String | 否 | 某地市 |
修改后的设备所在的实际地址,至少需要您录入省份和市区。 长度限制64位。 设备安装地址修改不影响citycode和经纬度。 |
Longitude | String | 否 | 116.397128 |
经度。取值范围-180~180,小数最多6位。 |
Latitude | String | 否 | 39.916527 |
纬度。取值范围-90~90,小数最多6位。 |
DeviceDirection | String | 否 | 由内朝外 |
设备安装方向。 IPC 默认由内朝外。 长度限制64位。 |
DeviceSite | String | 否 | 东门门口 |
设备安装地点。 长度限制64位。 |
DeviceResolution | String | 否 | 1920*1080 |
设备分辨率,格式为“数字*数字”。 IPC默认1920*1080 |
DeviceRate | String | 否 | 4096 |
码率范围128-16384kbps,默认4096。 |
FrameRate | String | 否 | 25 |
设备支持的帧率。仅适用于IPC。 取值范围 1~100。默认25。 |
GovLength | String | 否 | 50 |
I帧间隔。仅适用于IPC。 取值范围5-250。 推荐为帧率两倍。 |
EncodeFormat | String | 否 | 6 |
视频或图片格式。仅适用于IPC。 枚举值: 3: MJPEG 6: H.264 13: H.265 默认6。 |
AudioEnable | String | 否 | 1 |
是否开启音频。仅适用于IPC。 取值范围:0 关闭; 1 打开。默认1。 |
OSDTimeEnable | String | 否 | 1 |
是否在画面上显示时间。仅适用于IPC。 取值范围:0 关闭; 1 打开。默认1。 |
OSDTimeType | String | 否 | 2 |
时间显示类型。仅适用于IPC。 取值范围: 0:YYYY-MM-DD 星期W HH:MM:SS; 1:DD-MM-YYYY星期W HH:MM:SS; 2:YYYY年MM月DD日 星期W HH:MM:SS; 3:MM月DD日YYYY年 星期W HH:MM:SS; 4:YYYY-MM-DD |
OSDTimeX | String | 否 | 99 |
时间戳X像素坐标(可选),以播放窗口左上角像素为原点,水平向右为正。仅适用于IPC。 默认99。 |
OSDTimeY | String | 否 | 1 |
时间戳Y像素坐标(可选),以播放窗口左上角像素为原点,竖直向下为正。仅适用于IPC。 默认1。 |
Vendor | String | 否 | 阿里云 |
设备厂商,如阿里云等。 长度限制64位。 |
DeviceModel | String | 否 | ACube200-8 |
所要注册设备的型号,便于分类。 长度限制64位。 |
DeviceSubType | String | 否 | 1 |
1:标清固定摄像机 2:标清云台摄像机 3:高清固定摄像机 4:高清云台摄像机 199:视图库摄像机 |
DeviceIp | String | 否 | 192.168.XX.XX |
设备IP。 注:仅针对IPC设备生效,其他设备不支持设置IP。 |
Password | String | 否 | ****** |
密码 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 46329898-489C-4E63-9BA1-C1DA5C5D0986 |
请求ID |
Code | String | 200 |
错误码 |
Message | String | success |
错误码描述 |
示例
请求示例
http(s)://[Endpoint]/?Action=ModifyDevice
&DeviceId=3200000099118700****
&DeviceName=某公司门口
&DeviceAddress=某地市
&Longitude=116.397128
&Latitude=39.916527
&DeviceDirection=由内朝外
&DeviceSite=东门门口
&DeviceResolution=1920*1080
&DeviceRate=4096
&FrameRate=25
&GovLength=50
&EncodeFormat=6
&AudioEnable=1
&OSDTimeEnable=1
&OSDTimeType=2
&OSDTimeX=99
&OSDTimeY=1
&Vendor=阿里云
&DeviceModel=ACube200-8
&DeviceSubType=1
&DeviceIp=192.168.XX.XX
&Password=******
&公共请求参数
正常返回示例
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "46329898-489C-4E63-9BA1-C1DA5C5D0986",
"Code" : "200",
"Message" : "success"
}
错误码
访问错误中心查看更多错误码。