Manual do Utilizador SoftPlayer

Extrair SoftPlayer na máquina de destino e verificar que o ambiente cumpre os requisitos.

1. Confirme que a máquina de destino é Windows 10/11 x64.
2. Extraia o pacote SoftPlayer para um diretório permanente, por exemplo C:\SoftPlayer\.
3. Verifique que o diretório contém SoftPlayer.exe, appsettings.json e a estrutura de subdiretórios SoftPlayerMedia\.
4. Para reprodução de vídeo 8K, certifique-se de que a máquina tem uma GPU com suporte a descodificação por hardware (GTX 1060+ ou equivalente); 4K e abaixo funcionam com gráficos integrados.

• SoftPlayer.exe está visível no diretório extraído.
• O diretório SoftPlayerMedia\ é pré-criado com subdiretórios: Video, StandBy, Audio, PPT, etc.

• Coloque SoftPlayer num caminho estável — ficheiros de mídia, logs e estado de licença são todos guardados relativamente ao diretório do programa.
• Recomenda-se armazenamento SSD com velocidade de leitura de 200MB/s+ para reprodução de alta resolução mais fluida.

Confirmar que o programa arranca corretamente e completar a integração do primeiro arranque.

1. Clique duas vezes em SoftPlayer.exe para arrancar (não são necessários direitos de administrador).
2. No primeiro arranque, o programa abre o guia de Início Rápido no browser predefinido (apenas no primeiro arranque; arranques subsequentes ignoram isto).
3. Após ler o guia, visite http://localhost:8766/ num browser para abrir a consola de gestão.
4. No separador Dashboard, confirme que o estado do player é normal e que a informação de versão/licença está visível.

