HyperFrames Studio 慣例
Studio 會為每個頂層元素繪製一條時間軸列。遵循以下規則的專案會顯示為簡短、可讀的時間軸;不遵循的專案會顯示為一堆無法編輯的未標籤列。這些是用於建置內容的慣例。
若要修改剪輯片段,請遵循 /hyperframes-core 的 references/creator-editing-recipes.md,切勿自行發明不同形式的相同編輯操作。
1. 每個場景都是一個子合成
根合成僅包含計時主機、媒體和音訊。任何具有巢狀結構的場景(包含子元素的 div、帶有副標題的標題、圖表)都應作為獨立的檔案,並使用 data-composition-src 載入,接線方式請參考 references/sub-compositions.md。
留在根合成內部的巢狀標記不會成為獨立的列。它會隱藏在一個不透明的列中,無法逐段修剪或移動。
請以結構檢查會拒絕任何違規的方式來編寫。
2. 一條字幕軌道
- 所有字幕都位於一條軌道上:一個單一的子合成主機(一個
data-track-index)標記為data-track-kind="captions",按順序承載所有字幕群組。 - 絕不每個字幕群組一條列,也絕不將字幕與其他種類混合在同一條軌道上。
- 字詞時間規則不變:請參閱
/embedded-captions和caption_*lint 規則。
3. 每條軌道一種元素類型
按類型分組,使每一列代表用戶可以選擇、靜音或拖動的單一物件集合。
| 類型 | data-track-kind |
|---|---|
| 基礎影片 / A-roll | video(來自標籤) |
| 場景、疊加層、圖形 | graphics |
| 字幕 | captions |
| 音訊(旁白、音樂、音效) | audio(來自標籤) |
在子合成主機上設定 data-track-kind。影片和音訊類型來自標籤,因此 <video> 和 <audio> 不需要屬性。為每種類型指定各自的 data-track-index;該數字僅供顯示,不會改變渲染層級。請使用 CSS 進行分層。
4. 安全區域
任何標尺或安全框疊加層都應位於預覽窗格中,絕不放在合成內部,因此請勿在 HTML 中加入引導元素。
兩種畫面比例(寬螢幕和直立)都使用相同的兩個安全框,即 Premiere 的預設值。預覽切換按鈕會在每個邊的中點繪製一個刻度來顯示它們。來源:packages/studio/src/utils/previewSafeMargins.ts 中的 ACTION_SAFE_PERCENT 和 TITLE_SAFE_PERCENT。
| 安全框 | 佔畫面比例 | 每邊內縮比例 |
|---|---|---|
| 動作安全框 | 90% | 5% |
| 標題安全框 | 80% | 10% |
- 安全邊距:所有可見內容都應保持在動作安全框(90%)內部,而字幕和關鍵內容則應保持在標題安全框(80%)內部。
- 雙欄和 50/50 佈局應使每半邊的內容保持在標題安全框內部。
檢查你的工作
執行 hyperframes lint 並修復所有發現的問題。然後在 Studio 中開啟專案,檢查時間軸是否顯示一條基礎列、每個場景主機一條列、一條字幕列以及音訊列。