SWAG
SWAG OBS 教學Guide Agora 串流設定 Agora streaming setup
主播教學
Creator guide

用 OBS 開台：Agora 串流設定

Go live with OBS: Agora streaming setup

依照以下步驟完成 OBS 與 SWAG 的串流設定，即可開始直播。

Follow the steps below to set up OBS for SWAG streaming and start your live stream.

🍎 使用 Mac 開播前，請確認您的裝置為 M 系列晶片（Apple Silicon），Intel Mac 目前不支援。 Before going live on Mac, please make sure your device uses an Apple Silicon (M-series) chip — Intel Macs are not currently supported.

開始之前

Before you start

1

安裝 SWAG Agora 插件

Install the SWAG Agora plugin

  1. 下載 SWAG Agora 插件（Windows）。
  2. 解壓縮後，開啟 SWAG Agora 的資料夾。
  3. 雙擊 Agora-Tool-4.5.2.4-Installer。
  4. 一路點 Next，再點 Install 完成安裝即可關閉。
  1. Download the SWAG Agora plugin (Windows).
  2. Unzip it, then open the SWAG Agora folder.
  3. Double-click Agora-Tool-4.5.2.4-Installer.
  4. Click Next through the setup, then Install to finish.
Agora plugin installer
  1. 下載 SWAG Agora 插件。
  2. 下載完點開 agora-tool-MAC.pkg 開始安裝。
  3. macOS 通常會先擋一次，跳出「未打開」的警告視窗 —— 這是正常的，跟著下面兩步驟排除就好。
  1. Download the SWAG Agora plugin.
  2. Open agora-tool-MAC.pkg to start installing.
  3. macOS will usually block it once with a "Not Opened" warning first — that's expected, just follow the two steps below to clear it.
🔒 跟 Windows 不同，Mac 會先擋下這個安裝檔，需要手動放行一次才能繼續安裝。 Unlike Windows, macOS blocks this installer once by default — you'll need to manually allow it before setup can continue.

如果跳出「未打開」警告視窗：

If you see a "Not Opened" warning window:

  1. 在警告視窗中按 「完成」（不要選「丟到垃圾桶」）。
  1. Click Done in the warning popup (do not choose "Move to Trash").
macOS 未打開警告視窗，完成按鈕已標紅框
macOS Not Opened warning, Done button highlighted

接著手動放行：

Then manually allow it:

  1. 打開 系統設定 → 隱私權與安全性。
  2. 往下滑，找到被阻擋的 agora-tool-MAC.pkg，點 「強制打開」。
  3. 再點一次「強制打開」，輸入電腦密碼即可。完成後就能正常繼續安裝插件。
  1. Open System Settings → Privacy & Security.
  2. Scroll down to find the blocked agora-tool-MAC.pkg, then click Open Anyway.
  3. Click Open Anyway again and enter your Mac password. The installer will then continue normally.
系統設定隱私權與安全性，強制打開按鈕已標紅框
Privacy & Security settings, Open Anyway button highlighted
2

開始直播，打開 SWAG 的串流設定視窗

Go live and open the stream-setup window in SWAG

  1. 打開 SWAG，點擊「開始直播」。
  2. 畫面會自動跳出一個「串流設定」視窗。
  3. 確認視窗標題寫的是 Agora RTC 串流設定。
  1. Open SWAG and click "Start Live".
  2. A stream-setup window pops up automatically.
  3. Check the title says Agora RTC Streaming Configuration.
Moor 的 Agora RTC 串流設定彈窗
Moor Agora RTC streaming configuration popup
💡 先別關掉這個視窗 — 下一步要用到裡面的 4 組資料，等全部貼到 OBS 之後才需要關。 Keep this window open — you'll copy 4 values from it in a later step. Only close it after everything is pasted into OBS.
3

在 OBS 打開聲網連麥設定

Open the Agora connect settings in OBS

  1. 開啟 OBS，點擊上方選單「工具」→「聲網連麥」。
  2. 跳出的小視窗裡，點擊「設定」。
  1. Open OBS, then click Tools → Agora RTC Tool in the top menu.
  2. In the window that appears, click Settings.
OBS 工具選單
聲網連麥設定按鈕
OBS Tools menu
Agora connect settings button
Mac OBS 工具選單
Mac 聲網連麥設定按鈕
Mac OBS Tools menu
Mac Agora connect settings button
4

把 SWAG 的資料複製貼到 OBS

Copy the values from SWAG into OBS

回到步驟 2 留著的視窗，把 4 組資料依照下表複製貼到 OBS 的設定視窗裡：

Go back to the window from step 2, and copy each value into the matching OBS field:

