Release V3.0.0¶

Date de documentation : 8 octobre 2026.

Résumé¶

La V3.0.0 permet de piloter plusieurs sorties depuis les mêmes boutons du match, de jouer des habillages OGraf avec AppSport et de commander la rencontre depuis Companion. Scoreboard OCR peut alimenter les scores et les horloges des habillages. Les réglages AppSport sont répartis en onglets pour retrouver plus facilement chaque fonction. Les administrateurs d’entreprise peuvent également créer des jetons API pour connecter leurs outils, avec une documentation Swagger publique.

Plusieurs sorties pour vos boutons SYNTHE¶

• Ajoutez et nommez vos connexions vMix, CasparCG et OGraf-server dans AppSport settings → Outputs.
• Chaque carte possède un Type et une Sortie. Un même bouton peut enchaîner des cartes envoyées à plusieurs logiciels ou à plusieurs postes.
• Conservez les commandes de clic gauche, molette et clic droit, avec Next, AutoNext, Break ou Reset pour la suite des cartes.
• Enregistrer les cartes conserve la séquence ; Annuler les modifications retrouve les derniers réglages enregistrés.
• Tester enregistre les cartes et joue uniquement la carte choisie sur sa sortie. Quittez ensuite le mode édition pour tester le bouton complet.
• Désactiver une connexion dans Outputs ignore ses cartes, leurs délais et leurs actions de séquence. Les autres sorties continuent à jouer ; les cartes désactivées restent modifiables et enregistrées, avec Tester indisponible. Si toutes les sorties sont désactivées, le bouton reste visible et grisé, et l’édition reste accessible.

Guide : configurer les boutons Live Output.

OGraf dans une source navigateur OBS ou vMix¶

AppSport démarre un serveur OGraf sur le poste de régie. Placez vos modèles et leurs ressources dans SOURCE\TEMPLATES\OGRAF, puis actualisez le catalogue. Le choix du modèle se fait dans les cartes des boutons du match.

• Copiez une URL fixe, indépendante du match, dans une source navigateur OBS ou vMix.
• Choisissez l’adresse locale ou une adresse réseau du PC AppSport. Plusieurs sources peuvent ouvrir la même sortie et suivre les mêmes commandes.
• Retrouvez l’état du serveur, les lecteurs connectés et Restart server dans l’onglet Outputs.
• Les champs dont le nom correspond à une variable, par exemple T2_FULL, sont associés automatiquement. Les images des dossiers Source et Cache sont accessibles à la sortie.
• Les premières animations et les séquences d’images des modèles convertis bénéficient d’une préparation avant affichage. Les ressources déjà chargées sont réutilisées.
• Recharger le même match conserve les dernières données de la sortie. Changer de match ou de projet réinitialise les habillages pour préparer la nouvelle rencontre.

Une page transparente peut paraître vide tant qu’aucun habillage n’a reçu In. L’installation des modèles se fait dans le projet local AppSport.

Guide : installer et jouer un modèle OGraf.

Scroll et alertes de score sur les sorties graphiques¶

• Le scroll peut utiliser une sortie OGraf seule, sans ancien input vMix. Les champs de la première rencontre sélectionnée sont préparés avant In ; les suivantes suivent la vitesse et la boucle réglées dans Direct.
• Le bouton d’alerte reste armé et attend un changement de score d’une rencontre cochée ALERT. Le premier relevé ne déclenche pas d’alerte. Les alertes sont jouées dans leur ordre d’arrivée.
• vMix utilise les animations Page1 / Page2 et les champs présents dans le titre ; OGraf utilise les étapes 0 (attente), 1 (alerte) et 2 (masquage). Dans CasparCG, le modèle HTML anime l’alerte à réception des nouvelles données.
• Couper le bouton ou changer de sortie annule les alertes en attente. Testez un modèle d’alerte adapté et sa durée hors antenne.
• Les textes et le chrono des modèles GT convertis sont actualisés sans relancer leurs séquences d’images. Une image fixe laissée vide conserve la ressource embarquée ; une image associée sans valeur efface la précédente.

Guide : programme, scroll et alertes.

Scoreboard OCR : scores et horloges pour les habillages¶

Sélectionnez Scoreboard OCR dans Table de marque, activez l’API locale puis enregistrez. Copiez son URL dans la sortie Web Socket de Scoreboard OCR. Cette entrée partage les réglages réseau et de protection de l’API locale utilisée par Companion ; elle remplace la source Bodet quand elle est sélectionnée.

• Associez les zones reconnues aux variables de score, de période, de chrono ou de possession, ou utilisez directement leurs noms : ocr.2_SCORE.Text dans OGraf, le champ homonyme dans vMix ou la clé brute dans CasparCG.
• Le diagnostic distingue les relevés reçus des relevés appliqués. L’application des lectures exige un match modifiable prêt, hors mode édition.
• Une coupure conserve les dernières valeurs, avec l’horloge figée. Effacer les données OCR rend la priorité aux valeurs habituelles du match. Changer de match efface les lectures et demande une reconnexion.
• Les lectures alimentent les habillages ; elles ne modifient pas les scores officiels ni les événements enregistrés. Cette entrée fait partie de la table de marque en bêta : vérifiez la reconnaissance et les associations hors antenne.

Guide illustré : connecter Scoreboard OCR et vérifier les données.

Companion : boutons, joueurs et événements¶

L’onglet Local API permet d’activer l’API locale, de copier l’URL et la clé d’accès, puis de consulter les commandes du match ouvert.

