Manuel utilisateur SoftPlayer

Extraire SoftPlayer sur la machine cible et vérifier que l'environnement répond aux exigences.

1. Confirmer que la machine cible est Windows 10/11 x64.
2. Extraire le package SoftPlayer dans un répertoire permanent, par ex. C:\SoftPlayer\.
3. Vérifier que le répertoire contient SoftPlayer.exe, appsettings.json et la structure de sous-répertoires SoftPlayerMedia\.
4. Pour la lecture vidéo 8K, s'assurer que la machine dispose d'un GPU prenant en charge le décodage matériel (GTX 1060+ ou équivalent) ; 4K et inférieur fonctionnent avec les graphiques intégrés.

• SoftPlayer.exe est visible dans le répertoire extrait.
• Le répertoire SoftPlayerMedia\ est pré-créé avec des sous-répertoires : Video, StandBy, Audio, PPT, etc.

• Placez SoftPlayer dans un chemin stable — les fichiers médias, journaux et état de licence sont tous enregistrés par rapport au répertoire du programme.
• Recommandez un stockage SSD avec une vitesse de lecture 200 Mo/s+ pour une lecture haute résolution plus fluide.

Confirmer que le programme démarre correctement et compléter l'intégration au premier lancement.

1. Double-cliquer sur SoftPlayer.exe pour lancer (aucun droit administrateur requis).
2. Au premier lancement, le programme ouvre le guide de démarrage rapide dans le navigateur par défaut (uniquement au premier lancement ; les lancements suivants ignorent cela).
3. Après avoir lu le guide, visiter http://localhost:8766/ dans un navigateur pour ouvrir la console de gestion.
4. Dans l'onglet Tableau de bord, confirmer que l'état du lecteur est normal, et que les informations de version/licence sont visibles.

