Twitch

Toon de nieuwste video's en meest bekeken clips van een Twitch kanaal, afgespeeld in Twitch's eigen speler.

Overzicht: Embed je Twitch video's en clips.

Verbind het

Open “Sources” (Bronnen) en druk op “Add source” (Bron toevoegen), kies dan Twitch (de ondertitel is "Video's en clips"). Het formulier is “Connect Twitch” (Twitch verbinden).
Typ in “Channel name or link” (Kanaalnaam of link) de kanaalnaam (met of zonder de @) of plak een link naar de pagina op twitch.tv. Een link naar een van de video's of clips van het kanaal onder twitch.tv/naam werkt ook. Het vak bovenaan “Add a source” (Een bron toevoegen) (“Find a source or paste a link” (Zoek een bron of plak een link)) maakt een twitch.tv-link voor je.

Een clips.twitch.tv-link of een twitch.tv/videos/123-link noemt het kanaal niet, dus het formulier vraagt je om de eigen link van het kanaal te plakken. Een kanaalnaam Twitch die niet bekend is, wordt geweigerd wanneer je verbindt, met "Twitch heeft geen kanaal met die naam. Controleer de spelling, of plak de link naar de twitch.tv-pagina van het kanaal."

Er is niets te autoriseren: geen aanmelding bij Twitch, enig kanaal, op elk plan. De bron volgt de id van het kanaal, dus een hernoemd kanaal blijft werken.

Via een agent, gebruik connect_source met { "type": "twitch", "twitchChannel": "name" }, of setup_widget met source ingesteld op twitch en een query (de kanaalnaam of een twitch.tv-link), of gewoon een twitch.tv-link als de query. Via de API neemt POST /v1/sources type twitch, "mode": "live" en twitchChannel.

Wat wordt opgehaald

