Manual de usuario de SoftPlayer

Extraer SoftPlayer en la máquina de destino y verificar que el entorno cumple los requisitos.

1. Confirme que la máquina de destino sea Windows 10/11 x64.
2. Extraiga el paquete de SoftPlayer en un directorio permanente, p. ej. C:\SoftPlayer\.
3. Verifique que el directorio contenga SoftPlayer.exe, appsettings.json y la estructura de subdirectorio SoftPlayerMedia\.
4. Para reproducción de video 8K, asegúrese de que la máquina tenga una GPU compatible con decodificación por hardware (GTX 1060+ o equivalente); 4K y por debajo funcionan con gráficos integrados.

• SoftPlayer.exe es visible en el directorio extraído.
• El directorio SoftPlayerMedia\ está precreado con subdirectorios: Video, StandBy, Audio, PPT, etc.

• Coloque SoftPlayer en una ruta estable — los archivos de medios, registros y estado de licencia se guardan relativos al directorio del programa.
• Se recomienda almacenamiento SSD con velocidad de lectura de 200 MB/s+ para una reproducción más fluida en alta resolución.

Confirmar que el programa se inicia correctamente y completar la configuración inicial.

1. Haga doble clic en SoftPlayer.exe para iniciar (no se requieren permisos de administrador).
2. En el primer inicio, el programa abre la guía de Inicio Rápido en el navegador predeterminado (solo en el primer inicio; los inicios posteriores omiten esto).
3. Después de leer la guía, visite http://localhost:8766/ en un navegador para abrir la consola de administración.
4. En la pestaña Dashboard, confirme que el estado del reproductor sea normal y que la información de versión/licencia sea visible.

