Twitch

Affichez les vidéos les plus récentes et les clips les plus regardés d'une chaîne Twitch, diffusés dans le lecteur de Twitch.

Voir un exemple en direct

Aperçu : Intégrez vos vidéos et clips Twitch.

Connectez-le

Ouvrez « Sources » et appuyez sur « Add source » (Ajouter une source), puis choisissez Twitch (son sous-titre est « Vidéos et clips »). Le formulaire est « Connect Twitch » (Connecter Twitch).
Dans « Channel name or link » (Nom de la chaîne ou lien), tapez le nom de la chaîne (avec ou sans le @) ou collez un lien vers sa page sur twitch.tv. Un lien vers l'une des vidéos ou l'un des clips de la chaîne sous twitch.tv/nom fonctionne également. La boîte en haut de « Add a source » (Ajouter une source) (« Find a source or paste a link » (Trouvez une source ou collez un lien)) génère un lien twitch.tv pour vous.

Un lien clips.twitch.tv ou un lien twitch.tv/videos/123 ne nomme pas la chaîne, le formulaire vous demande donc de coller le lien de la chaîne elle-même. Un nom de chaîne Twitch que le système ne connaît pas est refusé lorsque vous vous connectez, avec « Twitch n'a pas de chaîne portant ce nom. Vérifiez l'orthographe ou collez le lien de la page de la chaîne sur twitch.tv. »

Il n'y a rien à autoriser : aucune connexion à Twitch, aucune chaîne, sur aucun plan. La source suit l'ID de la chaîne, donc une chaîne renommée continue de fonctionner.

Via un agent, utilisez connect_source avec { "type": "twitch", "twitchChannel": "name" }, ou setup_widget avec source défini sur twitch et un query (le nom du canal ou un lien twitch.tv), ou juste un lien twitch.tv comme requête. Via l'API, POST /v1/sources prend type twitch, "mode": "live" et twitchChannel.

Ce qui est récupéré

Chaque mise à jour lit les diffusions passées, les moments forts et les vidéos téléchargées (ses vidéos les plus récentes) du canal, ainsi que ses clips les plus vus des 30 derniers jours, les assemble dans l'ordre chronologique inverse et en conserve jusqu'à 24. Chaque vignette est la miniature de la vidéo ou du clip avec un marqueur de lecture, et son titre est la légende. Dans « Grid » (Grille) et « Carousel » (Carrousel), les vignettes sont larges (16:9) ; « Masonry » (Mosaïque) suit la forme de la miniature et « Bento » celle de sa propre cellule.

Avec « Lightbox » activé, une vignette lit la vidéo ou le clip dans le propre lecteur de Twitch à l'intérieur de la lightbox. Elle démarre immédiatement, en sourdine, et le visiteur la réactive dans le lecteur. Sur un téléphone, le lecteur de Twitch affiche son propre bouton de lecture et un tap suffit pour la lancer : Twitch ne démarre un lecteur de son côté que s'il mesure au moins 400 par 300 pixels, et jamais sur un téléphone. Sans la lightbox, une vignette renvoie à la vidéo ou au clip sur twitch.tv.
Avec « Header » (En-tête) activé, l'image et le nom d'utilisateur du canal s'affichent au-dessus de la grille, avec un lien Suivre vers le canal. Pendant que le canal diffuse, un indicateur rouge Live now s'affiche à côté du nom, avec le titre du flux comme info-bulle. Un clic dessus lance le flux dans le lecteur en direct de Twitch dans la lightbox, d'abord en sourdine, que « Lightbox » soit activé ou non. Un clic avec Ctrl, Cmd ou la molette ouvre le flux sur twitch.tv dans un nouvel onglet, comme n'importe quel lien. TileSet vérifie si le canal est en direct lorsque le widget est affiché, au maximum toutes les 2 minutes par canal, de sorte que Live now puisse apparaître ou avoir jusqu'à environ 3 minutes de retard.

« Live stream » (sur la carte de personnalisation du widget, pour une source Twitch ou Kick) décide où un flux en direct est lu :