• Déclenchez les boutons SYNTHE et les commandes de chrono.
• Suivez le score, le chrono, les libellés et les états des boutons en WebSocket, avec une lecture HTTP de secours dans le module AppSport.
• Sélectionnez un joueur et préparez un événement ou un remplacement avant de le confirmer.
• Enregistrez directement un événement, ajustez une statistique ou rappelez un synthé déjà enregistré.
• Les commandes proposées suivent le sport ouvert : football, futsal, basketball, handball, hockey ou tennis. Les remplacements concernent les sports collectifs.
• Depuis Local API · Companion, accédez directement au guide et aux téléchargements du module Companion.
• Consultez et appliquez les réglages de l’API locale avant d’ouvrir un match. Si vous demandez les commandes sans match prêt, un message indique de charger la rencontre dans la fenêtre principale.

La préparation, l’enregistrement d’un événement et la diffusion du synthé restent des actions distinctes. Un événement confirmé modifie réellement le match ; le bouton SYNTHE joue ensuite les cartes prévues par votre régie.

Guide : connecter Companion et préparer les actions du match.

API et tokens d’entreprise¶

Connectez un tableau de bord, un outil de résultats ou une autre intégration aux données de votre entreprise depuis Compte → API et tokens. L’API web fonctionne indépendamment du match ouvert sur le poste AppSport.

• Seuls les administrateurs de l’entreprise peuvent accéder à la gestion des jetons et au Swagger intégré, puis créer, modifier ou révoquer un accès. Les autres comptes ne peuvent pas ouvrir ces pages, même avec leur lien direct.
• Chaque jeton appartient à l’entreprise sélectionnée et reste limité à ses données, à sa licence et aux sports autorisés : football, futsal, hockey, basketball, handball et tennis.
• Choisissez Lecture seule ou Lecture et écriture d’événements, ainsi qu’une expiration de 7, 30, 90 ou 365 jours.
• Copiez le secret à sa création : il n’est plus affiché après fermeture. Modifier un jeton conserve son secret ; Révoquer bloque les nouvelles requêtes.
• Les pages API et Swagger reprennent la typographie des éditeurs, avec une présentation adaptée aux thèmes clair/sombre et au mobile. Les résultats et erreurs, notamment Modification annulée, apparaissent en notifications popup.

Les jetons de l’API web et la clé de l’API locale Companion sont indépendants. Les jetons web donnent accès aux données de l’entreprise ; les commandes du poste de régie utilisent l’API locale.

Guides : créer et utiliser un jeton web et utiliser l’API locale AppSport.

Swagger et aide API publique¶

La rubrique API et intégrations du help rassemble les guides, les contrats OpenAPI et les Swagger web/local consultables sans compte. Les Swagger publics permettent de lire les opérations et leurs paramètres.

Le parcours de démarrage renvoie au guide commun des boutons Live Output. L’ancien éditeur vMix, les variables dépréciées et les anciennes notes sont regroupés dans Archives, en dehors de la recherche des guides actuels. Les anciennes adresses restent accessibles.

Pour tester une opération, un administrateur ouvre API et tokens → Ouvrir Swagger dans l’application et renseigne le jeton de son entreprise avec Authorize. Les essais envoient des requêtes réelles : une opération POST peut créer ou modifier les événements du match indiqué.

Documentation : API et tokens, Swagger web et Swagger local.

Des réglages AppSport plus faciles à retrouver¶

Les libellés de cette fenêtre restent en anglais. Output enabled devient un interrupteur. Les actions Cancel, Save to .appsport et Apply restent accessibles en bas de la fenêtre.

Generator conserve la génération des projets de match depuis SOURCE vers LIVE : les modèles sont copiés et adaptés selon les règles de copie. Le projet source reste avec la case décochée ; le projet de rencontre généré reçoit la case cochée pour le direct. La génération se lance depuis Générer le projet sur la page du match.

Guide : préparer AppSport pour un match.

Championnats et classements¶

• L’enregistrement d’une équipe dans les cinq sports collectifs, ou d’un club optionnel au tennis, actualise sa ligne sans recharger toute la liste et conserve les autres saisies en cours.
• Les sections des phases, groupes et journées sont simplifiées. Les photos de joueurs et plusieurs champs ou boutons sont harmonisés.
• En futsal, le départage par confrontations directes conserve le groupe initial d’équipes à égalité pour comparer les points et la différence de buts.
• Les corrections de classement futsal sont conservées par journée ; corriger une journée recalcule aussi les journées suivantes, avec leurs corrections respectives.
• Une nouvelle aide explique les modes de calcul, les corrections et les mouvements de classement.

Guide : comprendre et corriger les classements.

Reprendre un projet existant¶

AppSport 3.0.0 minimum est requis pour accéder au site V3. Une installation antérieure doit être mise à jour avant de reprendre le pilotage du match.

Les fichiers .appsport, titres vMix et modèles CasparCG existants restent utilisables. Les cartes historiques sont reprises lorsqu’une connexion de leur type est active. La configuration commune des sorties multiples et OGraf demande AppSport 3.0.0 et les écrans web correspondants.

Sauvegardez le fichier .appsport, vos dossiers Source et Cache, notamment cache\LIVEOUTPUT et cache\OGRAF. Les nouvelles cartes sont locales au projet : elles ne sont pas incluses dans le seul fichier .appsport et ne se transfèrent pas automatiquement entre postes.

Le numéro V3.0.0 concerne cette release. Les noms variables v1/v2 décrivent les formats des données d’habillage et restent inchangés. La date ci-dessus correspond à la rédaction de l’aide ; consultez votre canal habituel pour la disponibilité de la mise à jour.