Intégration vMix

Envoyez des sous-titres en direct vers vMix pour les productions de diffusion.

Vue d'ensemble

Envoyez des sous-titres en temps réel vers vMix pour les productions de diffusion. Maestra fonctionne sur le même ordinateur que vMix et envoie vos sous-titres en direct dans une entrée de titre vMix.

Avant de commencer

Utilisez Google Chrome et gardez-le à jour avec la dernière version.
Assurez-vous que vMix est en cours d'exécution et que le vMix Web Controller est activé.
Ouvrez Maestra dans le même navigateur, sur la même machine que vMix.

Comment configurer

Vous devez exécuter vMix sur le même ordinateur que celui sur lequel Maestra Live est exécuté.
Téléchargez ce modèle de titre qui affichera les sous-titres dans vMix. Importez ce modèle de titre dans vMix en accédant à Add Input > Title/XAML. En haut à droite de la fenêtre Input Select, cliquez sur Browse... et sélectionnez le fichier de modèle de titre que vous avez téléchargé. Cliquez sur OK.
Dans vMix, accédez à Settings > Web Controller et cochez la case pour activer le web controller.
Définissez le port ou acceptez la valeur par défaut.
Copiez l'adresse « vMix Web Site Address » et collez-la dans Maestra.
Facultativement, téléchargez l'application Maestra Companion pour une expérience plus fluide. Une fois installée et en cours d'exécution, activez-la dans les paramètres du canal vMix, actualisez la page et profitez des sous-titres dans vMix.

Dépannage

Si les sous-titres n'atteignent pas vMix depuis votre session en temps réel Maestra, parcourez cette liste de contrôle dans l'ordre. Chaque étape écarte une cause courante, depuis les paramètres du Web Controller et les autorisations réseau de Chrome jusqu'aux pare-feu, aux ports et au modèle de sous-titres de vMix. Arrêtez-vous dès que les sous-titres commencent à se mettre à jour à l'écran.

Liste de contrôle

Confirmer les bases

Exécutez le vMix Web Controller sur la même machine que le navigateur utilisant Maestra.
Assurez-vous que le canal pointe vers la bonne URL vMix (par défaut http://localhost:8088) et que le titre de sous-titres ou le GUID du modèle correspond.

Vérifier les options de sécurité du Web Controller

Gardez l'option Allow software on this computer access without login cochée.
Laissez l'option Enable enhanced security on Web and TCP API décochée.
Laissez l'option Restrict access to LAN only décochée.

Activer l'accès au réseau local dans Chrome

Rendez-vous sur chrome://settings/content/all, puis recherchez et sélectionnez live.maestra.ai (ou utilisez le cadenas, puis Paramètres du site).
Réglez Accès au réseau local sur Autoriser, rechargez Maestra et réessayez.

Vérifier l'accessibilité réseau

Sur cette machine, ouvrez l'URL du Web Controller (par exemple http://localhost:8088) dans n'importe quel navigateur.
Si elle ne se charge pas ou est lente, corrigez cela d'abord : démarrez vMix, corrigez le port et débloquez les pare-feu.

Essayer un autre port

Si 8088 continue d'échouer, changez le vMix Web Controller vers un port élevé inutilisé (par exemple 2025), mettez à jour l'URL dans Maestra et retestez.
Cela contourne souvent les filtres de sécurité d'entreprise ou les processus d'écoute obsolètes liés aux ports courants.

Écarter les blocages d'entreprise ou de VPN

Déconnectez temporairement les VPN, les pare-feu de poste ou les antivirus susceptibles d'empêcher les pages HTTPS d'atteindre http://localhost.
Si les sous-titres commencent à fonctionner, ajoutez vMix et le navigateur à la liste blanche, puis réactivez les outils de sécurité.

Valider le modèle vMix

Dans Title Designer, assurez-vous que le champ WebCaptionerCaptions existe et que le GUID correspond aux paramètres de Maestra.
Modifiez manuellement le champ dans vMix pour confirmer qu'il se met à jour à l'écran.

Inspecter le navigateur

Ouvrez DevTools, puis l'onglet Réseau, activez le canal et observez la requête SetText.
Notez si le navigateur signale du contenu mixte (Mixed Content), un accès au réseau privé (Private Network Access) ou du CORS, ou si la requête ne part jamais.

Traiter les avertissements de contenu mixte ou de réseau privé

Chrome, Edge ou Brave : désactivez chrome://flags/#block-insecure-private-network-requests, puis redémarrez.
Safari : activez Développement, puis Disable Cross-Origin Restrictions pendant les tests.
Firefox : réglez network.websocket.allowInsecureFromHTTPS sur true et assurez-vous que le mode HTTPS uniquement est désactivé.

Surveiller les résultats

Gardez DevTools ouvert pendant que les sous-titres défilent. Si les requêtes semblent réussies mais que le texte ne se met pas à jour, capturez des captures d'écran de l'entrée Réseau et de l'aperçu vMix.
Collectez l'horodatage, la version du navigateur, le système d'exploitation et toute erreur de console avant de faire remonter le problème à l'assistance.

Toujours bloqué ?

Si les sous-titres ne se mettent toujours pas à jour après cette liste de contrôle, ouvrez le widget d'assistance dans l'application et cliquez sur Créer un ticket. Veuillez indiquer l'horodatage, la version de votre navigateur, votre système d'exploitation, la version de vMix et toute erreur de console.