要在直播中使用转盘?请阅读 OBS 转盘指南

在你的网站上嵌入转盘

输入选项,选择访客如何使用转盘,然后复制一段代码。任何接受 HTML 的 https 页面都能用,无需账号、插件,也不收费。

要从你的服务器创建转盘?可以使用 ChoiceSpin 开发者 API 保存转盘、生成可直接转动的链接,并控制嵌入转盘的转动。

设置你的转盘

添加选项,选择访客操作,然后检查预览。

1 选项
2 到 100 个选项,每个最多 80 个字符 4 / 100
2 访客操作
3 外观
背景
转盘颜色
5秒钟
转盘标题

实时预览

这就是访客将会使用的转盘,试着转一次吧。

可互动

转盘由 ChoiceSpin 提供

4 个选项 · 点击转动 在单独页面中打开转盘

复制用于网站的代码

将此代码粘贴到 HTML 区块或嵌入区块中。转盘会随页面调整大小。

你的选项保存在代码里,而不是我们的服务器上。任何能查看你页面源代码的人都能看到它们,所以不要放入私人姓名、密码或账号信息。

如何嵌入转盘

只需三步,转盘就会出现在你的页面上。之后随时可以回来修改。

  1. 01

    添加选项

    在上方输入 2 到 100 个选项,每行一个。再选择访客操作、颜色和转动时长。

  2. 02

    试转预览

    预览运行的就是访客将会用到的同一个转盘,所以在这里试转一次,就能看到它在你页面上的表现。

  3. 03

    粘贴代码

    把这段代码粘贴到页面里的 HTML 区块或嵌入区块中,然后照常发布页面。

代码该粘贴到哪里

大多数建站工具都有放 HTML 或嵌入代码的区块,只是叫法各不相同。如果页面是你自己写的,就把代码粘贴到 <body> 里转盘该出现的位置。不需要另外添加 script 标签、样式表或 API 密钥。

WordPress

  1. 在区块编辑器中输入 /html,选择 Custom HTML 区块。
  2. 粘贴代码,然后更新或发布页面。

在经典编辑器中,请粘贴到 Text 标签页。WordPress 只保留有权发布未过滤 HTML 的用户所添加的嵌入代码,通常是 Administrator 和 Editor 角色。在 WordPress.com 上,需要开启了托管功能的付费套餐。

Google Sites

  1. 依次点击 Insert、Embed,再点击 Embed code 标签页。
  2. 粘贴代码,点击 Next,然后点击 Insert。
  3. 拖动框的边缘,直到整个转盘都显示出来,然后点击 Publish。

Wix

  1. 依次点击 Add Elements、Embed Code、Embed HTML。
  2. 点击新元素,选择 Enter Code,粘贴代码后点击 Apply。
  3. 拖动元素的边缘,直到转盘完整显示。

在 Wix Studio 中,同样的元素在 Add Elements 下:依次选择 Embed & Social、Embed Code。

Squarespace

  1. 点击 Add block,选择 Code,再点击铅笔图标。
  2. 粘贴代码,将类型设为 HTML,并保持 Display Source 关闭。

Core、Plus 和 Advanced 套餐以及旧版 Business 和 Commerce 套餐都能运行嵌入代码,Basic 套餐不行。如果登录状态下看不到转盘,请用 Preview in Safe Mode 检查页面。

Webflow

  1. 打开 Add 面板,把一个 Code Embed 元素拖到页面上。
  2. 粘贴代码,然后点击 Save & Close。

Code Embed 需要付费的 Workspace 或 Site 套餐。

Shopify

  1. 进入 Online Store 下的 Pages,打开一个页面。
  2. 点击编辑器工具栏中的 Show HTML,粘贴代码后点击 Save。

如果想把转盘放进主题分区,请打开 Edit theme,点击 Add section,然后选择 Custom Liquid。

Notion

  1. 把上方的输出切换到“直接链接”,然后复制链接。
  2. 在 Notion 中输入 /embed,选择 Embed link,然后粘贴链接。

Notion 只接受链接,所以在 Notion 中粘贴嵌入代码不起作用。

Canvas LMS

  1. 在 Rich Content Editor 中,依次选择 Insert、Embed。
  2. 把代码粘贴到 Embed Code 中,然后点击 Submit。