Elke update leest de afgelopen uitzendingen, hoogtepunten en uploads van het kanaal (zijn nieuwste video's) en zijn meest bekeken clips van de afgelopen 30 dagen, voegt ze samen, nieuwste eerst, en houdt er maximaal 24 bij. Elke tegel is de miniatuurweergave van de video of clip met een afspeelicoon, en de titel is het bijschrift. In “Grid” (Raster) en “Carousel” (Carrousel) zijn tegels breed (16:9); “Masonry” volgt de vorm van elke miniatuurweergave en “Bento” zijn eigen celvormen.

Met “Lightbox” aan, speelt een tegel de video of clip af in Twitch's eigen speler binnen de lightbox. Het start direct, gedempt, en de bezoeker ontmengt het in de speler. Op een telefoon toont Twitch's speler zijn eigen afspeelknop en een tik speelt het af: Twitch start alleen een speler op zichzelf als deze minimaal 400 bij 300 pixels is, en nooit op een telefoon. Zonder de lightbox linkt een tegel naar de video of clip op twitch.tv.
Met “Header” (Koptekst) aan, worden de afbeelding en @naam van het kanaal boven de rasterweergave getoond, met een Volg-link naar het kanaal. Terwijl het kanaal streamt, toont een rode Live now naast de naam, met de streamtitel als tooltip. Een klik erop speelt de stream af in Twitch's live-speler in de lightbox, eerst gedempt, ongeacht of “Lightbox” aan staat. Een Ctrl-, Cmd- of middenklik opent de stream op twitch.tv in een nieuw tabblad, zoals elke link doet. TileSet controleert of het kanaal live is wanneer de widget wordt weergegeven, maximaal elke 2 minuten per kanaal, zodat Live now ongeveer 3 minuten laat kan verschijnen of omhoog kan gaan.

“Live stream” (op de aanpassingskaart van de widget, voor een Twitch of Kick bron) bepaalt waar een live stream wordt afgespeeld:

“Lightbox” (standaard): Live now opent de stream in de lightbox, zoals hierboven.
“Inline”: terwijl het kanaal streamt, toont een live kaart boven de tegels, in plaats van Live now in de header: de live afbeelding van de stream met een afspeelknop, de titel, categorie en kijkersaantal, en een "Kijk op Twitch"-link. Een klik speelt de stream direct in de kaart af, eerst gedempt. Twitch's speler laadt alleen bij die klik, nooit met de pagina, dus de kaart vertraagt de pagina niet. Wanneer de kaart kleiner is dan de minimale spelergrootte van Twitch (400 bij 300 pixels, dus op de meeste telefoons), opent de klik de stream in plaats daarvan in de lightbox. De “Bento” lay-out behoudt Live now in de header en toont geen kaart.

Wanneer de stream eindigt terwijl een bezoeker kijkt, toont de speler van Twitch zijn eigen offline-scherm. Via een agent of de API is de optie liveStream, "lightbox" of "inline".

Alleen het feed-raster wordt aangeboden, net als voor YouTube, omdat de tekst van een video alleen de titel is (zie Templates). Layouts zijn raster, carrousel, metselwerk en bento, licht of donker. Er zijn geen like- of weergavetellingen (“Likes & comments” (Likes en reacties) heeft niets te tonen) en geen beoordelingen. Een Twitch bron kan zich aansluiten bij een gemengde feed.

Agents en API-sleutels ontvangen nooit Twitch inhoud, zelfs geen tellingen: describe_source_content zegt dat de inhoud niet wordt samengevat voor agents, en GET /v1/sources/:id/content antwoordt 403 op een API-sleutel. De inhoud bereikt een pagina alleen via de widget, net als bij Instagram en Facebook. Om te controleren wat een Twitch widget toont, gebruik je de preview in het dashboard.

Hoe vaak het bijwerkt

Een Twitch update kost 2 credits, hetzelfde als YouTube. De snelste snelheid is dagelijks op Free en elk uur op Starter en hoger (elk uur is de snelste voor Twitch op elk betaald abonnement). Langzamere snelheden gebruiken minder credits. “Update now” wacht minimaal 15 minuten tussen updates van één Twitch bron. Connect-zoekopdrachten zijn beperkt tot 10 per dag per account en 20 per netwerk, net als voor X. Terwijl TileSet's Twitch app bijna de limiet per minuut bereikt, antwoordt een nieuwe connect "Twitch is momenteel bezig voor deze app, dus er is niets opgezocht. “Try again” (Opnieuw proberen) over een minuut." Zie Update snelheid en schema's en Abonnementen en credits. Op het gratis abonnement wordt een bron die niemand 14 dagen heeft bekeken gepauzeerd tot de volgende weergave.

De 24-uursregel

De ontwikkelaarsvoorwaarden van Twitch staan een kopie van de inhoud slechts 24 uur toe. Dus TileSet toont nooit een kopie ouder dan 23 uur: daarna haalt de volgende weergave van een widget het kanaal opnieuw op, gratis, ongeacht de gekozen update-snelheid. Een langzamere snelheid houdt de inhoud binnen een dag terwijl de widget wordt bekeken. Een video of clip die het kanaal verwijdert, is weg bij de volgende update.

Een “Link in bio” blok toont niets van een Twitch bron zodra de kopie 23 uur oud is, totdat de volgende update van de bron plaatsvindt. Kies voor een bron op een “Link in bio” pagina Twee keer per dag of sneller: een dagelijkse update laat het blok ongeveer een uur per dag leeg.

Miniaturen en de kanaalafbeelding worden niet gekopieerd. De browsers van je bezoekers laden ze van Twitch. De speler is van Twitch zelf (player.twitch.tv voor video's en live streams, clips.twitch.tv voor clips), dus een bezoeker die een video of stream afspeelt, laadt de speler van Twitch, en het eigen privacybeleid van Twitch is erop van toepassing. Als je site een content security policy instelt, zie Snippet installeren voor de te autoriseren frames.

Opnieuw verbinden

Niets om opnieuw te verbinden: er is geen aanmelding die verloopt. Als het verkeerde kanaal werd gematcht, verwijder dan de bron en verbind deze opnieuw met de link van het kanaal.