01 / PREPARE
准备好,再下载。
你需要一台 Windows x64 电脑、稳定网络、OBS 或 TikTok LIVE Studio,以及要接收直播事件的 TikTok 账号。直播软件和特效程序必须在同一台电脑上运行。
安装文件约 3.5 GB,请预留安装和内置素材所需的磁盘空间。这是完整安装包,用户无需另行安装 Node.js,也不需要先启动其他原版程序。
下载 Windows 0.1.27 安装包 ↗ 中国大陆下载(无需外网)↗ 打开备用下载页 ↗文件名:LiveEntrance-Setup-0.1.27.exe。下载来自本项目现有的发行空间;如果浏览器先打开下载页,请通过该页面的下载按钮获取文件。
先区分两种下载:Windows 安装包用于主播在电脑上使用特效;website.zip 是这个介绍与教程网站的静态文件,用于网站上线。一般主播只需要下载安装包。
02 / INSTALL
安装,然后确认授权。
月费:人民币 ¥105/月,或新台币 NT$499/月(二选一)。
- 安装前先关闭旧版如果已经使用旧版,先保存设置、断开聊天室并停止待播,再完全退出程序。同一时间只运行一个进场程序,避免本机 17891 端口冲突。
- 运行安装文件等待下载完成,双击
LiveEntrance-Setup-0.1.27.exe,按照安装向导完成安装。安装后,通过新的桌面快捷方式打开“直播进场特效 订阅版”。 - 进入“订阅与授权”首次使用时,按界面提供的方案激活,或输入你已经获取的有效授权码。已有授权的用户可使用原授权码或“重新确认付款”恢复。
- 确认授权有效且网络正常订阅版需要联网验证有效授权。先确认界面显示可用,再设置动画和直播;更新程序不需要重新购买已有授权。
界面右上角可切换繁体中文、简体中文、English 或 Tiếng Việt。如果当前仍使用繁体界面,本教程中的“保存设置”对应“儲存設定”,“连接聊天室”对应“連線聊天室”。
03 / CONFIGURE
设置你的进场节奏。
- 设置“进场条件”选择普通观众、特殊称号、粉丝团/财富等级与 TOP 排名等条件。动画间隔可根据直播节奏调整,初次使用可先保留默认值。
- 选择“画面特效”设置共用特效、称号专属动画、背景、大小与位置。先按“▶ 预览”查看素材,再调整为适合直播画面的大小。
- 设置“欢迎语”选择 Windows 语音,调整语速与音量,输入欢迎语模板。按“试听欢迎语”检查发音和音量。如果需要中文语音但列表中没有,请先在 Windows 安装相应中文语音。
- 保存设置真实聊天室事件使用已保存的设置。预览和“测试进场”使用当前正在编辑的内容,因此测试完成后仍需再保存一次。
升级特效需要单独开启。如果要使用粉丝团或财富等级升级动画,请在对应设置中开启、调整门槛,再使用各自的测试按钮确认;新安装的升级功能默认关闭。
04 / OBS STUDIO
将特效添加到 OBS。
保持特效程序运行,在 OBS 中选择实际用于开播的场景。你可以在程序中点击“加入 OBS”自动设置,也可以按以下步骤手动添加。
- 新增浏览器源在 OBS“来源”面板点击
+→“浏览器”,命名为“直播进场特效”。不要勾选“本地文件”。 - 粘贴本机源网址将以下完整网址粘贴到 URL 栏中,保留
#tiktok.studio:
http://127.0.0.1:17891/overlay/screen-1#tiktok.studio
- 宽高设为实际画布尺寸竖屏直播常用宽
1080、高1920;如果横屏画布为 1920 × 1080,则填宽1920、高1080。请以 OBS“设置 → 视频”中的基础画布尺寸为准。 - 确认图层与音频将特效源拖到摄像头或直播背景上方,打开该源的眼睛图标。勾选“通过 OBS 控制音频”,在混音器中确认此源未静音,并调整合适音量。
- 返回程序点击“测试进场”确认 OBS 显示动画且混音器有信号。如需自己听见声音,可在高级音频属性中设置监听,并戴耳机检查是否重复收音。
没有事件时画面透明,属于正常待机状态。它不会一直显示底图,也无需给透明待机添加绿幕或色度键。请通过“测试进场”确认源是否正常。
备用网址:http://local.joyso.taipei:17891/overlay/screen-1。如果该主机名无法解析,改用上方的 127.0.0.1。两者都指向同一台电脑上的播放器。
05 / TIKTOK LIVE STUDIO
将特效添加到 LIVE Studio。
如果使用 TikTok LIVE Studio,可直接在 Studio 中添加网页源,无需为了这一步额外启动 OBS。
- 选择直播场景并添加源在来源区域点击新增,选择“网页/网页链接”类型。不同语言或 Studio 版本的选项名称可能略有差异。
- 粘贴同一个播放器网址使用
http://127.0.0.1:17891/overlay/screen-1#tiktok.studio,保持特效程序与 Studio 在同一台电脑上运行。 - 设置尺寸与图层源的宽高应匹配实际直播画布,竖屏可用 1080 × 1920,横屏按你的画布设置填写。将网页源放在摄像头或背景上方,并确认可见。
- 测试声音与画面在特效程序中点击“测试进场”,检查 Studio 画面、该源的音量与静音状态。录制一小段本地测试视频,确认声音完整且没有重复。
06 / GO LIVE
先测试,再连接真实直播间。
- 完成模拟测试在程序右侧选择观众称号,填写测试昵称,点击“测试进场”。至少测试普通进场和你准备使用的特殊称号;检查动画完整播放、头像与姓名位置、语音、音效及退场。
- 保存最终设置调整位置或音量后,再保存一次设置。同时确认 OBS/Studio 正在使用正确的场景,特效源处于可见状态。
- 按平时的方式开播由你在 OBS 或 TikTok LIVE Studio 中操作开始直播;进场程序不会代替你开播。
- 填写正确的 TikTok ID在进场程序中填写本场直播使用的 TikTok 账号 ID,不要填写显示昵称或他人的预填值。确认该账号已经开播,再点击“连接聊天室”。
- 核对真实事件确认连接成功后,观察符合条件的观众进场是否显示在直播画面上。模拟测试成功只表示本机播放正常;真实连接还取决于直播状态和上游事件服务。
- 已在 OBS/Studio 中检查动画、姓名与音量。
- 授权有效,特效程序与直播软件均保持运行。
- TikTok ID 正确,聊天室已连接,最终设置已保存。
07 / UPDATE & BACKUP
升级时保留你的设置。
0.1.27 修复了 TOP 1–3 再次进场省略徽章时漏播的问题。更新保留已有素材、授权、动画与语音设置;升级后请重新加载 Studio/OBS 网页源。
- 先保存并备份停止待播、断开聊天室、保存设置后,完全退出程序。按
Win + R,输入以下文件夹路径,将整个文件夹复制到你自己的私人备份位置。
%APPDATA%\live-entrance-zh-subscriber
- 获取并应用更新重新打开程序,点击右上角版本号进入“版本与更新”,选择稳定版,检查更新并按照提示下载、重新启动以应用更新。也可以关闭旧版后手动运行新版安装文件。如果存在未保存内容、聊天室仍连接或有待播,程序可能要求先完成整理。
- 重新加载源并再次测试在 OBS 打开对应浏览器源的属性,刷新当前页面缓存;Studio 则刷新网页源。返回程序点击“测试进场”,确认画面与音频正常后再连接聊天室。程序中的“修复 OBS”也可重新加载已有 OBS 源。
备份包含个人设置与授权相关数据,请放在私人位置,不要加入网站包或公开云端目录。从旧 ZIP 版升级时,第一次需要手动运行安装文件,以后通过新的桌面快捷方式启动。
08 / TROUBLESHOOTING
遇到问题,从这里检查。
| 情况 | 按顺序检查 |
|---|---|
| 源的画面一片空白 | 待机本来透明 → 点击“测试进场” → 确认程序正在运行 → 确认源可见及图层顺序 → 检查网址与 17891 端口。 |
| 画面被遮挡或尺寸不对 | 将特效源移动到背景/摄像头上方,宽高设为实际画布尺寸,并检查是否存在意外裁剪。 |
| 动画出现,但没有声音 | 检查欢迎语和音效是否开启、Windows 语音是否可用;OBS 中检查“通过 OBS 控制音频”、源静音和混音器。录制短段测试视频确认输出。 |
| 声音重复或出现回声 | 检查是否重复添加播放器,以及桌面音频是否同时录入了源的监听声。保留一条正确的特效音频路径,再次测试录制。 |
| 测试正常,真实进场没有反应 | 确认 TikTok ID、账号已开播、聊天室已连接、授权有效;检查事件是否符合设置的进场条件,最后再保存一次设置。 |
| 升级后仍显示旧效果 | 刷新 OBS/Studio 网页源,确认新程序版本和正确的源网址,再执行一次“测试进场”。 |
| 程序无法启动本机服务 | 完全退出其他旧版/自用版,然后只运行一个进场程序。直播软件必须与它在同一台电脑。 |
FOR THE WEBSITE OWNER
把这个单页网站放上网。
以下部署的是介绍、教程与下载入口。Windows 特效程序仍在主播电脑上运行;授权与更新服务沿用项目现有服务。
09 / WEBSITE FILES
先解压网站包。
返回首页下载网站 ZIP ↗- 保存并解压在 Windows 中右键点击
website.zip→“全部解压缩”,然后打开解压后的网站文件夹。 - 找到正确的网站根目录根目录应直接包含
index.html,以及assets、downloads等文件夹。如果外面还有一层dist,请使用里面直接包含 index.html 的那一层。 - 预览首页双击
index.html查看页面。部署时应上传整个网站文件夹;如果只上传单个 HTML,可能会缺少样式、图片或下载文件。
网站根目录 / dist
├─ index.html
├─ assets/
│ └─ 网站样式、脚本与展示素材
└─ downloads/
├─ deployment-guide.html
├─ deployment-guide-zh-cn.html
├─ deployment-guide-en.html
└─ website.zip (可选:原始部署的备用下载文件)
网站包不需要包含 3.5 GB 的 EXE。安装包按钮直接链接到现有发行空间。公开文件夹只放网站及公开下载内容,不要加入个人备份、授权码、付款数据、API 密钥或环境配置文件。
下载的网站包通常不包含 downloads/website.zip,这是正常的。点击首页“下载网站 ZIP”时,页面会从当前网站文件生成新的 ZIP,并自动排除压缩包,避免 ZIP 一层层打包进自身。重新部署时直接上传解压后的完整文件夹即可,无需手动补回 ZIP。
生成新 ZIP 需要通过 HTTP/HTTPS 打开首页,例如已上线的网址或本地网页服务器;直接双击 index.html 的 file:// 预览不支持此下载功能。原始部署另外提供的 downloads/website.zip,可作为禁用 JavaScript 时的备用下载。
10 / CLOUDFLARE PAGES
使用 Direct Upload 上线。
这份网站已经是可以直接发布的静态文件,无需安装 Node.js、无需填写构建命令,也无需先连接 GitHub。以下采用 Cloudflare Pages 的浏览器拖放上传流程。
- 登录 Cloudflare打开 Cloudflare Dashboard,登录账号并选择要使用的账户。
- 创建 Pages 项目进入
Workers & Pages,点击Create application,选择 Pages 的直接上传入口。界面可能显示为Get started → Drag and drop your files,或Pages → Use direct upload。 - 输入项目名称例如
live-entrance-guide;如果该名称已被占用,请换成你自己的名称。按照界面点击Create project或继续上传。 - 上传网站根目录将上一节找到的完整文件夹拖入上传区。请使用直接包含
index.html的文件夹,等待所有文件上传完成;也可以上传根层直接包含 index.html 的 ZIP。 - 点击 Deploy site确认没有文件上传失败后,点击
Deploy site;有些界面显示为Save and Deploy。完成后进入项目页面。 - 打开正式网址Cloudflare 会显示项目的
*.pages.dev网址。使用实际显示的网址打开网站,完成下方验收后即可分享。
Direct Upload 网站更新时需要重新上传。如果以后要改为 Git 推送自动部署,需要另外创建 Git 集成项目。控制台拖放上传目前最多支持 1,000 个文件,每个文件上限 25 MiB;若某个文件出现红色警示,请先压缩或移除超限展示素材,再重新上传整个网站包。
流程与限制根据 2026.10.16 查阅的官方文档整理:Cloudflare Pages Direct Upload;另一套官方界面说明:Pages Direct Upload 操作步骤。按钮名称可能随界面更新而变化。
11 / DOMAIN & UPDATES
绑定域名,并持续更新。
有自己的域名时,再进行绑定。
- 在 Pages 项目中添加域名进入
Workers & Pages → 你的 Pages 项目 → Custom domains,点击Set up a domain,输入你拥有的域名或子域名,再点击Continue。 - 按照提示设置 DNS根域名需要添加到同一个 Cloudflare 账户并使用 Cloudflare nameserver;子域名可按照提示配置 CNAME,指向你的
*.pages.dev。务必先在 Pages 中关联域名,再配置 DNS。 - 启用后测试确认自定义域名可以通过 HTTPS 打开首页和下载页。没有自己的域名,也可以一直使用项目提供的 pages.dev 网址。
官方说明:Cloudflare Pages 自定义域名。
更新网站时,回到同一个项目。
修改本地文件后,回到现有 Pages 项目,点击 Create a new deployment,选择 Production,上传完整新版文件夹并部署。完成后重新打开正式网址,检查文案、图片与下载链接是否已更新。
更新桌面安装包版本时,也要同步修改首页和教程中的版本、大小与安装包网址。首页会在下载时生成当前网站的 ZIP;如果另外提供静态备用 ZIP,也需要更新该文件。仅修改网页不会自动更新 Windows 程序、授权服务或更新后端。
重新部署参考:Create a new deployment。
12 / FINAL CHECK
分享网址前,完成这 6 项。
- 使用电脑与手机打开正式网址,确认首页排版和图片正常。
- 页面导航可以跳转到各区段,操作按钮可以使用。
- 安装包按钮指向正确的 0.1.27 EXE,备用下载页也能打开。
- 完整教程可以打开,首页“下载网站 ZIP”可在 HTTP/HTTPS 网站中生成下载。
- 公开文件中没有个人备份、授权凭据或 API 密钥。
- 如果绑定自定义域名,检查 HTTPS 与各页面路径均可正常打开。
网站准备好后,就可以分享正式网址。主播按本教程前半部分安装桌面程序、完成授权并接入 OBS/Studio,即可设置自己的进场效果。
← 返回单页网站