Skip to content

Uso y operación

Cómo operar la integración una vez instalada: el panel, nombrar zonas, y armar la alarma en Milestone que discrimina por zona.


El modelo, en una imagen

Cámara Hikvision
HikvisionZoneBridge
Milestone
Zona 1
→
slot 1
→
Hikvision Intrusion_1
Zona 2
→
slot 2
→
Hikvision Intrusion_2
Línea 1
→
slot 1 (línea)
→
Hikvision Line Crossing_1

Tres ideas conviene tener claras antes de operar:

  1. Los tipos de evento son fijos y globales — 20 en total, compartidos por todas las cámaras. No se crea un tipo nuevo por cada cámara que se agrega.
  2. El número del tipo (_2) es un slot lógico, no el número de zona de la cámara. El panel siempre muestra las dos numeraciones juntas.
  3. La cámara es el origen del evento. Por eso la alarma se define como tipo + cámara — ahí está la discriminación.

El panel

Cada tarjeta es una cámara, con un color de estado: verde en línea, ámbar reconectando, rojo con más de 5 errores consecutivos. Dentro de cada cámara, una fila por zona — con el tipo de evento que va a emitir, un campo para el nombre, el índice real que muestra la cámara, y un botón para probar el envío sin esperar a que pase algo de verdad.

A la derecha, los últimos eventos en vivo: sirve para confirmar que la zona correcta se activa antes de armar la alarma.


Nombrar las zonas

La cámara no guarda nombres — solo números de zona. El nombre vive en el panel: hacé clic en el campo de texto, escribí el nombre real (Portón Norte, Playa de carga), listo. Se guarda solo, y viaja en la descripción del evento, así que el operador lo ve directo en el Smart Client.


Armar la alarma en Milestone

Este es el objetivo de todo el desarrollo. En Alarmas → Definiciones de alarma → Agregar nueva:

Campo Valor
Nombre Intrusión — Portón Norte
Tipo de evento Hikvision Intrusion_2
Fuentes la cámara correspondiente

Y listo: esa alarma se dispara únicamente cuando hay intrusión en esa zona de esa cámara. Otra alarma con Hikvision Intrusion_1 cubre la otra zona, con su propia prioridad y su propio destinatario si hace falta.

Como se emiten inicio y fin, también se puede grabar mientras dure el evento — regla de inicio en Hikvision Intrusion_2, de fin en Hikvision Intrusion_2 End.

Convive con el evento genérico

La integración no reemplaza al driver de Hikvision, convive con él. Cada intrusión sigue generando el evento genérico de Milestone además del nuestro con la zona — las alarmas que ya tenías armadas sobre el evento genérico siguen funcionando igual.


Operación diaria

Cámara nueva — no hay que hacer nada. Se da de alta en Milestone como siempre, y en el siguiente refresco (cada 5 minutos) aparece sola en el panel, con sus zonas ya mapeadas.

Cambio de contraseña de la cámara — se cambia en Milestone, el servicio la relee sola. No existe un segundo lugar donde actualizarla.

Zona nueva — se detecta sola y toma el primer slot libre.

Zona borrada — el slot queda marcado como huérfano, pero no se recicla automáticamente. Es deliberado: si se reciclara solo, la próxima zona nueva lo tomaría y la alarma que apuntaba ahí empezaría a dispararse por otra zona física, sin ningún error que lo avise.

Más de 5 zonas activas en una cámara — el panel lo marca en rojo en vez de descartar el evento en silencio.


Diagnóstico rápido

Invoke-RestMethod https://localhost:8097/api/probar -Headers @{ 'X-HKZB' = '1' } -Method Post -ContentType application/json -Body (@{
    camaraId = '<id-de-la-camara>'
    tipo     = 'Hikvision Intrusion_2'
} | ConvertTo-Json)

Envía un evento de prueba sin esperar a que alguien camine frente a la cámara — lo mismo que hace el botón probar del panel.

La API completa (/api/camaras, /api/estado, /api/bitacora, /api/zona) está pensada para integrarse con otras herramientas si lo necesitás.