足球小组件 — 文档 - ScoreBat：足球比分与直播

01

创建第一个小组件

选择小组件，复制嵌入代码，再按需进行定制。

打开小组件目录并选择所需视图。使用构建器选择球队、联赛、赛事或比赛。
登录，并在需要时选择开发者套餐。复制最终的嵌入代码，包括令牌、iframe 类和尺寸脚本。
将嵌入代码粘贴到网站的 HTML 区块中。对于原生 WebView，请使用小组件 URL，并配置宿主应用以支持视频和全屏。
只调整该小组件支持的偏好。请在移动设备上进行测试，并使用与正式环境相同的账户令牌。

最简固定高度嵌入

<iframe id="football-widget"
  title="Football scores"
  src="https://www.scorebat.com/embed/livescore/?token=YOUR_EMBED_TOKEN"
  style="display:block;width:100%;height:760px;border:0"
  allow="autoplay; fullscreen"
  allowfullscreen>
</iframe>

02

偏好设置的工作方式

四种不同类型的设置，各自有不同的作用范围。

设置	所属位置	作用范围
内容选择	嵌入 URL 路径	选择小组件及其球队、赛事、联赛或比赛。
小组件偏好设置	pref 查询参数	此小组件实例的 JSON 对象。键必须完全使用小写；值保留其 JSON 类型。
尺寸与框架外观	Iframe 属性、CSS 和尺寸脚本	宽度、高度、圆角、阴影和响应式尺寸调整应由父页面控制。
账户偏好	已保存的开发者设置	颜色和符合条件的自定义导航设置属于账户共享设置，并受当前套餐限制。

URL 参数为单数形式 pref。它包含经过 URL 编码的 JSON，而不是 Base64。请使用布尔值 true 和 false，不要使用 "true" 等字符串。不支持通过未知键进行自定义。

安全构建 URL

const url = new URL("https://www.scorebat.com/embed/standings/team/chelsea/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  language: "en",
  tableview: "nearby",
  tableneighbors: 2,
  nomaxwidth: true
}));
// URLSearchParams performs the URL encoding once.
const iframe = document.querySelector("#football-widget");
iframe.src = url.toString();

编辑现有 URL 时，请先解析其中的 pref JSON，修改所需键，然后重新序列化。不要拼接未经转义的 JSON，也不要对已经编码的值进行二次编码。

某项偏好即使成功解析，如果所选小组件不使用它，也不会产生效果。下方每个小组件章节都会列出支持的偏好和重要例外。

03

查找合适的内容

请使用构建器中的实际选择，并保留实体类型。

球队和赛事路由使用构建器生成的标识符。chelsea 或 england-premier-league 等 slug 是便于理解的示例；不要通过将显示名称转换为小写来创建标识符。比赛路由必须使用比赛选择器提供的比赛标识符，或现有返回结果中的 matchviewUrl。

“赛事”指单项赛事或某个阶段。“联赛”则包含多个相关赛事。统一选择器会选择合适的类型；联赛和赛事不可互换。

世界杯构建器是在相同的联赛、比分条、视频面板和比赛小组件基础上提供的预设。请使用当前构建器中的选择，不要使用旧的赛事别名。

04

响应式尺寸

为小组件使用匹配的辅助脚本。

内容小组件：自动高度

<iframe title="Football widget"
  class="_scorebatEmbeddedPlayer_"
  src="https://www.scorebat.com/embed/team/chelsea/?token=YOUR_EMBED_TOKEN"
  allow="autoplay; fullscreen" allowfullscreen
  style="display:block;width:100%;height:760px;border:0"></iframe>
<script src="https://www.scorebat.com/embed/embed.js?v=arrv"
  id="scorebat-jssdk"></script>

视频面板：响应式尺寸调整

<iframe title="Football videos"
  class="_scorebatEmbeddedPanel_"
  src="https://www.scorebat.com/embed/videopanel/?token=YOUR_EMBED_TOKEN"
  allow="autoplay; fullscreen" allowfullscreen
  style="display:block;width:100%;height:800px;border:0"></iframe>
<script>
  window.SCOREBAT_OPTIONS = {
    panelClassName: "_scorebatEmbeddedPanel_",
    panelSizing: "responsive"
  };
</script>
<script src="https://www.scorebat.com/embed/panelx.js?v=f4fksn"
  id="scorebat-paneljs"></script>