« Lightbox » (par défaut) : Live now ouvre le flux dans la lightbox, comme ci-dessus.
« Inline » (En ligne) : pendant que le canal diffuse, une carte en direct s'affiche au-dessus des vignettes, à la place de Live now dans l'en-tête : l'image en direct du flux avec un bouton de lecture, son titre, sa catégorie et le nombre de spectateurs, et un lien « Regarder sur Twitch ». Un clic lance le flux directement dans la carte, d'abord en sourdine. Le lecteur de Twitch ne se charge qu'au moment de ce clic, jamais avec la page, de sorte que la carte n'alourdit pas la page. Lorsque la carte est plus petite que la taille minimale du lecteur de Twitch (400 par 300 pixels, donc sur la plupart des téléphones), le clic ouvre le flux dans la lightbox à la place. La disposition « Bento » conserve Live now dans l'en-tête et n'affiche pas de carte.

Lorsque le flux se termine pendant qu'un visiteur regarde, le lecteur de Twitch affiche son propre écran hors ligne. Via un agent ou l'API, l'option est liveStream, "lightbox" ou "inline".

Seule la grille de flux est proposée, comme pour YouTube, car le texte d'une vidéo n'est que son titre (voir Templates). Les mises en page sont grille, carrousel, masonry et bento, claires ou sombres. Il n'y a pas de compteurs de likes ou de vues (« Likes & comments » (J'aime et commentaires) n'a rien à montrer) ni de notes. Une source Twitch peut rejoindre un flux mixte.

Les agents et les clés d'API ne reçoivent jamais le contenu de Twitch, pas même les comptes : describe_source_content indique que le contenu n'est pas résumé pour les agents, et GET /v1/sources/:id/content répond 403 à une clé d'API. Le contenu n'atteint une page que par le biais du widget, comme avec Instagram et Facebook. Pour vérifier ce qu'un widget Twitch affiche, utilisez l'aperçu dans le tableau de bord.

Fréquence de mise à jour

Une mise à jour de Twitch coûte 2 crédits, tout comme YouTube. La vitesse la plus rapide est quotidienne sur Free et horaire sur Starter et supérieur (l'horaire est la plus rapide pour Twitch sur tous les plans payants). Les vitesses plus lentes utilisent moins de crédits. « Update now » attend au moins 15 minutes entre les mises à jour d'une source Twitch. Les recherches de connexion sont limitées à 10 par jour et par compte et 20 par réseau, comme pour X. Pendant que l'application Twitch de TileSet est proche de sa limite par minute, une nouvelle connexion répond « Twitch est occupée pour cette application pour le moment, rien n'a donc été recherché. « Try again » (Réessayer) dans une minute. » Voir Vitesse et planification des mises à jour et Plans et crédits. Sur le plan gratuit, une source que personne n'a vue depuis 14 jours est mise en pause jusqu'à sa prochaine vue.

La règle des 24 heures

Les conditions de développeur de Twitch autorisent une copie de son contenu pendant 24 heures seulement. Ainsi, TileSet n'affiche jamais une copie de plus de 23 heures : passé ce délai, la prochaine vue d'un widget récupère à nouveau le flux, gratuitement, quelle que soit la vitesse de mise à jour que vous avez choisie. Une vitesse plus lente maintient le contenu dans la journée pendant que le widget est consulté. Une vidéo ou un clip que la chaîne supprime disparaît lors de la prochaine mise à jour.

Un bloc « Link in bio » n'affiche rien d'une source Twitch une fois que sa copie a 23 heures, jusqu'à la prochaine mise à jour de la source. Pour une source sur une page « Link in bio », choisissez Deux fois par jour ou plus rapide : une mise à jour quotidienne laisse le bloc vide pendant environ une heure chaque jour.

Les miniatures et l'image de la chaîne ne sont pas copiées. Les navigateurs de vos visiteurs les chargent depuis Twitch. Le lecteur est celui de Twitch (player.twitch.tv pour les vidéos et les flux en direct, clips.twitch.tv pour les clips), donc un visiteur qui lit une vidéo ou un flux charge le lecteur de Twitch, et la politique de confidentialité de Twitch s'y applique. Si votre site définit une politique de sécurité du contenu, voir Installer le snippet pour les cadres à autoriser.

Reconnexion

Rien à reconnecter : aucune connexion n'est expirée. Si le mauvais canal a été associé, supprimez la source et reconnectez-la avec le lien du canal.