使用文档

从建第一个房间，到接进导播系统。

一、三分钟上手

1. 建房间：点免费创建房间，立刻得到一个控制台， 地址栏里那串链接就是你的凭证，请收藏它——丢了就进不去了。
2. 排流程：中间那一列是流程单。点「+ 添加计时」加一项，点齿轮改标题、讲者和时长。 已经有 Excel 流程单的话，用「导入流程单」直接粘三列进去。
3. 投大屏：点右上角「分享链接」，把「大屏输出」那条链接在会场那台电脑上打开，按 F11 全屏， 或者在页面上双击进入全屏。
4. 开跑：回到控制台，按空格开始。

二、六种链接分别给谁

三、流程单

每一条计时项都可以单独设置：

• 外观——倒计时、正计时、只显示当前时间、隐藏数字。领导讲话建议用正计时， 避免屏幕上出现给对方压力的倒计时。
• 黄灯 / 红灯——填剩余多少秒开始转色。默认黄灯 60 秒、红灯 15 秒。
• 开始方式——手动、定时自动开始、接上一项结束自动开始。

时间归零后不会停住，会继续显示 -01:23 这样的负数并转红，方便判断超时了多久。

CSV 导入格式

每行一项，逗号分隔，依次是标题、时长、讲者。时长写 10:00、 1:02:03 或直接写秒数：

开场致辞,5:00,张伟
主题分享,20:00,李娜
圆桌讨论,30:00
茶歇,15:00

四、提示消息

消息会盖在大屏中央，字号按文字长度自动放大。同一时刻只显示一条，点第二条会自动替换第一条。

• 四种颜色：白色（一般）、绿色（可以继续）、黄色（注意）、红色（紧急）。
• 「闪烁」会让整块屏闪几下，用来在对方没看屏幕时抓注意力。
• 「黑屏」把大屏变全黑，适合节目过场或者不希望屏幕干扰画面的时候。

五、快捷键

控制台页面上（焦点不在输入框里时）：

六、接入 OBS / vMix

1. 在 OBS 里新建一个「浏览器」源。
2. URL 填大屏输出链接，末尾加上 &clean=1 可以只保留数字、去掉标题和角落信息。
3. 宽高按需要设置，勾选「透明背景」需要自行加一段 CSS： body{background:transparent!important}。

vMix、Wirecast 等软件同理，都用网页输入源。

七、开放接口

所有请求都是 POST，参数可以用表单也可以用 JSON。 room 是房间号，t 是控制台密钥（从控制台链接里取）。

播控 api/control.php

其他端点

• GET api/state.php?room=&t=&since=——读取房间状态。 带上 since=<revision> 会挂起等待变化（长轮询），适合做实时同步。
• POST api/timer.php——add / update / delete / move / duplicate / import
• POST api/message.php——add / update / show / toggle / hide / delete / move
• POST api/room.php——update / reset_all / delete
• POST api/question.php——submit（公开）/ promote / handled / delete / clear

示例

# 开始 / 暂停
curl -X POST "https://www.stagetimer.cn/api/control.php" \
     -d "room=K7M2QP&t=你的控制台密钥&action=toggle"

# 加两分钟
curl -X POST "https://www.stagetimer.cn/api/control.php" \
     -d "room=K7M2QP&t=你的控制台密钥&action=addtime&ms=120000"

把这类命令绑到 Stream Deck 的「网站」或「多动作」按钮上，就得到了一台硬件遥控器。

八、私有部署

1. 环境要求：PHP 7.4 以上（推荐 8.1+，需 PDO MySQL 扩展）、MySQL 5.7+ 或 MariaDB 10.3+。
2. 把整个目录放到服务器上，网站根目录指向 public/。
3. 改 config.php 里的数据库信息，然后在浏览器打开 install.php 建表。
4. 建表完成后删掉 install.php。