如果你的学校开启了 Canvas 的内容安全策略,管理员可能需要把 choicespin.com 加入允许的域名列表。

Moodle

  1. 在 Page 资源或 HTML 区块中,打开编辑器的 Tools 菜单,选择 Source code。
  2. 粘贴代码并保存。

论坛帖子会移除嵌入代码;在开启了 Content cleaning everywhere 的站点上,所有区域都会移除嵌入代码。

如果你的套餐会删除嵌入代码,或者某个工具只接受链接,就把上方的输出切换到“直接链接”。把它作为链接或按钮粘贴后,会在单独的页面中打开同一个转盘。

在 Google Slides 或 PowerPoint 中使用转盘

演示文稿软件不会运行嵌入代码,所以最可靠的方法是用链接。放映时点一下,就会在浏览器标签页中打开转盘,随时可以转动。

Google Slides

在幻灯片上选中一些文字,选择 Insert,再选择 Link(Ctrl+K,Mac 上为 ⌘+K),然后粘贴直接链接。在演示模式下点击链接打开转盘,转完后再切回幻灯片。

PowerPoint

选中文字或形状,按 Ctrl+K(Mac 上为 ⌘+K),粘贴直接链接。放映时点击它,就会在浏览器中打开转盘。Microsoft 已于 2024 年 12 月停用其免费的 Web Viewer 加载项。其他公司的付费加载项可以在幻灯片中显示网页,但我们没有测试过。

调整大小

代码会占满你的内容栏,最宽 760 像素,高度随宽度变化。

调窄一些

把第一行里的 max-width:760px 改成更小的宽度,例如 480px。转盘会随之缩小,并保持居中。

让手机上也看得清

min-height 这个值能防止框架在窄屏上变得太矮:普通转盘为 460 像素,带“转动”按钮时为 560,允许访客编辑时为 760。请保留它。

会给嵌入内容加外框的建站工具

在 Wix、Google Sites 等建站工具中,代码会放在一个可调整大小的框里。拖动这个框,直到整个转盘和署名链接都完整显示、没有滚动条为止。

访客能得到什么

嵌入的转盘与 ChoiceSpin 本站使用的是同一个转盘,只是运行在自己的框架里。

公平的转动

每次转动时,每个选项的机会都相同。在现代浏览器中,由 Web Crypto 随机数决定选中项。请参阅转盘如何抽选。

键盘和屏幕阅读器

访客可以把焦点移到转盘上,按空格键或 Enter 键转动。每个结果出来时,屏幕阅读器都会读出来。

没有 Cookie,也不追踪

框架处于沙盒中,无法设置 Cookie,也无法在浏览器中保存任何内容。它不加载广告,也不加载统计分析。

页面依然轻快

代码会让浏览器在访客滚动到转盘附近时才加载它,所以页面顶部依然加载迅速。

用 JavaScript 控制转盘

复制的代码本身就能独立运行。如果你自己编写页面代码,还可以通过窗口消息开始转动、更改选项并读取每次的选中项,而无需放宽框架的沙盒限制。

开始转动并读取选中项

在页面中加入 <button id="spin-from-page" type="button" disabled>Spin</button>,并把这段脚本放在嵌入代码之后。转盘在发出 ready 之前会忽略所有命令,所以在那之前按钮会一直保持禁用。

const frame = document.querySelector('iframe[src^="https://choicespin.com/e"]');
const spinButton = document.querySelector("#spin-from-page");

// Every message carries the same channel and version.
function send(action, extra = {}) {
  frame.contentWindow.postMessage(
    { channel: "choicespin.embed", version: 1, action, ...extra },
    "*"
  );
}

window.addEventListener("message", (event) => {
  if (event.source !== frame.contentWindow || event.origin !== "null") return;
  const data = event.data;
  if (data?.channel !== "choicespin.embed" || data?.version !== 1) return;
  if (data.event === "ready") spinButton.disabled = false;
  if (data.event === "spin-end") console.log("Winner:", data.winner);
});

spinButton.addEventListener("click", () => send("spin"));

