Intégration Twitch

Fourni avec strAImer : ce module s'installe avec l'application, il n'y a donc rien à télécharger. Il figure dans Catalogue de modules → Intégrés.

Ce qu'est cette page

La page connecte un compte Twitch à l'application — comme le dit sa description, "Configurez l'intégration Twitch pour recevoir les messages du chat, les récompenses et gérer votre chaîne." Elle existe en deux variantes : la propre chaîne du streamer, et un compte séparé depuis lequel le bot écrit.

Compter les bits comme des dons se trouve sur l'onglet de la chaîne. Les cheers arrivent aussi comme un don, donc les bits font avancer les objectifs de collecte, les enchères et les totaux du stream — au taux défini dans « Paramètres → Taux de change ». Désactivez pour garder les bits à part de l'argent ; le compteur de bits reste dans tous les cas. C'est ce qui fait qu'un cheer déplace un objectif de collecte ou pose une enchère ; désactivé, les bits restent un compteur à part. Par défaut, un bit vaut un cent de dollar américain, ce que Twitch paie par bit, converti dans votre devise de base ; votre propre taux dans « Paramètres → Taux de change » remplace cette valeur.

Basculer l'interrupteur redémarre la connexion à Twitch : le chat et le flux d'événements se reconnectent, ce qui prend quelques secondes, et des messages de chat ou des événements de ces secondes-là peuvent être manqués. Réglez-le avant de passer en direct plutôt qu'en plein stream.

Comment la configurer

1. Ouvrez Connexions → Chaînes et ouvrez la page Twitch. Son en-tête indique Compte du streamer (Lit les événements, EventSub).
2. État de la connexion affiche l'une des cinq formulations. L'indice à côté nomme ce qui est demandé : "Nécessite des autorisations maximales (lire le chat, gérer le stream, les sondages, les prédictions et les points de chaîne)."
3. Appuyez sur Autoriser via le navigateur. La page a un bouton et aucun champ pour un jeton : la connexion s'ouvre dans votre navigateur habituel et s'y termine.
4. Le navigateur va directement sur la page de confirmation de Twitch lui-même, avec le code déjà rempli. Connectez-vous à Twitch si elle le demande, confirmez le code et autorisez les permissions. Le résultat est annoncé par Twitch lui-même, pas par une page de strAImer : il n'y a donc pas, à la fin, de page indiquant "Autorisation réussie !". Vous pouvez ensuite fermer l'onglet du navigateur.
5. Pendant que vous êtes dans le navigateur, la page du module affiche "Terminez la connexion dans la fenêtre du navigateur — cette page se mettra à jour toute seule." Au bout de deux minutes, cela devient "Nous attendons toujours le navigateur. Terminez la connexion là-bas ; cette page se mettra à jour toute seule. Si cela prend du temps, rien n'est perdu." N'appuyez pas de nouveau sur le bouton tant que cette connexion est ouverte : un nouvel appui lance une nouvelle connexion, et celle du navigateur ne compte plus. Au bout de trente minutes, la page abandonne : "La connexion n'a pas abouti. La fenêtre du navigateur a été fermée ou l'accès a été refusé — appuyez sur le bouton pour réessayer." Un refus sur Twitch a le même aspect vu d'ici : la page attend jusqu'à cette limite.
6. Quand la connexion aboutit, la page du module signale Configuration Twitch enregistrée avec succès ! et se ferme un instant plus tard. Nom du compte (identifiant) affiche maintenant l'identifiant connecté ; le champ est en lecture seule.
7. Autorisations accordées apparaît : "Quelles fonctionnalités fonctionnent avec le jeton actuel". Chaque fonctionnalité est cochée ou barrée, douze lignes sur l'onglet de la chaîne : Lire et envoyer des messages de chat, Événements de nouveaux abonnés, Événements d'abonnement payant, Événements de bits, Récompenses de points de chaîne, Événements Hype Train, Événements des objectifs de chaîne, Sondages, Prédictions, Modifier le titre et la catégorie du stream, Créer des clips, Modération : bannir et supprimer des messages.
8. Si quelque chose est barré, un avertissement s'affiche : "Certaines autorisations manquent — les fonctionnalités associées ne fonctionneront pas. Réautorisez pour les accorder." Le bouton Réautoriser à côté lance la même connexion via le navigateur, et c'est cela qui ajoute les droits manquants.
9. La flèche en haut à gauche, Retour, quitte la page.