每个页面中的每种辅助脚本只加载一次，并放在其要管理的 iframe 元素之后。保留匹配的 iframe 类。在客户端渲染的应用中，请先挂载 iframe 元素，再插入辅助脚本；不要假定放入 HTML 的脚本文本会自动执行。

比分栏使用固定的条带高度。对于固定尺寸面板或其他固定高度的嵌入内容，请省略自动尺寸设置，并在 CSS 中设置 iframe 尺寸。内部的 nomaxwidth 不会调整 iframe 大小。

05

颜色、访问权限和账户设置

将实例偏好与已保存设置分开。

构建器将背景色保存为账户的 ui.color 设置，将比分条颜色保存为 ui.barColor。它还可能为 iframe 添加 background-color 样式。将 color 或 barColor 放入 pref 不会设置小组件的内部主题。

保存的颜色设置在整个账户范围内生效，并需要相应的自定义权益。更改它们可能会影响同一账户下的其他嵌入内容。构建器预览可能显示演示样式；请使用实际令牌验证导出的嵌入代码。

使用 noheader 隐藏内容标题需要有效的无广告权益。移除品牌标识需要单独的权益。偏好设置无法解锁付费功能、取消套餐限制，也无法强制显示不可用的 AI 内容。

符合条件的账户可在账户设置中配置比赛、球队、联赛和赛事的导航 URL。这些是已保存的链接偏好，而不是任意的 pref 键。除非已配置并测试自定义集成，否则请保留构建器的标准导航。

无广告小组件或播放器的加载次数，与需计费的 Video API 调用共享开发者额度。一次需计费的 API 调用消耗五个点数，一次无广告小组件或播放器加载消耗一个点数。请在账户中查看当前套餐和用量；超出额度后，可能会恢复免费套餐的限制。

06

标签页与自定义导航

初始标签页和自定义目标地址分别配置。

完整的比赛、球队、联赛和赛事组件可以在指定标签页中打开。tab 是独立的查询参数，不是 pref 中的键。此功能需要有效的免广告权限；所选内容还必须支持请求的标签页。

组件	tab 值
完整比赛	home, lineup, stats, standings
完整球队	home, results, fixtures
完整联赛/赛事	home, results, fixtures, standings

在标签页中打开完整组件

