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¶
Tres ideas conviene tener claras antes de operar:
- 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.
- 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. - 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.