Ce que signifient les cinq formulations de statut

• Connecté en tant que {username} — vert. Le compte est enregistré et ni Twitch ni le module ne l'ont refusé. C'est ce que cela certifie : la connexion est bonne. Ce n'est pas un test en direct pour savoir si les événements circulent à cette seconde.
• Connexion... — jaune, avec le nom du compte toujours affiché. Le module établit la connexion : juste après le démarrage de l'application, et chaque fois que l'une de ses deux moitiés, le chat ou le flux d'événements, a été interrompue. Les deux reviennent d'elles-mêmes, donc celle-ci passe généralement au vert en quelques secondes.
• Se reconnecter pour rétablir la connexion — jaune. Le compte est toujours là et son nom est toujours affiché en dessous, car vous devez savoir quel compte réparer, mais Twitch a refusé l'accès enregistré et ne le renouvellera pas en arrière-plan. Rien n'arrive de la chaîne jusqu'à ce que vous vous reconnectiez, et se reconnecter est la seule réparation ; il n'y a pas de bouton qui le rafraîchit de l'extérieur.
• Erreur de connexion — rouge. Le compte est bon et la connexion ne l'est pas : le flux d'événements a été interrompu, ou le module n'a pas pu terminer sa configuration. Le module réessaie de lui-même, donc celle-ci s'efface souvent sans que vous touchiez à quoi que ce soit.
• Déconnecté — rouge, et la seule des cinq qui masque la ligne Nom du compte (identifiant), car aucun compte n'est encore enregistré sur cette page. C'est ce qu'affiche une installation fraîche.

Le badge est en direct : il change pendant que la page est ouverte, il n'est donc pas nécessaire de la quitter et d'y revenir pour voir une nouvelle formulation.

Le compte du bot

La même page sous Connexions → Bots est intitulée Compte du bot (Envoie les réponses dans le chat), et son indice est plus court : "Nécessite des autorisations pour lire et envoyer des messages dans le chat." La connexion est le même bouton unique, Autoriser via le navigateur : connectez-vous là sous le compte depuis lequel le bot doit écrire, pas le vôtre. Sa liste Autorisations accordées ne compte qu'une ligne, Lire et envoyer des messages de chat, car le bot ne fait qu'écrire dans le chat. Les bannissements et la suppression de messages passent par le compte du streamer, c'est pourquoi Modération : bannir et supprimer des messages se trouve sur l'onglet de la chaîne.

Les deux comptes sont jugés séparément, et le bot ne dit jamais Erreur de connexion. Une connexion de bot que Twitch a refusée n'entraîne pas la connexion propre du streamer dans Se reconnecter pour rétablir la connexion avec elle.

Si le navigateur signale une erreur

Au lieu de la page de Twitch, le navigateur peut afficher Erreur d'autorisation avec "Échec de l'échange du code d'autorisation contre des jetons : {error}". Cela signifie que la connexion n'a même pas pu démarrer, le plus souvent parce que Twitch était injoignable. Le compte reste tel qu'il était ; appuyez à nouveau sur Autoriser via le navigateur.

Ce qu'elle ne peut pas faire

• Il n'y a nulle part où coller un jeton, une clé d'accès ou une clé de rafraîchissement. Autoriser via le navigateur est le seul moyen d'entrée, et c'est aussi ainsi qu'une connexion expirée est renouvelée.
• Nom du compte (identifiant) ne peut pas être saisi. Pour connecter un compte différent, connectez-vous en tant que ce compte.
• Les permissions ne peuvent pas être choisies une par une. La liste à cocher ne fait que rapporter ce que la connexion actuelle porte ; Réautoriser transmet à nouveau l'ensemble complet.
• Il n'y a pas de champs Client ID et Client Secret, et aucun n'est nécessaire : la connexion passe par l'application strAImer elle-même.
• La page n'a pas de bouton Enregistrer : tout est stocké à la fin de la connexion via le navigateur. L'interrupteur Compter les bits comme des dons est enregistré au moment où vous le basculez.
• La page ne déconnecte pas le compte ni ne supprime la connexion, et elle ne désactive pas le module.
• Le compte du streamer et le compte du bot sont configurés séparément : une connexion ne remplit pas l'autre.