SWAG 顯示的名稱貼到 OBS 的欄位
Agora App IDAPPID
Agora TokenAppToken（可選）
Channel Name頻道
String Uid用戶ID
SWAG fieldOBS field
Agora App IDAgora APPID
Agora TokenToken (Optional)
Channel NameChannel Name
String UidUid (Optional)
SWAG 顯示的名稱貼到 OBS 的欄位
Agora App IDAPPID
Agora TokenAppToken（可選）
Channel Name頻道
String Uid用戶id（勾選右邊 Basic.Agora.StringUid）
SWAG fieldOBS field
Agora App IDAgora APPID
Agora TokenAgora Token (Optional)
Channel NameChannel Name
String UidUid (Optional) — check "Basic.Agora.StringUid" on the right
OBS 設定對話框，欄位已標紅框
OBS settings dialog with fields highlighted
Mac OBS 設定對話框，欄位已標紅框
Mac OBS settings dialog with fields highlighted
⚠️ 貼上「用戶ID」前，記得把右邊的「StringUid」打勾。 Before pasting the Uid, check the "StringUid" box on the right.. 貼上「用戶id」前，記得把右邊的「Basic.Agora.StringUid」打勾。 Before pasting the Uid, check the "Basic.Agora.StringUid" box on the right.

全部貼好、確認打勾後，點擊「確定」。

Once everything is filled in and checked, click OK.

🔁 Channel Name 跟 Agora Token 每場直播都會變，不能沿用上一次的，每次開播都要重新複製貼上。 Channel Name and Agora Token change every stream. Copy them each time.
5

開始推流

Start streaming

  1. 點擊「開始推流到聲網」。
  2. 按鈕會變成藍色的「停止推流到聲網」——這是正常的，代表已經在推流中，不是壞掉。
  3. 回到 SWAG，畫面顯示「已連接訊號源」就代表成功了！
  1. Click Start Streaming to Agora.
  2. The button turns blue and changes to "Stop Streaming to Agora" — that's expected, it just means the stream is now live, not that anything broke.
  3. Back in SWAG, once you see "Stream Source Connected", you're done!
開始推流到聲網按鈕
已連接訊號源確認畫面
Start Streaming to Agora button
Stream Source Connected confirmation
Mac 開始推流到聲網按鈕
Mac 停止推流到聲網，已在推流中
Moor 已連接訊號源
Mac Start Streaming to Agora button
Mac Stream Source Connected confirmation
🚫 OBS 右側「控制項」面板裡也有一個「開始串流」按鈕——那是不同的按鈕，不要點它！你要點的是「聲網連麥」小視窗裡的「開始推流到聲網」，點錯 OBS 自己的「開始串流」會導致直播中斷。 OBS's own Controls panel also has a "Start Streaming" button — that's a different button, don't click it! You want "Start Streaming to Agora" inside the small Agora RTC Tool window. Clicking OBS's own Start Streaming will cut your stream. OBS 右側「控制項」面板裡也有一個「開始直播」按鈕——那是不同的按鈕，不要點它！你要點的是「聲網連麥」小視窗裡的「開始推流到聲網」，點錯 OBS 自己的「開始直播」會導致直播中斷。 OBS's own Controls panel also has a "Start Streaming" button — that's a different button, don't click it! You want "Start Streaming to Agora" inside the small Agora RTC Tool window. Clicking OBS's own Start Streaming will cut your stream.
💡 記得別關掉「聲網連麥」這個視窗，關掉的話畫面會中斷。 Don't close the "Agora RTC Tool" window while live — closing it will cut the stream. 記得別關掉「聲網連麥」這個視窗，關掉的話畫面會中斷。 Don't close the "Agora RTC Tool" window while live — closing it will cut the stream.
6

連接藍牙跳蛋（選用）

Connect a Bluetooth toy (optional)

只要你的電腦本身內建藍牙，就可以直接連線跳蛋，不需要額外安裝插件。

If your computer already has built-in Bluetooth, you can connect a toy directly — no extra plugin needed.

💡 最多可以同時連接 2 個玩具。
查看目前支援的品牌與型號 → You can connect up to 2 toys at the same time.
See supported brands & models →

常見問題

Troubleshooting

每次開播都要重新貼一次資料嗎？
是的——Channel Name 跟 Agora Token 每場直播都會變動，開播前務必回到 SWAG 複製最新的值。

Do I need to re-paste the values every time?
Yes — Channel Name and Agora Token change every stream, so copy the latest values from SWAG before each broadcast.

OBS 啟動時出現無法載入 "agora-ui-tools" 的錯誤？
到 C:\Program Files\obs-studio\data\obs-plugins，移除資料夾裡的 agora-tool-ui，重新安裝 Agora 插件後重啟 OBS 即可修正。 到 ~/Library/Application Support/obs-studio/plugins，移除 agora-tool-ui.plugin，重新安裝 Agora 插件後重啟 OBS 即可修正。

OBS shows an error that it can't load "agora-ui-tools"?
Go to C:\Program Files\obs-studio\data\obs-plugins, remove the agora-tool-ui folder, reinstall the Agora plugin, then restart OBS. Go to ~/Library/Application Support/obs-studio/plugins, remove agora-tool-ui.plugin, reinstall the Agora plugin, then restart OBS.

影片教學

Video walkthrough

文字看不夠清楚？跟著錄好的完整操作影片一步步做。

Prefer to watch? Follow the full recorded walkthrough step by step.

🎬 中文版設定教學
🎬 English walkthrough