• Le navigateur ouvre avec succès la console de gestion (http://localhost:8766/) et affiche le Tableau de bord.
• Le numéro de version et l'état de licence sont visibles dans l'en-tête de la console.

Pour désactiver le guide au premier lancement, définir System.ShowQuickStartOnFirstRun sur false dans appsettings.json.

Contrôler avec succès le lecteur via UDP et confirmer que le canal de contrôle fonctionne.

1. Placer un fichier vidéo (ex. test.mp4) dans le répertoire SoftPlayerMedia\Video\.
2. Ouvrir PowerShell et exécuter les commandes suivantes :
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. Observer si la fenêtre SoftPlayer commence à lire la vidéo spécifiée.

• La fenêtre SoftPlayer commence à lire le fichier vidéo spécifié.
• L'onglet Journal de la console de gestion indique que la commande a été reçue.

• Fichier vidéo placé dans le mauvais répertoire (doit être dans SoftPlayerMedia\Video\, pas à la racine du programme).
• Mauvais port (par défaut 7600, pas le port de la console de gestion 8766).

Maîtriser le format de commande et comprendre les réponses de succès et d'échec.

1. Format de commande : commande:argument, ex. video:show.mp4 ou volume:80.
2. Les commandes sans argument peuvent être envoyées en tant que simple nom de commande (les deux-points sont optionnels), ex. play.
3. Format de réponse de succès : OK:commande-originale, ex. OK:video:show.mp4.
4. Format de réponse d'échec : ERR:commande-originale:message-erreur.
5. Pour les chemins de fichiers médias, seul le nom de fichier est nécessaire — le lecteur cherche automatiquement dans le sous-répertoire correspondant : video: cherche dans SoftPlayerMedia/Video/.

• Une réponse préfixée OK après l'envoi d'une commande confirme le format correct et l'exécution.
• Une réponse ERR inclut une raison spécifique (fichier non trouvé, erreur de format, etc.).

Pour spécifier un sous-répertoire, utilisez une barre oblique : video:sousdossier/video.mp4 cherche dans SoftPlayerMedia/Video/sousdossier/.

Maîtriser toutes les commandes liées à la lecture vidéo.

1. Lire une vidéo locale : video:nomfichier.mp4 (cherche dans le répertoire Video).
2. Lire un flux vidéo réseau : webvideo:URL (prend en charge les flux HTTP/HTTPS/RTSP/RTMP/UDP).
3. Lecture/Reprise : play: (reprendre le média en pause).
4. Pause : pause: (mettre en pause le média en cours).
5. Arrêter et retourner en veille : stop: (retourne à l'écran de bienvenue / boucle de veille).
6. Arrêt complet / écran noir : stoped: (écran noir économie d'énergie).
7. Relire le média actuel : replay:.
8. Contrôle de progression : seek:millisecondes (sauter à la position), forward: (avancer de 10s), backward: (reculer de 10s).
9. Vitesse de lecture : speed:1.5 (prend en charge 1,5x, 2,0x, etc.).

• Après la commande video:, le lecteur commence à lire le fichier spécifié.
• Après la commande stop:, retourne à l'écran de veille (si un fichier de veille est configuré).

• Pour une veille prolongée dans les expositions, utiliser standby: pour boucler un fichier de veille plutôt que stoped: écran noir (l'écran noir peut faire croire aux visiteurs que l'appareil est en panne).
• stop et stoped ont des sémantiques différentes : stop retourne à l'écran de bienvenue ; stoped affiche un écran noir pur.

Maîtriser les commandes de réglage du volume et de contrôle de la lecture audio.

1. Définir le volume (0-100) : volume:80 (définit à la valeur exacte).
2. Augmenter le volume de 10% : volup: (augmente de 10% par appel).
3. Diminuer le volume de 10% : voldown: (diminue de 10% par appel).
4. Basculer le muet : mute: (basculer entre muet et non muet).
5. Muet explicite : muteon:.
6. Non muet explicite : muteoff:.
7. Lire un fichier audio : audio:nomfichier.mp3 (cherche dans SoftPlayerMedia/Audio/).
8. Arrêter l'audio : audiostoped:.

• Après volume:50, le volume du lecteur tombe à 50%.
• mute: bascule entre son et silence.

Maîtriser les commandes de boucle de liste, pagination PPT et chargement web.

1. Boucler une playlist : listloop:fichier1.mp4;fichier2.mp4;fichier3.mp4 (séparer les fichiers par des points-virgules).
2. Lecture séquentielle (arrêt à la fin) : liststop:nomfichier.
3. Piste suivante : next:, Piste précédente : prev:.
4. Ouvrir PPT en plein écran : ppt:nomfichier.pptx (cherche dans SoftPlayerMedia/PPT/).
5. Navigation PPT : ppt:next (diapo suivante), ppt:prev (précédente), ppt:home (première), ppt:end (dernière).
6. Sauter à une diapo : ppt:goto-5 (aller à la page 5).
7. PPT à avancement automatique : ppt:auto-5-nomfichier.pptx (avancement auto toutes les 5 secondes).
8. Charger une page web : web:URL (afficher l'URL spécifiée en plein écran).

• Après la commande listloop:, le lecteur défile en boucle dans les fichiers listés.
• ppt:next fait avancer le PPT à la diapo suivante.

• Les fichiers PPT doivent être placés dans SoftPlayerMedia/PPT/ avant d'envoyer des commandes.
• Pour les fichiers PDF, la commande bascule vers une fenêtre de visionneuse avec pagination par simulation de touches.
• Utiliser listloop pour les scénarios de boucle d'exposition plutôt que d'envoyer manuellement des commandes individuelles.

Comprendre les commandes de masque et de niveau système.

1. Afficher la superposition de masque : openmask: (superpose une couche de masque sur la vidéo).
2. Masquer la superposition : closemask:.
3. Définir le comportement de fin de lecture : endbehavior:Stop / Loop / Standby.
4. Obtenir la version : version: (la réponse inclut les informations de version actuelle).
5. Redémarrer le lecteur : restart: (redémarre à distance le processus du lecteur).

• Après openmask:, une superposition de masque apparaît sur la vidéo.
• Après version:, une réponse avec les informations de version est reçue.

Connaître l'emplacement correct pour chaque type de fichier média.

1. SoftPlayerMedia/Video/ — Fichiers vidéo (.mp4/.mkv/.avi etc.), utilisés par la commande video:.
2. SoftPlayerMedia/StandBy/ — Fichiers de veille, utilisés par la commande standby: et la boucle par défaut.
3. SoftPlayerMedia/Audio/ — Fichiers audio (.mp3/.wav/.flac etc.), utilisés par la commande audio:.
4. SoftPlayerMedia/BackgroundAudio/ — Audio en arrière-plan, boucle automatiquement quand activé.
5. SoftPlayerMedia/PPT/ — Fichiers PPT/PDF, utilisés par la commande ppt:.
6. SoftPlayerMedia/Mask/ — Images de masque, utilisées par la commande openmask:.
7. SoftPlayerMedia/Thumbnail/ — Répertoire de cache des miniatures (généré automatiquement, aucun fichier manuel nécessaire).

• Après avoir placé une vidéo dans Video/, la commande video:nomfichier la lit correctement.
• La structure de répertoire est créée automatiquement au premier lancement — aucune configuration manuelle nécessaire.

Gérer les fichiers médias au quotidien via la console de gestion navigateur.

1. Ouvrir http://IP-lecteur:8766/ dans un navigateur pour accéder à la console de gestion.
2. Cliquer sur la navigation supérieure pour passer à l'onglet Fichiers.
3. Sélectionner le répertoire cible (Video / StandBy / Audio / PPT, etc.).
4. Cliquer sur Télécharger pour sélectionner des fichiers, ou faire glisser des fichiers vers la zone de téléchargement.
5. Prend en charge la création de dossiers, le renommage, la suppression de fichiers/dossiers et le téléchargement de fichiers.
6. Les fichiers prennent en charge jusqu'à 3 niveaux de sous-répertoires ; sélectionner le répertoire actuel lors du téléchargement.

• Le fichier nouvellement téléchargé apparaît dans la liste des fichiers après le téléchargement.
• La commande video:nomfichier lit avec succès le fichier qui vient d'être téléchargé.

• La console utilise l'authentification de base — configurer nom d'utilisateur/mot de passe dans appsettings.json.
• La limite de téléchargement d'un seul fichier par défaut est de 500 Mo, configurable dans le fichier de configuration.
• Le personnel de maintenance sur site peut télécharger le contenu de remplacement via la console sans RDP.

Comprendre les règles d'essai et planifier le calendrier de licence de manière appropriée.

1. L'essai de 30 jours démarre automatiquement au premier lancement de SoftPlayer.
2. Toutes les fonctionnalités sont disponibles pendant l'essai, y compris la lecture haute résolution et toutes les commandes UDP.
3. Vérifier les jours d'essai restants dans l'onglet Tableau de bord de la console de gestion.
4. Après l'essai, un code de licence doit être importé pour continuer à utiliser.

• Le Tableau de bord de la console de gestion affiche l'état d'essai actuel et les jours restants.
• Les commandes répondent normalement pendant l'essai sans restrictions de fonctionnalités.

• Utilisez la période d'essai pour compléter les tests et la réception avant la livraison officielle du projet.
• Achetez la licence avant la fin de l'essai pour éviter les temps d'arrêt de l'exposition.

Choisir le bon niveau de licence en fonction des besoins réels de résolution d'exposition.

1. Licence Standard : prend en charge une résolution maximale de 4K (3840×2160).
2. Licence Professional : prend en charge une résolution maximale de 16K (15360×8640).
3. Configuration matérielle 4K : Intel i3+, 8 Go RAM, graphiques intégrés (aucun GPU dédié nécessaire).
4. Configuration matérielle 8K : Intel i5 8e génération+, 16 Go RAM, GTX 1060+.
5. Configuration matérielle 16K : Intel i7+, 32 Go RAM, RTX 3070+.
6. Si vous ne savez pas quel niveau est nécessaire, utilisez l'essai pour vérifier les exigences de résolution réelles avant d'acheter.

• Le niveau de licence correspond à la résolution maximale de l'appareil d'affichage dans le projet.
• La configuration matérielle du serveur répond aux exigences minimales pour la résolution cible.

Les ordinateurs sans GPU dédié peuvent lire 4K et inférieur (le programme bascule automatiquement vers le décodage logiciel), mais 8K/16K nécessite un GPU dédié qualifié.

Importer le code de licence pour passer de l'essai à la version complète.

1. Trouver le champ ID d'appareil dans le Tableau de bord de la console de gestion et le copier.
2. Fournir l'ID d'appareil au fournisseur en spécifiant le niveau requis (Standard/Professional).
3. Après réception du code de licence, aller à l'onglet Configuration dans la console et trouver la section Gestion des licences.
4. Coller le code de licence dans le champ de saisie et cliquer sur Importer la licence.
5. Après l'importation réussie, l'état de licence du Tableau de bord passe de Essai à Standard ou Professional.

• Le Tableau de bord de la console de gestion affiche l'état de la version complète (Standard ou Professional).
• La lecture vidéo haute résolution n'est plus limitée.

• Appliquer un code de licence au mauvais appareil (les codes sont liés à l'appareil ; une nouvelle machine nécessite un nouveau code).
• Attendre que l'essai expire pour demander une licence, causant des temps d'arrêt de l'exposition.

Restaurer le canal de contrôle des commandes UDP.

1. Confirmer que SoftPlayer est en cours d'exécution (visible dans la barre des tâches ou le Gestionnaire des tâches).
2. Vérifier que le port dans votre commande correspond au paramètre UdpPort dans appsettings.json (par défaut 7600).
3. Vérifier si le pare-feu Windows autorise le trafic UDP entrant sur le port 7600.
4. Si la liste blanche IP est activée (IpWhitelistEnabled: true), confirmer que l'IP de l'expéditeur est dans AllowedIps.
5. Vérifier l'onglet Journal de la console de gestion pour les enregistrements de réception de commandes afin de confirmer si les commandes atteignent le lecteur.

• Les journaux de la console de gestion affichent les enregistrements de réception de commandes, confirmant que le canal UDP fonctionne.
• L'envoi de volume:50 change le volume du lecteur.

• Tester d'abord avec 127.0.0.1 (localhost) pour exclure les problèmes réseau avant d'utiliser l'IP réelle.
• Lors de l'envoi depuis SoftControl, s'assurer que le protocole de commande UDP et le port SoftControl correspondent à la configuration de SoftPlayer.

Diagnostiquer et résoudre les échecs de lecture de fichiers médias.

1. Confirmer que le fichier vidéo est dans SoftPlayerMedia\Video\ (pas le répertoire racine du programme).
2. Les noms de fichiers sont sensibles à la casse — confirmer que le nom dans la commande correspond exactement au nom de fichier réel, extension comprise.
3. Pour les fichiers dans des sous-répertoires, inclure le chemin relatif : video:sousdossier/video.mp4.
4. Parcourir l'onglet Fichiers dans la console de gestion pour confirmer que le fichier existe réellement.
5. Pour les formats de fichiers inhabituels, vérifier les journaux de la console de gestion pour les messages d'erreur VLC.
6. Essayer d'ouvrir le même fichier directement avec VLC Player sur la machine pour exclure une corruption de fichier.

• Le fichier cible est visible dans la liste des fichiers de la console de gestion.
• Le nom de fichier dans la commande correspond exactement à ce qui est affiché dans la liste des fichiers.

• Le nom de fichier dans la commande contient des espaces pleine largeur ou des caractères, causant un fichier non trouvé.
• Discordance de casse de l'extension de fichier (ex. la commande utilise .MP4 mais le fichier est en réalité .mp4).

Résoudre les problèmes de performance de lecture vidéo haute résolution.

1. Confirmer d'abord le niveau de licence actuel : Standard ne prend en charge que 4K ; Professional prend en charge 16K.
2. Vérifier si le GPU prend en charge le décodage matériel (GTX 1060+ ou équivalent nécessaire pour 8K).
3. Dans l'onglet Performance du Gestionnaire des tâches, vérifier l'utilisation du décodage GPU — près de 100% indique un goulot d'étranglement GPU.
4. Vérifier les exigences de vitesse de lecture disque : 4K nécessite 25-50 Mbps, 8K nécessite 80-100 Mbps, 16K nécessite 200+ Mbps.
5. Stocker les fichiers vidéo haute résolution sur un SSD pour éviter les goulots d'étranglement de lecture HDD.
6. Pour l'ajustement des paramètres VLC, voir la documentation intégrée (docs\Manuel utilisateur.html) dans le répertoire du programme.

• Le niveau de licence correspond à la résolution de lecture requise.
• La configuration matérielle répond aux exigences minimales pour la résolution cible.

Restaurer l'accès à la console de gestion navigateur.

1. Confirmer que SoftPlayer est en cours d'exécution.
2. Essayer http://localhost:8766/ localement d'abord pour exclure les problèmes réseau.
3. Vérifier appsettings.json pour confirmer que HttpMonitor.Enabled est true et que le port est 8766.
4. Vérifier si le pare-feu Windows autorise le trafic TCP sur le port 8766.
5. Si le port est occupé par un autre programme, changer HttpMonitor.Port dans appsettings.json et redémarrer.

• Le navigateur peut accéder à http://localhost:8766/ et affiche la console de gestion.
• Le Tableau de bord de la console de gestion affiche l'état d'exécution du lecteur.