分辨率

400 万像素（2688 × 1520）

镜头

2.7-13.5 mm 电动变焦

红外距离

最远 60 米

最低照度

0.003 lux @ F1.5

视频编码

H.265 / H.264 / MJPEG

供电

PoE (802.3af) / 12 VDC

接口

RJ45 10/100M

快速入门 —— 大华 IPC-HFW4433R-ZS

让这款枪型摄像机联网并推流。以下均为参考模式；请以官方大华 IPC HTTP API / NetSDK对应你固件的文档。

1. 发现设备

使用大华ConfigTool（Windows）或扫描子网：

# example: discover Dahua devices
nmap -p 37777,80,554 192.168.1.0/24

默认 IP 通常为 DHCP；出厂 Web 界面位于http://<ip>.

2. 激活并设置密码

使用默认凭据登录 Web 界面admin / admin（或为空），然后设置强密码。设备出厂时未激活并且必须激活。

3. 实时视频流（RTSP）

ffplay "rtsp://admin:PASSWORD@192.168.1.65:554/cam/realmonitor?channel=1&subtype=0"
# subtype=0 main stream, subtype=1 sub stream

4. 验证 HTTP API

curl --digest -u admin:PASSWORD \
  "http://192.168.1.65/cgi-bin/magicBox.cgi?action=getSystemInfo"

成功响应会返回version=和serialNumber=行。

后续步骤

• API 参考 →API标签页（CGI 示例）。
• 应用对接 →SDK标签页（NetSDK）。

API 参考 —— 大华 HTTP API（IPC-HFW4433R-ZS）

大华摄像机提供一套基于 CGI 的 HTTP API之下/cgi-bin/...，并使用以下方式鉴权：HTTP Digest（部分接口需要经由以下方式获取的会话令牌：global.login）。

仅为参考模式。参数名称与可用性因固件而异 —— 请以大华 IPC HTTP API文档。

鉴权

curl --digest -u admin:PASSWORD "http://192.168.1.65/cgi-bin/magicBox.cgi?action=getSystemInfo"

对于程序化会话，调用global.login获取会话令牌，再附加到session=TOKEN用于后续 CGI 调用。

常用接口

示例：获取配置

curl --digest -u admin:PASSWORD \
  "http://192.168.1.65/cgi-bin/configManager.cgi?action=getConfig&name=VideoInOptions"

示例：快照

curl --digest -u admin:PASSWORD \
  "http://192.168.1.65/cgi-bin/snapshot.cgi?channel=1" -o snap.jpg

说明

• 媒体端口554（RTSP）、TCP37777为 SDK/DMSS 使用的私有传输通道。
• ONVIF 同样支持跨厂商客户端。

SDK —— 大华 NetSDK（IPC-HFW4433R-ZS）

对于录像、实时回放、云台控制与报警处理，请使用大华 NetSDK（二进制37777协议）。在媒体与事件方面，它比 CGI 能力更强。

参考概述。请从大华官方开发者门户获取 NetSDK（头文件 + 库）与示例。

语言与平台

• C / C++—— 原生 NetSDK，支持 Windows 与 Linux（含 arm）。
• C#—— 通过所提供的NetSDKCS封装。

典型流程（C# 参考）

// Pseudocode — adapt to NetSDK's wrapped declarations
NETSDK.Init();
int lLoginID = NETSDK.Login(ip, port37777, "admin", password, out deviceInfo);
if (lLoginID <= 0) throw new Exception("Login failed");
// StartRealPlay(lLoginID, channel, windowHandle) ...
NETSDK.Logout(lLoginID);
NETSDK.Cleanup();

最佳实践

• 调用Init()每个进程一次；Cleanup()在退出时。
• 如需移动侦测/IO 事件，请注册报警回调。
• 请将 32/64 位 SDK 二进制文件与你的应用位数相匹配。

常见问题 —— 大华 IPC-HFW4433R-ZS

问：摄像机无法推流 / RTSP 超时。答：确认已激活，且admin密码。确认设备 IP 及端口554可达。

问：CGI 返回 401。答：使用 Digest 鉴权（curl --digest）。对于状态化调用，通过以下方式获取会话：global.login并传入session=.

问：忘记了管理员密码。答：使用 ConfigTool 的「密码重置」，配合设备的重置文件/安全码，或联系厂商渠道。

问：SDK 使用哪个端口？答：TCP37777为 NetSDK/DMSS 专用传输通道。RTSP 则554；HTTP80.

问：ONVIF 与 HTTP API 怎么选？答：ONVIF 适用于跨厂商客户端；大华 HTTP API 与 NetSDK 则提供完整厂商特性（IVS 事件、电动镜头控制）。