從下載到第一場直播，
每一步都在這裡。

01 / PREPARE

準備好，再下載。

你需要一台 Windows x64 電腦、穩定網路、OBS 或 TikTok LIVE Studio，以及自己要接收事件的 TikTok 帳號。直播軟體和特效程式要在同一台電腦執行。

安裝檔約 3.5 GB，請預留安裝及內建素材的磁碟空間。這是完整安裝包，使用者不需要另外安裝 Node.js，也不需要先啟動其他原版程式。

檔名：LiveEntrance-Setup-0.1.27.exe。下載來自本專案既有的發行空間；如果瀏覽器先開啟下載頁，依該頁的下載按鈕取得檔案。

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：

3. 寬高設為實際畫布大小直式直播常用寬 1080、高 1920；橫式畫布若是 1920 × 1080，就填寬 1920、高 1080。以你在 OBS「設定 → 影像」看到的基本畫布尺寸為準。
4. 確認圖層與音訊把特效來源拖到攝影機或直播背景上方，打開來源的眼睛圖示。勾選「由 OBS 控制音訊」，在混音器確認此來源沒有靜音，並把音量調到合適程度。
5. 回程式按「測試進場」確認 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，輸入下面資料夾路徑，將整個資料夾複製到你自己的私人備份位置。

2. 取得並套用更新重新開啟程式後，按右上版本號進入「版本與更新」，選穩定版、檢查更新並依畫面下載與重新啟動套用。也可關閉舊版後手動執行新版安裝檔。未儲存、聊天室連線中或有待播時，程式可能要求先完成整理。
3. 重新載入來源並重測在 OBS 開啟該瀏覽器來源屬性，使用重新整理目前頁面快取；Studio 則重新整理網頁來源。回程式按「測試進場」，確認畫面與音訊正常再連線聊天室。程式的「修復 OBS」也可用於重載既有 OBS 來源。

備份含個人設定與授權相關資料，請留在私人位置，不要放入網站包或公開雲端目錄。從舊 ZIP 版升級時，第一次需手動使用安裝檔，之後以新的桌面捷徑開啟。

08 / TROUBLESHOOTING

遇到問題，從這裡檢查。

09 / WEBSITE FILES

先解壓縮網站包。

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  （選用：原始部署的備用下載檔）

下載的網站包通常不含 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 網址。用這個實際顯示的網址開啟網站，完成下方驗收後就能分享。

流程與限制已依 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，就能開始設定自己的進場效果。