跳转至

Cómo funciona

Una mirada por dentro: la arquitectura, y la decisión de diseño que evita que el sistema se rompa solo con el tiempo.


Arquitectura

HikvisionZoneBridge — servicio Windows
InventarioCámaras, grupos, credenciales
MIP SDK
grupos, IPs y credenciales
Management ServerFuente de verdad
Un lector por cámaraDetecta flancos por zona
consulta a la cámara
Cámara Hikvision
zona, detección, inicio/fin
Mapeo de eventosTipo + nombre de zona
Envío a Milestone
Analytics Events
puerto 9090
Event Server
Panel web
panel
Navegador

Cuatro piezas, cada una con un trabajo:

  • Inventario — lee de Milestone qué cámaras Hikvision existen, con qué credenciales, y las mantiene al día en cada refresco.
  • Lector por cámara — mantiene una conexión abierta con cada cámara y se entera de cada cambio de zona en el instante en que ocurre, sin preguntar todo el rato.
  • Mapeo de eventos — traduce la zona física de la cámara al tipo de evento de Milestone correspondiente, con el nombre que le pusiste.
  • Panel web — inventario visual, nombres de zona, estado en vivo, botón de prueba.

La decisión de diseño que importa: el mapeo es pegajoso, no posicional

Cada zona de cada cámara tiene un identificador propio, asignado por la cámara. Esos identificadores no son prolijos ni consecutivos — una cámara puede tener zonas activas en 1, 2 y 9, por ejemplo, si en algún momento se borró y recreó una zona intermedia.

La forma ingenua de resolver esto sería numerar por orden: "la primera zona activa es la 1, la segunda es la 2". Es más simple, y es la decisión equivocada: el día que alguien borra una zona en la cámara, todas las que venían después se corren un lugar — y las alarmas que ya armaste en Milestone pasan a apuntar a la zona física equivocada, sin ningún error que lo avise.

Antes de borrar una zonazona 1 → slot 1zona 2 → slot 2zona 9 → slot 3
se borra la zona 2
Si el mapeo fuera posicionalzona 1 → slot 1zona 9 → slot 2 ⚠
mapeo pegajoso
Con mapeo pegajosozona 1 → slot 1zona 9 → slot 3

En el escenario posicional, la regla que apuntaba al slot 2 ahora dispara por una zona distinta a la que el operador cree. Con mapeo pegajoso, cada zona recibe su slot una sola vez, y ese par queda fijo para siempre: si la zona se borra, su slot queda simplemente libre — no se reasigna hasta que aparece una zona genuinamente nueva.

Es una decisión que cuesta un poco más de lógica al principio y ahorra un incidente de seguridad silencioso más adelante.


Alcance de las detecciones

La integración cubre intrusión y cruce de línea, con 5 zonas y 5 líneas por cámara — el mismo límite que ya usa el plugin Hikvision instalado en el mismo sistema, elegido para que la nomenclatura no se vuelva confusa con más tipos de evento de los que un operador puede seguir cómodamente. Cada tipo se emite también con su evento de fin, así que además de alarmar se puede grabar mientras dura el evento.

Convivencia, no reemplazo

Nada de esto reemplaza al driver oficial de Hikvision. El evento genérico de Milestone ("hubo intrusión") sigue llegando exactamente igual que siempre; el nuestro llega al lado, con la zona adentro. Las reglas viejas no se tocan; las nuevas se vuelven posibles.