可以发送的操作

  • spin 开始一次转动
  • setEntries 用包含 2 到 100 个字符串的 entries 数组替换选项
  • addEntry 添加一个 entry 字符串
  • removeWinner 移除最近一次的选中项
  • reset 恢复代码中的选项

会收到的事件

ready、spin-start、spin-end(带 winner 和 index)、entries-changed 和 error。每个事件还会报告当前选项的 count。

需要了解的三条规则

发送消息时请以 "*" 作为目标,因为沙盒框架没有可供指定的源(origin)。消息仍然只会发给那一个框架。收到回传的消息时,它的源显示为 "null",所以只有当 event.source 同时也是该框架的 window 时才信任它。转盘只监听嵌入它的页面,收到格式错误的命令时会回复一个 error 事件。生成的 sandbox 和 referrerpolicy 属性请保持原样:普通命令需要用到从 referrer 获知的父页面源。如果重新加载导致 referrer 丢失,可选的开发者辅助工具可以通过由实际 HTTPS 父页面发起、经过验证的握手重新连接。

如果转盘没有显示

大多数问题出在代码粘贴的位置上。请先检查以下几点。

代码显示成了文字

代码被粘贴到了普通文本区块里。请删除它,改为粘贴到 HTML、代码或嵌入区块中。

只显示一个空框

转盘只会在通过 https 提供的页面上加载。如果你的页面地址以 http 开头,或者你的套餐会删除嵌入代码,请把直接链接当作普通链接使用。

转盘被截断了

嵌入框太矮了。把它拉高,直到转盘、按钮和署名链接都能完整显示。仅框架本身就至少需要 460 像素,带“转动”按钮时需要 560,允许访客编辑时需要 760。署名链接大约还要再加 30 像素。

没有声音

检查是否勾选了“播放结束音效”。浏览器只有在访客于框架内点击或按键之后才允许播放声音,所以在此之前由你自己的代码发起的转动不会有声音。

常见问题

把转盘放到公开页面之前,先看看这些简短解答。

嵌入的转盘免费吗?

是的。完全免费,无需注册,同一段代码想放到多少个页面都可以。

嵌入之后怎样修改转盘?

如果转盘是用这个生成器做的,就在这里做好新版本,再替换掉你页面上的旧代码。它的选项就保存在代码里,所以没有需要更新的账号或保存副本。通过 API 在服务器端创建的转盘则另有单独的保存记录。

访客能修改我的转盘吗?

只能改他们自己的那一份。开启“允许访客编辑”后,访客可以输入新选项;“移除选中项”按钮或“每次移除选中项”会把选中项移出转盘。这些改动不会影响你的原始转盘,也不会影响其他人的副本,重新加载后就会恢复你的选项。

嵌入的转盘会使用 Cookie 或追踪访客吗?

不会。转盘运行在沙盒框架中,无法设置 Cookie,也无法在浏览器中存储任何内容,而且不加载任何广告或统计分析。对于生成器生成的转盘,选项是代码的一部分,所以任何查看你页面源代码的人都能看到。通过 API 创建的快照保存在服务器上,任何拿到其链接的人都能读取。

嵌入的转盘最多能有多少个选项?

2 到 100 个选项,每个最多 80 个字符。由于选项是放在链接里传递的,所有选项加起来大约可用 3,900 个字符,日文等文字能用的会更少。如果需要更长的列表、权重或保存结果,请使用完整版 ChoiceSpin 转盘,它最多支持 2,000 个选项。

嵌入的转盘能在手机上用吗?

能。它会占满内容栏的宽度,高度始终不低于 460 像素,所以在小屏幕上文字也清晰可读。访客点一下就能转动。

可以去掉 ChoiceSpin 署名吗?

可以。复制代码前取消勾选“显示 ChoiceSpin 署名”,或者之后从代码中删除署名那一行。两种方式下转盘的功能完全一样。

转盘页面会代替我的页面出现在 Google 搜索结果里吗?

不会。只含转盘的页面标记了 noindex,不会出现在搜索结果中。你自己页面的搜索可见度取决于它自身的内容和设置。

需要超过 100 个选项?

完整版转盘最多支持 2,000 个选项,并提供权重、图片、已保存的转盘和结果历史记录。老师们可以在教师指南中找到课堂用法。

打开完整版转盘