@camstack/addon-provider-hikvision

中文文档
1.2.186发布于 2026/11/08MITESM + CJS近 30 天下载 6455

CamStack的 Hikvision相机设备提供商添加了 – ISAPI over HTTP( S) 并带有摘要认证( snapshot, 提醒流, RTSP 发现)

中文使用文档
文档目录9 节
  1. v0.1 地表线
  2. v0.2 表面( 添加)
  3. 推迟到v0.3+
  4. 页:1
  5. 参考资料
  6. 它提供的东西
  7. 配置
  8. 所需资源
  9. 文档

@camstack/addon-professor-hikvision (英语)

Hikvision ISAPI相机/CamStack的NVR提供商. HTTP(S) ISAPI 使用 HTTP Digest auth 将RTSP URL 交给 Camstack 流媒体经纪人进行视频牵引(没有进行中视频工作).

v0.1 地表线

  • 连接: ISAPI over HTTP 或 HTTPS, digit auth (RFC 7616, MD5+qop=auth). HTTPS 用途 rejectUnauthorized: false 因为Hikvision号的舰只默认会自动签署证书.
  • 探测数字 : /ISAPI/System/deviceInfo — 用于添加- Device 模式的测试按钮 + 由 onCreateDevice 以确认相机响应并坚持模型/序列缓存.
  • 抓图数字 : /ISAPI/Streaming/channels/{id}/picture?snapShotImageType=JPEG (登记为 snapshot 原生盖;系统快照包装手柄可缓缓取出+上部入睡取出.
  • 重启数字 : /ISAPI/System/reboot (登记为 reboot 原生盖.
  • 流出发现数字 : /ISAPI/Streaming/channels 列出单相机设备和NVR上的每对相机(相机,插槽). 每个已启用的条目都作为 pull-rtsp 来源(rtsp://user:pass@host:554/Streaming/Channels/{id}?transportmode=unicast) (中文(简体) ).
  • 警报流: 订阅 /ISAPI/Event/notification/alertStream; 多部分解析器输出 EventCategory.Motion (带有歇斯底里语:move → service 3s silence)并 EventCategory.NativeDetection (智能事件:横行、区域进入/出走、实地探测——班名通过 HIKVISION_AI_CLASS_MAP) (中文(简体) ).

v0.2 表面( 添加)

  • 波兹语NAME —— 说 ptz 注册的上限 /PTZCtrl/channels/{id}/capabilities 报告任何平面/倾斜/缩放。 方法: move (一发500毫米后自动停止), continuousMove, (中文(简体) ), stop, (中文(简体) ), getPresets (单位:千美元)/presets, (中文(简体) ), goToPreset (单位:千美元)/presets/{id}/goto, (中文(简体) ), goHome (预设代号的别名) 1) (中文(简体) ). 速度范围 - 100..+每轴100作为Hikvision文档;被夹在发送上.
  • 辅助光线 —— 说 switch + 键 brightness 注册的上限 /Image/channels/{id}/supplementLight/capabilities 广告任何非close 模式。 "上"模式是决定性的: colorVuWhiteLight 当存在时( 更新的 ColorVu 固件), 否则第一个非close 模式。 亮度 0. 100 — 当灯光关闭时, 亮度写作被隐藏并应用到下一个 setState({on:true})。 。 。 .
  • 警示/ 提醒输出 —— 说 switch 注册的上限 /System/IO/inputs 列出至少一个提醒输入端口。 移植的默认值 1 (典型的内置-siren GPIO). 注:相机边 连接方法 (Confulation → Evolution → Linkage Method)必须配置,以在输入翻转时放出警笛音/strobe——API只切换输入状态. v0.2限制:当补充光和警报同时存在时,补充光拥有 switch 盖; 警报登记日志并跳过。 儿童辅助装置(每盖一具)在v0.3中着陆以固定相撞.

探测器每个相机寿命运行一次(第一次成功之后) publishToBroker);结果被缓存到 deviceCache.{hasPtz,hasSupplementalLight,hasAlarmIo} 因此,下一个靴子可以短路 不重试。 Cap注册本身在运行时总是被重新处理.

推迟到v0.3+

  • 儿童辅助装置 • 型号警笛/作为单独子女的辅助灯光 IDevice 行(parent DeviceId =相机),所以两个开关不必共享父的 switch 盖. 镜像再链接 ReolinkAccessory 模式.
  • 双向音频( intercom) —— 说 /ISAPI/System/TwoWayAudio/... 加 RTP 接力;在Camstack 添加一个其他提供者也可以执行的互通封顶之前,超出范围.
  • AI 缩略图转发 - 警报流分析器看到 image/jpeg 用于跟踪智能检测事件但将其丢弃的部分。 虎克干净地降落在 pumpAlarmStream 当消费者要求它.
  • PTZ 位置回读 —— 说 /PTZCtrl/channels/{id}/status 固执于器械;今天,我们返回一个根茎 {0,0,0} 页:1 getPosition。 。 。 .

页:1

  • 通道 id 编码: 希克视的使用 {cameraNumber}{streamSlot} —— 说 101 =相机1/主电路, 102 =相机1/分机, 201 =相机2/主电. 单相机设备产量 native:main 编号 : native:sub 相机流ID; 多通道 NVRs 产量 ch{N}-main 编号 : ch{N}-sub。 。 。 .
  • 旧 NVR 倒置: 2018年之前的NVRs(DS-7600系列和相类似)缺乏 /ISAPI/Streaming/channels提供商倒回合成器 [101, 102] 频道设置 视频仍然发布.
  • 运动解除:Hikvision在运动活动时每~1s会点火VMD事件. 司机会翻车 motion 上限为 detected: true 3s的静默,然后转回 detected: false 活动总线上同时释放出已激活和已失效的过渡.

参考资料

  • ISAPI Service v2 & v3 specs (Hikvision ISAPI doc package-供应商下载).

软件包 @camstack/addon-provider-hikvision 时间npm.

它提供的东西

  • 影视 (单位:千美元)provider-hikvision: Hikvision ISAPI相机/NVR提供商——发现RTSP流,抓取快照,解析出警报事件流. 类别:供应商.
    • 能力: device-provider, (中文(简体) ), stream-params, (中文(简体) ), recording-onboard, (中文(简体) ), motion-zones, (中文(简体) ), privacy-mask, (中文(简体) ), day-night, (中文(简体) ), image-settings, (中文(简体) ), failure-contribution, (中文(简体) ), videoclips。 。 。 .

配置

从 System, Addons, 此加词, 设置( 设备的设置在设备页面上) 编辑这些 。 密码字段被存储在密钥链中 .

添加设备

  • 相机: 名称
  • 证书:用户名、密码
  • 连接:相机 IP, 端口, 使用 HTTPS

每台设备设置

  • 补充光:模式 (上),默认亮度,模式,亮度调节器,IR亮度,白光亮度
  • 警报/警报输出:警报输入端口,在(ms)后自动释放
  • 连接:相机 IP, 端口, 使用 HTTPS, RTSP 传输, 用户名, 密码
  • 相机上运动(VMD):运动探测,灵敏度
  • 图片:亮度,对比度,饱和度,锐度,WDR,WDR级别,日/夜
  • 时间/ NTP: 时区, 时间同步, NTP 服务器, NTP 端口, 同步间隔( min), 手动日期和时间, 同步时间
  • 双向音频:模式
  • 双向音频通道:音频解码器,输入源,扬声器卷,减少噪音
  • 4个科室

所需资源

  • 安置:只设枢纽.
  • 附加安装的运行时间依赖性 : onvif, (中文(简体) ), werift。 。 。 .
  • 一个CamStack枢纽。 只有在上述放置允许的情况下才使用一种剂.

文档

见 变动情况 对于每个版本的变化.

版本与发布记录

@camstack/addon-provider-hikvision 共发布 238 个版本,首次发布于 2026/05/08;过去 12 个月发布了 238 个版本。

版本发布日期距今
1.2.186latest2026/11/08今天
1.2.1852026/11/072 天前
1.2.1842026/11/072 天前
1.2.1832026/11/063 天前
1.2.1822026/11/054 天前
1.2.1812026/11/054 天前

关于 @camstack/addon-provider-hikvision 的常见问题

@camstack/addon-provider-hikvision 是什么?

CamStack的 Hikvision相机设备提供商添加了 – ISAPI over HTTP( S) 并带有摘要认证( snapshot, 提醒流, RTSP 发现)

如何安装 @camstack/addon-provider-hikvision?

在项目目录运行 npm install @camstack/addon-provider-hikvision,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:zod(^4.3.6)、@camstack/types(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@camstack/addon-provider-hikvision 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/camstack__addon-provider-hikvision 是否存在。

@camstack/addon-provider-hikvision 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@camstack/addon-provider-hikvision 可以商用吗?

@camstack/addon-provider-hikvision 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@camstack/addon-provider-hikvision 的下载量有多少?

根据 npm 官方下载统计,@camstack/addon-provider-hikvision 在 2026/10/09 – 2026/11/07 这 30 天内被下载 6,455 次,日均约 215 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@camstack/addon-provider-hikvision 还在维护吗?

最新版本 1.2.186 发布于 2026/11/08(今天);至今共发布 238 个版本,其中过去 12 个月发布了 238 个;首次发布于 2026/05/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。