• O browser abre com sucesso a consola de gestão (http://localhost:8766/) e mostra o Dashboard.
• O número de versão e o estado da licença estão visíveis no cabeçalho da consola.

Para desativar o guia do primeiro arranque, defina System.ShowQuickStartOnFirstRun como false em appsettings.json.

Controlar com sucesso o player via UDP e confirmar que o canal de controlo funciona.

1. Coloque um ficheiro de vídeo (por exemplo test.mp4) no diretório SoftPlayerMedia\Video\.
2. Abra o PowerShell e execute os seguintes 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 se a janela do SoftPlayer começa a reproduzir o vídeo especificado.

• A janela do SoftPlayer começa a reproduzir o ficheiro de vídeo especificado.
• O separador Log da consola de gestão mostra que o comando foi recebido.

• Ficheiro de vídeo colocado no diretório errado (deve estar em SoftPlayerMedia\Video\, não na raiz do programa).
• Porta errada (a predefinição é 7600, não a porta da consola de gestão 8766).

Dominar o formato de comando e compreender respostas de sucesso vs. falha.

1. Formato de comando: comando:argumento, por exemplo video:show.mp4 ou volume:80.
2. Comandos sem argumento podem ser enviados apenas com o nome do comando (dois pontos opcionais), por exemplo play.
3. Formato de resposta de sucesso: OK:comando-original, por exemplo OK:video:show.mp4.
4. Formato de resposta de falha: ERR:comando-original:mensagem-de-erro.
5. Para caminhos de ficheiros de mídia, apenas o nome do ficheiro é necessário — o player procura automaticamente no subdiretório correspondente: video: procura em SoftPlayerMedia/Video/.

• Uma resposta com prefixo OK após enviar um comando confirma formato e execução corretos.
• Uma resposta ERR inclui uma razão específica (ficheiro não encontrado, erro de formato, etc.).

Para especificar um subdiretório, use uma barra: video:subpasta/video.mp4 procura em SoftPlayerMedia/Video/subpasta/.

Dominar todos os comandos relacionados com reprodução de vídeo.

1. Reproduzir um vídeo local: video:nome_do_ficheiro.mp4 (procura no diretório Video).
2. Reproduzir um stream de vídeo de rede: webvideo:URL (suporta streams HTTP/HTTPS/RTSP/RTMP/UDP).
3. Reproduzir/Retomar: play: (retomar mídia pausada).
4. Pausar: pause: (pausar mídia atual).
5. Parar e regressar ao standby: stop: (regressa ao ecrã de boas-vindas / ciclo de standby).
6. Paragem total / ecrã negro: stoped: (ecrã negro de poupança de energia).
7. Reproduzir novamente a mídia atual: replay:.
8. Controlo de progresso: seek:milissegundos (saltar para posição), forward: (avançar 10s), backward: (recuar 10s).
9. Velocidade de reprodução: speed:1.5 (suporta 1.5x, 2.0x, etc.).

• Após o comando video:, o player começa a reproduzir o ficheiro especificado.
• Após o comando stop:, regressa ao ecrã de standby (se o ficheiro de standby estiver configurado).

• Para standby de longa duração em exposições, use standby: para repetir um ficheiro de standby em vez de stoped: ecrã negro (o ecrã negro pode fazer os visitantes pensar que o dispositivo está avariado).
• stop e stoped têm semânticas diferentes: stop regressa ao ecrã de boas-vindas; stoped mostra um ecrã completamente negro.

Dominar comandos de ajuste de volume e controlo de reprodução de áudio.

1. Definir volume (0-100): volume:80 (define para valor exato).
2. Aumentar volume 10%: volup: (aumenta 10% por chamada).
3. Diminuir volume 10%: voldown: (diminui 10% por chamada).
4. Alternar silêncio: mute: (alternar entre silenciado e com som).
5. Silenciar explicitamente: muteon:.
6. Dessilenciar explicitamente: muteoff:.
7. Reproduzir um ficheiro de áudio: audio:nome_do_ficheiro.mp3 (procura em SoftPlayerMedia/Audio/).
8. Parar áudio: audiostoped:.

• Após volume:50, o volume do player cai para 50%.
• mute: alterna entre som e silêncio.

Dominar comandos de lista em ciclo, paginação PPT e carregamento web.

1. Ciclo de uma lista de reprodução: listloop:ficheiro1.mp4;ficheiro2.mp4;ficheiro3.mp4 (separar ficheiros com ponto e vírgula).
2. Reprodução sequencial (parar no final): liststop:nome_do_ficheiro.
3. Faixa seguinte: next:, Faixa anterior: prev:.
4. Abrir PPT em ecrã completo: ppt:nome_do_ficheiro.pptx (procura em SoftPlayerMedia/PPT/).
5. Navegação PPT: ppt:next (próximo slide), ppt:prev (anterior), ppt:home (primeiro), ppt:end (último).
6. Saltar para slide: ppt:goto-5 (saltar para a página 5).
7. Avançar automaticamente PPT: ppt:auto-5-nome_do_ficheiro.pptx (avançar automaticamente a cada 5 segundos).
8. Carregar uma página web: web:URL (exibir URL especificado em ecrã completo).

• Após o comando listloop:, o player percorre os ficheiros listados em ciclo.
• ppt:next avança o PPT para o próximo slide.

• Os ficheiros PPT devem ser colocados em SoftPlayerMedia/PPT/ antes de enviar comandos.
• Para ficheiros PDF, o comando recorre a uma janela de visualizador com paginação por simulação de teclas.
• Use listloop para cenários de ciclo em exposições em vez de enviar comandos individuais manualmente.

Compreender comandos de máscara e a nível de sistema.

1. Mostrar sobreposição de máscara: openmask: (sobrepõe uma camada de máscara no vídeo).
2. Ocultar sobreposição de máscara: closemask:.
3. Definir comportamento no fim da reprodução: endbehavior:Stop / Loop / Standby.
4. Obter versão: version: (a resposta inclui informações da versão atual).
5. Reiniciar player: restart: (reinicia remotamente o processo do player).

• Após openmask:, uma sobreposição de máscara aparece no vídeo.
• Após version:, é recebida uma resposta com informações de versão.

Saber a localização correta para cada tipo de ficheiro de mídia.

1. SoftPlayerMedia/Video/ — Ficheiros de vídeo (.mp4/.mkv/.avi etc.), usados pelo comando video:.
2. SoftPlayerMedia/StandBy/ — Ficheiros de standby, usados pelo comando standby: e ciclo predefinido.
3. SoftPlayerMedia/Audio/ — Ficheiros de áudio (.mp3/.wav/.flac etc.), usados pelo comando audio:.
4. SoftPlayerMedia/BackgroundAudio/ — Áudio de fundo, repete automaticamente quando ativado.
5. SoftPlayerMedia/PPT/ — Ficheiros PPT/PDF, usados pelo comando ppt:.
6. SoftPlayerMedia/Mask/ — Imagens de máscara, usadas pelo comando openmask:.
7. SoftPlayerMedia/Thumbnail/ — Diretório de cache de miniaturas (gerado automaticamente, sem necessidade de ficheiros manuais).

• Após colocar um vídeo em Video/, o comando video:nome_do_ficheiro reproduz-o corretamente.
• A estrutura de diretórios é criada automaticamente no primeiro arranque — sem necessidade de configuração manual.

Gerir ficheiros de mídia diariamente através da consola de gestão no browser.

1. Abra http://IP-do-player:8766/ num browser para aceder à consola de gestão.
2. Clique na navegação superior para mudar para o separador Ficheiros.
3. Selecione o diretório de destino (Video / StandBy / Audio / PPT, etc.).
4. Clique em Upload para selecionar ficheiros, ou arraste ficheiros para a área de upload.
5. Suporta criação de pastas, renomear, eliminar ficheiros/pastas e descarregar ficheiros.
6. Os ficheiros suportam até 3 níveis de subdiretórios; selecione o diretório atual ao fazer upload.

• O ficheiro recentemente carregado aparece na lista de ficheiros após o upload.
• O comando video:nome_do_ficheiro reproduz com sucesso o ficheiro recém-carregado.

• A consola usa Autenticação Básica — configure nome de utilizador/palavra-passe em appsettings.json.
• O limite de upload de ficheiro único predefinido é 500MB, configurável no ficheiro de configuração.
• A equipa de manutenção no local pode fazer upload de conteúdo de substituição via consola sem RDP.

Compreender as regras da avaliação e planear o momento da licença adequadamente.

1. A avaliação de 30 dias começa automaticamente no primeiro arranque do SoftPlayer.
2. Todos os recursos estão disponíveis durante a avaliação, incluindo reprodução em alta resolução e todos os comandos UDP.
3. Verifique os dias restantes da avaliação no separador Dashboard da consola de gestão.
4. Após a avaliação, é necessário importar um código de licença para continuar a utilização.

• O Dashboard da consola de gestão mostra o estado atual da avaliação e os dias restantes.
• Os comandos respondem normalmente durante a avaliação sem restrições de recursos.

• Use o período de avaliação para completar testes e aceitação antes da entrega formal do projeto.
• Compre a licença antes do fim da avaliação para evitar tempo de inatividade na exposição.

Escolher o nível de licença correto com base nas necessidades reais de resolução da exposição.

1. Licença Standard: suporta até resolução 4K (3840×2160).
2. Licença Professional: suporta até resolução 16K (15360×8640).
3. Requisitos de hardware para 4K: Intel i3+, 8GB RAM, gráficos integrados (sem GPU discreta necessária).
4. Requisitos de hardware para 8K: Intel i5 8ª geração+, 16GB RAM, GTX 1060+.
5. Requisitos de hardware para 16K: Intel i7+, 32GB RAM, RTX 3070+.
6. Se não tiver certeza de qual nível é necessário, use a avaliação para verificar os requisitos reais de resolução antes de comprar.

• O nível de licença corresponde à resolução máxima do dispositivo de exibição no projeto.
• A configuração de hardware do servidor cumpre os requisitos mínimos para a resolução alvo.

Computadores sem GPU discreta podem reproduzir 4K e abaixo (o programa recorre automaticamente à descodificação por software), mas 8K/16K requer uma GPU discreta qualificada.

Importar o código de licença para atualizar da avaliação para a versão completa.

1. Encontre o campo ID do Dispositivo no Dashboard da consola de gestão e copie-o.
2. Forneça o ID do dispositivo ao fornecedor, especificando o nível necessário (Standard/Professional).
3. Após receber o código de licença, vá ao separador Configuração na consola e encontre a secção Gestão de Licença.
4. Cole o código de licença no campo de entrada e clique em Importar Licença.
5. Após importação bem-sucedida, o estado da licença no Dashboard muda de Avaliação para Standard ou Professional.

• O Dashboard da consola de gestão mostra o estado da versão completa (Standard ou Professional).
• A reprodução de vídeo de alta resolução já não está restrita.

• Aplicar um código de licença ao dispositivo errado (os códigos são vinculados ao dispositivo; uma nova máquina requer um novo código).
• Esperar até após a expiração da avaliação para solicitar uma licença, causando tempo de inatividade na exposição.

Restaurar o canal de controlo por comando UDP.

1. Confirme que o SoftPlayer está em execução (visível na barra de tarefas ou no Gestor de Tarefas).
2. Verifique se a porta no seu comando corresponde à configuração UdpPort em appsettings.json (predefinição 7600).
3. Verifique se a Firewall do Windows permite tráfego UDP de entrada na porta 7600.
4. Se a lista branca de IPs estiver ativada (IpWhitelistEnabled: true), confirme que o IP do remetente está em AllowedIps.
5. Verifique o separador Log da consola de gestão para registos de receção de comandos para confirmar se os comandos chegam ao player.

• Os logs da consola de gestão mostram registos de receção de comandos, confirmando que o canal UDP funciona.
• Enviar volume:50 altera o volume do player.

• Teste com 127.0.0.1 (localhost) primeiro para descartar problemas de rede antes de usar o IP real.
• Ao enviar a partir do SoftControl, certifique-se de que o protocolo UDP e a porta do SoftControl correspondem à configuração do SoftPlayer.

Diagnosticar e resolver falhas de reprodução de ficheiros de mídia.

1. Confirme que o ficheiro de vídeo está em SoftPlayerMedia\Video\ (não no diretório raiz do programa).
2. Os nomes de ficheiros são sensíveis a maiúsculas/minúsculas — confirme que o nome no comando corresponde exatamente ao nome do ficheiro real incluindo a extensão.
3. Para ficheiros em subdiretórios, inclua o caminho relativo: video:subpasta/video.mp4.
4. Navegue até ao separador Ficheiros na consola de gestão para confirmar que o ficheiro existe.
5. Para formatos de ficheiro incomuns, verifique os logs da consola de gestão para mensagens de erro VLC.
6. Tente abrir o mesmo ficheiro diretamente com VLC Player na máquina para descartar corrupção do ficheiro.

• O ficheiro alvo é visível na lista de ficheiros da consola de gestão.
• O nome do ficheiro no comando corresponde exatamente ao que é mostrado na lista de ficheiros.

• O nome do ficheiro no comando contém espaços de largura completa ou caracteres especiais, causando ficheiro não encontrado.
• Incompatibilidade de maiúsculas/minúsculas na extensão do ficheiro (por exemplo, o comando usa .MP4 mas o ficheiro é .mp4).

Resolver problemas de desempenho de reprodução de vídeo de alta resolução.

1. Primeiro confirme o nível de licença atual: Standard suporta apenas 4K; Professional suporta 16K.
2. Verifique se a GPU suporta descodificação por hardware (GTX 1060+ ou equivalente necessário para 8K).
3. No separador Desempenho do Gestor de Tarefas, verifique a utilização de descodificação GPU — perto de 100% indica um gargalo de GPU.
4. Verifique os requisitos de velocidade de leitura do disco: 4K precisa de 25-50 Mbps, 8K precisa de 80-100 Mbps, 16K precisa de 200+ Mbps.
5. Armazene ficheiros de vídeo de alta resolução num SSD para evitar gargalos de leitura HDD.
6. Para ajuste de parâmetros VLC, consulte a documentação integrada (docs\User Manual.html) no diretório do programa.

• O nível de licença corresponde à resolução de reprodução necessária.
• A configuração de hardware cumpre os requisitos mínimos para a resolução alvo.

Restaurar o acesso à consola de gestão no browser.

1. Confirme que o SoftPlayer está em execução.
2. Tente http://localhost:8766/ localmente para descartar primeiro problemas de rede.
3. Verifique appsettings.json para confirmar que HttpMonitor.Enabled é true e a porta é 8766.
4. Verifique se a Firewall do Windows permite tráfego TCP na porta 8766.
5. Se a porta estiver ocupada por outro programa, altere HttpMonitor.Port em appsettings.json e reinicie.

• O browser consegue aceder a http://localhost:8766/ e exibe a consola de gestão.
• O Dashboard da consola de gestão mostra o estado de execução do player.