分辨率

400 万像素（2560 × 1440）

镜头

2.8 mm 定焦，F1.6

视场角

水平 107 度

最低照度

0.005 lux @ F1.6

音频

内置麦克风

视频编码

H.265+ / H.265 / H.264+ / H.264

供电

PoE (802.3af) / 12 VDC

接口

RJ45 10/100M，内置麦克风

快速入门 —— 海康威视 DS-2CD2143G2-ISU

本指南可在约 10 分钟内让一台全新摄像机联网推流。以下细节均为参考模式；具体步骤请以官方海康威视对接手册适配你的固件版本。

1. 发现设备

使用海康威视SADP（Search Active Devices Protocol，即设备搜索协议）工具，或探测子网：

# find devices on the LAN (example with a community SADP CLI)
sadp -a

记录 IP 地址（出厂默认通常为192.0.0.64（关闭 DHCP）。

2. 激活并设置密码

新设备必须先已激活方可使用。激活同时会设置admin密码。

# Using Hikvision's device management CLI (reference)
sadp -a <IP> -p <NEW_ADMIN_PASSWORD>

该admin密码需满足复杂度规则（大小写字母/数字/符号）。在激活完成前，你无法对接。

3. 拉取实时视频流（RTSP）

激活后，主码流即可通过 RTSP 获取。可用以下方式测试：ffplay或用 VLC：

ffplay "rtsp://admin:[email protected]:554/Streaming/Channels/101"
# 101 = channel 1, main stream
# 102 = channel 1, sub stream

4. 验证 API 接口

curl --digest -u admin:PASSWORD \
  "http://192.168.1.64/ISAPI/System/deviceInfo"

成功响应为 XML，其中包含<deviceName>, <firmwareVersion>，等等。

后续步骤

• API 参考 → 见API标签页（ISAPI 示例）。
• 应用对接 → 见SDK标签页（设备网络 SDK）。

API 参考 —— ISAPI（海康威视 DS-2CD2143G2-ISU）

海康威视设备提供ISAPI通过 HTTP/HTTPS 使用摘要鉴权。基础 URL 为http://<ip>/ISAPI。响应为 XML（当支持时也可为 JSON）format=json受支持）。

仅为参考模式。字段名称与可用性因固件而异 —— 请以ISAPI 参考适配你的型号。

鉴权

curl --digest -u admin:PASSWORD "http://192.168.1.64/ISAPI/System/deviceInfo"

常用接口

示例：抓取快照

curl --digest -u admin:PASSWORD \
  "http://192.168.1.64/ISAPI/Streaming/channels/1/picture?snapShotImageType=JPEG" \
  -o snapshot.jpg

示例：以 JSON 读取设备信息

curl --digest -u admin:PASSWORD \
  "http://192.168.1.64/ISAPI/System/deviceInfo?format=json"

事件订阅（推送）

对于移动侦测 / VCA 事件，通过 ISAPI 订阅Event/notification/httpHosts推送到你的服务器，或轮询/ISAPI/Event/triggerState.

说明

• 默认 HTTP 端口80，HTTPS443。SDK/设备端口为8000.
• ONVIF 同样可用于跨厂商客户端。

SDK —— 设备网络 SDK（海康威视 DS-2CD2143G2-ISU）

对于服务端应用（录像、云台控制、实时回放），请使用海康威视设备网络 SDK。它使用二进制8000协议，在媒体处理上比 ISAPI 更快、更完整。

参考概述。请从海康威视官方开发者门户下载 SDK 与头文件，并参照其示例。

语言与平台

• C / C++—— 原生 SDK，支持 Windows 与 Linux（含 arm）。
• C#—— 通过所提供的HCNetSDK封装 /PlayCtrl.
• Python—— 围绕 C 语言库的社区封装（例如hikvisionapi）或 ctypes 绑定。

典型初始化（C# 参考）

// Pseudocode — adapt to the SDK's HCNetSDK declarations
int userId = -1;
bool ok = NET_DVR_Init();
NET_DVR_SetConnectTime(2000, 1);
userId = NET_DVR_Login_V30(ip, 8000, "admin", password, out deviceInfo);
if (userId < 0) throw new Exception("Login failed: " + NET_DVR_GetLastError());
// ... start real-time stream, capture, PTZ ...
NET_DVR_Logout(userId);
NET_DVR_Cleanup();

Python（社区封装）

from hikvisionapi import ISAPI
cam = ISAPI("192.168.1.64", "admin", "PASSWORD", "80")
print(cam.System.deviceInfo(method="get"))

最佳实践

• 调用NET_DVR_Init()在进程启动时一次；Cleanup()在退出时。
• 始终处理NET_DVR_GetLastError()用于诊断。
• 对于 64 位应用，请匹配 64 位 SDK 二进制文件。

常见问题 —— 海康威视 DS-2CD2143G2-ISU

问：摄像机无画面 / RTSP 连接失败。答：确保设备已已激活（SADP）与admin密码已设置。密码错误是首要原因。

问：curl即便密码正确也返回 401。答：使用--digest显式指定；ISAPI 要求 Digest 鉴权，而非 Basic。

问：忘记了管理员密码。答：通过 SADP 使用设备的安全问题 / 导出文件重置，或凭序列号联系厂商渠道。

问：SDK 使用哪个端口？答：TCP8000（设备端口）。HTTP/HTTPS API 使用80/443.

问：能否用 ONVIF 替代 ISAPI？答：可以 —— ONVIF 支持跨厂商客户端（profiles S/G）。ISAPI/SDK 则提供更深入的控制（VCA 事件、云台预置位）。

问：如何接收移动侦测事件？答：通过 ISAPI 配置 HTTP(S) 推送Event/notification/httpHosts，或使用 SDK 的报警回调。