Este artículo explica cómo integrar una aplicación externa, como un software de CRA, con Safire Viewer Player mediante la ejecución de SafireViewerLauncher.exe.
El launcher permite abrir la ventana de Safire Viewer con vídeo en directo y/o playback de un dispositivo y cámara específico para reproducir o descargar eventos de alarma. Todo esto utilizando solo parámetros de línea de comandos.
Requisitos Previos
Antes de comenzar asegúrese de haber completado la instalación explicada en este artículo:
Safire Viewer - Standalone | Guía de Instalación
1. Abrir una terminal de Windows
Para ejecutar manualmente los comandos de este artículo, primero debe abrir una terminal de Windows.
Puede utilizar cualquiera de las siguientes opciones:
- Símbolo del sistema — CMD
- Windows PowerShell
- Terminal de Windows
Abrir el Símbolo del sistema
- Abra el menú Inicio.
- Escriba
cmd. - Seleccione Símbolo del sistema.
2. Sintaxis de invocación
SafireViewerLauncher se añade en la instalación al PATH del sistema, por lo que el comando puede ser ejecutado desde cualquier ubicación. La aplicación se ejecuta utilizando la siguiente sintaxis:
SafireViewerLauncher.exe [opciones]
Ejemplo básico:
SafireViewerLauncher.exe --address 210235TALXXXXXXXX_[OWNER] --channel 1
En la versión actual, el parámetro --address debe contener el número de serie del dispositivo Uniview. En el punto 7.Uniview se habla a fondo este tema.
El numero de serie puede verlo
3. Formatos de parámetros admitidos
El parser admite diferentes formatos de invocación.
Alias corto
Los alias cortos distinguen entre mayúsculas y minúsculas.
SafireViewerLauncher.exe -a 210235TALXXXXXXXX
Por ejemplo, -N y -n no se consideran el mismo parámetro.
Alias largo
Los alias largos no distinguen entre mayúsculas y minúsculas.
SafireViewerLauncher.exe --address 210235TALXXXXXXXX
Las siguientes invocaciones se interpretan de la misma forma:
SafireViewerLauncher.exe --address 210235TALXXXXXXXX SafireViewerLauncher.exe --ADDRESS 210235TALXXXXXXXX SafireViewerLauncher.exe --Address 210235TALXXXXXXXX
Estilo Windows
También se admite el formato habitual de parámetros de Windows:
SafireViewerLauncher.exe /address 210235TALXXXXXXXX
Valor en el mismo argumento
El parámetro y su valor pueden separarse mediante el signo igual:
SafireViewerLauncher.exe --address=210235TALXXXXXXXX
SafireViewerLauncher.exe -a=210235TALXXXXXXXX
Parámetros desconocidos
Los parámetros desconocidos y los valores sueltos que no estén asociados a ningún parámetro se ignoran.
Estos valores no interrumpen el arranque de la aplicación.
SafireViewerLauncher.exe --address 210235TALXXXXXXXX --parametro-desconocido prueba
4. Parámetros disponibles
| Corto | Largo | Tipo | Descripción |
|---|---|---|---|
-a |
--address |
Texto | Identificador del dispositivo. En Uniview, corresponde al número de serie (añadiendo al final "_[Owner]", en caso de no ser el propietario), nombre del dispositivo, IP, DNS. Más información en Safire Viewer - Formas de conectase a Uniview P2P |
-p |
--port |
Número | Puerto de control del dispositivo. Solo para conexiones IP o DNS |
-b |
--rtsp-port, --rtspport
|
Número | Puerto RTSP, por ejemplo 554. Solo para conexiones IP o DNS |
-u |
--username, --user
|
Texto | Usuario. En caso de Uniview, el correo electrónico del usuario de la nube de EZCloud |
-w |
--password |
Texto | Contraseña de EZCloud |
-m |
--manufacturer |
Texto | Fabricante del dispositivo. Por defecto es "Uniview" |
-c |
--channel, --camera
|
Número | Número de canal o cámara |
-N |
--cameraname |
Texto | Nombre de la cámara que se mostrará en el reproductor |
-s |
--stream |
0 o 1
|
0 para el stream principal y 1 para el substream o stream extra |
-z |
--zero |
Booleano | Activa o desactiva Zero Channel. Siempre que el NVR lo admita |
-d |
--dual |
Booleano | Activa o desactiva el modo dual: directo y reproducción |
-l |
--clip |
Descarga el clip automáticamente al abrir el player. Esto produce que el Player tarde en visualizarles | |
-t |
--ptz |
Booleano | Activa o desactiva los controles PTZ |
-r |
--autorec |
Booleano | Activa o desactiva la grabación automática al abrir |
-e |
--pre |
Número | Tiempo anterior al evento de alarma, expresado en segundos |
-o |
--post |
Número | Tiempo posterior al evento de alarma, expresado en segundos |
-v |
--date |
Fecha | Fecha y hora del evento. El playback empezará su reproducción con el date menos pre |
-k |
--key |
Texto | Clave utilizada para el cifrado del stream. No es necesario en Unview |
-h |
--help |
— | Muestra la ayuda integrada y finaliza la ejecución |
Importante: Los alias cortos distinguen entre mayúsculas y minúsculas
5. Parámetros booleanos
Los siguientes parámetros son booleanos:
zerodualclipptzautorec
Activación sin valor
Cuando un parámetro booleano se incluye sin valor, se interpreta como activado.
SafireViewerLauncher.exe --ptz
La instrucción anterior equivale a:
SafireViewerLauncher.exe --ptz 1
Valores considerados verdaderos
Los siguientes valores activan el parámetro:
1 true on yes si
Ejemplo:
SafireViewerLauncher.exe --dual true --ptz on
Valores considerados falsos
Los valores 0, false, off y no desactivan el parámetro.
SafireViewerLauncher.exe --dual 1 --clip off
En este ejemplo:
- El modo dual queda activado.
- La funcionalidad de clips queda desactivada.
6. Fecha y hora del evento
La fecha del evento se configura mediante uno de los siguientes parámetros:
-v --date
La presencia de este parámetro activa automáticamente el envío de la fecha del evento mediante evdate. No es necesario incluir ningún parámetro adicional.
Formatos admitidos
yyyy-MM-dd HH:mm:ss yyyy-MM-dd HH:mm yyyy-MM-dd yyyy/MM/dd HH:mm:ss dd-MM-yyyy HH:mm:ss dd/MM/yyyy HH:mm:ss
Ejemplos:
SafireViewerLauncher.exe --date "2026-07-16 17:45:00"
SafireViewerLauncher.exe --date "2026-07-16 17:45"
SafireViewerLauncher.exe --date "2026/07/16 17:45:00"
SafireViewerLauncher.exe --date "16/07/2026 17:45:00"
Utilización de la fecha y hora actual
Los valores now y ahora utilizan la fecha y hora actuales del equipo:
SafireViewerLauncher.exe --date now
SafireViewerLauncher.exe --date ahora
También se utiliza la fecha y hora actual cuando --date se incluye sin ningún valor:
SafireViewerLauncher.exe --date
Invocación sin fecha de evento
Cuando no se incluye -v ni --date, el launcher no envía ninguna fecha de evento. El playback empezará a reproducirse la hora actual menos 2 minutos.
Ejemplo completo
SafireViewerLauncher.exe -a 210235TALXXXXXXXX -c 3 -v "2026-07-16 17:45:00"
Esta llamada abre el canal 3 del dispositivo e indica que el evento se produjo el 16 de julio de 2026 a las 17:45:00.
7. Uniview
En esta versión, Uniview es el único fabricante compatible.
Además, Uniview es el valor predeterminado de -m y --manufacturer, por lo que normalmente no es necesario indicarlo en cada llamada.
Dirección del dispositivo
En dispositivos Uniview, -a o --address recomendamos utilizar el número de serie del dispositivo, seguido del "_[OWNER]" en caso de no ser el propietario del dispositivo.
En este apartado explicamos este tema:
Safire Viewer - Formas de conectase a Uniview P2P
SafireViewerLauncher.exe --address 210235TALXXXXXXXX
Credenciales predeterminadas
Durante la instalación de Safire Viewer – Player se guardan las credenciales de la cuenta Cloud de Uniview.
En el funcionamiento habitual no es necesario incluir los siguientes parámetros en cada llamada:
-u --username --user -w --password
El launcher utilizará las credenciales almacenadas durante la instalación.
Sobrescritura de credenciales
Los valores enviados mediante la línea de comandos tienen prioridad sobre los valores guardados durante la instalación. En caso de querer conectarse a otra cuenta diferente a la almacenada por defecto, se puede utilizar lo siguiente:
SafireViewerLauncher.exe --address 210235TALXXXXXXXX --username usuario --password clave
La modificación solamente afecta a esa llamada y no sustituye permanentemente la configuración almacenada.
Ejemplo mínimo
El siguiente comando utiliza las credenciales configuradas durante la instalación:
SafireViewerLauncher.exe --address 210235TALXXXXXXXX --channel 1
Ejemplo con credenciales explícitas
SafireViewerLauncher.exe --address 210235TALXXXXXXXX --manufacturer Uniview --username correo@dominio.com --password XXXX --channel 1
8. Ejemplos de integración
Utilizar el stream principal
SafireViewerLauncher.exe --address 210235TALXXXXXXXX --channel 2 --stream 0
Utilizar el substream
SafireViewerLauncher.exe --address 210235TALXXXXXXXX --channel 2 --stream 1
Reproducir un evento de alarma
SafireViewerLauncher.exe -a 210235TALXXXXXXXX -c 1 -v "2026-07-16 17:45:00" -e 10 -o 15
En este ejemplo:
- El evento se produce a las
17:45:00. - La reproducción comienza 10 segundos antes.
- El periodo posterior al evento es de 15 segundos.
El intervalo resultante comprende desde las 17:44:50 hasta las 17:45:15.
Abrir el modo dual
SafireViewerLauncher.exe --address 210235TALXXXXXXXX --channel 1 --dual
El reproductor mostrará simultáneamente:
- El vídeo en directo.
- La reproducción asociada al evento.
Para situar la reproducción en un evento concreto, debe incluirse también --date:
SafireViewerLauncher.exe --address 210235TALXXXXXXXX --channel 1 --dual --date "2026-07-16 17:45:00"
Activar PTZ
SafireViewerLauncher.exe --address 210235TALXXXXXXXX --channel 1 --ptz
Los controles PTZ estarán disponibles siempre que la cámara y la configuración del dispositivo sean compatibles.
Activar clips
SafireViewerLauncher.exe --address 210235TALXXXXXXXX --channel 1 --clip
Activar la grabación automática
SafireViewerLauncher.exe --address 210235TALXXXXXXXX --channel 1 --autorec
Modo dual con PTZ y clips
SafireViewerLauncher.exe -a 210235TALXXXXXXXX -c 1 -d -t -l
También puede utilizarse una combinación de alias cortos y largos:
SafireViewerLauncher.exe -a 210235TALXXXXXXXX -c 1 -d -t --clip
Mostrar la ayuda integrada
SafireViewerLauncher.exe --help
La aplicación muestra la ayuda disponible y finaliza la ejecución.
9. Ejecución desde otra aplicación
Un software de CRA puede invocar directamente el ejecutable utilizando su ruta completa.
Ejemplo conceptual:
"C:\Ruta\De\Instalacion\Safire Viewer\SafireViewerLauncher.exe" --address 210235TALXXXXXXXX --channel 1
Cuando se utilice una ruta completa que contenga espacios, la ruta del ejecutable debe escribirse entre comillas.
Ejemplo con reproducción de alarma:
"C:\Ruta\De\Instalacion\Safire Viewer\SafireViewerLauncher.exe" --address 210235TALXXXXXXXX --channel 1 --date "2026-07-16 17:45:00" --pre 10 --post 15
10. Comportamiento al recibir varios eventos
El software de CRA puede ejecutar SafireViewerLauncher.exe tantas veces como eventos reciba.
Safire Viewer no abre una ventana nueva por cada llamada. La aplicación:
- Reutiliza la ventana existente.
- Cambia el contenido al nuevo evento.
- Sitúa la ventana en primer plano.
- Evita la acumulación de múltiples ventanas.
Ejemplo de un primer evento:
SafireViewerLauncher.exe -a 210235TALXXXXXXXX -c 1 -v "2026-07-16 17:45:00"
Ejemplo de un segundo evento:
SafireViewerLauncher.exe -a 210235TALXXXXXXXX -c 3 -v "2026-07-16 17:46:30"
La segunda llamada actualiza la ventana existente para mostrar el evento del canal 3.
11. Cierre y ejecución en segundo plano
Al pulsar el botón de cierre de la ventana, representado mediante una X, la aplicación no se cierra por completo.
Safire Viewer permanece activo en la bandeja del sistema para poder atender inmediatamente la siguiente invocación.
Para cerrar completamente la aplicación:
- Localice el icono de Safire Viewer en la bandeja del sistema.
- Pulse sobre el icono con el botón derecho.
- Seleccione Salir.
Una vez cerrada completamente, la siguiente invocación volverá a iniciar la aplicación.
12. Recomendaciones de seguridad
Evitar el envío de contraseñas por línea de comandos
Las contraseñas enviadas mediante -w o --password pueden quedar expuestas en:
- Listados de procesos.
- Registros del sistema.
- Scripts de integración.
- Ficheros de log.
- Herramientas de diagnóstico.
- Historiales de terminal.
Siempre que sea posible, utilice las credenciales Cloud de Uniview configuradas durante la instalación.