Twitch

Zeigt die neuesten Videos und meistgesehenen Clips eines Twitch-Kanals, abgespielt im eigenen Player von Twitch.

Live-Beispiel ansehen

Overview: Embed your Twitch videos and clips.

Verbindung herstellen

1. Öffnen Sie „Sources“ (Quellen), klicken Sie auf „Add source“ (Quelle hinzufügen) und wählen Sie dann Twitch (Untertitel „Videos and clips“). Das Formular heißt „Connect Twitch“ (Twitch verbinden).
2. Geben Sie in „Channel name or link“ (Kanalname oder Link) den Kanalnamen ein (mit oder ohne @) oder fügen Sie einen Link zu dessen Seite auf twitch.tv ein. Auch ein Link zu einem der Videos oder Clips des Kanals unter twitch.tv/name funktioniert. Das Feld oben in „Add a source“ (Eine Quelle hinzufügen) („Find a source or paste a link“ (Quelle finden oder Link einfügen)) erkennt einen twitch.tv-Link für Sie.

Ein clips.twitch.tv-Link oder ein twitch.tv/videos/123-Link nennt den Kanal nicht, daher bittet das Formular Sie, den Link des Kanals selbst einzufügen. Ein Kanalname, den Twitch nicht kennt, wird beim Verbinden abgelehnt, mit der Meldung „Twitch hat keinen Kanal mit diesem Namen. Überprüfen Sie die Schreibweise oder fügen Sie den Link zur twitch.tv-Seite des Kanals ein.“

Es ist nichts zu autorisieren: keine Anmeldung bei Twitch, für jeden Kanal, in jedem Tarif. Die Quelle folgt der Kanal-ID, sodass ein umbenannter Kanal weiterhin funktioniert.

Über einen Agenten verwende connect_source mit { "type": "twitch", "twitchChannel": "name" } oder setup_widget mit source auf twitch und query (dem Kanalnamen oder einem twitch.tv-Link) gesetzt, oder nur einen twitch.tv-Link als Abfrage. Über die API nimmt POST /v1/sources type twitch, "mode": "live" und twitchChannel.

Was abgerufen wird

Jedes Update liest die vergangenen Übertragungen, Highlights und Uploads (die neuesten Videos) des Kanals sowie seine meistgesehenen Clips der letzten 30 Tage, fügt sie in der neuesten Reihenfolge zusammen und behält bis zu 24. Jede Kachel ist die Miniaturansicht des Videos oder Clips mit einem Wiedergabesymbol, und ihr Titel ist die Bildunterschrift. In „Grid“ (Raster) und „Carousel“ (Karussell) sind Kacheln breit (16:9); „Masonry“ folgt der Form jeder Miniaturansicht und „Bento“ seinen eigenen Zellformen.

• Mit „Lightbox“ wird eine Kachel das Video oder den Clip in Twitchs eigenem Player innerhalb der Lightbox abgespielt. Es startet sofort, stummgeschaltet, und der Besucher schaltet es im Player stumm. Auf einem Telefon zeigt Twitchs Player seinen eigenen Wiedergabebutton an und ein Tippen spielt es ab: Twitch startet einen Player nur dann von selbst, wenn er mindestens 400 x 300 Pixel groß ist, und niemals auf einem Telefon. Ohne die Lightbox verlinkt eine Kachel zum Video oder Clip auf Twitch.tv.
• Wenn „Header“ (Kopfzeile) aktiviert ist, werden das Bild und der Name des Kanals oberhalb des Rasters angezeigt, zusammen mit einem Link zum Kanal. Während der Kanal streamt, wird ein rotes Live now neben dem Namen angezeigt, mit dem Stream-Titel als Tooltip. Ein Klick darauf spielt den Stream im Live-Player von Twitch in der Lightbox ab, zunächst stummgeschaltet, unabhängig davon, ob „Lightbox“ aktiviert ist oder nicht. Ein Klick mit Strg, Cmd oder der mittleren Maustaste öffnet den Stream auf twitch.tv in einem neuen Tab, wie jeder Link. TileSet prüft, ob der Kanal live ist, wenn das Widget angezeigt wird, höchstens alle 2 Minuten pro Kanal, sodass Live now bis zu etwa 3 Minuten später erscheinen oder verschwinden kann.

„Live stream“ (Live-Stream): Lightbox oder Inline

„Live stream“ (auf der Anpassungskarte des Widgets, für eine Twitch- oder Kick-Quelle) entscheidet, wo ein Live-Stream abgespielt wird:

