Migration vMix SOURCE et templates GT¶

Cette page décrit la migration des projets vMix historiques vers la nouvelle nomenclature MY LIVE SPORT : dossiers SOURCE plus lisibles, clés GT en anglais court, et script autonome pour migrer les fichiers existants.

Télécharger le script¶

Télécharger migrate-vmix-source.ps1

Le script est autonome. Il ne dépend pas d'AppSport ou d'un dépôt de développement. Il doit être exécuté depuis un dossier situé au-dessus de SOURCE, par exemple C:\FFF National.

Objectif de la migration¶

La migration applique quatre changements :

• les dossiers métiers sous SOURCE passent en anglais ;
• les dossiers médias historiques MUSIQUE et VIDEO passent en MUSICS et VIDEOS ;
• les champs GT et les masques d'animation dans les .gtzip passent sur des clés v2 courtes et stables ;
• les fichiers projet vMix/AppSport peuvent être mis à jour pour pointer vers les nouveaux chemins.

Les valeurs affichées restent localisables. Une clé comme PERIOD reste en anglais, mais sa valeur peut rester MI-TEMPS, devenir HALF-TIME, ou utiliser un autre libellé selon la langue choisie.

Préparer le dossier¶

Fermez vMix et AppSport avant de lancer la migration.

Structure attendue :

C:\FFF National\
├─ SOURCE\
│  ├─ TEMPLATE\
│  ├─ LOGO_EQUIPE\
│  └─ IMAGES\
└─ migrate-vmix-source.ps1

La première exécution doit toujours être faite en simulation.

cd "C:\FFF National"
powershell -NoProfile -ExecutionPolicy Bypass -File ".\migrate-vmix-source.ps1"

Cette commande ne crée pas SOURCE_backup et ne modifie aucun fichier. Elle affiche seulement ce que le script ferait.

Application réelle :

cd "C:\FFF National"
powershell -NoProfile -ExecutionPolicy Bypass -File ".\migrate-vmix-source.ps1" -Apply -ReportPath ".\migration-vmix-source-report.json"

Application réelle avec le chemin absolu de SOURCE :

powershell -NoProfile -ExecutionPolicy Bypass -File "C:\FFF National\migrate-vmix-source.ps1" -SourcePath "C:\FFF National\SOURCE" -Apply -ReportPath "C:\FFF National\migration-vmix-source-report.json"

Dans cet exemple, le backup est créé ici :

C:\FFF National\SOURCE_backup

Application sans modifier les fichiers projet :

powershell -NoProfile -ExecutionPolicy Bypass -File ".\migrate-vmix-source.ps1" -Apply -SkipProjectFiles

Continuer une migration déjà appliquée avec un SOURCE_backup existant :

powershell -NoProfile -ExecutionPolicy Bypass -File ".\migrate-vmix-source.ps1" -Apply -UseExistingBackup -ReportPath ".\migration-vmix-source-report.json"

Sécurité et sauvegarde¶

Par défaut, le script ne modifie rien. Sans -Apply, il affiche uniquement les actions prévues. Si -ReportPath est fourni, il écrit quand même le rapport de simulation demandé.

Avec -Apply, le script crée d'abord une copie complète :

SOURCE_backup

Si SOURCE_backup existe déjà, la migration bloque. Utilisez -OverwriteBackup uniquement après avoir vérifié que l'ancien backup peut être remplacé.

Options utiles :

Dossiers migrés¶

SOURCE et IMAGES sont conservés. Le dossier IMAGES reste au pluriel, car il contient plusieurs types de visuels et pas uniquement des photos.

MUSICS est une convention projet volontaire pour rester cohérent avec IMAGES, VIDEOS et TEMPLATES. En anglais strict, MUSIC serait plus naturel.

Fichiers image renommés¶

Les PNG statiques connus sont renommés avec les dossiers pour que la nouvelle arborescence reste cohérente. Les images dynamiques issues des données terrain ne sont pas renommées : logos équipes, photos joueurs, images de composition et images embarquées dans les .gtzip restent inchangés.

Electron crée aussi EMPTY.png à la racine du cacheFolder quand il crée ou vérifie le cache du projet. Le fallback serveur public est également /file/EMPTY.png, servi depuis shared/file/EMPTY.png.

Templates .gtzip¶

Les fichiers .gtzip sont des archives ZIP. Le script les ouvre en place, cherche les fichiers XML internes et remplace les noms de champs GT dans les valeurs d'attribut, les valeurs texte simples et les Mask de Storyboard.

Les Mask sont importants pour les animations : si un storyboard masque ou cible un ancien champ comme E1NOM_FULL.Text, le script le migre aussi vers la nouvelle clé, par exemple T1_NAME.Text. Les listes de masks contenant plusieurs champs sont traitées champ par champ.

