Esta guía explica cómo mostrar una cámara Hikvision en Home Assistant mediante ONVIF. Actualiza el artículo anterior para Home Assistant 2025.12.2 con la documentación vigente de Home Assistant y Hikvision. Según el modelo, la integración separada « Hikvision » también puede ofrecer vídeo y eventos; ONVIF es una alternativa interoperable.
1. Activar ONVIF en la cámara
Abra la interfaz web de la cámara usando su IP local. La ruta habitual es « Configuración » → « Red » → « Ajustes avanzados » → « Protocolo de integración ». Active ONVIF y guarde. Cree allí un usuario ONVIF exclusivo para Home Assistant con una contraseña fuerte y única. Para ver vídeo suele bastar un usuario estándar o de medios; conceda solo los permisos necesarios. La cuenta ONVIF es distinta de la cuenta habitual de la cámara.
Compruebe que Home Assistant alcanza la cámara por la red local. Al menos un perfil de vídeo debe emitir en H.264. Si el flujo principal usa H.265, puede configurar el secundario en H.264. Sincronice la hora de la cámara y Home Assistant, por ejemplo mediante NTP.
2. Añadir la cámara a Home Assistant
Abra « Ajustes » → « Dispositivos y servicios ». Si se detecta ONVIF, pulse « Configurar ». Si no, seleccione « Añadir integración » y busque « ONVIF ». Introduzca la IP de la cámara y, cuando corresponda, el puerto ONVIF configurado en su modelo. Utilice el nombre y la contraseña del usuario ONVIF dedicado.
Tras completar la configuración, los perfiles H.264 compatibles deberían aparecer como entidades de cámara. Las alarmas de movimiento o de zonas compatibles pueden generar sensores binarios si la cámara emite esos eventos. Desactive en Home Assistant las entidades que no necesite.
3. Mostrar el vídeo en el panel
Edite el panel y añada una tarjeta de cámara, por ejemplo « Entidad de imagen ». Elija la entidad ONVIF y guarde. Pruebe la vista previa y el directo. Si hay mucho retraso, puede ayudar un subflujo H.264 de menor resolución, según el modelo y la red.
Solución de problemas y seguridad
Si falla la autenticación, revise la cuenta ONVIF, sus permisos, la hora de la cámara y el puerto real. No desactive sin motivo el bloqueo por intentos de inicio de sesión. Si aparece « No se encontraron cámaras utilizables », compruebe primero que existe un perfil H.264.
También puede evaluar las integraciones de Home Assistant « Hikvision » o « Generic Camera ». Introduzca las credenciales en los campos previstos por la integración en lugar de dejarlas en texto claro dentro de una URL RTSP. Evite usar la cuenta administradora salvo que una función concreta la requiera.