• El navegador abre correctamente la consola de administración (http://localhost:8766/) y muestra el Dashboard.
• El número de versión y el estado de la licencia son visibles en el encabezado de la consola.

Para deshabilitar la guía del primer inicio, establezca System.ShowQuickStartOnFirstRun en false en appsettings.json.

Controlar con éxito el reproductor mediante UDP y confirmar que el canal de control funciona.

1. Coloque un archivo de video (p. ej. test.mp4) en el directorio SoftPlayerMedia\Video\.
2. Abra PowerShell y ejecute los siguientes comandos:
3. $udp = New-Object System.Net.Sockets.UdpClient
4. $data = [System.Text.Encoding]::UTF8.GetBytes("video:test.mp4")
5. $udp.Send($data, $data.Length, "127.0.0.1", 7600)
6. $udp.Close()
7. Observe si la ventana de SoftPlayer comienza a reproducir el video especificado.

• La ventana de SoftPlayer comienza a reproducir el archivo de video especificado.
• La pestaña Log de la consola de administración muestra que el comando fue recibido.

• Archivo de video colocado en el directorio incorrecto (debe estar en SoftPlayerMedia\Video\, no en la raíz del programa).
• Puerto incorrecto (el predeterminado es 7600, no el puerto de la consola de administración 8766).

Dominar el formato de comandos y entender las respuestas exitosas vs. fallidas.

1. Formato de comando: comando:argumento, p. ej. video:show.mp4 o volume:80.
2. Los comandos sin argumento pueden enviarse como solo el nombre del comando (los dos puntos son opcionales), p. ej. play.
3. Formato de respuesta exitosa: OK:comando-original, p. ej. OK:video:show.mp4.
4. Formato de respuesta fallida: ERR:comando-original:mensaje-de-error.
5. Para rutas de archivos de medios, solo se necesita el nombre del archivo — el reproductor busca automáticamente en el subdirectorio correspondiente: video: busca en SoftPlayerMedia/Video/.

• Una respuesta con prefijo OK después de enviar un comando confirma el formato correcto y la ejecución.
• Una respuesta ERR incluye una razón específica (archivo no encontrado, error de formato, etc.).

Para especificar un subdirectorio, use una barra diagonal: video:subcarpeta/video.mp4 busca en SoftPlayerMedia/Video/subcarpeta/.

Dominar todos los comandos relacionados con la reproducción de video.

1. Reproducir un video local: video:nombre_archivo.mp4 (busca en directorio Video).
2. Reproducir un flujo de video de red: webvideo:URL (admite flujos HTTP/HTTPS/RTSP/RTMP/UDP).
3. Reproducir/Reanudar: play: (reanudar medios pausados).
4. Pausar: pause: (pausar medios actuales).
5. Detener y volver al standby: stop: (vuelve a la pantalla de bienvenida / bucle de standby).
6. Detención completa / pantalla negra: stoped: (pantalla negra de ahorro de energía).
7. Reproducir de nuevo los medios actuales: replay:.
8. Control de progreso: seek:milisegundos (saltar a posición), forward: (saltar 10 s adelante), backward: (saltar 10 s atrás).
9. Velocidad de reproducción: speed:1.5 (admite 1,5x, 2,0x, etc.).

• Después del comando video:, el reproductor comienza a reproducir el archivo especificado.
• Después del comando stop:, vuelve a la pantalla de standby (si el archivo de standby está configurado).

• Para standby de larga duración en exposiciones, use standby: para hacer un bucle de un archivo de standby en lugar de stoped: pantalla negra (la pantalla negra puede hacer que los visitantes piensen que el dispositivo está roto).
• stop y stoped tienen semánticas diferentes: stop vuelve a la pantalla de bienvenida; stoped muestra una pantalla completamente negra.

Dominar los comandos de ajuste de volumen y control de reproducción de audio.

1. Establecer volumen (0-100): volume:80 (establece en valor exacto).
2. Subir volumen 10%: volup: (aumenta un 10% por llamada).
3. Bajar volumen 10%: voldown: (disminuye un 10% por llamada).
4. Alternar silencio: mute: (alternar entre silenciado y sin silencio).
5. Silenciar explícitamente: muteon:.
6. Dessilenciar explícitamente: muteoff:.
7. Reproducir un archivo de audio: audio:nombre_archivo.mp3 (busca en SoftPlayerMedia/Audio/).
8. Detener audio: audiostoped:.

• Después de volume:50, el volumen del reproductor cae al 50%.
• mute: alterna entre sonido y silencio.

Dominar los comandos de lista de bucle, paginación de PPT y carga web.

1. Hacer un bucle de una lista de reproducción: listloop:archivo1.mp4;archivo2.mp4;archivo3.mp4 (separar archivos con punto y coma).
2. Reproducción secuencial (detener al final): liststop:nombre_archivo.
3. Pista siguiente: next:, Pista anterior: prev:.
4. Abrir PPT en pantalla completa: ppt:nombre_archivo.pptx (busca en SoftPlayerMedia/PPT/).
5. Navegación PPT: ppt:next (siguiente diapositiva), ppt:prev (anterior), ppt:home (primera), ppt:end (última).
6. Saltar a diapositiva: ppt:goto-5 (saltar a página 5).
7. PPT con avance automático: ppt:auto-5-nombre_archivo.pptx (avance automático cada 5 segundos).
8. Cargar una página web: web:URL (mostrar URL especificada en pantalla completa).

• Después del comando listloop:, el reproductor cicla por los archivos listados.
• ppt:next avanza el PPT a la siguiente diapositiva.

• Los archivos PPT deben colocarse en SoftPlayerMedia/PPT/ antes de enviar comandos.
• Para archivos PDF, el comando recurre a una ventana de visor con paginación simulada por pulsación de tecla.
• Use listloop para escenarios de bucle en exposiciones en lugar de enviar comandos individuales manualmente.

Entender los comandos de máscara y a nivel de sistema.

1. Mostrar superposición de máscara: openmask: (superpone una capa de máscara en el video).
2. Ocultar superposición de máscara: closemask:.
3. Establecer comportamiento al finalizar la reproducción: endbehavior:Stop / Loop / Standby.
4. Obtener versión: version: (la respuesta incluye información de versión actual).
5. Reiniciar reproductor: restart: (reinicia remotamente el proceso del reproductor).

• Después de openmask:, aparece una superposición de máscara en el video.
• Después de version:, se recibe una respuesta con información de versión.

Conocer la ubicación correcta para cada tipo de archivo de medios.

1. SoftPlayerMedia/Video/ — Archivos de video (.mp4/.mkv/.avi etc.), usados por el comando video:.
2. SoftPlayerMedia/StandBy/ — Archivos de standby, usados por el comando standby: y el bucle predeterminado.
3. SoftPlayerMedia/Audio/ — Archivos de audio (.mp3/.wav/.flac etc.), usados por el comando audio:.
4. SoftPlayerMedia/BackgroundAudio/ — Audio de fondo, hace un bucle automáticamente cuando está habilitado.
5. SoftPlayerMedia/PPT/ — Archivos PPT/PDF, usados por el comando ppt:.
6. SoftPlayerMedia/Mask/ — Imágenes de máscara, usadas por el comando openmask:.
7. SoftPlayerMedia/Thumbnail/ — Directorio de caché de miniaturas (generado automáticamente, no se necesitan archivos manuales).

• Después de colocar un video en Video/, el comando video:nombre_archivo lo reproduce correctamente.
• La estructura de directorios se crea automáticamente en el primer inicio — no se necesita configuración manual.

Gestionar archivos de medios diariamente a través de la consola de administración del navegador.

1. Abra http://IP-del-reproductor:8766/ en un navegador para acceder a la consola de administración.
2. Haga clic en la navegación superior para cambiar a la pestaña Files.
3. Seleccione el directorio de destino (Video / StandBy / Audio / PPT, etc.).
4. Haga clic en Upload para seleccionar archivos, o arrastre archivos al área de carga.
5. Admite crear carpetas, renombrar, eliminar archivos/carpetas y descargar archivos.
6. Los archivos admiten hasta 3 niveles de subdirectorios; seleccione el directorio actual al subir.

• El archivo recién subido aparece en la lista de archivos después de la carga.
• El comando video:nombre_archivo reproduce con éxito el archivo recién subido.

• La consola usa Autenticación Básica — configure el nombre de usuario/contraseña en appsettings.json.
• El límite de carga de un solo archivo predeterminado es 500 MB, configurable en el archivo de configuración.
• El personal de mantenimiento en el sitio puede subir contenido de reemplazo a través de la consola sin RDP.

Entender las reglas de la prueba y planificar el momento de la licencia adecuadamente.

1. La prueba de 30 días comienza automáticamente en el primer inicio de SoftPlayer.
2. Todas las funciones están disponibles durante la prueba, incluida la reproducción en alta resolución y todos los comandos UDP.
3. Compruebe los días de prueba restantes en la pestaña Dashboard de la consola de administración.
4. Después de la prueba, se debe importar un código de licencia para continuar el uso.

• El Dashboard de la consola de administración muestra el estado actual de la prueba y los días restantes.
• Los comandos responden normalmente durante la prueba sin restricciones de funciones.

• Use el período de prueba para completar las pruebas y la aceptación antes de la entrega formal del proyecto.
• Compre la licencia antes de que expire la prueba para evitar tiempo de inactividad en la exposición.

Elegir el nivel de licencia correcto según las necesidades reales de resolución de la exposición.

1. Licencia Standard: admite hasta resolución 4K (3840×2160).
2. Licencia Professional: admite hasta resolución 16K (15360×8640).
3. Requisitos de hardware para 4K: Intel i3+, 8 GB RAM, gráficos integrados (no se necesita GPU dedicada).
4. Requisitos de hardware para 8K: Intel i5 8ª gen+, 16 GB RAM, GTX 1060+.
5. Requisitos de hardware para 16K: Intel i7+, 32 GB RAM, RTX 3070+.
6. Si no está seguro de qué nivel se necesita, use la prueba para verificar los requisitos reales de resolución antes de comprar.

• El nivel de licencia coincide con la resolución máxima del dispositivo de visualización en el proyecto.
• La configuración de hardware del servidor cumple los requisitos mínimos para la resolución objetivo.

Las computadoras sin GPU dedicada pueden reproducir 4K y por debajo (el programa retrocede automáticamente a la decodificación por software), pero 8K/16K requiere una GPU dedicada calificada.

Importar el código de licencia para actualizar de la prueba a la versión completa.

1. Encuentre el campo ID del dispositivo en el Dashboard de la consola de administración y cópielo.
2. Proporcione el ID del dispositivo al proveedor, especificando el nivel requerido (Standard/Professional).
3. Después de recibir el código de licencia, vaya a la pestaña Configuration en la consola y encuentre la sección License Management.
4. Pegue el código de licencia en el campo de entrada y haga clic en Import License.
5. Después de una importación exitosa, el estado de licencia del Dashboard cambia de Trial a Standard o Professional.

• El Dashboard de la consola de administración muestra el estado de versión completa (Standard o Professional).
• La reproducción de video en alta resolución ya no está restringida.

• Aplicar un código de licencia al dispositivo incorrecto (los códigos están vinculados al dispositivo; una nueva máquina requiere un nuevo código).
• Esperar hasta después de que expire la prueba para solicitar una licencia, causando tiempo de inactividad en la exposición.

Restaurar el canal de control de comandos UDP.

1. Confirme que SoftPlayer esté en ejecución (visible en la barra de tareas o el Administrador de tareas).
2. Verifique que el puerto en su comando coincida con la configuración UdpPort en appsettings.json (predeterminado 7600).
3. Compruebe si el Firewall de Windows permite el tráfico UDP entrante en el puerto 7600.
4. Si la lista blanca de IP está habilitada (IpWhitelistEnabled: true), confirme que la IP del remitente esté en AllowedIps.
5. Compruebe la pestaña Log de la consola de administración para registros de recepción de comandos para confirmar si los comandos llegan al reproductor.

• Los registros de la consola de administración muestran registros de recepción de comandos, confirmando que el canal UDP funciona.
• Enviar volume:50 cambia el volumen del reproductor.

• Pruebe primero con 127.0.0.1 (localhost) para descartar problemas de red antes de usar la IP real.
• Al enviar desde SoftControl, asegúrese de que el protocolo de comandos UDP y el puerto de SoftControl coincidan con la configuración de SoftPlayer.

Diagnosticar y resolver fallos de reproducción de archivos de medios.

1. Confirme que el archivo de video esté en SoftPlayerMedia\Video\ (no en el directorio raíz del programa).
2. Los nombres de archivo distinguen mayúsculas de minúsculas — confirme que el nombre en el comando coincida exactamente con el nombre de archivo real incluyendo la extensión.
3. Para archivos en subdirectorios, incluya la ruta relativa: video:subcarpeta/video.mp4.
4. Navegue a la pestaña Files en la consola de administración para confirmar que el archivo realmente existe.
5. Para formatos de archivo inusuales, compruebe los registros de la consola de administración para mensajes de error de VLC.
6. Intente abrir el mismo archivo directamente con VLC Player en la máquina para descartar la corrupción del archivo.

• El archivo de destino es visible en la lista de archivos de la consola de administración.
• El nombre de archivo en el comando coincide exactamente con lo que se muestra en la lista de archivos.

• El nombre de archivo en el comando contiene espacios de ancho completo o caracteres, causando que no se encuentre el archivo.
• Discrepancia en mayúsculas/minúsculas de la extensión del archivo (p. ej. el comando usa .MP4 pero el archivo es en realidad .mp4).

Resolver problemas de rendimiento de reproducción de video en alta resolución.

1. Primero confirme el nivel de licencia actual: Standard solo admite 4K; Professional admite 16K.
2. Compruebe si la GPU admite decodificación por hardware (se necesita GTX 1060+ o equivalente para 8K).
3. En la pestaña Rendimiento del Administrador de tareas, compruebe la utilización de decodificación GPU — cerca del 100% indica un cuello de botella de GPU.
4. Compruebe los requisitos de velocidad de lectura del disco: 4K necesita 25-50 Mbps, 8K necesita 80-100 Mbps, 16K necesita 200+ Mbps.
5. Almacene archivos de video en alta resolución en un SSD para evitar cuellos de botella de lectura de HDD.
6. Para ajuste de parámetros de VLC, consulte la documentación integrada (docs\User Manual.html) en el directorio del programa.

• El nivel de licencia coincide con la resolución de reproducción requerida.
• La configuración de hardware cumple los requisitos mínimos para la resolución objetivo.

Restaurar el acceso a la consola de administración del navegador.

1. Confirme que SoftPlayer esté en ejecución.
2. Intente http://localhost:8766/ localmente para descartar primero problemas de red.
3. Compruebe appsettings.json para confirmar que HttpMonitor.Enabled sea true y el puerto sea 8766.
4. Compruebe si el Firewall de Windows permite el tráfico TCP en el puerto 8766.
5. Si el puerto está ocupado por otro programa, cambie HttpMonitor.Port en appsettings.json y reinicie.

• El navegador puede acceder a http://localhost:8766/ y muestra la consola de administración.
• El Dashboard de la consola de administración muestra el estado de ejecución del reproductor.