發佈影片:改變了什麼,展示改變
推廣影片銷售產品;發佈影片則是向大致已熟悉該產品的使用者展示一個發佈版本的差異。同樣的引擎,不同的任務:先前的狀態很重要,每一個宣稱都受到一個標籤的限制,而這部影片是一個系列中的其中一集。
此技能擴展自 site-promo-film,位於同層目錄 ../site-promo-film/。請先閱讀其 SKILL.md:方向、外觀、禁令、建構規則、畫布陷阱、渲染前的靜止幀、渲染與驗證,所有這些都原封不動地適用。此檔案僅包含發佈版本所新增的內容。
| 檔案 | 說明 |
|---|---|
template/release.html | 引擎加上一個 16 秒的發佈示範:版本卡片 → 應用程式過去的樣貌 → 一個新控制項出現在工具列並被點擊(列表重新排序,移動中的行會升起)→ 鍵帽上的快捷鍵開啟一個新介面(一個藥丸形狀展開成面板)→ 其餘的更新日誌 → 在玻璃選單中點擊更新路徑 → 回到版本卡片。單一檔案同時支援寬螢幕和方形版面;每個主打功能可以擁有自己的燈光。 |
../site-promo-film/template/film.js | 舞台(每個子幀都有次像素抖動:在緩慢移動中沒有任何東西會跳動或閃爍)、FILM.draw 用於圖示和符號、用於長影片的時間軸、特效。範本會載入它;其頂端和 site-promo-film §5 中有說明文件。 |
../site-promo-film/template/parts.js | 向量零件:視窗、瀏覽器、終端機、裝置、鍵帽、開關、圓環。 |
../site-promo-film/template/fx.js | 外觀——背景、燈光、粒子、玻璃、點擊漣漪——與推廣範本共用,後者有其說明文件(§4)。 |
../site-promo-film/scripts/render.mjs、contact.mjs、beats.mjs | 渲染器、連絡表單和配樂的節拍(site-promo-film §7,節拍),按原樣使用:PAGE=release.html node render.mjs …。 |
../site-promo-film/scripts/clickcheck.mjs | 每個點擊是否都可見(§3b):攝影機靜止且游標在頁面上每個 CLICKS 位置靜止。node clickcheck.mjs release.html,若有點擊未被看到則退出碼為 1。 |
../site-promo-film/scripts/deliver.mjs | 將完成的影片及其封面移動到一個專屬資料夾,然後在其內容安全無虞後將工作資料夾丟到垃圾桶(site-promo-film §8)。 |
將範本(或產品的套件,§5)、film.js、parts.js、fx.js(以及 type.js 及其設定的字型,用於使用 type.js 風格的標題)和四個腳本複製到工作資料夾的 src/ 中,路徑為 ~/Downloads/<product>-<version>-whats-new-work/src/(~/Downloads 是工作根目錄,除非設定另有指定:見 site-promo-film,Studio 章節),並在該處執行 npm i playwright-core。示範在 16 個子幀、8 個工作執行緒下需 69 秒渲染完成,在低光源外觀(night)下則需 171 秒;以寬螢幕測量。
使用 ? 或 help 叫用,或在對話中沒有任何內容提及發佈版本時叫用:進入引導模式,../site-promo-film/guide.md。它會詢問版本並引導完成簡報;此模式下不會進行任何渲染。Studio(site-promo-film,Studio)也會撰寫發佈簡報:kind: release,版本寫在 release.tag 中;它回答了 §1 的問題。
0 — 這個發佈有影片嗎?
僅在使用者要求製作影片後才詢問:發佈命令不會引發此問題,且此處的任何內容都不會主動提出。渲染遵循 site-promo-film §7 的熱度預設值。
- 從標籤建立列表,絕不依賴記憶:
git log --oneline <prev-tag>..<ref>,已合併的 PR,草稿版的發佈說明。根據「我認為裡面有什麼」製作的影片會顯示一個已遺漏的功能,或一個來自上一個發佈版本的功能。 - 當發佈版本包含了使用者能看到或操作方式不同的內容時,才符合資格:新的介面、新的控制項、重新設計、新的快捷鍵。錯誤修正、效能提升和內部改動不符合資格;用一句話說明並停止。一個沒有內容可展示的發佈版本影片,只是一個帶有版本號碼的標題卡。
- 最多主打三個功能。 其餘的內容原封不動地放入更新日誌滾動區,或乾脆不放。五個主打功能意味著每個功能只有三秒鐘,那只會是一場投影片秀。
1 — 詢問,然後等待
首先檢視:產品的先前影片(其套件,§5)、專案關於發佈媒體存放位置的說明,以及它的示範模式或測試夾具。如果套件或該標籤的原始碼中都沒有某個資產(如圖示的主檔、作為向量的標誌),則在同一則訊息中要求提供,絕不憑空捏造(site-promo-film §1)。然後在一則訊息中詢問以下項目,每個項目都包含預設值:
- 要製作影片的發佈版本和參考 (ref)(預設:標籤;如果尚未標記,則為
main,之後在標記時再次檢查)。 - 主打功能(預設:我從日誌中挑選,每個功能一行說明為何它適合展示)。
- 影片長度(預設:每個主打功能約 6–8 秒,加上約 3 秒的版本卡片,總計 15–30 秒;如果有需要觀察的點擊,則加倍,§3b)。一部 30 秒或更長、要上傳到 YouTube 的影片需要有章節(§6);較短的影片則無法做到:YouTube 要求至少三個章節,第一個從 0:00 開始,每個至少 10 秒。
- 格式:一個 16:9 的主版本(預設),以及一個方形裁切版本作為第二種版面配置。
- 外觀(預設:套件的外觀;對於第一部影片,提供一張真實影格的外觀表,如 site-promo-film §4 所述)。
- 存放位置(預設:
<product>-<version>-whats-new/,按照 site-promo-film §8 的方式交付,僅包含完成的影片和封面,而其-work資料夾則保留在工作根目錄(預設為~/Downloads);如果專案的說明指定了發佈媒體的存放位置,則使用該位置)。 - 音樂:預設為無。發佈片段預設為靜音自動播放,因此文字傳達所有資訊。
然後,當產品已有套件時(風格已確定,僅內容需要選擇),在節拍網格上提供一份分鏡腳本;如果是該產品的首部影片,則提供三份。等待確認。
2 — 來源:應用程式,在指定的參考 (ref) 上
- 讀取該參考 (ref) 上的程式碼,而非工作目錄的程式碼:
git show <ref>:<path>。檢視程式碼以取得字串、符號、間距和顏色;專案的腳本化螢幕截圖(示範模式、測試夾具)則提供比例。絕不能使用包含真實資料的擷取畫面。 - 變更前的狀態來自前一個標籤的原始碼。 根據記憶重建的狀態,在發佈版本所變更的細節上必定是錯誤的。
- 螢幕上的每個字串都存在於該參考 (ref) 上:
git grep -nF -- '<string>' <ref>必須能找到,適用於 UI 文字、選單項目,以及鍵帽上的快捷鍵(搜尋按鍵綁定,而非說明文件)。使用原始碼的語言來製作影片。 - 標題是發佈說明的效益描述,幾個字即可:不是 PR 標題,也不是發佈版本未提供的功能。它們是公開的宣稱。
- 一個預設為關閉的功能,需要在螢幕上顯示其開關。 否則影片會宣傳一個使用者找不到的功能。
3 — 分鏡腳本模式
- 以版本卡片開場和結束:圖示、名稱、「X.Y 版的新功能」、使用強調色顯示的版本號碼。這是第 0 幀和最後一幀,在循環點前後各約 1.5 秒。
- 原地變更。 先展示介面過去一個節拍的樣貌,然後讓變更在該介面上發生:控制項出現在工具列中、列表重新排序、面板長出新區塊。不使用變更前/後的標籤,也不使用分割畫面:過渡本身就是解釋。當變更發生時,將攝影機推近,在使用該功能時拉遠。
- 新的介面從開啟它的元素中生長出來:點擊、選單項目、快捷鍵。快捷鍵會顯示在標題位置的鍵帽上,並在介面回應的節拍上按下。
- 一個主打功能,一個標題,一個互動。 標題在變更發生時才出現,而非之前:觀看者先看到它,然後才讀到它是什麼。
- 一個章節可以擁有自己的顏色。 對於具有燈光的外觀,當每個主打功能發生時,外觀的
keys會重新為它們上色,並在版本卡片處恢復最初的顏色,就像示範影片所做的那樣。當產品的顏色具有特定意義(如帳戶、狀態)時,則省略此功能。 - 其餘的更新日誌以簡短的滾動方式顯示在標題位置,包含一個標籤(「同樣在 X.Y 版中」)和三到五行來自發佈說明的原文,每個節拍一行。僅在其餘內容值得提及時才使用。
- 以實際點擊的更新路徑結束:產品本身的更新路徑(例如「檢查更新…」選單項目、商店按鈕、網站 URL)。然後 UI 收縮回圖示。在選單中,反白顯示的列是游標在該瞬間下方的列,這是根據游標自身的軌跡計算出來的,因此經過某一列時會像真實選單一樣亮起。
- 沒有進度條、章節計數器或「NEW」徽章:標題變更本身就是章節的斷點。
- 原地變更是主要格式,但非唯一格式。 如果套件中的上一部影片已經使用了這種方式,則嘗試變化:說明文字展開成它們所描述的螢幕畫面、使用 3D 深度顯示已變更的介面、在同一幀上進行變更前/後的
擦除、或是新流程的教學。site-promo-film §2 有完整的目錄;發佈影片選擇一種方式,並在其分鏡腳本中說明。 - 一個主要版本可以製作一部長片(1–3 分鐘,每個主打功能一個章節,非循環播放),使用 site-promo-film §2b 的時間軸,並附上用於社群媒體貼文的短剪輯。
3b — 每個點擊都必須被看見
發佈影片主要由點擊組成,而點擊是一個需要觀看者看到結果的節拍。一個 30 秒的剪輯曾經因為移動過快且某些點擊遺漏而播放失敗。經測量:在畫面以 1255 和 1414 px/s 移動時,有兩次點擊發生,且大部分點擊落在距離目標 20-45 pt 的游標上。根據以下規則計時的 60 秒剪輯,測量到每次點擊的游標速度都低於 2 px/s 且距離目標 1 pt 以內。
- 在點擊發生前,攝影機必須已就位。 至少在點擊前約 1.3 秒開始攝影機移動,並僅在 UI 回應後才繼續移動。
- 游標在按下前必須靜止:給每次移動大約兩秒鐘的時間,使用緩慢的彈簧係數(水平 f 0.85,垂直 0.75;短距離跳躍可以更快),使其靜止約半秒鐘。
- 在按下過程中保持靜止,按住足夠長的時間以被看見(按下 0.05 秒,0.14 秒後放開),並帶有較大的漣漪圈;下一次移動最早在按下後 0.3 秒開始。
- 點擊所開啟的內容絕不能遮蓋被點擊的項目:面板從其項目的下方展開,視窗從其所來自的通知旁邊放大,工作表在其按鈕被按下 0.15-0.2 秒後關閉。第一個 60 秒的主版本在按下時將外殼覆蓋在被點擊的項目上,從而將其隱藏;在精確時間點的靜止幀從未顯示它,即使從 mp4 中提取的影格也是如此。
- 檢查它:在確認前執行
node clickcheck.mjs release.html(它會測量攝影機在被點擊點上的位置、按下前的移動距離以及按壓期間的移動量;兩個範本都通過測試),並在渲染後從 mp4 中每個點擊時間點提取一個影格(site-promo-film §7)。 - 在 iPhone 或 iPad 上(簡報中的
frame,site-promo-film §0),點擊是觸碰:不繪製箭頭,且只有在觸碰時才顯示手指(一個柔軟的圓盤,按下時帶有外觀的漣漪)。頁面仍然宣告CLICKS,而curX(t)/curY(t)是手指的位置:它們在兩次觸碰之間跳到下一個觸碰點,並在每次觸碰前後靜止於該點,因此clickcheck.mjs測量觸碰的方式與測量點擊完全相同,且沒有CLICKS的頁面仍然會以退出碼 2 退出。上述所有規則和攝影機相關規則仍然適用。
4 — 版面:一個插槽和一個自由區域
範本會計算攝影機而非手動調整。fit(rect, head) 返回一個攝影機,使得世界座標矩形能夠填充自由區域(在寬螢幕中位於標題插槽旁,在方形版面中位於其下方,或者如果沒有標題則為整個影格),上限為 zmax。三條規則,均在建構示範時測量:
- 當標題顯示時,特寫鏡頭會延伸到介面自身在插槽那一側的邊緣(
toEdge)。僅貼合細節,視窗的其餘部分會滑入標題下方,使標題一半位於畫布上,一半位於深色視窗上。 - 在方形版面中,特寫鏡頭會保留介面的完整寬度,否則其行標籤會在影格的兩側邊緣被裁切。
- 離開的標題會繪製在正在變形的形狀下方,因此視窗會在其上方生長。如果繪製在上方,其淡出的文字會在視窗上顯示半秒鐘。
第二種長寬比是第二種版面配置,而非第一種的裁切:頁面會讀取 location.hash,而 PAGE='release.html#square' 會將雜湊傳遞給 render.mjs。雜湊也可以與外觀結合,使用 & 連接:PAGE='release.html#square&look=night'。
5 — 套件:一個產品的每部影片看起來都像同一齣秀
為一個產品製作的第一部影片(或它的 site-promo 影片)會產生一個套件:字型、顏色代碼、向量格式的圖示、版本卡片、視窗 chrome、攝影機語言、外觀(其預設值和覆蓋值:一行 FX.look)。在使用者指定的位置將其提交到產品程式碼庫中(如果沒有指定,則建議放在 scripts/film/),然後再拋棄工作資料夾。這樣下一個發佈版本就可以從套件開始,而不是從範本開始:只需要一份分鏡腳本,只有內容會改變,而且整個系列是可識別的。在版本卡片上,只有版本號碼會改變。
套件保留的是頁面,而不是引擎。 引擎是技能的一部分,每部影片都需要重新複製。頁面是工作成果:產品介面的向量表示、每個在標籤上來源確定的字串、經過審查回合考驗的時間安排,以及一個說明這些審查回合結果的 README,以便下一位作者知道為什麼一次移動花費了 3 秒而不是 2.5 秒。除非預設值被推翻,否則引擎的版本包含在已交付的影片中。
建構套件: 從範本 + 示範開始,然後將示範的內容替換為產品的內容。運作成功後,刪除所有未使用的部分、捷徑和未在該產品影片中使用的零件,但保留 parts.js 中的零件,因為它們很小。不要保留備註,除非它保留了在審查中生存下來的節奏。保持頁面整潔;工作資料夾中的其他所有內容都是可拋棄的,但 src/release.html 是種子。
6 — YouTube 章節
當一部影片發佈到 YouTube 且時長達到 30 秒(§1,預設值)時,章節是強制性的。在src/ 中以 chapters.txt 的形式提供它們,該檔案由 deliver.mjs 提取為影片說明。格式:
00:00 版本卡片
00:05 [功能標題或核心動作]
00:18 [下一個功能]
…
01:30 更新路徑
章節文字與影片標題的語言相同。對於多於一個的章節:章節之間去抖動 0.1 秒(完全相同時間點的兩個章節會讓 YouTube 感到困惑)。從影片時間軸中提取時間,而不是從節拍網格:t = 3.2 變為 00:03。不包含功能名稱以外的任何內容(「簡介」或「結束」是章節文字,而不是「章節 1」)。
6b — 社交貼文
對於社群媒體貼文(也交付於 deliver.mjs 中,site-promo-film §8),一個簡短的文字行,包含產品名稱、版本、「新功能」以及主打功能的標題。
7 — 執行
render.mjs 在其進度欄中顯示 PAGE=…,因此檢查 release.html 是否被使用。如果沒有,則 cd src/ 並設定 PAGE 環境變數。
一部包含真實鏡頭和點擊的 30 秒發佈影片,在 8 個執行緒、16 個子幀下,從原始碼開始:複製檔案(文件部分上方)、npm i,並在 MacBook M4 Max 上渲染,從 git clone 到 deliver 需要跟蹤:18 分鐘。設定預期。使用 --workers 1 來除錯可能會將渲染時間延長到約 2 小時。對於一部預計時長為 16 秒且鏡頭移動不多的測試/示範影片,渲染時間為 69 秒。