Démarrer l'essai gratuit — 7 jours offerts

Démarrer l'essai gratuit

← Back to docs

Voco Docs

Stream Deck et contrôle à distance

Contrôlez Voco depuis un bouton Stream Deck, une action ProPresenter ou n'importe quel déclencheur URL via l'API Signal.

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.

  1. 1Trouver votre clé APIOuvrez Paramètres → API dans le tableau de bord Voco et copiez la clé API de votre église.
  2. 2Ajouter un bouton Site webDans Stream Deck, ajoutez une action et choisissez le type d'action Système → Site web.
  3. 3Coller l'URL de déclenchementUtilisez le format d'URL ci-dessous, en remplaçant YOUR_KEY par votre clé réelle.
  4. 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.
  5. 5Répéter pour chaque actionCréez un bouton par action — démarrer, arrêter, sous-titres on/off, effacer.
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=stream:start
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=stream:stop
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=captions:hide
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=captions:show
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=captions:clear

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.

Related guides