直播进场特效 / LIVE ENTRANCE

THE COMPLETE GUIDE · 完整操作手册

从下载到第一场直播,
每一步都在这里。

先安装桌面程序、接入直播画面,再测试真实进场。文末还附有这个单页网站的上线方法,下载网站包后就能自己部署。

正式网站已经上线:luckydamo.com,也可访问 www.luckydamo.com;另有 workers.dev 备用入口。均可直接浏览,无需登录。本次使用 Cloudflare Workers Static Assets 部署。文末的 Pages 教程仍适用于下载网站包后部署你自己的副本。

Windows x64正式版 0.1.27OBS / TikTok LIVE Studio文档更新 2026.10.16

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/月(二选一)。

  1. 安装前先关闭旧版如果已经使用旧版,先保存设置、断开聊天室并停止待播,再完全退出程序。同一时间只运行一个进场程序,避免本机 17891 端口冲突。
  2. 运行安装文件等待下载完成,双击 LiveEntrance-Setup-0.1.27.exe,按照安装向导完成安装。安装后,通过新的桌面快捷方式打开“直播进场特效 订阅版”。
  3. 进入“订阅与授权”首次使用时,按界面提供的方案激活,或输入你已经获取的有效授权码。已有授权的用户可使用原授权码或“重新确认付款”恢复。
  4. 确认授权有效且网络正常订阅版需要联网验证有效授权。先确认界面显示可用,再设置动画和直播;更新程序不需要重新购买已有授权。

界面右上角可切换繁体中文、简体中文、English 或 Tiếng Việt。如果当前仍使用繁体界面,本教程中的“保存设置”对应“儲存設定”,“连接聊天室”对应“連線聊天室”。

03 / CONFIGURE

设置你的进场节奏。

  1. 设置“进场条件”选择普通观众、特殊称号、粉丝团/财富等级与 TOP 排名等条件。动画间隔可根据直播节奏调整,初次使用可先保留默认值。
  2. 选择“画面特效”设置共用特效、称号专属动画、背景、大小与位置。先按“▶ 预览”查看素材,再调整为适合直播画面的大小。
  3. 设置“欢迎语”选择 Windows 语音,调整语速与音量,输入欢迎语模板。按“试听欢迎语”检查发音和音量。如果需要中文语音但列表中没有,请先在 Windows 安装相应中文语音。
  4. 保存设置真实聊天室事件使用已保存的设置。预览和“测试进场”使用当前正在编辑的内容,因此测试完成后仍需再保存一次。

升级特效需要单独开启。如果要使用粉丝团或财富等级升级动画,请在对应设置中开启、调整门槛,再使用各自的测试按钮确认;新安装的升级功能默认关闭。

04 / OBS STUDIO

将特效添加到 OBS。

保持特效程序运行,在 OBS 中选择实际用于开播的场景。你可以在程序中点击“加入 OBS”自动设置,也可以按以下步骤手动添加。

  1. 新增浏览器源在 OBS“来源”面板点击 + →“浏览器”,命名为“直播进场特效”。不要勾选“本地文件”。
  2. 粘贴本机源网址将以下完整网址粘贴到 URL 栏中,保留 #tiktok.studio:
http://127.0.0.1:17891/overlay/screen-1#tiktok.studio
  1. 宽高设为实际画布尺寸竖屏直播常用宽 1080、高 1920;如果横屏画布为 1920 × 1080,则填宽 1920、高 1080。请以 OBS“设置 → 视频”中的基础画布尺寸为准。
  2. 确认图层与音频将特效源拖到摄像头或直播背景上方,打开该源的眼睛图标。勾选“通过 OBS 控制音频”,在混音器中确认此源未静音,并调整合适音量。
  3. 返回程序点击“测试进场”确认 OBS 显示动画且混音器有信号。如需自己听见声音,可在高级音频属性中设置监听,并戴耳机检查是否重复收音。

