YouTube 嵌入程式碼產生器
簡介
Toollect 的 YouTube 嵌入程式碼產生器可一鍵將任意 YouTube 影片 URL 或單一影片 ID 轉換為可複製 iframe 程式碼。貼上連結、選擇播放器行為、產生、預覽、複製、貼上，整個過程只需幾秒鐘，每個選項都對應一個今天仍然有效的真實 YouTube 參數。
它解決的是繁瑣的問題。官方分享對話框只能提供一個固定 iframe，無法控制大小、比例或行為，而每個「如何嵌入 YouTube」的教學都會把你引向一串需要手動寫進 URL 的參數。這個工具替你完成組裝：選擇寬高比，另一側尺寸自動計算；開啟無 Cookie 模式、循環、控制項；無需開啟任何編輯器即可將影片截取到指定的開始和結束時間。
產生器刻意是一款單一影片工具。它接受真實 YouTube 連結的完整語法，包括 watch URL、youtu.be 短連結、Shorts、直播，甚至單一影片 ID，並將它們全部正規化為一個標準的嵌入 URL。一切都在你的瀏覽器中完成，無需 API 金鑰、無需帳戶，你的連結相關資訊不會離開你的裝置。唯一的網路請求是誠實的那一個：即時預覽會載入真實的播放器 iframe，讓你在複製之前驗證結果。
使用場景
YouTube 影片嵌入出現的地方遠不止部落格文章，而且每個場景中選項的意義各不相同。
- 部落格和文章頁面。 560×315 的 16:9 預設符合大多數 CMS 主題的預期，無 Cookie 網域預設保持嵌入符合 GDPR 要求。
- 課程和文件頁面。 start 和 end 可以向學生展示長篇講座的精確片段，產生的程式碼可在任何接受原始 HTML 的學習平台上運作。
- Shorts 和直式內容。 9:16 預設為直式影片產生 360×640 的手機形播放器，這是大多數其他產生器根本沒有的。
- 自助服務終端和標示螢幕。 關閉播放器控制項可獲得乾淨、無干擾的播放介面，必要時用循環開關進行連續播放。
- 設計原型。 自訂比例模式接受 144 到 3840 像素之間的任意寬度和高度，你可以將影片以精確像素尺寸放入 Figma 或 HTML 原型中。
- 注重隱私的網站。 這裡預設使用無 Cookie 網域，而官方對話框總是產生 www.youtube.com 的 URL，除非你知道需要手動修改。
工作原理
產生器是一個兩階段管線，兩個階段都完全在你的瀏覽器中執行。
第一階段：ID 擷取。 URL 解析器識別所有常見的 YouTube 連結形式並擷取 11 個字元的影片 ID。YouTube 嵌入播放器只需要這個 ID。單一 ID 也被接受，因此你可以貼上從網址列或資料庫複製的 ID。
第二階段：程式碼組裝。 ID 被插入嵌入 URL 範本，每個啟用的選項都會附加一個查詢參數：
https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ?autoplay=1&start=30
iframe 標籤帶有明確的寬度和高度屬性、無障礙標題、標準 allow 權限清單和 allowfullscreen。YouTube 的一個特性會被自動處理：循環播放的單一影片必須以單一條目播放清單的形式呈現，因此循環開關會將 loop=1 和 playlist=VIDEO_ID 一起加入。沒有第二個參數，YouTube 會靜默忽略循環。
預覽就是產生的程式碼所包含的同一個 iframe，該工具渲染真實的播放器而非仿製品。你在預覽中看到的內容正是你的訪客將看到的內容，包括 YouTube 自身如何提示已刪除、私人或不可用的影片。
支援的 URL 格式
解析器接受所有能識別單一影片的形式，拒絕所有不能的形式。
可接受
| URL 格式 | 範例 |
|---|---|
| watch URL | https://www.youtube.com/watch?v=dQw4w9WgXcQ |
| 短連結 | https://youtu.be/dQw4w9WgXcQ |
| embed URL | https://www.youtube.com/embed/dQw4w9WgXcQ |
| Shorts URL | https://www.youtube.com/shorts/dQw4w9WgXcQ |
| live URL | https://www.youtube.com/live/dQw4w9WgXcQ |
| /v/ URL | https://www.youtube.com/v/dQw4w9WgXcQ |
| 無 Cookie 網域 | https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ |
| 單一影片 ID | dQw4w9WgXcQ |
帶有 &t=42s 或 &list=PL... 等附加查詢參數的 watch URL 也能被正確解析，產生器會擷取 ID 並忽略其餘部分，因為嵌入參數是從你的設定重新建構的，而不是從連結中複製。
會被拒絕
| URL 格式 | 拒絕原因 |
|---|---|
| 播放清單連結 | youtube.com/playlist?list=PL... 識別的是播放清單，不是單一影片 |
| 頻道頁面 | youtube.com/@channel 沒有影片 ID |
| 搜尋 URL | youtube.com/results?search_query=... 沒有影片 ID |
| 使用者頁面 | youtube.com/user/name 沒有影片 ID |
| 無 ID 的 Shorts | youtube.com/shorts/ 是索引頁面，不是影片 |
嵌入程式碼的結構
產生的 iframe 很緊湊，每個部分都有其職責。以下是 16:9 的標準輸出：
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
| 屬性 | 作用 |
|---|---|
| width / height | 播放器尺寸（像素）。變更寬度時會根據所選寬高比重新計算高度，反之亦然。 |
| src | 嵌入 URL。預設主機是 www.youtube-nocookie.com，關閉無 Cookie 模式會切換為 www.youtube.com。查詢參數承載播放器選項。 |
| title | 螢幕閱讀器為框架播報的無障礙名稱。它保留 YouTube 的官方預設值，使產生的程式碼與 YouTube 自身發布的內容一致。 |
| frameborder | 用於相容舊版 HTML 驗證器的舊版屬性，在現代瀏覽器中沒有視覺效果。 |
| allow | 嵌入播放器的權限政策，支援全螢幕和自動播放，與官方 YouTube 嵌入一致。 |
| referrerpolicy | 告訴瀏覽器在 referer 標頭中傳送什麼。strict-origin-when-cross-origin 是現代預設值，只暴露來源，絕不暴露完整的頁面 URL。 |
| allowfullscreen | 啟用播放器的全螢幕按鈕。 |
src 的查詢參數是可設定部分。autoplay=1、loop=1&playlist=ID、controls=0、start=秒和 end=秒僅在啟用對應選項時出現，因此最簡嵌入不攜帶任何參數。
嵌入選項
設定面板中的每個選項對應最終 URL 中的一個參數。
| 設定 | 參數 | 預設 | 說明 |
|---|---|---|---|
| 寬高比 | – | 16:9 | 預設為 16:9、4:3、3:4、9:16 和 1:1，另有自訂。選擇預設會填入該比例的標準尺寸，16:9 變為 560×315，9:16 變為 360×640。 |
| 寬度 / 高度 | – | 560×315 | 編輯任一欄位都會根據目前比例重新計算另一個。自訂模式停用計算，兩個值保持獨立。範圍 144–3840 px。 |
| 無 Cookie 模式 | 主機切換 | 開啟 | 使用 www.youtube-nocookie.com，只要影片未播放，YouTube 就不會儲存訪客資訊。 |
| 自動播放 | autoplay=1 | 關閉 | 注意：瀏覽器仍會封鎖帶聲音的自動播放，請參閱常見問題。 |
| 循環 | loop=1&playlist=ID | 關閉 | playlist 參數會自動加入，沒有它 YouTube 會忽略循環。 |
| 顯示播放器控制項 | 關閉時 controls=0 | 開啟 | 關閉後隱藏控制列，獲得乾淨的播放介面。 |
| 開始時間 | start=秒 | 關閉 | 時、分、秒欄位，URL 中會轉換為秒。 |
| 結束時間 | end=秒 | 關閉 | 在指定時刻停止播放，無需編輯來源影片即可截取片段。 |
寬高自動計算會四捨五入到整數像素並限制在 144–3840 範圍內。由於預設是精確比例，560×315 和 360×640 等標準組合是像素級精確的，需要精確尺寸時無需與四捨五入誤差搏鬥。
參數參考：2026 年仍然有效的內容
YouTube 已停用的嵌入參數比大多數網站知道的還多，而舊教學仍在推薦失效參數。以下是 2026 年你在網路上會遇到的那些參數的實際狀態，已與官方播放器文件核對。
仍然有效
| 參數 | 2026 年的效果 |
|---|---|
| autoplay | 啟動播放（受瀏覽器聲音政策限制） |
| loop + playlist | 循環播放影片，兩者必須保持在一起 |
| controls | 0 隱藏控制列，2 還隱藏全螢幕按鈕 |
| start / end | 以秒為單位的起點和截止點 |
| cc_load_policy | 1 強制開啟字幕 |
| cc_lang_pref | 指定字幕語言 |
| hl | 指定播放器介面語言 |
| color | color=white 將進度列改為白色（僅限控制項可見時） |
| fs | 0 隱藏全螢幕按鈕 |
| disablekb | 1 停用播放器鍵盤控制 |
| rel | 0 將相關影片限制在同一頻道，但無法刪除它們 |
已停用且無效
| 參數 | 發生了什麼 |
|---|---|
| modestbranding | 2023 年 8 月停用，Logo 始終顯示 |
| showinfo | 2018 年 9 月停用，標題始終顯示 |
| autohide | 已停用，參數被忽略 |
| theme | 已停用，只有深色播放器 |
| vq | 多年前就已失效，無法再強制初始畫質 |
| iv_load_policy | 註解已從 YouTube 移除，該參數已無可控制對象 |
產生器刻意只暴露仍然有效且大多數嵌入者真正需要的參數。功能正常但屬於小眾的集合（fs、hl、color、disablekb、cc_load_policy）有意保留在介面之外，因為輸出是簡單的 URL，任何人都可以手動附加 &fs=0 或 &cc_load_policy=1，而不會破壞產生器建立的程式碼。
使用方法
- 將 YouTube 影片 URL 或單一影片 ID 貼到輸入框，點擊產生按鈕或按 Enter。
- 嵌入程式碼出現在輸出區域，即時預覽自動在下方開啟。
- 調整選項：比例、寬度或高度、無 Cookie 模式、自動播放、循環、控制項、開始和結束時間。每次變更程式碼和預覽都會立即更新。
- 檢查預覽。它是真實的播放器，因此你可以按下播放、快轉並直觀地驗證開始和結束點。
- 點擊複製，將 iframe 貼到你的頁面、CMS 或 HTML 區塊中。
如果 URL 不包含影片 ID，紅色錯誤訊息會說明預期內容。清除會一次重置輸入、程式碼和預覽。
教學
範例一：截取講座片段並循環。 課程頁面需要一段 12 分鐘的課程，但來源影片長達 40 分鐘，相關部分從 3:05 到 12:30，並為想複習的學生循環播放。
- 將 watch URL 貼到輸入框並點擊產生。
- 16:9 比例和寬度 560 已經正確，保留即可。
- 在開始分鐘欄位輸入 3，開始秒欄位輸入 5。
- 在結束分鐘欄位輸入 12，結束秒欄位輸入 30。
- 開啟循環。
- 程式碼現在包含 start=185&end=750&loop=1&playlist=VIDEO_ID。
- 複製 iframe 並貼到課程頁面。
範例二：直式格式的 Shorts 影片。 一篇面向行動端的文章嵌入 9:16 的 Shorts。
- 貼上 Shorts URL，https://www.youtube.com/shorts/... 會像其他連結一樣被識別。
- 選擇 9:16 比例。寬度自動變為 360，高度變為 640。
- 保持自動播放關閉，行動瀏覽器反正會封鎖它。
- 產生、預覽、複製。iframe 呈手機形狀，適合為直式媒體建置的內容欄。
專業提示
- 無需剪輯即可截取。 start 和 end 建立的片段無需重新編碼、無需重新上傳、沒有畫質損失，播放器直接跳到起點並在終點停止。
- 為歐盟流量保留無 Cookie 主機。 youtube-nocookie.com 在影片未播放時不儲存訪客資訊，相比一般網域能減輕同意流程的負擔。
- 手動組合自動播放與靜音。 如果確實需要 autoplay，請在產生的 src 後附加 &mute=1，瀏覽器允許靜音自動播放，訪客輕點即可開啟聲音。
- 把預覽當作品質檢查環節。 由於預覽是真實播放器，已刪除或私人的影片會在那裡顯示 YouTube 自身的錯誤訊息，而不是將死 iframe 悄悄送入正式環境。
- 卡片和清單的迷你嵌入。 144 px 的最小值支援縮圖大小的播放器，用於懸停預覽卡片，而大播放器會破壞這類版面。
- 非常規版面用自訂比例。 側邊欄、直排文章欄和社交證明區塊常常需要非標準尺寸，自訂模式保持寬度和高度獨立。
- 批次產生。 URL 留在輸入框中，切換選項即可，每次變更都會立即重新產生，因此循環截取版和簡潔版 iframe 在幾秒內就能得到，而不是幾分鐘。
替代方案
| 替代方案 | 優點 | 缺點 |
|---|---|---|
| YouTube 官方分享對話框 | 官方出品，始終最新 | 固定 16:9 尺寸、無比例預設、無開始/結束欄位、始終 www.youtube.com 主機 |
| YouTube oEmbed | 回傳帶自動影片標題的 iframe | 需要伺服器或 fetch、無法控制參數、需要 JavaScript 基礎設施 |
| 手動複製 URL | 無需學習 | 每個選項都是手動 URL 編輯，容易出錯，且失效參數潛伏 |
| 本產生器 | 一鍵完成、比例預設、預設無 Cookie 主機、開始/結束欄位、即時預覽 | 刻意只支援單一影片，不嵌入播放清單 |
與 YouTube 分享對話框對比
YouTube 自家的「分享 → 嵌入」流程在你只需要一個固定 iframe 時沒問題。對話框提供 560×315 播放器、一個可切換的核取方塊和一個 www.youtube.com 的 URL。這就是它的全部能力。
產生器涵蓋了對話框根本沒有解決的場景：9:16 的 Shorts 播放器、3:4 或 1:1 的方塊、精確的像素尺寸、預設的隱私友善主機、無需手動編輯 URL 的開始/結束截取，以及真正有效的循環，因為 playlist 參數會替你加入。對話框能產生的，產生器都能產生，還額外提供對話框沒有的即時預覽。
嵌入程式碼產生器與嵌入檢查器的區別
本站還提供 YouTube 嵌入檢查器，兩個工具互補而非競爭。
| 問題 | 嵌入檢查器 | 嵌入程式碼產生器 |
|---|---|---|
| 這個影片到底能不能嵌入？ | 透過 oEmbed、播放器和播放測試給出判定 | 假定可以並產生程式碼 |
| 影片的標題、作者和時長是什麼？ | 會顯示 | 按設計不取得中繼資料 |
| 給我嵌入程式碼 | 不行，只做診斷 | 可以，選項完全可控 |
| 先驗證可疑連結？ | 可以，這是它的職責 | 需要的話可直接貼上結果 |
當需要確認可嵌入性時先讓連結過一遍檢查器，需要程式碼時再過一遍產生器。它們共用同一個 URL 解析器，因此檢查器接受的任何內容，產生器也能解析。
它不能做什麼
- 取得中繼資料。 產生器從不呼叫 YouTube API，因此無法預填標題或作者。它是程式碼工具而非資訊工具，檢查器才是做這件事的姊妹工具。
- 嵌入播放清單。 播放清單連結會被拒絕。播放清單嵌入是另一項功能，有自己的參數集，刻意超出單一影片工具的範圍。
- 編輯 iframe 標題。 title 屬性保留 YouTube 官方的「YouTube video player」。螢幕閱讀器獲得一致的標籤，輸出與 YouTube 自身發布的內容一致。
- 移除相關影片。 任何參數都做不到，請參閱常見問題。
- 強制自動播放。 瀏覽器會封鎖它，該工具也不會悄悄給你的嵌入加入 mute。
- 上傳或儲存任何內容。 產生 100 % 在本機進行，請參閱下一節。
疑難排解
| 問題 | 可能的原因 | 解決方案 |
|---|---|---|
| 預覽顯示 YouTube 的「影片無法使用」訊息 | 影片已刪除、為私人或受地區限制 | 嵌入在你的網站上也會同樣失敗，請換一個影片 |
| 自動播放不啟動 | 瀏覽器封鎖帶聲音的自動播放 | 在產生的 src 後附加 &mute=1 |
| 影片播放一次後停止 | 手動編輯時 loop=1 失去了 playlist 搭檔 | 保持 loop=1&playlist=VIDEO_ID 在一起或重新產生 |
| 開始或結束時間被忽略 | 結束早於開始，或片段超過影片時長 | 檢查時間順序和影片時長 |
| 播放器在我的網站上不渲染 | 網站的 Content Security Policy 封鎖了 iframe | 向你的 CSP 加入 frame-src https://www.youtube-nocookie.com https://www.youtube.com |
| 播放器渲染但缺少控制項 | 控制項開關已關閉 | 開啟「顯示播放器控制項」並重新產生 |
| 點擊產生沒有任何反應 | URL 中沒有影片 ID | 使用上表中可接受的格式之一 |
隱私與資料處理
該工具屬於本站隱私譜系中最乾淨的一類：產生期間零請求。
- 產生完全在本機。 URL 在你的瀏覽器中解析，iframe 在那裡組裝。不會向 Toollect 伺服器傳送任何請求，也不會記錄任何內容。
- 預覽載入真實播放器。 預覽開啟期間，你的瀏覽器與 YouTube 的嵌入網域通訊，就像任何嵌入了該影片的頁面一樣。
- 預設主機注重隱私。 產生的程式碼使用 www.youtube-nocookie.com，除非訪客播放影片，否則 YouTube 不會儲存他們的資訊。關閉隱私選項會切換到 www.youtube.com，即具有通常追蹤行為的同一播放器，這正是官方對話框始終產生的內容。
技術規格
- 輸入格式 – watch、embed、Shorts、live、/v/ URL、youtu.be、無 Cookie 網域 URL 和 11 個字元的單一影片 ID。
- 輸出 – 單一 iframe 標籤，帶明確的尺寸、無障礙標題、權限政策和 allowfullscreen。
- 支援的參數 – autoplay、loop + playlist、controls、start、end 以及無 Cookie 模式的主機切換。
- 寬高比 – 16:9、4:3、3:4、9:16、1:1 預設和自由自訂模式，另一側尺寸按像素四捨五入計算。
- 尺寸範圍 – 兩個軸均為 144 到 3840 像素。
- 處理方式 – 完全在瀏覽器中，產生期間無網路請求。
- 瀏覽器相容性 – 任何現代瀏覽器均可使用，產生的程式碼在任何能渲染 iframe 的瀏覽器中都能運作，也就是說所有瀏覽器。
功能特色
- 一鍵從任意影片 URL 或單一影片 ID 產生 YouTube iframe 嵌入程式碼
- 寬高比預設，包括 16:9、4:3、3:4、Shorts 適用的 9:16、1:1 和自訂，另一側尺寸自動計算
- 預設使用注重隱私的 youtube-nocookie.com 網域
- 無需剪輯即可截取影片，開始和結束時間精確到時:分:秒
- 自動播放、循環和播放器控制項選項，複製前可即時預覽
- 100 % 在瀏覽器內產生，無需 API 金鑰、無需帳戶、無需上傳