Piloter MyHUD depuis un autre appareil

Par défaut, MyHUD accepte les commandes uniquement depuis le PC sur lequel il tourne. Pour utiliser l'API depuis un deuxième PC, une tablette ou une machine Companion sur le même réseau, active le mode réseau local.

WARNING

Le trafic n'est pas chiffré. Utilise ce mode uniquement sur un réseau de confiance, par exemple le réseau de ton studio ou de ta LAN.

Activer le mode réseau local

Va dans Intégrations > Automatisation locale.
Vérifie que Activer le serveur d'automatisation local est coché.
Coche Autoriser les connexions depuis le réseau local.
Si Windows le demande, autorise MyHUD dans le pare-feu.

Le panneau affiche alors :

Adresses pour les autres appareils : les adresses de ce PC sur ton réseau, par exemple http://192.168.1.20:44555. Clique sur une adresse pour la copier.
Jeton d'accès : une clé secrète. Clique sur Afficher ou Copier.

Envoyer le jeton

Les autres appareils doivent envoyer le jeton avec chaque requête. Le PC qui fait tourner MyHUD n'en a jamais besoin.

HTTP

Envoie le jeton dans l'en-tête Authorization :

curlPowerShellPythonTypeScript

bash

curl -X POST http://192.168.1.20:44555/api/actions/show_veto \
  -H 'Authorization: Bearer <jeton>'

powershell

$headers = @{ Authorization = 'Bearer <jeton>' }
Invoke-RestMethod -Method Post http://192.168.1.20:44555/api/actions/show_veto -Headers $headers

python

import requests

res = requests.post(
    "http://192.168.1.20:44555/api/actions/show_veto",
    headers={"Authorization": "Bearer <jeton>"},
)
print(res.json())

const res = await fetch('http://192.168.1.20:44555/api/actions/show_veto', {
  method: 'POST',
  headers: { Authorization: 'Bearer <jeton>' },
});
console.log(await res.json());

L'en-tête X-MyHUD-Token: <jeton> fonctionne aussi.

WebSocket

Mets le jeton dans l'adresse :

ws://192.168.1.20:44555/?token=<jeton>

Ou envoie ce message en premier, dans les 5 secondes après la connexion :

json

{ "type": "auth", "token": "<jeton>" }

Tant que le jeton n'est pas accepté, la connexion ne reçoit rien.

Changer le jeton

Clique sur Régénérer pour créer un nouveau jeton. Tous les appareils distants sont déconnectés et doivent utiliser le nouveau jeton. Fais-le si tu penses que quelqu'un d'autre a le jeton.

Ce qui est bloqué

Les appareils hors de ton réseau local sont toujours refusés, même avec le jeton.
Les pages web ouvertes dans un navigateur ne peuvent pas envoyer de commandes, même sur le PC de MyHUD. Un site web ne peut donc pas piloter ton HUD.
Un appareil distant peut envoyer jusqu'à 20 requêtes par seconde. Au-delà, MyHUD répond 429 rate_limited.

Problèmes fréquents

Réponse	Cause
`401 unauthorized`	Le jeton est absent ou faux. Copie-le à nouveau depuis le panneau.
`403 forbidden`	Le mode réseau local est désactivé, ou l'appareil n'est pas sur un réseau local.
Pas de réponse, délai dépassé	Le pare-feu Windows bloque MyHUD, ou l'adresse est fausse.
WebSocket fermé avec le code `4401`	Le jeton est faux, ou le message `auth` est arrivé trop tard.

Piloter MyHUD depuis un autre appareil ​

Activer le mode réseau local ​

Envoyer le jeton ​

HTTP ​

WebSocket ​

Changer le jeton ​

Ce qui est bloqué ​

Problèmes fréquents ​