Raccourcis OBS et contrôle par Stream Deck Bêta

Vous pouvez contrôler SermonWave dans OBS sans toucher au panneau : avec des raccourcis clavier, ou depuis un Stream Deck ou Bitfocus Companion via obs-websocket. Tout ce qui est décrit ici fonctionne avec le panneau fermé. Dans le panneau, Stream Deck & control détermine quand la traduction démarre d'elle-même et affiche un court résumé sous Hotkeys and Stream Deck.

À qui s'adresse cet article#

Aux directeurs techniques qui pilotent déjà OBS avec des raccourcis, un Elgato Stream Deck, Bitfocus Companion ou un contrôleur similaire.

Avant de commencer#

• Le plugin est installé et associé. Voir Associer OBS à SermonWave.
• Pour Stream Deck / Companion : le serveur obs-websocket est activé dans OBS (Tools → WebSocket Server Settings → Enable WebSocket server, soit Outils → Paramètres du serveur WebSocket → Activer le serveur WebSocket). Il est intégré à OBS 28 et versions ultérieures.
• Votre contrôleur peut envoyer une requête obs-websocket brute (par exemple le module OBS de Companion avec une requête personnalisée, ou un plugin Stream Deck qui prend en charge CallVendorRequest).

Raccourcis clavier#

Le plugin ajoute des entrées SermonWave dans OBS Settings → Hotkeys (Paramètres → Raccourcis clavier) :

• SermonWave: Start translation, SermonWave: Stop translation et SermonWave: Start / stop translation (toggle) (démarrer, arrêter, ou basculer la traduction).
• Par langue : SermonWave: Start translated stream … / Stop translated stream … (flux traduit) et SermonWave: Start translated recording … / Stop translated recording … (enregistrement traduit).
• Par langue : SermonWave: Toggle language … ajoute ou retire cette langue des langues de l'appareil. Cela modifie l'appareil pour tout le monde, comme Save languages.

Attribuez-y des touches comme pour n'importe quel autre raccourci OBS. Un Stream Deck peut les déclencher avec ses actions de raccourci OBS.

Souvent, vous n'en avez même pas besoin, car la traduction suit OBS :

1. Dans le panneau, sous Stream Deck & control, réglez Translate when sur Streaming, Recording ou Streaming or recording. Voir Configurer l'audio, les langues et le démarrage/l'arrêt dans OBS.
2. Dans OBS Settings → Hotkeys, attribuez des touches aux commandes intégrées d'OBS Start Streaming / Stop Streaming et Start Recording / Stop Recording (démarrer/arrêter le streaming et l'enregistrement).
3. Ces touches démarrent et arrêtent désormais ensemble la traduction, les flux traduits et les enregistrements traduits.

Capture d'écran bientôt disponible

Requêtes fournisseur obs-websocket#

Le plugin enregistre un fournisseur (vendor) obs-websocket nommé sermonwave. N'importe quel client obs-websocket peut l'appeler avec la requête standard CallVendorRequest :

{
  "requestType": "CallVendorRequest",
  "requestData": {
    "vendorName": "sermonwave",
    "requestType": "get_state",
    "requestData": {}
  }
}

Les langues sont indiquées par des codes courts, par exemple es, fr, pt.

Requêtes utiles#

Champs de set_output#

Tous facultatifs sauf language :

• stream_now : "start" ou "stop" — identique au bouton Start / Stop de la langue dans la barre de contrôle.
• video_quality : auto, 720p, 1080p, 480p ou match — la Video quality de la langue (match = Same as the main stream, identique au flux principal).
• stream_enabled, record_enabled, room (true/false) — Stream …, Record a … copy, Play … in the room.
• preset : youtube_rtmps, youtube_rtmps_backup, youtube_rtmp, facebook, custom ; ou destination : youtube_auto pour YouTube (automatic).
• server, key — serveur et clé de stream pour une plateforme configurée manuellement.
• sync_video, stream_captions, record_captions, captions_default, resync, keep_live (true/false).
• bg_db, bg_off, duck_db — niveau Original audio, Original audio Off (coupé) et niveau Under translation, en dB.

Exemples#

Démarrer maintenant le flux traduit en espagnol :

{
  "requestType": "CallVendorRequest",
  "requestData": {
    "vendorName": "sermonwave",
    "requestType": "set_output",
    "requestData": { "language": "es", "stream_now": "start" }
  }
}

Activer la diffusion du français dans la salle :

{
  "requestType": "CallVendorRequest",
  "requestData": {
    "vendorName": "sermonwave",
    "requestType": "set_output",
    "requestData": { "language": "fr", "room": true }
  }
}

Baisser le son d'origine sous la traduction espagnole à −25 dB :

{
  "requestType": "CallVendorRequest",
  "requestData": {
    "vendorName": "sermonwave",
    "requestType": "set_output",
    "requestData": { "language": "es", "duck_db": -25 }
  }
}

La réponse se trouve dans le champ responseData de la réponse. Les requêtes comme set_output répondent immédiatement {"ok": true} ; vérifiez le résultat avec get_outputs.

Dépannage#

La requête échoue avec un fournisseur inconnu. obs-websocket ne fonctionnait pas quand OBS a chargé le plugin, ou le plugin n'est pas installé. Activez le serveur WebSocket et redémarrez OBS.

set_output renvoie ok: false. Le champ language est manquant.

Rien ne se passe pour une langue. Vérifiez que cette langue a bien été ajoutée avec Add language sous Translated streams (ou appelez d'abord add_language). Les raccourcis par langue apparaissent dans OBS Settings → Hotkeys dès que la langue est proposée par l'appareil ou ajoutée dans le panneau.

FAQ#

Les raccourcis fonctionnent-ils quand le panneau est fermé ?#

Oui. Les raccourcis, les requêtes obs-websocket et le démarrage/l'arrêt automatique avec votre flux ou votre enregistrement fonctionnent tous avec le panneau fermé.

La connexion obs-websocket est-elle sécurisée ?#

Elle reste locale à votre réseau. Laissez Enable Authentication (activer l'authentification) coché dans les paramètres du serveur WebSocket et utilisez le mot de passe dans votre contrôleur.