Communitygithub.com

滾動影片網站

建立或優化一個網站,讓原生滾動控制核准影片的播放進度,並協調物件過渡到頁面內容中。適用於滾動驅動的電影式開場及攝影物體動態,而非一般的自動播放影片嵌入。

滾動影片網站 是什麼?

這項技能旨在協助開發者建立或優化一個「滾動驅動」的互動式網站,其中原生滾動行為能精確控制影片的播放進度,並協調3D物體或視覺元素平滑過渡到頁面內容中。它特別適用於產品展示、室內空間揭曉、藝術品導覽等需要電影級開場效果的情境,而非單純的自動播放影片嵌入。 此技能支援多種開發平台(如 Claude Code、Cursor 等),其核心工作流程包括:分析現有實作與使用者反饋、準備影片與靜態媒體素材、將故事劃分為意圖明確的滾動區段、實現影片刮擦與物體動畫的同步、以及確保網站的可訪問性與響應式設計。它強調使用原生滾動機制,避免攔截滑鼠滾輪或觸控事件來模擬滾動條,從而維持良好的使用者體驗與可及性。 關鍵技術要點包括:透過 requestAnimationFrame 排程更新、合併影片搜尋請求以避免畫面堆積、在邊界點提供像素容錯、並在滾動停止時保持當前狀態。此外,技能也涵蓋了減少動畫偏好、媒體載入失敗等特殊情況的處理,確保網站在各種情境下都能正常運作。最後,它要求開發者在真實瀏覽器環境中進行全面測試,包括桌面與手機版面、縮放、鍵盤焦點等,以確保互動效果的可靠性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itsmanuelarx/creative-web-animation-skills/tree/HEAD/skills/scroll-video-website

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

滾動影片網站 是做什麼的?

將核准的視覺序列轉變為響應式、可反向操作的網站互動。重複使用現有網站的技術棧與核准素材;此技巧不依賴特定的動畫庫。主題、路徑與目的地皆為專案輸入參數。將此工作流程應用於產品旋轉、內部空間揭曉、藝術品或其他視覺故事。墜落的唱片與唱盤僅為範例,並非必要場景。

建立互動機制

在編輯前,先檢查現有實作、核准版本與最新的使用者反饋。根據此脈絡解決以下問題:

  • 影片中包含哪些動作?哪些物件是透過程式碼獨立動畫的?
  • 滾動控制的是完整片段,還是在刻意定時的段落之後才開始滾動?遵循所選的行為。從頭開始滾動的需求必須能在首次滑鼠滾輪或觸控滾動時生效,無需點擊閘門。
  • 最終場景在何處變成一般頁面內容?訪客如何直接到達主要內容?
  • 哪些尺寸與平台是重要的?哪些預覽版本必須保持可用?

如果僅要求變更時間點或控制方式,請勿重新生成媒體。儲存當前可用的版本,並在需要比較時建立一個獨立的替代版本。

準備媒體

使用確切的影片以及與其對應的解碼開始/結束靜止畫面。保留色彩詮釋、長寬比與原始檔案。如果接縫本身有問題,請在試圖用互動效果隱藏之前,先修正媒體交接。

檢查持續時間、幀率、尺寸與搜尋行為。較短的關鍵幀間隔有助於刮擦;全部為關鍵幀的副本對於本地原型可能有用,但部署時可能過於龐大。在實際瀏覽器中測試衍生版本,並分別優化傳遞方式。不要為每個片段指定統一的編碼設定。

在中繼資料與影格載入期間保留一個海報圖。保留最新的請求時間,並在影片準備就緒時套用。如果影片遺失或遭到拒絕,必須留下一條可用的靜態路徑通往內容。

