L'API Signal
L'API Signal de Voco permet aux appareils externes d'envoyer des commandes au flux actif sans ouvrir le tableau de bord admin. Elle est disponible sur les plans Voco Pro et Network.
L'API prend en charge cinq actions : stream:start, stream:stop, captions:clear, captions:hide et captions:show.
Configuration Stream Deck (action URL)
Le bouton Site web de Stream Deck ouvre une URL — ce qui suffit pour déclencher l'endpoint GET de l'API Signal. Pas de plugin nécessaire.
- 1Trouver votre clé APIOuvrez Paramètres → API dans le tableau de bord Voco et copiez la clé API de votre église.
- 2Ajouter un bouton Site webDans Stream Deck, ajoutez une action et choisissez le type d'action Système → Site web.
- 3Coller l'URL de déclenchementUtilisez le format d'URL ci-dessous, en remplaçant YOUR_KEY par votre clé réelle.
- 4Définir ouverture en arrière-planActivez « ouvrir en arrière-plan » pour que l'URL se déclenche silencieusement sans ouvrir un onglet de navigateur.
- 5Répéter pour chaque actionCréez un bouton par action — démarrer, arrêter, sous-titres on/off, effacer.
Bitfocus Companion
Bitfocus Companion prend en charge les actions de requête HTTP, qui fonctionnent avec l'endpoint POST de l'API Signal. Utilisez un bouton Requête HTTP générique, réglez la méthode sur POST, l'URL sur https://voco.church/api/v1/signal, et ajoutez un corps JSON avec votre clé API et l'action.
Companion est utile lorsque vous avez besoin d'un contrôleur à grille de boutons complet plutôt qu'un Stream Deck grand public, ou lorsque vous intégrez des flux de contrôle ATEM, vMix ou ProPresenter.
Actions URL ProPresenter
Les diapositives ProPresenter peuvent déclencher des actions URL lorsqu'elles sont affichées. Ajoutez une action URL à n'importe quelle diapositive en utilisant l'endpoint GET de l'API Signal — par exemple, une diapositive pré-culte qui démarre automatiquement le flux Voco lorsqu'elle est mise à l'écran.
Gardez votre clé API privée
Ne collez pas votre clé API dans des documents partagés, des chats de groupes bénévoles ou des enregistrements de diffusion. Faites-la tourner depuis Paramètres → API si elle est exposée.