Cómo conectar una cámara IP Hikvision en C# .NET¶

Video Capture SDK .NET Media Blocks SDK .NET

Descripción de la marca¶

Hikvision (Hangzhou Hikvision Digital Technology Co., Ltd.) es el mayor fabricante de equipos de videovigilancia del mundo por cuota de mercado. Fundada en 2001 y con sede en Hangzhou, China, Hikvision produce cámaras IP, DVRs, NVRs y software de gestión de video utilizados en mercados empresariales, gubernamentales y de consumo.

Datos clave:

• Líneas de producto: DS-2CD (cámaras fijas), DS-2DE (cámaras PTZ), DS-76/77/96 (NVRs), DS-7200/7300/7600 (DVRs)
• Soporte de protocolos: ONVIF Profile S/G/T, RTSP, HTTP, ISAPI
• Puerto RTSP predeterminado: 554
• Credenciales predeterminadas: admin / (establecido durante la configuración inicial; firmware antiguo: admin / 12345)
• Soporte ONVIF: Completo -- recomendado para descubrimiento y configuración automática
• Códecs de video: H.264, H.265 (Smart Codec), MJPEG

Patrones de URL RTSP¶

Las cámaras Hikvision utilizan una estructura de URL basada en canales. Los números de canal codifican tanto el canal de la cámara como el tipo de flujo.

Formato de URL¶

rtsp://[USUARIO]:[CONTRASEÑA]@[IP]:[PUERTO]/Streaming/Channels/[ID_CANAL]

Codificación del ID de canal:

• ID de canal = (número_de_cámara * 100) + número_de_flujo
• Flujo 1 = flujo principal, Flujo 2 = subflujo, Flujo 3 = tercer flujo
• Ejemplo: Cámara 1, flujo principal = 101; Cámara 1, subflujo = 102

Cámaras IP (canal único)¶

Canales NVR / DVR¶

Para dispositivos NVR y DVR, cambie el número de cámara en el ID de canal:

Formatos de URL alternativos¶

Algunos modelos Hikvision más antiguos y variantes OEM utilizan patrones de URL diferentes:

Conexión con VisioForge SDK¶

Use la URL RTSP de su cámara Hikvision con cualquiera de los tres enfoques del SDK mostrados en la Guía de Inicio Rápido:

// Hikvision DS-2CD2032-I, main stream
var uri = new Uri("rtsp://192.168.1.64:554/Streaming/Channels/101");
var username = "admin";
var password = "YourPassword";

Para acceder al subflujo, use /Streaming/Channels/102 en su lugar.

Descubrimiento ONVIF¶

Las cámaras Hikvision tienen excelente soporte ONVIF. Use ONVIF para descubrir automáticamente cámaras en su red y obtener sus URIs de flujo sin construir manualmente las URLs RTSP. Consulte la guía de integración ONVIF para ejemplos de código de descubrimiento.

URLs de captura y MJPEG¶

Las cámaras Hikvision también proporcionan endpoints HTTP para capturas y flujos MJPEG:

Solución de problemas¶

"Doble barra" en la ruta de URL¶

Las URLs RTSP de Hikvision usan una ruta que comienza con /Streaming/Channels/. Algunas herramientas o código generan //Streaming/Channels/ (doble barra). Ambas funcionan con cámaras Hikvision, pero use una sola barra para mayor corrección.

Conexión rechazada en el puerto 554¶

• Verifique que RTSP esté habilitado en la interfaz web de la cámara: Configuración > Red > Configuración Avanzada > RTSP
• Comprueba que el puerto RTSP no haya sido cambiado del predeterminado (554)
• Asegúrese de que ningún firewall esté bloqueando el puerto entre su aplicación y la cámara

Fallos de autenticación¶

• Las cámaras Hikvision requieren autenticación digest por defecto. El VisioForge SDK maneja esto automáticamente.
• En firmware más reciente, las credenciales predeterminadas admin/12345 están deshabilitadas. Debe establecer una contraseña segura durante la configuración inicial mediante la herramienta Hikvision SADP o la interfaz web.
• Si se conecta a un NVR, use las credenciales del NVR, no las credenciales individuales de la cámara.

El flujo H.265 no se reproduce¶

• Asegúrese de tener instalado el redistributable del decodificador HEVC
• Alternativamente, configure la cámara para usar codificación H.264 en sus ajustes de video
• Use rtspSettings.UseGPUDecoder = true para decodificación H.265 acelerada por hardware

Alta latencia¶

• Use transporte TCP: rtspSettings.AllowedProtocols = RTSPSourceProtocol.TCP
• Reduzca la latencia del buffer: rtspSettings.Latency = TimeSpan.FromMilliseconds(200)
• Cambie al subflujo (canal 102) para menores requisitos de ancho de banda
• Desactive el audio si no es necesario: audioEnabled: false

Combinado en una sola instancia RTSPSourceSettings (construida vía factory async):

var rtspSettings = await RTSPSourceSettings.CreateAsync(
    uri: new Uri("rtsp://192.168.1.100:554/Streaming/Channels/102"),  // subflujo
    login: "admin",
    password: "password",
    audioEnabled: false);

rtspSettings.UseGPUDecoder    = true;                        // decodificación H.265 acelerada por hardware
rtspSettings.AllowedProtocols = RTSPSourceProtocol.TCP;      // transporte TCP
rtspSettings.Latency          = TimeSpan.FromMilliseconds(200);

Preguntas frecuentes¶

¿Cuál es la URL RTSP predeterminada para cámaras Hikvision?

La URL RTSP estándar para cámaras Hikvision es rtsp://admin:password@IP_CAMARA:554/Streaming/Channels/101 para el flujo principal. Reemplace admin y password con las credenciales de su cámara, e IP_CAMARA con la dirección IP de la cámara. Use el canal 102 para el subflujo.

¿Cómo encuentro la dirección IP de mi cámara Hikvision?

Use la herramienta Hikvision SADP (Search Active Devices Protocol), que es una utilidad gratuita que descubre todos los dispositivos Hikvision en su red local. Alternativamente, consulte la lista de clientes DHCP de su router o use el descubrimiento de dispositivos ONVIF con el VisioForge SDK.

¿Puedo conectarme a un NVR Hikvision y ver canales de cámaras individuales?

Sí. Use el mismo formato de URL RTSP pero cambie el número de canal. La cámara 1 es el canal 101 (principal) o 102 (sub), la cámara 2 es el canal 201/202, y así sucesivamente. La fórmula es: ID de canal = (número_de_cámara x 100) + número_de_flujo.

¿El VisioForge SDK soporta H.265+ (Smart Codec) de Hikvision?

Sí. El SDK soporta decodificación estándar H.265/HEVC. El H.265+ de Hikvision es una optimización de compresión propietaria que produce flujos H.265 estándar, por lo que funciona con cualquier decodificador compatible con H.265.

Recursos relacionados¶

• Todas las Marcas de Cámaras — Directorio de URLs RTSP
• Guía de Conexión LTS — OEM de Hikvision, usa el mismo formato de URL
• Guía de Conexión EZVIZ — Marca de consumo de Hikvision
• Tutorial de Vista Previa de Cámara IP
• Instalación del SDK y Ejemplos