Variables live output v2 - Socle général¶

Cette page décrit le contrat commun v2 pour les sports d'équipe : football, futsal, handball, hockey sur glace et basketball. Le tennis utilise aussi plusieurs familles communes, mais son modèle joueur/score est détaillé dans Tennis v2.

Référence actualisée pour MY-LIVE-SPORT V2.1.8. Les familles des journées adjacentes sont disponibles depuis la V2.1.6 ; la correction de SET.Text en futsal, basketball et handball est incluse depuis la V2.1.7.

Règles de nommage¶

Chaque variable doit correspondre exactement au nom du champ dans l'habillage configuré. La casse, les underscores et les chiffres comptent.

Si le même champ doit être utilisé plusieurs fois dans un même habillage, ajoutez un suffixe £_0 à £_99 au nom du champ dans le template, quand votre moteur de sortie le supporte. Exemple : T1_LOGO£_0 lit la même valeur que T1_LOGO.

Langue des valeurs¶

Les clés v2 restent en anglais court pour rester stables dans les templates. Les valeurs textuelles peuvent être générées en français ou en anglais selon la langue live output choisie dans l'édition du championnat (LANGUE VMIX, champ technique vmix_text_locale).

Exemples :

Système et match¶

CLOCK_ADD_MLS fait 13 caractères. C'est une exception conservée parce que le logiciel l'expose déjà ainsi.

Chrono¶

Les sports d'équipe peuvent utiliser le chrono AppSport ou un décompte lu depuis vMix. Une table de marque active peut également fournir la période et les données terrain.

Pour les sports à décompte, comme le futsal, le hockey et le basketball, AppSport peut inverser le chrono de période avant de l'envoyer en temps de jeu global. Les règles exactes sont détaillées dans les pages sport.

Avec une source vMix externe, SET.Text est une donnée d'entrée : 1 sélectionne la première période, 2 la deuxième et les valeurs suivantes les périodes supplémentaires selon le sport. En l'absence de période provenant d'une table de marque, AppSport n'envoie plus de valeur vide dans SET.Text; une saisie manuelle vMix reste donc conservée. SET_MLS.Text reste, lui, un champ de sortie piloté par le chrono AppSport. Si une table de marque active fournit une période, sa valeur SET reprend volontairement la priorité sur la saisie manuelle.

Journée et phase¶

Arbitrage et commentateurs¶

Météo¶

Équipes¶

T1 correspond au côté 1, généralement l'équipe à domicile. T2 correspond au côté 2, généralement l'équipe extérieure.

Historique court d'équipe¶

Ces clés servent aux templates qui affichent les derniers matchs d'une équipe.

Buts, synthés et changements¶

Joueurs et staff¶

Les joueurs utilisent T1P{N}_* et T2P{N}_*. Le staff utilise T1S{N}_* et T2S{N}_*.

Exemples :

Le nombre de slots joueurs dépend du sport : titulaires du sport + max_substitutes + 5 slots de sécurité. Le nombre de slots staff dépend de max_staff. Si les valeurs championnat sont absentes, l'export utilise 9 remplaçants et 1 membre du staff par défaut.

Formations¶

Les variables de formation existent pour les sports qui utilisent un placement sur terrain. Les formations réellement utiles sont précisées dans chaque page sport.

Exemple : T1F442LP11I = équipe 1, formation 442L, position 11, image.

Statistiques d'événements¶

Pour chaque type d'événement activé dans la configuration du match, l'export expose les compteurs par équipe.

Tirs au but¶

Résultats du jour¶

Positions disponibles : RES1 à RES20.

Programme¶

Positions disponibles : SCH1 à SCH20.

Journées précédente et suivante¶

Depuis la version v2.1.6, les clés suivantes sont disponibles pour le football, le futsal, le handball, le hockey sur glace, le basketball et le tennis. Elles sont calculées relativement à la journée du match actuellement ouvert. L'ordre réel du championnat est utilisé : il ne faut pas déduire la journée précédente ou suivante du numéro présent dans son libellé.

Exemples de champs à créer dans un template vMix :

Les lignes de date consomment une position dans PSCH* et NSCH*, comme dans SCH*. Les statuts terminés, reportés et suspendus, les horaires, les scores, les logos et les fonds suivent exactement les règles de la famille courante correspondante. Pour le tennis, PRES{N}_SETS fournit aussi le détail des sets.

Ces familles sont uniquement des données live output : aucun bouton supplémentaire n'apparaît dans la page match. Les switches SCROLL de la journée courante ne filtrent pas PRES*. Les métadonnées PREV_* et NEXT_* appliquent les mêmes règles que DAY_NO, DAY_SUF, DAY_LBL, FINAL et DAY_TERM. Le nom de la clé reste FINAL, sans E; ses variantes sont donc PREV_FINAL et NEXT_FINAL. Quand la journée précédente ou suivante n'existe pas, les textes restent vides et les images utilisent les fichiers de remplacement habituels. Les clés historiques ne sont ni supprimées ni renommées; la sélection des lignes RES* est cependant corrigée selon les règles ci-dessous.

Règles d'inclusion dans les résultats¶

Les mêmes règles s'appliquent à RES* et PRES* :

Un match à venir ne réserve aucune position : le résultat admissible suivant remonte vers la première clé libre. Cette règle empêche notamment un match à venir dont les scores techniques valent 0 d'être diffusé comme un faux résultat 0 - 0, tout en conservant les scores des rencontres en cours ou non terminées. Techniquement, seul le statut API 0 (À VENIR) est exclu; les autres codes, notamment les périodes propres au basketball, au handball et aux autres sports, restent admissibles.

Classement global¶

Le classement global prépare jusqu'à 80 lignes.

Classement par groupe¶

Les groupes sont codés sur deux chiffres. Exemple : SG01NM = nom du groupe 1 ; SG0105PT = points de la position 5 du groupe 1.

Tableau final¶

Le tableau final est exposé avec des clés compactes pour limiter la longueur des noms GT.

L'initialisation historique prépare 2 phases, jusqu'à 6 tours par phase, 8 matchs par tour et 48 matchs globaux.

Scroll et alertes¶

Chemins v2¶

Fichiers image attendus¶

Fichier de repli : EMPTY.png. Il doit être disponible dans le dossier de fichiers utilisé par AppSport, car il est envoyé quand une image manque.