没有事件时画面透明,属于正常待机状态。它不会一直显示底图,也无需给透明待机添加绿幕或色度键。请通过“测试进场”确认源是否正常。

备用网址:http://local.joyso.taipei:17891/overlay/screen-1。如果该主机名无法解析,改用上方的 127.0.0.1。两者都指向同一台电脑上的播放器。

操作参考:OBS Browser Source、OBS 来源与图层指南。

05 / TIKTOK LIVE STUDIO

将特效添加到 LIVE Studio。

如果使用 TikTok LIVE Studio,可直接在 Studio 中添加网页源,无需为了这一步额外启动 OBS。

  1. 选择直播场景并添加源在来源区域点击新增,选择“网页/网页链接”类型。不同语言或 Studio 版本的选项名称可能略有差异。
  2. 粘贴同一个播放器网址使用 http://127.0.0.1:17891/overlay/screen-1#tiktok.studio,保持特效程序与 Studio 在同一台电脑上运行。
  3. 设置尺寸与图层源的宽高应匹配实际直播画布,竖屏可用 1080 × 1920,横屏按你的画布设置填写。将网页源放在摄像头或背景上方,并确认可见。
  4. 测试声音与画面在特效程序中点击“测试进场”,检查 Studio 画面、该源的音量与静音状态。录制一小段本地测试视频,确认声音完整且没有重复。

06 / GO LIVE

先测试,再连接真实直播间。

  1. 完成模拟测试在程序右侧选择观众称号,填写测试昵称,点击“测试进场”。至少测试普通进场和你准备使用的特殊称号;检查动画完整播放、头像与姓名位置、语音、音效及退场。
  2. 保存最终设置调整位置或音量后,再保存一次设置。同时确认 OBS/Studio 正在使用正确的场景,特效源处于可见状态。
  3. 按平时的方式开播由你在 OBS 或 TikTok LIVE Studio 中操作开始直播;进场程序不会代替你开播。
  4. 填写正确的 TikTok ID在进场程序中填写本场直播使用的 TikTok 账号 ID,不要填写显示昵称或他人的预填值。确认该账号已经开播,再点击“连接聊天室”。
  5. 核对真实事件确认连接成功后,观察符合条件的观众进场是否显示在直播画面上。模拟测试成功只表示本机播放正常;真实连接还取决于直播状态和上游事件服务。
  • 已在 OBS/Studio 中检查动画、姓名与音量。
  • 授权有效,特效程序与直播软件均保持运行。
  • TikTok ID 正确,聊天室已连接,最终设置已保存。

07 / UPDATE & BACKUP

升级时保留你的设置。

0.1.27 修复了 TOP 1–3 再次进场省略徽章时漏播的问题。更新保留已有素材、授权、动画与语音设置;升级后请重新加载 Studio/OBS 网页源。

  1. 先保存并备份停止待播、断开聊天室、保存设置后,完全退出程序。按 Win + R,输入以下文件夹路径,将整个文件夹复制到你自己的私人备份位置。
%APPDATA%\live-entrance-zh-subscriber
  1. 获取并应用更新重新打开程序,点击右上角版本号进入“版本与更新”,选择稳定版,检查更新并按照提示下载、重新启动以应用更新。也可以关闭旧版后手动运行新版安装文件。如果存在未保存内容、聊天室仍连接或有待播,程序可能要求先完成整理。
  2. 重新加载源并再次测试在 OBS 打开对应浏览器源的属性,刷新当前页面缓存;Studio 则刷新网页源。返回程序点击“测试进场”,确认画面与音频正常后再连接聊天室。程序中的“修复 OBS”也可重新加载已有 OBS 源。

备份包含个人设置与授权相关数据,请放在私人位置,不要加入网站包或公开云端目录。从旧 ZIP 版升级时,第一次需要手动运行安装文件,以后通过新的桌面快捷方式启动。

08 / TROUBLESHOOTING

遇到问题,从这里检查。

