Pilotage audiovisuel
Interfaces AV : documenter TCP, UDP, API et GPIO
Une interface exprime une intention entre systèmes. Son usage en spectacle demande de connaître le message et son sens : ce que le destinataire accepte, ce qu’il renvoie et son comportement en cas de perte de connexion.
TCP et UDP : transport et signification
TCP fournit un flux d’octets ordonné. UDP transporte des datagrammes sans garantir leur livraison ni la protection contre les doublons. Aucun ne définit le sens de « lire Q010 » dans votre application.
Pour une interface TCP, précisez la délimitation des messages et la reconnaissance d’une réponse complète. En UDP, vérifiez les mécanismes de corrélation, de confirmation ou de répétition proposés par l’application. Un accusé de réception au niveau du transport ne prouve pas la présentation du contenu.
La fiche d’une interface applicative
Demandez au fabricant les commandes et requêtes acceptées, les types de données et plages, le format et la terminaison des messages, les erreurs, les exigences d’authentification, les limites d’interrogation et le comportement à la reconnexion. Conservez les identifiants d’accès séparément des documents publics.
Exemple documenté : QRC de Q-SYS 10.5.0 utilise JSON-RPC 2.0 terminé par un caractère nul et un id pour associer réponse et requête. N’étendez pas ce découpage à une autre API. L’id permet la corrélation, sans garantir la déduplication.
Contacts et GPIO : identifier la variante
La distinction des variantes est essentielle : l’aide Q-SYS 10.5.0 indique des GPIO intégrés au Core 110f et leur absence sur le Core 110f v2. Confirmez matériel physique et compatibilité de version avant de retenir ce parcours.
Un contact et une entrée logique ne sont pas équivalents par leur nom. Demandez au fabricant type d’interface, niveaux admissibles, isolation requise et état au repos. Toute connexion doit être étudiée par le professionnel compétent à partir de la documentation exacte.
Pour un déclenchement AV, consignez front ou niveau, durée requise selon le récepteur, traitement des rebonds et réarmement. Ne supposez pas ces paramètres et n’utilisez pas une interface AV pour le mouvement ou les fonctions de sécurité.
Les éléments à remettre au spécialiste
Une fiche pour l’interface IF-01 peut préciser : la sélection du cue Q010 ; l’émetteur et le destinataire avec leurs versions ; le transport ou le type d’entrée ; le message ou la condition documentés ; le retour attendu ; le comportement à la perte et à la reprise ; et la personne qui vérifie la sortie.
Marquez les données manquantes comme non confirmées. Ne les remplacez pas par le brochage ou les temps d’un autre modèle. Sans retour d’état, convenez de l’observation par l’opérateur et du moment où l’avance doit être suspendue.
Commencer sans disposer de tous les détails
Décrivez la séquence à coordonner. Des photos du matériel ou un schéma préliminaire suffisent pour commencer, même sans tous les modèles ou dimensions. Ils permettent de repérer la documentation manquante et les interfaces à étudier.
Sources et manuels
Étudier l’interface et les besoins techniques
GLMedia peut vous aider à étudier les possibilités d’intégration et les besoins d’exploitation. Si le projet nécessite du matériel supplémentaire, nous pouvons examiner les options de location ou d’achat, avec périmètre et disponibilité à confirmer.
Étudier l’interface et les besoins techniques