# @camstack/addon-provider-hikvision 中文文档

规范地址：https://npmcn.com/package/%40camstack/addon-provider-hikvision/

版本：1\.2\.186
npm 元数据更新时间：2026-11-08T12:24:54.903Z
中文译文更新时间：2026-11-09T00:58:19.336Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40camstack/addon-provider-hikvision
原文对照：https://npmcn.com/package/%40camstack/addon-provider-hikvision/?lang=original
项目主页：https://camstack-docs.zentik.app/
源码仓库：https://github.com/camstack/server

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：6.9 MB，10 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- peer 依赖：zod ^4\.3\.6，@camstack/types \*
- 首次发布：2026-05-07T19:04:38.462Z
- 最新版本发布：2026-11-08T12:24:54.736Z
- 近 30 天下载量：6455（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：238（近 12 个月 238 个）

## 中文简介

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

## 安装

```sh
npm install @camstack/addon-provider-hikvision
```

也可以使用：`pnpm add @camstack/addon-provider-hikvision`、`yarn add @camstack/addon-provider-hikvision`、`bun add @camstack/addon-provider-hikvision`

## README

# @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枢纽。 只有在上述放置允许的情况下才使用一种剂.

## 文档

-   [docs/addons/addon-professor-hikvision.md (中文(简体) )](https://github.com/camstack/server/blob/main/docs/addons/addon-provider-hikvision.md)
-   [文件/建筑/设备-模型](https://github.com/camstack/server/blob/main/docs/architecture/device-model.md)
-   [软件包/addon-professor-hikvision/AGENTS.md](https://github.com/camstack/server/blob/main/packages/addon-provider-hikvision/AGENTS.md)

见 [变动情况](https://npmcn.com/package/%40camstack/addon-provider-hikvision/CHANGELOG.md) 对于每个版本的变化.

## 常见问题

### @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 和提交记录判断。