Logo
Section 1 / 6

活跃流

学习如何获取 Twitch 上所有正在进行的直播流列表。

导入

活跃流

学习如何获取 Twitch 上所有正在进行的直播流列表。

大多数用户访问 Twitch 的目的是观看直播流。事实上,当我们打开 Twitch 首页时,看到的正是多个正在直播的流。只需点击一下,即可开始观看。

Twitch API 也可以用来获取类似的直播流列表。我们可以通过向 Twitch API 的 streams 端点发送 GET 请求,来获取当前所有正在直播的流列表。

Course Image
...
streams 端点概览

代码示例

1https://api.twitch.tv/helix/streams

参数类型分类描述
after字符串可选用于向前分页的游标值。每次从 streams 端点返回多页结果时,都会附带一个游标值。我们可以将该值放入 after 参数中,以获取游标所指页面之后的结果页。
before字符串可选用于向后分页的游标值。同上,每次返回多页数据时都会提供一个游标值。将该值放入 before 参数中,可获取游标所指页面之前的结果页。
first整数可选每页返回的流数量,每页最多 100 条,默认值为 20。
game_id字符串可选根据指定的游戏 ID 过滤返回的流。最多支持 100 个游戏 ID。
language字符串可选用于过滤流语言的 ISO-639-1 语言代码。最多支持 100 个语言代码。
user_id字符串可选根据指定的用户 ID 过滤返回的流。最多支持 100 个用户 ID。
user_login字符串可选与 user_id 类似,根据用户登录名过滤流。最多支持 100 个登录名。
1import fetch from "node-fetch"; 2 3const endpointUrl = new URL("https://api.twitch.tv/helix/streams"); 4 5const headerParameters = { 6 Authorization: "Bearer {{APP_ACCESS_TOKEN}}", 7 "Client-Id": "{{CLIENT_ID}}", 8}; 9 10const options = { 11 method: "GET", 12 headers: headerParameters, 13}; 14 15async function fetchActiveStreams() { 16 try { 17 const response = await fetch(endpointUrl, options); 18 printResponse(response); 19 } catch (error) { 20 printError(error); 21 } 22} 23 24fetchActiveStreams();

属性类型描述
id字符串流的唯一标识 ID。
user_id字符串直播用户的 ID。
user_login字符串直播用户的登录名。
user_name字符串直播用户的显示名称。
game_id字符串流中正在播放的游戏 ID。
game_name字符串流中正在播放的游戏名称。
type字符串流的类型。由于我们获取的是正在进行的直播,其值为 live;若出现错误,则值为空字符串。
title字符串流的标题。
viewer_count整数当前正在观看该流的观众数量。
started_at字符串流开始的 UTC 时间戳。
language字符串流的语言代码,采用 ISO-639-1 标准。
thumbnail_url字符串流的缩略图 URL。可通过替换 {width} 和 {height} 占位符为所需的宽度和高度值,来获取不同尺寸的缩略图。
tag_ids字符串数组应用于该流的所有标签 ID 列表。
is_mature布尔值表示该流是否面向成人观众。

频道

关注的动态