Piloter My Live Sport avec Companion¶
Le module permet de choisir les joueurs, préparer et confirmer des événements ou remplacements, puis déclencher les graphiques configurés. Les actions et presets sont en anglais. Les noms de joueurs, équipes et cartes personnalisées restent ceux de votre configuration.
Prérequis : Companion 5, API locale activée, match chargé et droits de modification. Pour diffuser un graphique, configurez vos sorties et cartes Live Output.
1. Activer l’API et connecter Companion¶
- Dans My Live Sport, ouvrez Configuration → AppSport settings… → Local API et cochez Enable API.
- Conservez le port 18800 ou choisissez un port disponible distinct du port OGraf. Sur un autre PC, activez Allow network access et sélectionnez l’adresse réseau correspondante.
- Cliquez sur Apply, vérifiez Running, puis utilisez Copy URL. Copiez aussi la clé si Require API key est activé.
- Ouvrez la rencontre à piloter et quittez le mode édition des boutons.
Télécharger le module Companion My Live Sport (ZIP)
- Extrayez le ZIP et importez
appsport-local-test.tgzdans Modules de Companion, avec l’installation depuis un fichier. Le TGZ séparé est également disponible. Le module contient ses dépendances ; aucune installation Node/npm séparée n’est nécessaire. - Dans Connections, ajoutez BARYUM PRODUCTION / My Live Sport, puis donnez un label à la connexion, par exemple
MyLiveSport. - Collez l’adresse dans My Live Sport API URL et la clé dans My Live Sport API key (optional) si la protection est activée. Conservez Automatic WebSocket with HTTP fallback, 1000 ms, puis attendez OK.
Pour fonctionner sans clé, décochez Require API key dans l’application, appliquez, puis laissez le champ Companion vide. Cela fonctionne en HTTP et WebSocket. Les appareils pouvant joindre l’API disposent alors des commandes du compte connecté. Save to .appsport conserve les réglages de l'API dans le projet ; Apply les mémorise seulement sur le poste. Rouvrir le projet réapplique sa configuration API. La clé privée reste propre au PC et n'est pas transportée dans le .appsport.
Le lien Download the Companion module and follow the setup guide dans Local API ouvre directement cette page. Les réglages peuvent être appliqués avant d’ouvrir un match. Si Show match commands vous demande un match chargé, ouvrez-le dans la fenêtre principale, attendez son chargement puis consultez à nouveau le catalogue. L’entrée Scoreboard OCR peut fonctionner en parallèle sur un canal distinct de cette API.
Pour développer votre propre intégration, consultez API et tokens, le Swagger local ou les jetons de l’API web.
2. Faire un remplacement avec préparation¶
Dans Substitutions · HOME ou Substitutions · AWAY, déposez les boutons des quatre groupes numérotés sur votre page Companion :
| Étape | Action | Résultat |
|---|---|---|
| 1. Choose outgoing player | Appuyez sur le joueur qui sort. | Il doit être actuellement sur le terrain. |
| 2. Choose incoming player | Appuyez sur le joueur qui entre. | Il doit être actuellement sur le banc. |
| 3. Prepare substitution | Vérifiez les deux noms et appuyez sur PREPARE. | Un brouillon est créé ; aucun événement n’est sauvegardé. |
| 4. Check and confirm | Contrôlez Prepared players and time, puis CONFIRM & SAVE. | Le remplacement est sauvegardé et les statuts terrain / banc sont mis à jour. |
CANCEL efface la préparation. Les confirmations ciblées refusent un brouillon d’événement ou de l’autre équipe. En cas de refus de sauvegarde, le brouillon reste disponible : consultez Last command and error dans Match avant de réessayer.
Chaque position possède un bouton sortant et un bouton entrant. Le rôle impossible est grisé ; le joueur choisi devient vert. Après remplacement, ces mêmes boutons restent utilisables dans le rôle inverse. Après une sauvegarde confirmée, les deux choix locaux de l’équipe sont vidés pour le prochain remplacement.
La minute et les joueurs sont figés lors de la préparation. Changer le chrono ou les choix locaux ne modifie pas ce brouillon. Les droits, l’effectif et les statuts terrain / banc sont revérifiés à la confirmation.
Optional: save immediately contient l’alternative sans préparation. Pour suivre le parcours avec confirmation, utilisez les groupes numérotés.
Une fois le remplacement sauvegardé, vous pouvez le rappeler depuis Saved substitutions · HOME/AWAY, puis déclencher le preset Graphics prévu pour sa diffusion. La sauvegarde n’envoie pas automatiquement un graphique à l’antenne.
3. Préparer un événement¶
La rubrique Events · HOME/AWAY rassemble le parcours complet :
- Choose a player : choisissez le joueur, sans sauvegarder d’événement.
- Prepare an event : choisissez Goal, Yellow card, Player graphic, ou le type correspondant au sport ouvert.
- Check and confirm : vérifiez le type, le joueur et la minute / le set, puis confirmez ou annulez.
Les boutons d’événement affichent le joueur choisi. Le groupe Optional: save immediately propose la sauvegarde directe. Au tennis, les rubriques utilisent PLAYER / PAIR 1/2, avec les partenaires de double et les types Ace, Double fault, etc. Aucun remplacement n’est proposé.
Une seule préparation est partagée par les contrôleurs du match. En préparer une nouvelle remplace la précédente. La rubrique Preparation permet de confirmer ou annuler globalement le brouillon ; les confirmations placées dans les parcours numérotés vérifient leur équipe et leur type. Un changement de rencontre ou un rechargement de la page efface la préparation.
4. Lire les états et utiliser les autres commandes¶
Le fond est sombre, le bandeau Home bleu et le bandeau Away rouge. Les choix locaux deviennent verts ; les commandes indisponibles sont grisées. Les sorties à l’antenne affichent ON AIR en rouge ; la prévisualisation affiche PREVIEW en orange.
| Rubrique | Utilisation |
|---|---|
| Match | Chrono, score, période, Refresh et Last command and error. |
| Players | Choix d’un joueur pour les événements ou statistiques, indépendamment de la préparation. |
| Statistics | Ajouter ou retirer une occurrence pour le joueur choisi. -1 supprime réellement sa dernière occurrence. Au basket, le total individuel additionne les événements à 1, 2 et 3 points. |
| Tennis | Jeux, points et serveur du match. |
| Match controls | Boutons ordinaires de l’interface, notamment le chrono. Apply utilise la saisie déjà présente dans l’application. |
| Graphics | Gestes LEFT CLICK, MIDDLE CLICK, RIGHT CLICK et RESET SEQUENCE, selon les cartes configurées dans l’application. |
Les gestes des graphiques suivent votre conduite ; ils ne garantissent pas une entrée ou une sortie. Pour ajouter un élément de l’interface, utilisez Additional interface elements dans les réglages Companion de l’application, puis Apply et Show match commands.
5. Positions et variables¶
Les boutons suivent les emplacements namesList_home_1, namesList_home_2, etc., et leurs équivalents away. La position correspond à une ligne de composition, pas au numéro du maillot. L’API lit l’ID du joueur réellement choisi dans le formulaire de cette ligne.
Une ligne vide ou ambiguë refuse la commande. Ses variables restent définies et vides quand elle est retirée ou le match déconnecté. Sans emplacement disponible, un bouton Fixed ID (no slot) conserve le joueur précis. Au tennis, la ligne 1 désigne le joueur principal et la ligne 2 son partenaire de double.
| Variables | Utilisation |
|---|---|
namesList_home_1_id/name/number/label | ID et affichage de l’occupant actuel de la ligne. Les alias player_home_1_* sont conservés. |
chosen_player_id/name, chosen_home_id/name, chosen_away_id/name | Dernier choix global et choix indépendant par équipe. |
replacement_home_out_id/name, replacement_home_in_id/name | Sortant et entrant choisis localement. Utilisez les variantes away pour l’extérieur. |
prepared, prepared_type, prepared_detail, prepared_side, prepared_time, prepared_label | Présence, type, participants, équipe et temps du brouillon. |
clock, period, home_name, away_name, score_home, score_away | Données générales du match. |
last_command, last_error, last_event_id, transport | Résultat de commande, erreur, dernier événement et transport actif. |
Les presets gèrent les variables automatiquement. Pour construire une action, choisissez Roster slot / current choice ou Companion variable. Dans le second mode, utilisez par exemple $(MyLiveSport:namesList_home_1_id) et adaptez le label de connexion. Une variable vide refuse la commande ; le champ masqué est ignoré. Players / Get player ID renvoie un ID stockable dans une variable locale ou personnalisée Companion.
Mise à jour et diagnostic¶
Après import du module mis à jour, redéposez les nouveaux presets Events et Substitutions pour obtenir les groupes numérotés, les deux rôles par position et les confirmations ciblées. Les boutons déjà placés conservent leurs textes et leurs actions ; les anciens ID d’actions et variables restent acceptés.
| Symptôme | Vérification |
|---|---|
| NO PREPARATION | Préparer d’abord et vérifier l’équipe et le parcours utilisés. |
| CHOOSE BOTH PLAYERS | Choisir un sortant sur le terrain et un entrant sur le banc, dans la même équipe. |
failed dans Last command and error | Lire last_error. Le message du serveur conserve sa langue d’origine. |
401 | Vérifier la clé ou appliquer la désactivation de Require API key. |
409 ou action indisponible | Vérifier les droits, le mode édition, le chargement et la gestion automatique du match. |
| Sauvegarde réussie sans graphique visible | Déclencher ensuite le preset Graphics configuré. |
À la coupure WebSocket, le module reprend en HTTP et tente de reconnecter le flux. Les choix locaux sont effacés à la déconnexion, à la reconfiguration et au changement de rencontre. Aucune commande n’est rejouée automatiquement. Vérifiez le contexte du match avant de reprendre une page Companion existante.