將滾動對應到時間軸

  1. 當現有版面適用時,使用原生滾動軌道與黏性視覺舞台。如果滾動是入口控制,請保持頁面立即可滾動。避免僅為了模擬滾動條而攔截滑鼠滾輪或觸控捕捉。
  2. 將所選的故事劃分為意圖明確的區段,例如主體運動、鏡頭揭示、靜止場景、物件轉移與內容。僅使用對專案有幫助的階段;產品旋轉無需包含墜落或房間揭示。為簡短但重要的事件分配足夠的滾動距離。將每個區段對應到其媒體或轉換進度;剪輯的秒數無需均勻對應到滾動像素。
  3. 透過由滾動事件排程的單一 requestAnimationFrame 進行更新。在測量時讀取版面配置,而非在每次動畫更新時重複讀取。
  4. 保持影片暫停以進行刮擦。合併搜尋請求:儲存最新的目標,在一個搜尋進行中時不要啟動另一個競爭搜尋,並在 seeked 事件後套用最新的目標。不要建立過時幀的累積佇列。
  5. 限制端點,針對小數點視口計算提供少量像素容錯。使用實際的瀏覽器滾動位置測試第一幀與最後一幀。
  6. 讓停止的滾動保持當前狀態。根據所選的互動反轉每個階段,包括在整個剪輯由滾動控制時的開場動作。
  7. 當訪客使用滑鼠滾輪、觸控或導航鍵輸入時,取消程式化的移動。防止視窗調整大小與回復滾動位置意外跳過開場狀態。

對於混合式入口,明確定義哪個段落是由時間控制的,以及反向滾動在何處停止。不要在全滾動控制的體驗中默默引入計時段落。

保持攝影物體的連續性

在實際可行的情況下,在選擇的運動與交接過程中使用一個可見的物件,例如產品移動到其詳細視圖,或藝術品轉移到畫廊。如果將其重新附加到目標上,請在改變前後匹配其位置與投影。

完整的端到端翻轉需要能夠露出邊緣的 3D 旋轉。平面內旋轉是不同的運動。紋理平面適合印刷品或唱片等扁平物體;不要將其描述為完全建模的 3D 場景。一個在旋轉過程中輪廓會改變的實體產品,需要合適的拍攝/生成的視圖或 3D 資產。

將來源與目標的測量值保持在一致的座標系統中。當舞台是黏性時,不要混合視口與文件座標。在視窗調整大小時重新測量,並保留有意義的進度。根據物理原因對依賴性動作進行排序。例如,如果目標是唱盤,請在唱片降落前保持唱臂抬起,然後在播放狀態開始前將其放下。

使用匹配的光照與場景幾何來融合場景邊界。保持標題與內容連結可讀,而不是將它們放置在視覺上擁擠的圖像上。在窄視口上,當物件旁邊空間不足時,讓內容位於物件下方。

保留網站可訪問性

在故事中的選定點顯示導航,而非僅在漫長的影片結束後。保留直接分類存取、跳過、重播與返回場景的路徑。如果分類變更旨在交換物件,請與所選內容及任何依賴的動畫協調;快速選擇應以最新請求為準。

當目標或其祖先處於非互動狀態時,不要聚焦該目標。使其可互動,然後聚焦它,而無需額外的滾動跳躍。在專案對話框關閉後恢復焦點。

減少動畫的路徑應顯示可用的靜態場景,無需刮擦或翻轉,包括在反向滾動時。保持失敗媒體狀態為持久性,以便反向滾動無法恢復損壞的覆蓋層。

驗證與交接

使用支援的瀏覽器工具測試真實輸入,而不僅僅是呼叫內部動畫函數:

  • 從全新載入開始,無需點擊即可滾動。在途中停止,繼續,然後反向滾動到開頭。
  • 視覺檢查影片/靜止畫面交接以及物件到目的地的連接處。
  • 當物件過渡是設計的一部分時,確保動畫物件位於正確位置,即可到達主要內容。測試分類變更、跳過、重播與鍵盤焦點。
  • 檢查桌面與手機版面、中途調整視窗大小、減少動畫以及刻意讓影片不可用的情況。
  • 檢查水平溢出、媒體載入與控制台錯誤。區分瀏覽器模擬與實體手機測試。

提供審查 URL、有用的螢幕截圖、保留的基準版本,以及任何重要的效能或裝置測試限制。保留一份簡潔的清單,標明來源媒體與時間點。實施本地審查本身並不授權發布。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能