Le script ne modifie pas les images embarquées dans les .gtzip. Il ne renomme pas non plus les fichiers internes du template. Cette limite est volontaire : elle réduit le risque de casser un template vMix fonctionnel.

La migration couvre les familles utilisées par les sports suivants :

• football ;
• futsal ;
• hockey sur glace ;
• basketball ;
• tennis.

Réparer uniquement les animations .gtzip¶

Si une ancienne migration a cassé certaines animations, restaurez les templates depuis le backup, puis relancez seulement la migration .gtzip. N'utilisez pas -OverwriteBackup dans ce scénario, afin de garder le backup original intact.

cd "C:\FFF National"
Rename-Item ".\SOURCE\TEMPLATES" "TEMPLATES_broken"
Copy-Item ".\SOURCE_backup\TEMPLATE" ".\SOURCE\TEMPLATES" -Recurse
powershell -NoProfile -ExecutionPolicy Bypass -File ".\migrate-vmix-source.ps1" -SourcePath ".\SOURCE" -GtzipOnly -Apply -ReportPath ".\migration-gtzip-only-report.json"

Pour migrer tout sauf les templates .gtzip, utilisez :

powershell -NoProfile -ExecutionPolicy Bypass -File ".\migrate-vmix-source.ps1" -Apply -SkipGtzip -ReportPath ".\migration-vmix-source-report.json"

Règles de nommage GT¶

Les nouvelles clés respectent les règles suivantes :

• maximum 11 caractères pour le nom de champ de base ;
• le suffixe vMix .Text ou .Source n'est pas compté dans cette limite ;
• alphabet recommandé : A-Z, 0-9, _ ;
• pas d'accents, pas d'espaces, pas de tirets ;
• T1 et T2 remplacent les anciens préfixes E1 et E2 ;
• les index sont prévus jusqu'à 99 pour les équipes, joueurs, staff, lignes de programme, résultats et classements.

Exception connue : CLOCK_ADD_MLS fait 13 caractères parce que le logiciel l'expose déjà ainsi pour le chrono additionnel MY LIVE SPORT. Les nouveaux templates doivent utiliser CLOCK_ADD_MLS.Text.

Exemples de longueur valide :

Correspondances principales¶

Le mapping complet est intégré dans le script migrate-vmix-source.ps1. Les tableaux ci-dessous listent les familles les plus utilisées pour préparer ou contrôler les templates. La colonne legacy correspond à la v1 dépréciée, la colonne nouveau correspond au contrat v2.

Match, chrono et météo¶

Équipes, joueurs et staff¶

Formations, buts et actions¶

Résultats, programme et classements¶

Tableau final et statistiques¶

Scroll résultats et alertes¶

Localisation des valeurs¶

La migration ne doit pas transformer le contenu affiché en anglais par défaut. Les noms de clés sont techniques et restent anglais. Les valeurs sont du texte éditorial et doivent suivre la langue de sortie.

Exemples :

Le comportement attendu est :

• français par défaut pour conserver les productions existantes ;
• anglais si la langue de sortie est configurée en anglais ;
• autre langue possible via un mapping de libellés dédié.

Contrôles après migration¶

Après un -Apply, contrôlez au minimum :

1. présence de SOURCE_backup ;
2. présence de SOURCE/TEMPLATES ;
3. présence de SOURCE/TEAM_LOGOS ;
4. présence des nouveaux sous-dossiers dans SOURCE/IMAGES ;
5. ouverture d'un .gtzip migré dans vMix ;
6. affichage d'un logo équipe ;
7. affichage d'une météo ;
8. affichage d'un résultat, d'un programme et d'un classement ;
9. ouverture du fichier .vmix ou .appsport si les fichiers projet ont été mis à jour ;
10. contrôle du rapport JSON si -ReportPath a été utilisé.

Commande de recherche utile pour vérifier qu'un projet ne référence plus les anciens chemins :

rg -n "PICTO_METEO|BG_BUT|BG_CG|BG_TEMPS_MORT|PROGRAMME|RESULTAT|CLASSEMENT|LOGO_EQUIPE|SOURCE[/\\]TEMPLATE|SOURCE[/\\](MUSIQUE|VIDEO)\b" .

Rollback¶

En cas de problème :

1. fermez vMix et AppSport ;
2. renommez le dossier SOURCE migré, par exemple en SOURCE_migration_failed ;
3. renommez SOURCE_backup en SOURCE ;
4. restaurez les fichiers .vmix ou .appsport depuis une sauvegarde si leurs chemins ont été modifiés ;
5. relancez vMix et testez le projet avant production.

Ne supprimez pas SOURCE_backup tant que tous les templates et les chemins d'images n'ont pas été validés sur le poste de production.