• „Lightbox“ (Standard): Live now öffnet den Stream in der Lightbox, wie oben beschrieben.
• „Inline“: Während der Kanal streamt, wird über den Kacheln eine Live-Karte angezeigt, anstelle von Live now in der Kopfzeile: das Live-Bild des Streams mit einem Wiedergabe-Button, seinem Titel, Kategorie und Zuschauerzahl sowie einem „Auf Twitch ansehen“-Link. Ein Klick spielt den Stream direkt in der Karte ab, zunächst stummgeschaltet. Der Player von Twitch wird erst bei diesem Klick geladen, niemals mit der Seite, sodass die Karte die Seite nicht verlangsamt. Wenn die Karte kleiner ist als die minimale Player-Größe von Twitch (400 x 300 Pixel, also auf den meisten Handys), öffnet der Klick den Stream stattdessen im Lightbox-Fenster. Das „Bento“-Layout behält Live now in der Kopfzeile bei und zeigt keine Karte an.

Wenn der Stream endet, während ein Besucher zusieht, zeigt der Player von Twitch seinen eigenen Offline-Bildschirm an. Über einen Agenten oder die API ist die Option liveStream, "lightbox" oder "inline".

Nur das Feed-Raster wird angeboten, wie für YouTube, da der Text eines Videos nur sein Titel ist (siehe Vorlagen). Layouts sind Raster, Karussell, Mauerwerk und Bento, hell oder dunkel. Es gibt keine Like- oder View-Zählungen („Likes & comments“ (Likes & Kommentare) hat nichts anzuzeigen) und keine Bewertungen. Eine Twitch-Quelle kann einem gemischten Feed beitreten.

Agenten und API-Schlüssel erhalten niemals Inhalte von Twitch, nicht einmal Zählungen: describe_source_content besagt, dass der Inhalt für Agenten nicht zusammengefasst wird, und GET /v1/sources/:id/content antwortet mit 403 auf einen API-Schlüssel. Der Inhalt gelangt nur über das Widget auf eine Seite, wie bei Instagram und Facebook. Um zu überprüfen, was ein Twitch-Widget anzeigt, verwenden Sie die Vorschau im Dashboard.

Wie oft es aktualisiert wird

Ein Twitch Update kostet 2 Credits, genauso wie YouTube. Die schnellste Geschwindigkeit ist täglich auf Free und stündlich ab Starter (stündlich ist die schnellste für Twitch auf jedem bezahlten Plan). Langsamere Geschwindigkeiten verbrauchen weniger Credits. „Update now“ wartet mindestens 15 Minuten zwischen Updates einer Twitch Quelle. Verbindungsabfragen sind auf 10 pro Tag pro Konto und 20 pro Netzwerk begrenzt, wie für X. Während TileSets Twitch App nahe an ihrem Limit pro Minute ist, antwortet eine neue Verbindung „Twitch ist gerade für diese App beschäftigt, daher wurde nichts nachgeschlagen. „Try again“ (Erneut versuchen) in einer Minute.“ Siehe Update-Geschwindigkeit und Zeitpläne und Pläne und Credits. Auf dem kostenlosen Plan pausiert eine Quelle, die niemand seit 14 Tagen angesehen hat, bis zur nächsten Ansicht.

Die 24-Stunden-Regel

Die Entwicklerbedingungen von Twitch erlauben eine Kopie seines Inhalts für nur 24 Stunden. Daher zeigt TileSet nie eine Kopie, die älter als 23 Stunden ist: danach ruft die nächste Ansicht eines Widgets den Kanal erneut ab, kostenlos, unabhängig von der gewählten Aktualisierungsgeschwindigkeit. Eine langsamere Geschwindigkeit hält den Inhalt innerhalb eines Tages, während das Widget angezeigt wird. Ein Video oder Clip, das der Kanal löscht, ist beim nächsten Update weg.

Ein „Link in bio“-Block zeigt nichts von einer Twitch-Quelle, sobald ihre Kopie 23 Stunden alt ist, bis zum nächsten Update der Quelle. Für eine Quelle auf einer „Link in bio“-Seite wählen Sie Zweimal täglich oder schneller: ein tägliches Update lässt den Block jeden Tag etwa eine Stunde lang leer.

Thumbnails und das Kanalbild werden nicht kopiert. Die Browser Ihrer Besucher laden sie von Twitch. Der Player ist Twitch eigener (player.twitch.tv für Videos und Live-Streams, clips.twitch.tv für Clips), sodass ein Besucher, der ein Video oder einen Stream abspielt, Twitch Player lädt und Twitch eigene Datenschutzrichtlinie dafür gilt. Wenn Ihre Website eine Content Security Policy festlegt, finden Sie unter Snippet installieren die zuzulassenden Frames.

Erneut verbinden

Es gibt nichts neu zu verbinden, denn keine Anmeldung läuft ab. Wurde der falsche Kanal zugeordnet, entfernen Sie die Quelle und verbinden Sie sie erneut mit dem Link des Kanals.