const url = new URL("https://www.scorebat.com/embed/team/chelsea/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("tab", "fixtures");
url.searchParams.set("pref", JSON.stringify({language: "en", nomaxwidth: true}));

自定义导航的基础地址会保存为账户偏好设置：matchviewUrl、teamUrl、competitionUrl 和 leagueUrl。在支持的情况下，组件会将所选标识符和末尾斜杠附加到已配置的基础地址。请使用以斜杠结尾的基础地址，并确保目标页面可处理该路由。

打开已配置的自定义弹窗时，组件通常会添加 sbprf，其中包含经过 URL 编码的 JSON 及当前语言信息。目标页面可以读取该参数，并将支持的语言传入自己的组件。该参数并非所有源偏好设置的副本。

07

自定义域名设置

让访客打开比赛、赛事、联赛和球队页面时留在您的网站。适用于 Advanced 和 Enterprise 套餐。

此功能会将小组件链接指向您托管的页面。它不会将 ScoreBat 服务迁移到您的域名，也不需要更改 DNS。您的服务器必须在每个受支持的 URL 上呈现相应的小组件。

创建一个包含下方加载器的托管页面。将 YOUR_EMBED_TOKEN 替换为您从构建器获取的嵌入令牌。
配置内部重写，让每个受支持的路径都提供此页面，同时在浏览器中保留原始 URL 和查询字符串。
在启用整个账户的链接前，请测试真实的比赛、赛事、联赛和球队 URL。
在“账户”中打开“开发者设置”并输入基础 URL。检查更改，确认您已测试这些页面，然后保存。成功保存后，链接会立即生效，无需人工审核。

共享托管页面

<script>
window.SCOREBAT_OPTIONS = {
  embedToken: "YOUR_EMBED_TOKEN",
  baseDir: "/"
};
</script>
<script src="https://www.scorebat.com/embed/embedx.js?v=vh2"></script>

页面类型	您网站上的 URL	账户设置
比赛	https://example.com/matchview/MATCH_ID/	matchviewUrl: https://example.com/matchview/
赛事	https://example.com/competition/COMPETITION_ID_OR_SLUG/	competitionUrl: https://example.com/competition/
联赛	https://example.com/league/LEAGUE_ID/	leagueUrl: https://example.com/league/
球队	https://example.com/team/TEAM_ID_OR_SLUG/	teamUrl: https://example.com/team/

共享加载器需要使用 matchview、competition、league 和 team 路径名称。对于 /match/123/ 之类的路径，您需要自行实现路由逻辑，将其映射到 matchview 嵌入内容；仅重命名 URL 并不足够。

Apache：根目录 .htaccess 示例

RewriteEngine On
RewriteRule ^(?:matchview|competition|league|team)/[^/]+/?$ popup.html [L]
# Place popup.html at the website root.
# Keep these rules before a general application catch-all.

Nginx：server 块示例

location ~ ^/(matchview|competition|league|team)/[^/]+/?$ {
    rewrite ^ /popup.html last;
}
# Serve /popup.html as an existing static file in this server.
# Adapt this example to your application routing before reloading Nginx.

对于 /football/ 之类的子目录，请使用 baseDir: "/football/"，将 /football/matchview/... 和另外三个路径路由到共享页面，并使用相同的 /football/ 前缀保存基础 URL。请保留查询参数，包括用于传递导航偏好的 sbprf。

加载器可以更新托管页面的标题。如果您的网站自行管理标题，请在 SCOREBAT_OPTIONS 中设置 noTitle: true。请使用构建器中的真实标识符；占位符不是有效内容。

08

WordPress 设置

让每个小组件路由都提供同一个 WordPress 页面。

为小组件托管创建一个 WordPress 页面，并添加上一节中的共享托管页面脚本。请使用您自己的嵌入令牌。
在编辑器 URL 中查找页面 ID，然后替换下方示例中的 123。请将代码放入小型站点插件或子主题中，不要放入可能在更新时被覆盖的父主题。
添加或更改重写规则后，请保存一次“设置 → 固定链接”。不要在每次请求时刷新重写规则。
请打开全部四种内容类型的真实 URL，确认正确的小组件能够加载，然后再在“账户”中保存基础 URL。

WordPress 重写规则

<?php
// Put this in a small plugin or child theme functions.php.
// Omit the opening PHP tag if the file already has one.
function scorebat_custom_widget_routes() {
    $page_id = 123; // Replace with your widget host page ID.
    add_rewrite_rule(
        '^(matchview|competition|league|team)/[^/]+/?$',
        'index.php?page_id=' . $page_id,
        'top'
    );
}
add_action('init', 'scorebat_custom_widget_routes');

某些 WordPress 角色、编辑器和托管平台会移除“自定义 HTML”块中的 script 标签。如果加载器消失，请让开发者通过受信任的站点插件或页面模板添加，并仅在小组件托管页面上启用。如果深层链接失效，请检查缓存、重定向和安全插件。

如果 WordPress 安装在子目录中，请将 baseDir 设置为带末尾斜杠的安装路径。重写模式以该安装路径为基准；账户基础 URL 必须包含相同的前缀。

09

测试并启用链接

URL 已保存并不能证明您的网站已准备就绪。请先测试，再确认应用到账户全局。

为每个已配置的内容类型访问一个真实 URL。确认显示了正确的小组件，然后刷新页面并在新的浏览器标签页中打开。
检查移动端布局、小组件高度以及不同内容类型之间的导航。请保持原始深层链接 URL 可见；不要将每个请求都重定向到 popup.html 或 WordPress 页面别名。
请确保 HTTPS 正常工作，且服务器会保留查询字符串。如果内容安全策略阻止 ScoreBat 脚本或 iframe，请检查浏览器错误。
确认设置无误后，在“账户”中保存。使用同一账户令牌从小组件中点击进入，以验证已启用的目标地址。
要恢复 ScoreBat 目标地址，请清除相关基础 URL 或选择“使用 ScoreBat 链接”，然后重新检查并保存。

这些颜色由使用您账户令牌的所有符合条件的小组件共享，包括您已经发布的小组件。

编辑自定义域名需要有效的 Advanced 或 Enterprise 订阅。其他开发者可以查看相关控件并升级。已配置的链接会予以保留。如果您的设置不适用于这些示例，请联系 ScoreBat 获取帮助。

10

选择小组件

每份参考资料都会单独列出其支持的偏好、默认值和例外情况。

使用下方的系列筛选器查找要嵌入的小组件。同名参数在不同小组件中可能有不同效果；只有明确列出时，才表示支持该偏好设置。没有专用构建器预设的高级路由会有相应标记。

比分即时比分 ↗

各项赛事的比分、赛程和赛果。

比分比分栏 ↗

横向比分栏，可显示全部比赛、某支球队或某项赛事的比分。

赛事完整联赛 ↗

完整的联赛视图，整合相关赛事、比赛和积分榜。

赛事完整赛事 ↗

某项赛事的比赛、赛果和可用积分榜。

赛事赛程与赛果 ↗

专门显示赛程和赛果，并在适用时提供“今日”标签页。

赛事赛事与联赛积分榜 ↗

专门的联赛积分榜；一个联赛可能显示多个阶段的积分榜。

球队完整球队 ↗

完整的球队页面，包含比赛和可用的球队信息。

球队球队积分榜 ↗

以某支球队为中心的积分榜，可选择显示完整积分榜。

球队球队比赛卡片 ↗

显示一支球队即将进行和／或最近已结束的比赛卡片。

比赛完整比赛 ↗

显示该场比赛现有全部信息的完整比赛视图。

比赛比赛比分 ↗

比赛比分卡，可选择显示比赛事件。

比赛阵容 ↗

显示首发球员、场地图/列表形式，以及可用时的替补球员。

比赛比赛统计 ↗

集中显示可用的比赛统计数据。

比赛交锋记录 ↗

所选比赛的历史交锋和对比内容。

比赛比赛视频与 AI ↗

所选比赛的视频内容及可用的 AI 上下文。

比赛比赛积分榜 ↗

显示可用积分榜，并突出标示比赛双方。

比赛比赛 AI ↗

在有相关内容时显示专门的 AI 预测视图。

视频视频面板 ↗

视频播放器，可浏览并选择比赛。

视频视频信息流 ↗

纵向比赛视频流，支持展开和自动播放选项。

比分

即时比分

各项赛事的比分、赛程和赛果。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/livescore/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`limitwidth`	`boolean \| integer` `true \| false \| integer ≥ 400`	false	仅适用于即时比分：true 会将内容最大宽度限制为 1200px。至少为 400 的整数可设置自定义像素上限。此设置与 nomaxwidth 不同。

配置示例

const url = new URL("https://www.scorebat.com/embed/livescore/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "limitwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

比分

比分栏

横向比分栏，可显示全部比赛、某支球队或某项赛事的比分。

在构建器中打开 ↗尺寸辅助工具: fixed

嵌入路由

/embed/livescore-bar/
/embed/livescore-bar/team/{team}/
/embed/livescore-bar/competition/{competition}/
/embed/livescore-bar/league/{league}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。

配置示例

const url = new URL("https://www.scorebat.com/embed/livescore-bar/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

赛事

完整联赛

完整的联赛视图，整合相关赛事、比赛和积分榜。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/league/{league}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。
`noheader`	`boolean` `true \| false`	false	在支持时隐藏内容标题。需要有效的无广告权益；没有该权益时，此设置会被忽略。它本身不会移除 ScoreBat 品牌标识。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "nomaxwidth": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/league/{league}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

赛事

完整赛事

某项赛事的比赛、赛果和可用积分榜。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/competition/{competition}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "nomaxwidth": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/competition/{competition}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

赛事

赛程与赛果

专门显示赛程和赛果，并在适用时提供“今日”标签页。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/fixtures/competition/{competition}/
/embed/fixtures/league/{league}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`fixturesview`	`string` `fixtures \| results`	fixtures	初始显示的赛程/赛果标签页。如果该赛事今天有比赛，小组件会改为首先打开“今日”。
`noheader`	`boolean` `true \| false`	false	在支持时隐藏内容标题。需要有效的无广告权益；没有该权益时，此设置会被忽略。它本身不会移除 ScoreBat 品牌标识。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "fixturesview": "fixtures",
  "nomaxwidth": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/fixtures/competition/{competition}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "fixturesview": "results",
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

赛事

赛事与联赛积分榜

专门的联赛积分榜；一个联赛可能显示多个阶段的积分榜。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/standings/competition/{competition}/
/embed/standings/league/{league}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`tabledetailed`	`boolean` `true \| false`	false	以详细视图打开专门的积分榜。可用列取决于底层积分榜数据。
`noheader`	`boolean` `true \| false`	false	在支持时隐藏内容标题。需要有效的无广告权益；没有该权益时，此设置会被忽略。它本身不会移除 ScoreBat 品牌标识。
`nopadding`	`boolean` `true \| false`	false	移除受支持内容的内边距。此设置不会移除 iframe 在父页面中的内边距，也不会移除所有内部间距规则。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "nomaxwidth": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/standings/competition/{competition}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "tabledetailed": true,
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

球队

完整球队

完整的球队页面，包含比赛和可用的球队信息。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/team/{team}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "nomaxwidth": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/team/{team}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

球队

球队积分榜

以某支球队为中心的积分榜，可选择显示完整积分榜。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/standings/team/{team}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`tableview`	`string` `nearby \| full`	nearby	仅适用于球队积分榜：显示所选球队附近的排名行或完整积分榜。
`tableneighbors`	`integer` `1–5`	3	nearby 模式下，球队积分榜所显示的相邻行数。构建器提供 1、2、3 或 5；解析器会将值限制在 1–5。此设置在 full 模式下无效。
`tabledetailed`	`boolean` `true \| false`	false	以详细视图打开专门的积分榜。可用列取决于底层积分榜数据。
`tablecompetition`	`string` `Competition slug or numeric ID as a string`	自动	为球队选择一项积分榜赛事。该赛事必须在这支球队的可用赛事中；如果选择不匹配，将显示积分榜不可用，而不会自动回退。
`noheader`	`boolean` `true \| false`	false	在支持时隐藏内容标题。需要有效的无广告权益；没有该权益时，此设置会被忽略。它本身不会移除 ScoreBat 品牌标识。
`nopadding`	`boolean` `true \| false`	false	移除受支持内容的内边距。此设置不会移除 iframe 在父页面中的内边距，也不会移除所有内部间距规则。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "tableview": "nearby",
  "tableneighbors": 3,
  "nomaxwidth": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/standings/team/{team}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "tableview": "nearby",
  "tableneighbors": 2,
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

球队

球队比赛卡片

显示一支球队即将进行和／或最近已结束的比赛卡片。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/team-match/team/{team}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`matchmode`	`string` `next \| latest \| both`	both	为球队选择下一场比赛卡（优先显示进行中的比赛，否则显示即将开始的比赛）、最近结束的比赛卡，或同时显示两者。不会虚构不存在的比赛。
`noheader`	`boolean` `true \| false`	false	在支持时隐藏内容标题。需要有效的无广告权益；没有该权益时，此设置会被忽略。它本身不会移除 ScoreBat 品牌标识。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "matchmode": "both",
  "nomaxwidth": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/team-match/team/{team}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "matchmode": "next",
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

比赛

完整比赛

显示该场比赛现有全部信息的完整比赛视图。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/matchview/{match}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`noheader`	`boolean` `true \| false`	false	在支持时隐藏内容标题。需要有效的无广告权益；没有该权益时，此设置会被忽略。它本身不会移除 ScoreBat 品牌标识。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "nomaxwidth": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/matchview/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

比赛

比赛比分

比赛比分卡，可选择显示比赛事件。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/matchscore/{match}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`noevents`	`boolean` `true \| false`	false	隐藏比赛比分小组件中的事件时间线。其他类型的比赛小组件不使用此偏好。
`noheader`	`boolean` `true \| false`	false	在支持时隐藏内容标题。需要有效的无广告权益；没有该权益时，此设置会被忽略。它本身不会移除 ScoreBat 品牌标识。
`nopadding`	`boolean` `true \| false`	false	移除受支持内容的内边距。此设置不会移除 iframe 在父页面中的内边距，也不会移除所有内部间距规则。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。
`layout`	`string` `mini`	默认	阵容可使用 field 或 list；省略时显示组合视图。比赛比分可使用 mini 显示紧凑比分。此 URL 偏好与构建器的 iframe 尺寸模式无关。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "nomaxwidth": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/matchscore/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "noevents": true,
  "layout": "mini",
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

比赛

阵容

显示首发球员、场地图/列表形式，以及可用时的替补球员。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/line-up/{match}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`layout`	`string` `field \| list`	默认	阵容可使用 field 或 list；省略时显示组合视图。比赛比分可使用 mini 显示紧凑比分。此 URL 偏好与构建器的 iframe 尺寸模式无关。
`subs`	`string` `hide \| collapse`	已展开	仅适用于阵容：隐藏替补名单，或默认将其折叠。省略时保留正常的替补显示方式。
`noheader`	`boolean` `true \| false`	false	在支持时隐藏内容标题。需要有效的无广告权益；没有该权益时，此设置会被忽略。它本身不会移除 ScoreBat 品牌标识。
`nopadding`	`boolean` `true \| false`	false	移除受支持内容的内边距。此设置不会移除 iframe 在父页面中的内边距，也不会移除所有内部间距规则。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "nomaxwidth": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/line-up/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "layout": "field",
  "subs": "collapse",
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

比赛

比赛统计

集中显示可用的比赛统计数据。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/matchstats/{match}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`noheader`	`boolean` `true \| false`	false	在支持时隐藏内容标题。需要有效的无广告权益；没有该权益时，此设置会被忽略。它本身不会移除 ScoreBat 品牌标识。
`nopadding`	`boolean` `true \| false`	false	移除受支持内容的内边距。此设置不会移除 iframe 在父页面中的内边距，也不会移除所有内部间距规则。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "nomaxwidth": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/matchstats/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

比赛

交锋记录

所选比赛的历史交锋和对比内容。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/match-h2h/{match}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`noheader`	`boolean` `true \| false`	false	在支持时隐藏内容标题。需要有效的无广告权益；没有该权益时，此设置会被忽略。它本身不会移除 ScoreBat 品牌标识。
`nopadding`	`boolean` `true \| false`	false	移除受支持内容的内边距。此设置不会移除 iframe 在父页面中的内边距，也不会移除所有内部间距规则。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "nomaxwidth": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/match-h2h/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

比赛

比赛视频与 AI

所选比赛的视频内容及可用的 AI 上下文。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/g/{match}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`autoplay`	`boolean` `true \| false`	false	请求自动播放视频。播放会以静音开始。浏览器策略和视频源可用性仍可能阻止自动播放。

配置示例

const url = new URL("https://www.scorebat.com/embed/g/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "autoplay": false
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

比赛

比赛积分榜

显示可用积分榜，并突出标示比赛双方。

高级嵌入尺寸辅助工具: resizer

嵌入路由

/embed/matchstandings/{match}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`dontcollapse`	`boolean` `true \| false`	false	让视频流保持展开。在比赛积分榜中，此设置会显示完整积分榜，而不是仅显示比赛双方附近的小范围排名。
`noheader`	`boolean` `true \| false`	false	在支持时隐藏内容标题。需要有效的无广告权益；没有该权益时，此设置会被忽略。它本身不会移除 ScoreBat 品牌标识。
`nopadding`	`boolean` `true \| false`	false	移除受支持内容的内边距。此设置不会移除 iframe 在父页面中的内边距，也不会移除所有内部间距规则。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。

配置示例

const url = new URL("https://www.scorebat.com/embed/matchstandings/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "dontcollapse": true,
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

比赛

比赛 AI

在有相关内容时显示专门的 AI 预测视图。

高级嵌入尺寸辅助工具: resizer

嵌入路由

/embed/matchai/{match}/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`noheader`	`boolean` `true \| false`	false	在支持时隐藏内容标题。需要有效的无广告权益；没有该权益时，此设置会被忽略。它本身不会移除 ScoreBat 品牌标识。
`nomaxwidth`	`boolean` `true \| false`	false	移除小组件的内部最大宽度限制。页面中的 iframe 仍需设置合适的宽度。

配置示例

const url = new URL("https://www.scorebat.com/embed/matchai/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

视频

视频面板

视频播放器，可浏览并选择比赛。

在构建器中打开 ↗尺寸辅助工具: responsivePanel

嵌入路由

/embed/videopanel/
/embed/videopanel/team/{team}/
/embed/videopanel/competition/{competition}/
/embed/videopanel/league/{league}/
/embed/videopanel/live-stream/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`autoplay`	`boolean` `true \| false`	false	请求自动播放视频。播放会以静音开始。浏览器策略和视频源可用性仍可能阻止自动播放。
`filternotlive`	`boolean` `true \| false`	false	从直播视频流中滤除已结束的比赛。此设置仅适用于直播视频流范围，不是通用的即时比分筛选器。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "autoplay": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/videopanel/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "autoplay": false
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

视频

视频信息流

纵向比赛视频流，支持展开和自动播放选项。

在构建器中打开 ↗尺寸辅助工具: resizer

嵌入路由

/embed/videofeed/
/embed/videofeed/team/{team}/
/embed/videofeed/competition/{competition}/
/embed/videofeed/league/{league}/
/embed/videofeed/live-stream/

支持的偏好

默认值描述的是不带额外设置的 URL。请仅使用此小组件列出的偏好。

偏好	类型／值	省略时	效果
`language`	`string` `en, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn`	自动	选择小组件语言。请使用支持的代码；此设置不会翻译 API 字段名称。
`autoplay`	`boolean` `true \| false`	false	请求自动播放视频。播放会以静音开始。浏览器策略和视频源可用性仍可能阻止自动播放。
`dontcollapse`	`boolean` `true \| false`	false	让视频流保持展开。在比赛积分榜中，此设置会显示完整积分榜，而不是仅显示比赛双方附近的小范围排名。
`filternotlive`	`boolean` `true \| false`	false	从直播视频流中滤除已结束的比赛。此设置仅适用于直播视频流范围，不是通用的即时比分筛选器。

构建器默认值

构建器会明确设置这些偏好。其他默认值继承自所选变体。

构建器默认值

{
  "autoplay": true,
  "dontcollapse": true
}

配置示例

const url = new URL("https://www.scorebat.com/embed/videofeed/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
  "autoplay": false,
  "dontcollapse": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.

11

WordPress 插件

直接在 WordPress 仪表盘中添加和管理足球小工具。

使用 ScoreBat 插件，将实时比分、赛程、积分榜、球队和比赛小工具以及官方视频集锦添加到您的 WordPress 网站。

前往 WordPress.org 获取 ScoreBat 插件

在 WordPress 仪表盘中，打开“插件”→“安装新插件”，搜索 ScoreBat，然后安装并启用该插件。
在仪表盘中打开 ScoreBat，然后选择“连接到 ScoreBat”。登录或创建免费账户，然后批准与您网站的连接。
打开小工具目录，选择并自定义一个小工具，然后确认“在 WordPress 中使用”，将其保存到您的网站。
添加“ScoreBat 足球小工具”区块并选择已保存的小工具，或将其短代码粘贴到“短代码”区块中。您也可以在 ScoreBat 仪表盘中创建一个已添加该小工具的草稿页面。
在桌面端和移动端预览页面，准备就绪后即可发布。

12

设置不生效时

检查路由、值类型、账户权益和嵌入环境。

确认路由与当前阅读的小组件章节相符。完整球队、球队积分榜和球队比赛卡使用不同的渲染器。
检查键是否完全为小写，以及 JSON 类型是否正确。使用经过一次编码的 pref={...}；不要传入界面标签或内部 camelCase 名称。
与支持的偏好列表进行对照。某个构建器控件可能出现在多个变体中，即使某个特定渲染器并不使用它。
检查当前套餐和令牌。标题移除、颜色、品牌标识和 AI 功能可能取决于账户权益。
请测试实际导出的 URL，而不是演示预览。检查宿主页面是否允许加载 iframe 和所需的尺寸调整脚本。
如果内容本身缺失，请换一个有可用数据的比赛或赛事进行验证。偏好设置无法生成缺失的积分榜、视频或阵容。

遇到布局问题时，请先检查父容器的宽度和高度。如果内容被裁切，请确认辅助脚本和 iframe 类是否正确，或增大固定高度。更改小组件 URL 或已保存设置后，请刷新小组件。

13

使用 AI 助手构建

可复制的指南和机器可读的小组件清单。

请通过 Markdown 指南查看集成说明，并通过 JSON 清单查看路由、支持的偏好设置名称、允许值、默认值和适用性说明。两者使用的都是占位符，而非账户令牌。

从构建器中选择准确的小组件变体和真实标识符。切勿自行编造路由或偏好。
请使用该小组件支持的偏好设置列表。键应保持小写，并保留 JSON 值类型。
使用 URL 和 URLSearchParams 构建 URL，并保留嵌入令牌。尺寸设置应放在 pref 之外。
遵守账户权益和内容可用性限制。切勿承诺更改偏好可以移除品牌标识或显示原本不可用的内容。
添加说明清晰的 iframe 标题、合适的尺寸、需要时的视频权限，以及正确的辅助脚本。

Markdown（英文） ↓小组件清单（英文） ↓