Variables live output v1 legacy — Basketball¶
V1 legacy déprécié
Cette page documente les anciennes clés basketball. Elles sont conservées uniquement pour relire un template historique et préparer la migration vers les clés v2.
Le basketball partage le socle commun des variables avec les autres sports (
STATUS,MSG,ERR_MSG, équipes, joueurs, classement, programme, historique). Cette fiche documente uniquement les variables et comportements spécifiques au basketball.Pour les variables communes (
T1/T2en v2,E1/E2en v1 legacy), consultez le socle général.
Migration v1 -> v2¶
| V1 legacy déprécié | V2 actuel |
|---|---|
PERIODE | PERIOD |
CLOCK_MLS / clock_mls | CLOCK_MLS |
CLOCK_ADD_MCL | CLOCK_ADD_MLS |
E1SCORE / E2SCORE | T1_SCORE / T2_SCORE |
E1_P1_SCORE / E2_P1_SCORE | T1Q1_SC / T2Q1_SC |
E1_P2_SCORE / E2_P2_SCORE | T1Q2_SC / T2Q2_SC |
E1_P3_SCORE / E2_P3_SCORE | T1Q3_SC / T2Q3_SC |
E1_P4_SCORE / E2_P4_SCORE | T1Q4_SC / T2Q4_SC |
E1TIMEOUTLABEL / E2TIMEOUTLABEL | T1_TO_LBL / T2_TO_LBL |
E1TIMEOUT / E2TIMEOUT | T1_TO / T2_TO |
E1TIMEOUT_IMG / E2TIMEOUT_IMG | T1_TO_IMG / T2_TO_IMG |
SOURCE/IMAGES/BG_TEMPS_MORT | SOURCE/IMAGES/TIMEOUTS |
EVENT_{ID}_HOME / EVENT_{ID}_AWAY | EV{ID}_T1 / EV{ID}_T2 |
| Famille v2 | Usage basketball |
|---|---|
PERIOD | Libellé de période/statut : QT1 à QT4, mi-temps, prolongations, score final. |
SET | Libellé brut du quart-temps si disponible. |
CLOCK_MLS | Chrono principal converti depuis le décompte basket si nécessaire. |
CLOCK_ADD_MLS | Chrono secondaire si le template l'utilise. |
T1_SCORE / T2_SCORE | Score domicile / extérieur. |
T1Q1_SC à T1Q4_SC | Score équipe 1 par quart-temps. |
T2Q1_SC à T2Q4_SC | Score équipe 2 par quart-temps. |
T1_TO_LBL / T2_TO_LBL | Label temps-morts. |
T1_TO / T2_TO | Nombre de temps-morts utilisés. |
T1_TO_IMG / T2_TO_IMG | Image temps-morts depuis SOURCE/IMAGES/TIMEOUTS. |
T1P{N}_*, T2P{N}_* | Joueurs. |
T1S{N}_*, T2S{N}_* | Staff. |
EV{ID}_T1, EV{ID}_T2, EV{ID}_T1P, EV{ID}_T2P, EV{ID}_T1A, EV{ID}_T2A | Statistiques d'événements basketball. |
Correspondances v1 -> v2 basketball¶
| V1 legacy déprécié | V2 actuel |
|---|---|
PERIODE | PERIOD |
CLOCK_MLS / clock_mls | CLOCK_MLS |
CLOCK_ADD_MCL | CLOCK_ADD_MLS |
E1SCORE / E2SCORE | T1_SCORE / T2_SCORE |
E1_P1_SCORE / E2_P1_SCORE | T1Q1_SC / T2Q1_SC |
E1_P2_SCORE / E2_P2_SCORE | T1Q2_SC / T2Q2_SC |
E1_P3_SCORE / E2_P3_SCORE | T1Q3_SC / T2Q3_SC |
E1_P4_SCORE / E2_P4_SCORE | T1Q4_SC / T2Q4_SC |
E1TIMEOUTLABEL / E2TIMEOUTLABEL | T1_TO_LBL / T2_TO_LBL |
E1TIMEOUT / E2TIMEOUT | T1_TO / T2_TO |
E1TIMEOUT_IMG / E2TIMEOUT_IMG | T1_TO_IMG / T2_TO_IMG |
SOURCE/IMAGES/BG_TEMPS_MORT | SOURCE/IMAGES/TIMEOUTS |
Détail des clés v1 legacy¶
Les sections ci-dessous décrivent l'ancien contrat basketball. Elles ne doivent plus être utilisées pour un nouveau template.
Spécificités basketball¶
- 4 quart-temps de 10 minutes chacun (chrono dégressif : 10:00 → 0:00).
- Le chrono source peut être lu en mode compte-à-rebours et converti en temps croissant dans l'interface.
- Temps-morts : compteur par équipe (0 à 5), géré directement dans l'interface de match.
- Prolongations possibles après les 4 quarts-temps.
- Pas de temps additionnel (contrairement au football).
Variables de période¶
PERIODE¶
Nom du champ : PERIODE Type : Texte Description : label de période envoyé à l'habillage live. Selon le statut, la valeur peut être le chrono courant, 1RE PÉRIODE, 2E PÉRIODE, 3E PÉRIODE, 4E PÉRIODE, MI-TEMPS, SCORE FINAL, SUSPENSION, REPORTÉ ou PROLONGATIONS.
Le chrono principal est exporté séparément via CLOCK_MLS.
SET¶
Nom du champ : SET Type : Texte Description : valeur brute du quart-temps si elle est disponible dans le match (QT1, QT2, QT3, QT4). Cette variable est surtout utile pour les templates qui veulent afficher le libellé exact saisi côté interface.
Variables de score par quart-temps¶
Ces variables exposent le score marqué dans chaque période séparément.
| Champ | Type | Description |
|---|---|---|
E1_P1_SCORE | Numérique | Score de l'équipe 1 au 1er quart-temps |
E1_P2_SCORE | Numérique | Score de l'équipe 1 au 2e quart-temps |
E1_P3_SCORE | Numérique | Score de l'équipe 1 au 3e quart-temps |
E1_P4_SCORE | Numérique | Score de l'équipe 1 au 4e quart-temps |
E2_P1_SCORE | Numérique | Score de l'équipe 2 au 1er quart-temps |
E2_P2_SCORE | Numérique | Score de l'équipe 2 au 2e quart-temps |
E2_P3_SCORE | Numérique | Score de l'équipe 2 au 3e quart-temps |
E2_P4_SCORE | Numérique | Score de l'équipe 2 au 4e quart-temps |
Variables de chrono¶
| Champ | Type | Description |
|---|---|---|
CLOCK_MLS | Texte | Chrono principal envoyé à l'habillage |
clock_mls | Texte | Alias historique de CLOCK_MLS |
CLOCK_ADD_MCL | Texte | Chrono secondaire ou additionnel si le template l'utilise |
Le chrono basket peut être lu en dégressif par le moteur de sortie, puis converti côté interface avant envoi dans
CLOCK_MLS.
Décompte lu depuis vMix¶
Si vMix porte le chrono, le titre SCORE BUG doit contenir :
| Champ du score bug | Usage |
|---|---|
CLOCK | Décompte du quart-temps, généralement 10:00 → 0:00. |
PERIODE | Numéro du quart-temps : 1, 2, 3, 4, etc. |
CLOCK_ADD ou CLOCK_ADD_MCL | Chrono secondaire si votre habillage l'utilise. |
AppSport inverse le décompte de CLOCK, puis ajoute l'offset indiqué par PERIODE pour obtenir le temps de jeu global. La variable SET reste disponible pour afficher le libellé brut du quart-temps (QT1, QT2, QT3, QT4) dans un habillage.
Variables de temps-mort¶
| Champ | Type | Description |
|---|---|---|
E1TIMEOUTLABEL | Texte | Label TEMPS MORTS — équipe 1 |
E2TIMEOUTLABEL | Texte | Label TEMPS MORTS — équipe 2 |
E1TIMEOUT | Nombre | Nombre de temps-morts utilisés — équipe 1 |
E2TIMEOUT | Nombre | Nombre de temps-morts utilisés — équipe 2 |
E1TIMEOUT_IMG | Image | Indicateur visuel des temps-morts utilisés — équipe 1 |
E2TIMEOUT_IMG | Image | Indicateur visuel des temps-morts utilisés — équipe 2 |
Dans l'interface de match, les champs TEMPS MORTS DOMICILE et TEMPS MORTS EXTERIEUR acceptent des valeurs de 0 à 5.
Les images doivent être nommées :
/SOURCE/IMAGES/BG_TEMPS_MORT/TC_0_.png
/SOURCE/IMAGES/BG_TEMPS_MORT/TC_1_.png
...
/SOURCE/IMAGES/BG_TEMPS_MORT/TC_5_.png
Variables de composition et staff¶
Le basketball utilise la convention commune des sports d'équipe :
E1.../E2...pour les joueurs, avec5 + max_substitutes + 5slots exportés par équipe ;S1.../S2...pour le staff, avecmax_staffslots exportés par équipe.
max_substitutes et max_staff viennent du championnat associé au match. Si la donnée n'est pas disponible, l'export utilise 9 remplaçants et 1 membre du staff par défaut. Les deux valeurs sont bornées à 20.
Consultez le socle général pour le détail des suffixes (NOM, PRENOM, NUMERO, POSTE, C, NC, NCIMG).
Statuts de match¶
| Valeur | Label affiché |
|---|---|
0 | A VENIR |
1 | EN COURS |
2 | MI-TEMPS |
3 | TERMINÉ |
4 | SUSPENSION |
5 | TEMPS-MORT |
6 | ANNULÉ |
7 | REPORTÉ |
10 | 1RE PÉRIODE (QT1) |
11 | 2E PÉRIODE (QT2) |
12 | 3E PÉRIODE (QT3) |
13 | 4E PÉRIODE (QT4) |
14 | PROLONGATIONS |
Résumé des différences avec le Football¶
| Élément | Football | Basketball |
|---|---|---|
| Périodes | 2 mi-temps (45 min) | 4 quart-temps (10 min) |
| Variable période export | PERIODE | PERIODE + SET optionnel |
| Chrono exporté | CLOCK_MLS | CLOCK_MLS |
| Scores par période | (non) | E1_P1_SCORE à E1_P4_SCORE |
| Temps-morts | (non) | E1TIMEOUT_IMG, E2TIMEOUT_IMG |
| Temps additionnel | ADDITIONEL_TIME | (toujours null) |
| Tirs au but | E1TAB, E2TAB | (non) |
| Label des points | Buts | Paniers |
Variables de mouvement au classement¶
Le basketball utilise les mêmes variables de classement que la base commune, avec les indicateurs de mouvement :
| Champ | Description |
|---|---|
CL_G{G}_{P}_UP / CL_{N}_UP | Nombre de places gagnées depuis la journée précédente |
CL_G{G}_{P}_DN / CL_{N}_DN | Nombre de places perdues depuis la journée précédente |
CL_G{G}_{P}_MV / CL_{N}_MV | Icône UP.png, DOWN.png ou EMPTY.png depuis /SOURCE/IMAGES/CLASSEMENT/ |
Préparation de l'habillage¶
- Si vous utilisez vMix, nommez le titre principal contenant le chrono "SCORE BUG" (ou gardez cette chaîne dans son titre court) pour que l'interface le détecte automatiquement.
- Les noms de champs doivent correspondre exactement aux noms de variables (casse incluse).
- Les images vides utilisent
EMPTY.png, comme dans le socle général. - Pour le reste des données d'équipe, de joueurs et de composition, conservez la convention de nommage du socle général.