Dock
Notre dock, tel que décrit précédemment, est distribué sous la forme d'une page HTML présente à l'adresse suivante :
https://obs.multistream.tools/v1/dock
Le dock reçoit, traite, affiche et transmet les événements émis par les adaptateurs configurés. Il est donc nécessaire d'ajouter notre dock en tant que dock Internet personnalisé dans votre installation d'OBS sans quoi aucun overlay Multistream Tools ne pourra recevoir d'événements provenant de différentes plateformes.
Onglet Réglages
La première chose à faire après avoir ajouté notre dock à OBS est de le configurer. Ceci prend place dans l'onglet nommé Réglages. Il s'agira alors simplement d'ajouter autant d'adapateurs que vous le souhaitez - un par plateforme - en cliquant autant de fois que nécessaire sur le bouton Ajouter de la section Adaptateurs puis en inscrivant les URLs associées dans chaque champ de formulaire présent à l'écran. N'oubliez pas ensuite d'enregistrer votre configuration en cliquant sur le bouton Enregistrer/Recharger !
Il peut être parfois difficile de savoir à quelle plateforme un adaptateur fait référence en regardant simplement son URL ; vous pouvez alors ajouter par exemple #twitch à la fin de celle-ci en guise d'étiquette.
Ce bouton, comme son nom l'indique, permet également de recharger chaque adaptateur en cas de problème. Vous trouverez également un bouton nommé Recharger les overlays permettant de la même façon de recharger chaque overlay.
Onglet Flux d'activités
Une fois le dock configuré correctement, l'onglet nommé Flux d'activités deviendra sans doute celui sur lequel vous passerez le plus de temps en tant que streameur. En effet, son but est de lister les événements de catégorie alerte en prenant soin d'indentifier les plateformes sur lesquelles ceux-ci ont eu lieu. Les événements les plus récents sont ajoutés en haut de la liste et seuls ceux survenant pendant une session de stream sont affichés. Il permet donc extrêmement aisément de remercier les personnes à l'origine de ces différentes alertes.
L'onglet Flux d'activités comprend également trois boutons nommés Sourdine, Pause et Passer communiquant directement avec les overlays dans le but de respectivement couper le son des alertes, les mettre en pause ou en ignorer certaines si besoin. Ces boutons ne s'activent que lorsque vous avez précedemment configuré au moins un adapteur et que celui-ci a été chargé correctement.
Les boutons Sourdine et Pause se comportent en réalité comme des interrupteurs, un premier clic les mettra donc en position "allumée" et un second les basculera à nouveau en position "éteinte". L'état de ces boutons est conservé entre les différents redémarrages d'OBS sur un ordinateur donné.
Paramètres
| nom | valeur | optionnel |
|---|---|---|
lang | Langue de l'interface utilisateur (détectée par défaut) | oui |
theme | URL locale, distante ou de données | oui |
fonts | Requête Google Fonts, sans ?family=, ou false | oui |
zoom | Pourcentage (1 soit 100% par défaut) | oui |
Le paramètre optionnel nommé lang permet de modifier la langue de l'interface utilisateur du dock. Celle-ci est automatiquement détectée pour correspondre au réglage de votre installation d'OBS mais vous pouvez utiliser ce paramètre pour forcer la langue de votre choix. Les valeurs supportées actuellement sont en (anglais) et fr (français).
https://obs.multistream.tools/v1/dock?lang=fr
Le paramètre optionnel nommé theme permet d'appliquer le thème de votre choix dans le but de modifier l'aspect visuel de l'interface par défaut. Personnaliser les couleurs et/ou la taille des textes peut aider à une meilleure lecture ou simplement à mieux s'intégrer dans un setup où une attention particulière est mise sur le look.
https://obs.multistream.tools/v1/dock?theme=./themes/streamelements/dock.css
Si vous souhaitez uniquement personnaliser la police de caractères du dock, écrire un thème n'est pas nécessaire, il suffit d'utiliser le paramètre optionnel nommé fonts pour charger celle-ci via l'API Google Fonts.
https://obs.multistream.tools/v1/dock?fonts=Tangerine
La valeur du paramètre family de l'API Google Fonts doit toujours venir en premier et la valeur du paramètre display est block par défaut.
Dans le cas où vous souhaitez passer plusieurs paramètres à l'API Google Fonts, il est important d'encoder (%2526) chaque caractère & séparant ceux-ci ; on écrira donc :
https://obs.multistream.tools/v1/dock?fonts=Tangerine%2526display=auto
Au lieu de :
https://obs.multistream.tools/v1/dock?fonts=Tangerine&display=auto
Si vous jugez que l'affichage du dock devrait être ajusté, nul besoin également de créer un thème, vous pouvez simplement utiliser le paramètre optionnel nommé zoom dédié à cet effet.
https://obs.multistream.tools/v1/dock?zoom=1.5
Vous retrouverez plus de détails concernant les thèmes sur la page dédiée.