情况按顺序检查
源的画面一片空白待机本来透明 → 点击“测试进场” → 确认程序正在运行 → 确认源可见及图层顺序 → 检查网址与 17891 端口。
画面被遮挡或尺寸不对将特效源移动到背景/摄像头上方,宽高设为实际画布尺寸,并检查是否存在意外裁剪。
动画出现,但没有声音检查欢迎语和音效是否开启、Windows 语音是否可用;OBS 中检查“通过 OBS 控制音频”、源静音和混音器。录制短段测试视频确认输出。
声音重复或出现回声检查是否重复添加播放器,以及桌面音频是否同时录入了源的监听声。保留一条正确的特效音频路径,再次测试录制。
测试正常,真实进场没有反应确认 TikTok ID、账号已开播、聊天室已连接、授权有效;检查事件是否符合设置的进场条件,最后再保存一次设置。
升级后仍显示旧效果刷新 OBS/Studio 网页源,确认新程序版本和正确的源网址,再执行一次“测试进场”。
程序无法启动本机服务完全退出其他旧版/自用版,然后只运行一个进场程序。直播软件必须与它在同一台电脑。

FOR THE WEBSITE OWNER

把这个单页网站放上网。

以下部署的是介绍、教程与下载入口。Windows 特效程序仍在主播电脑上运行;授权与更新服务沿用项目现有服务。

09 / WEBSITE FILES

先解压网站包。

返回首页下载网站 ZIP ↗
  1. 保存并解压在 Windows 中右键点击 website.zip →“全部解压缩”,然后打开解压后的网站文件夹。
  2. 找到正确的网站根目录根目录应直接包含 index.html,以及 assets、downloads 等文件夹。如果外面还有一层 dist,请使用里面直接包含 index.html 的那一层。
  3. 预览首页双击 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 的浏览器拖放上传流程。

  1. 登录 Cloudflare打开 Cloudflare Dashboard,登录账号并选择要使用的账户。
  2. 创建 Pages 项目进入 Workers & Pages,点击 Create application,选择 Pages 的直接上传入口。界面可能显示为 Get started → Drag and drop your files,或 Pages → Use direct upload。
  3. 输入项目名称例如 live-entrance-guide;如果该名称已被占用,请换成你自己的名称。按照界面点击 Create project 或继续上传。
  4. 上传网站根目录将上一节找到的完整文件夹拖入上传区。请使用直接包含 index.html 的文件夹,等待所有文件上传完成;也可以上传根层直接包含 index.html 的 ZIP。
  5. 点击 Deploy site确认没有文件上传失败后,点击 Deploy site;有些界面显示为 Save and Deploy。完成后进入项目页面。
  6. 打开正式网址Cloudflare 会显示项目的 *.pages.dev 网址。使用实际显示的网址打开网站,完成下方验收后即可分享。

Direct Upload 网站更新时需要重新上传。如果以后要改为 Git 推送自动部署,需要另外创建 Git 集成项目。控制台拖放上传目前最多支持 1,000 个文件,每个文件上限 25 MiB;若某个文件出现红色警示,请先压缩或移除超限展示素材,再重新上传整个网站包。

流程与限制根据 2026.10.16 查阅的官方文档整理:Cloudflare Pages Direct Upload;另一套官方界面说明:Pages Direct Upload 操作步骤。按钮名称可能随界面更新而变化。

11 / DOMAIN & UPDATES

绑定域名,并持续更新。

有自己的域名时,再进行绑定。

  1. 在 Pages 项目中添加域名进入 Workers & Pages → 你的 Pages 项目 → Custom domains,点击 Set up a domain,输入你拥有的域名或子域名,再点击 Continue。
  2. 按照提示设置 DNS根域名需要添加到同一个 Cloudflare 账户并使用 Cloudflare nameserver;子域名可按照提示配置 CNAME,指向你的 *.pages.dev。务必先在 Pages 中关联域名,再配置 DNS。
  3. 启用后测试确认自定义域名可以通过 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,即可设置自己的进场效果。

← 返回单页网站