00:00 / 00:00

Persona

自動化

在 控制面板 左側導覽列的追蹤下方,點選自動化即可進入設定面板。一條自動化是一條基於時間軸組織的操作序列,作用於目前作用中場景。自動化可透過鍵盤快速鍵、遊戲控制器按鍵組合啟動,亦可由場景切換、臉部追蹤遺失等系統執行階段事件觸發,或隨時手動執行。藉由自動化,單次觸發即可並行或依序執行多項舞台操作,例如同步啟用濾鏡特效、平移相機機位、切換圖層可見性,或配合伴奏音訊按節拍觸發運鏡。

自動化面板首先呈現應用程式全域的自動化項目清單。當舞台視埠中存在模型時,面板下方將顯示可收合的虛擬形象快速鍵區塊,按模型分組列出 模型自帶的專屬快速鍵;該區塊預設保持展開,並會記住收合狀態。

建立自動化

點擊清單上方的新增自動化按鈕,在下拉選單中選取初始操作類型,並在相鄰選擇器中指定作用目標(無需指定目標的操作將直接顯示新增按鈕;歸屬於虛擬形象分組的 虛擬形象操作 需先選取目標虛擬形象)。系統將基於該動作產生一條新的自動化項目並自動展開設定卡片,輸入游標聚焦於自動化名稱輸入框。

每條自動化都是一張卡片。卡片頂端顯示名稱和觸發條件摘要,右側依序是綁定的按鍵組合、啟用自動化開關和自動化選項選單;播放期間,前方還會出現暫停自動化和停止自動化按鈕。

關閉啟用開關即可停用這條自動化:摘要以已暫停開頭,所有觸發都會被忽略(包括來自 Persona 外部的 API 呼叫),正在播放的時間軸也會立即停止。

點擊標題列可展開或收合卡片。可以在名稱中自訂標題;留空時,標題由各操作名稱以 · 連接而成。卡片主體由上到下依序是 觸發條件、開啟 時間軸面板 的時間軸編輯器按鈕,以及 執行操作 清單。

卡片選項選單包含執行自動化、複製自動化、匯出自動化、背景生效和刪除自動化。

  • 複製自動化:在下方插入一份副本並展開。副本保留所有操作及其時序、觸發條件、冷卻時間和啟用狀態,名稱後加上「副本」;基於安全考量,不複製按鍵組合。
  • 匯出自動化:將這條自動化匯出為獨立檔案(詳見 匯入與匯出)。
  • 背景生效:決定其他應用程式在前景時,這條自動化的快速鍵是否仍能觸發(詳見 背景與焦點快速鍵)。

觸發條件

觸發條件區塊列出了啟動該自動化的所有監聽管道。符合其中任意單一條件即可觸發執行,使用者亦可隨時手動觸發;卡片摘要列即時羅列已設定的觸發類型,未設定任何觸發源時顯示為僅手動執行。

鍵盤、滑鼠或控制器

鍵盤、滑鼠或控制器觸發器始終排在第一位。展開後點擊「設定快速鍵…」開啟錄製視窗,同時按下最多三個按鍵或滑鼠按鍵,再點擊儲存或按 Enter 確認;點擊清除可解除綁定。

回應規則與 虛擬形象快速鍵 相同:

  • 開啟背景生效時,任何組合(包括不帶修飾鍵的單鍵)在其他應用程式位於前景時也能觸發;關閉時只在 Persona 視窗處於焦點時回應。
  • 自動化要求按住的修飾鍵與綁定完全一致:綁定 W 的自動化在按住 Shift 時不會觸發。
  • 錄製器也可綁定同一控制器上最多三個輸入。控制器綁定與鍵盤遵循相同的規則(詳見 控制器快速鍵)。
標記說明
紅色三角目前自動化清單中存在另一項快速鍵佔用了完全相同的按鍵組合

按鍵綁定並非必選項。未分配快速鍵的自動化仍可透過執行階段事件觸發、手動點擊執行,或 經由外部介面調度。

事件觸發條件

點擊新增觸發條件可向自動化中追加以下事件監聽器。每項觸發器均為獨立的可收合條目,標題列直觀概括目前參數(已儲存項目預設收合,新新增項目自動展開),點擊移除觸發條件可將其刪除:

觸發條件觸發時機
麥克風音量音訊輸入訊號振幅越過設定的分貝臨界值
參數值所選模型圖層的指定輸入參數越過預設臨界值
模型載入完成場景中任意模型或指定的特定模型完成資產載入與初始化
動作播放所選模型圖層開始或結束播放動作動畫(可選開始、結束或開始或結束)
場景切換舞台進入或結束任意場景或指定場景(可選進入時、離開時或進入或離開時)
臉部追蹤所選追蹤來源識別到人臉或失去追蹤目標(可選偵測到臉部、失去臉部追蹤或偵測到臉部或失去追蹤)

若參數值與動作播放所綁定的圖層被替換為其他模型資產,原監聽條件將自動失效;當場景中尚未新增虛擬形象圖層時,上述兩項在新增觸發條件選單中呈反灰停用狀態;若目前未設定作用中的人臉追蹤資料源,臉部追蹤選項亦同步停用。

  • 參數值:監聽圖層收到的原始輸入,預設為 MouthOpen,可在參數下拉選單中改為任意臉部、控制器軸向或 隨機脈衝輸入(RandomPulse1 – RandomPulse8,無論是否已繫結到模型參數,均可用作隨機定時觸發來源)。它在 參數對應 之前取值,反映原始追蹤資料,不受模型形變曲線影響。
  • 麥克風音量:使用 口型同步 中選取的麥克風輸入,沿用其增益、雜訊閘和平滑設定。即使關閉了口型同步驅動,它也能正常運作,只是不驅動唇形。
  • 臉部追蹤:追蹤來源明確回報未偵測到人臉,或連續 1.5 秒沒有收到資料時,即判定為失去人臉。
  • 場景切換:由它觸發的操作始終作用於正在進入的目標場景,即使觸發時機設為離開時也是如此。只在編輯器中修改場景設定不算場景切換。

麥克風音量和參數值在訊號越過臨界值時觸發:

設定項說明
升至高於 / 降至低於訊號越過臨界值的方向
臨界值需要越過的數值:麥克風音量為 0 – 1(初始 0.65),參數值為對應輸入來源的原生量程
持續至少越過臨界值後需保持多久才觸發,0 – 60 秒
重設幅度一段死區,訊號須先回落到死區之外才能再次觸發

展開條目可看到重新觸發所需的數值,以及比較目前輸入與臨界值的即時電平表。

麥克風音量、輸入參數及臉部狀態觸發器在建立監聽初始時刻不會因靜止狀態觸發,僅對後續的動態邊緣變化產生回應;當音訊或追蹤訊號中斷後重新恢復時,系統將重新初始化邊緣判定。即使控制面板視窗處於關閉狀態,所有背景事件觸發器仍保持持續監聽。

冷卻時間

冷卻時間用於設定兩次自動化執行之間的最短強制時間間隔,取值範圍 0 – 3600 秒,自上一次序列啟動時開始計時。當自動化正處於重播執行中或處於冷卻保護期內時,接收到的所有外部觸發訊號均被直接丟棄,不進入等待佇列;冷卻計時不會對同一序列內部的後續操作產生任何延遲干擾。

操作

執行操作區塊羅列了目前自動化所包含的操作指令,點擊底部的新增操作可追加新的動作。每項操作均以以下三種時序形態之一排列在 時間軸 上:

操作行為說明調度形態
切換效果開啟、關閉或反轉指定 特效 的啟用狀態單次
套用效果設定將預存的特效參數及開關狀態一次性寫入目前場景單次
暫時效果在指定時間區間內覆寫特效參數,片段結束後恢復場景原始狀態片段
相機位置平滑插值過渡至預存的三維相機機位單次
重設相機平滑插值復位至場景初始的預設取景機位單次
播放相機運動載入 .vmd 運鏡軌跡動畫驅動 3D 相機片段
停止相機運動提前中止自動化運鏡重播,將相機控制權歸還場景單次
相機跟隨讓相機跟隨指定圖層或主模型移動,或取消跟隨單次
相機注視目標轉動相機使指定圖層或主模型保持在畫面中,或取消注視單次
相機對焦保持指定圖層或主模型在景深下合焦清晰,或取消對焦單次
手持晃動開啟、關閉或反轉相機的程式化手持晃動單次
圖層可見性顯示、隱藏或反轉指定 圖層 的可見狀態單次
套用預設以預設本身的轉場將圖層移至已儲存的 場景預設單次
直播模式開啟、關閉或反轉 直播模式單次
切換場景在時間軸啟動前切換至指定的已儲存 場景準備
播放音訊重播素材庫中的指定 音訊檔案片段
控制音訊暫停、繼續或停止指定音訊檔案的所有作用中播放實例單次
設定文字在指定 文字圖層 上暫時顯示動態文字單次
歌詞在指定文字圖層上關聯 .lrc 檔案進行逐行卡拉 OK 伴唱播放片段
切換表情啟用指定表情姿態;若目前已處於啟用狀態則予以清除單次
播放動作播放指定的動作片段,搶占接管目前正在執行的動作通道片段
清除所有表情一次性重設清除所有已疊加的模型表情單次
替換模型在時間軸啟動前將指定虛擬形象圖層資產替換為另一模型準備
模型位置將虛擬形象平滑滑動至預存的空間位置單次

準備類操作始終嚴格優先於時間軸執行:系統依清單順序依序完成目標場景載入及模型資產替換,待目標環境就緒且資產完全載入後,時間軸時鐘方開始計時。準備操作條目在介面中以虛線邊框標識,並註有播放前準備。

單次操作在時間軸的精確時間點瞬間觸發一次(條目標註為在第 X 秒執行),其產生的狀態變更將持續保持,即使中止自動化重播亦不會自動復原。處於同一時間戳記的多個單次操作嚴格按照清單先後順序循序執行。

片段覆蓋一段連續時間(例如標註為 2–7 秒 · 長度 5 秒),結束時釋放所控制的通道:暫時特效恢復為場景設定,運鏡、音訊和動作停止播放。

  • 未裁剪的播放相機運動、播放音訊、歌詞和播放動作片段沿用檔案本身的長度,標註為從第 X 秒開始 · 自動長度。
  • 相機運鏡、同一虛擬形象的動作通道、同一特效、同一文字圖層,同一時間都只能由一個片段控制;音訊片段可以自由重疊。

每條操作均為獨立可收合條目,標題列摘要顯示目前設定。介面同一時間僅展開一列詳細資訊,在時間軸上選定片段將連動展開對應的操作條目。拖曳條目左側控點可調整其在清單及時間軸軌道中的上下堆疊順序,該操作不會改變實際觸發時間點。自動化序列必須保留至少一項操作,最後剩餘的條目禁止刪除。

執行期間,每個條目的標題旁會顯示操作狀態和已用時間:等待執行、執行中…、已完成、已略過、失敗或已取消。音訊和運鏡條目還會顯示百分比進度。將滑鼠游標停在狀態上,可檢視失敗或略過的原因。

目標選擇器會考慮前面的準備操作:序列中有切換場景時,圖層選擇器列出目標場景中的圖層;有替換模型時,列出替換後的模型。

參照的目標被刪除後,條目仍會保留,並顯示警告:場景不存在、圖層已遺失、預設不存在、虛擬形象不存在、模型不存在、表情不存在、動作不存在、音訊不存在、相機運動遺失或歌詞不存在。執行時:

  • 以下操作會自動略過:
    • 圖層已遺失的圖層可見性
    • 預設不存在的套用預設
    • 圖層已遺失或不是文字圖層的設定文字
    • 圖層已遺失、或既不是 VRM 模型也不是 3D 物件的相機跟隨、相機注視目標與相機對焦(相機維持原狀)
  • 其他目標遺失會導致 執行失敗。

以下操作的選項較為簡單:

操作選項
圖層可見性圖層(具體圖層,或執行時指向主虛擬形象的主模型)和切換 / 顯示 / 隱藏,預設為切換
直播模式切換 / 開啟 / 關閉,預設為切換
手持晃動切換 / 開啟 / 關閉,預設為切換
重設相機無需設定。無論相機目前偏移多少,都會平滑回到場景設定的取景

直播模式是唯一修改全域設定、而非場景狀態的操作,因此和 舞台 中的開關一樣,切換場景後仍保持原有狀態。

套用效果設定

新建套用效果設定操作時,會以特效目前的即時參數作為初始快照;之後在條目中修改數值只影響這條自動化,不會改動目前場景。條目包含特效本身的所有滑桿,另有:

  • 觸發時啟用:決定操作執行後特效處於開啟還是關閉狀態。
  • 從目前舞台複製:用視埠目前的即時參數覆寫儲存的快照。
  • 重設為預設值:將參數還原為特效的出廠預設值,觸發時啟用的設定保持不變。

執行該操作時,浮點數值與色彩參數將在 0.4 秒內平滑插值過渡,列舉模式與硬開關則瞬間切換完成。

暫時效果

暫時效果的控制項與套用效果設定相同,另有淡入(秒)和淡出(秒),各最長 10 秒。新建片段預設長度 5 秒,淡入淡出各 0.4 秒;兩段淡變加起來不能超過片段長度。

片段播放期間,儲存的參數接管特效:開頭淡入,結束前淡出。之後特效回到場景中的設定。

  • 暫時參數不會寫入場景設定檔。
  • 播放期間手動調整這個特效,自動化會立即交出它的控制權,直到下次執行。

切換場景

新增該操作時,系統預設擷取目前作用中場景作為目標,使用者可在場景下拉選單中重新導向至其他場景。執行切換時無縫呼叫目標場景預設的 場景轉場 動畫。作為準備步驟,該動作在時間軸時鐘啟動前優先執行;待目標場景啟用載入後時間軸正式開始計時,此時全螢幕轉場動畫可能仍在播放過渡中。

若目標場景目前已處於啟用狀態,該操作僅取消擱置中的其他切換,不進行冗餘的重新載入。若在執行等待期間觸發了更新的場景切換(例如另一條自動化的切換場景、控制面板手動選景或外掛呼叫 scene.activate),系統將直接取消目前的等待執行,不顯示錯誤。若目標場景已被實體刪除,條目顯示為場景不存在,執行將回報錯誤並中斷。

若需透過實體按鍵或遊戲控制器切換場景,只需建立包含切換場景操作的自動化條目,並為其綁定相應的快速按鍵。

套用預設

套用預設提供預設選擇器,列出目標場景中已儲存的 場景預設;如果序列包含切換場景,則列出切換後場景的預設。執行時,圖層依預設本身的轉場方式移動。

  • 如果目標場景中已沒有這個預設,條目會顯示預設不存在,執行時略過。
  • 與其他單次操作一樣,透過自動化套用預設不會產生復原步驟。

若需透過鍵盤快速鍵或遊戲控制器按鍵套用預設,只需建立包含套用預設操作的自動化條目並綁定快速按鍵;Stream Deck 外掛另提供專用的 Apply Preset 按鍵。

相機位置

新建相機位置條目將自動擷取目前視埠相機的機位參數,並支援在面板中直接進行微調:

控制項取值範圍與說明
位置包含 X · Y · Z 三軸座標偏移,配備 3D 空間拖曳控制點
環繞角度水平環繞方位角,範圍 −180° – 180°
俯仰角垂直俯仰角,範圍 −80° – 80°
距離相機至注視點的視距,範圍 0.35 – 20(根據環境模型尺度動態調適擴展)
視角鏡頭焦距視角(FOV),範圍 10° – 90°
注視點相機鏡頭朝向並作為軌道旋轉中心的座標(注視點 X、Y、Z)

點擊從目前舞台複製可用目前視埠相機的取景參數覆寫現有數值,便於在舞台中直觀取景後儲存;點擊預覽位置可驅動視埠相機即時移至儲存的機位;修改參數僅影響目前自動化條目。

若擷取快照時相機處於初始預設取景狀態,條目將標記為預設構圖,僅視角開放編輯,直至使用者點擊設定位置完成自訂。

若需實現多機位連續運鏡,只需在時間軸上為不同相機位置條目分配遞進的時間戳記。若目前場景在 相機 設定中啟用了全域運鏡動畫,該運鏡軌跡將覆寫靜態機位,條目將顯示相應提示。

播放相機運動

播放相機運動允許從 素材庫 中選取 .vmd 格式的相機運動資產,在片段持續時間內獨占驅動 3D 相機運動,片段結束後將視埠平滑歸還場景相機;亦可透過單次的停止相機運動指令提前收回控制權。該操作優先級高於場景 相機 中的全域待機運鏡,且其時間基準嚴格鎖定於自動化時間軸(而非虛擬形象自身的待機動作循環)。因此,暫停自動化或在時間軸上拖曳播放頭時,相機運鏡將同步暫停或精確定位。在自動化暫停期間手動調整舞台相機,恢復播放後相機將平滑重新捕捉運鏡軌跡。

相機跟隨

相機跟隨讓相機跟隨指定圖層或 主模型 移動取景;選擇「無」則停止跟隨。

設定項與 相機:跟隨 相同:圖層、錨點(骨骼或根節點)、旋轉(忽略 / 偏航 / 偏航和俯仰 / 偏航、俯仰和滾轉 / 延遲跟隨)和阻尼。點擊從目前舞台複製可讀取視埠相機目前的跟隨設定。

相機注視目標

相機注視目標讓相機原地轉動,使指定圖層或主模型保持在螢幕的指定區域內;選擇「無」則恢復朝向一般注視點。

設定項與 相機:注視目標 相同:圖層、錨點、螢幕位置(螢幕 X 與 Y)、死區、軟區、偏置、阻尼和預判。點擊從目前舞台複製可讀取視埠相機目前的注視設定。

相機對焦

在場景啟用 景深 效果時,相機對焦將景深焦平面持續鎖定在指定圖層或主模型的特定骨骼錨點上,並支援設定對焦阻尼;選擇「無」則將對焦點恢復至相機注視點。詳見 相機:對焦。點擊從目前舞台複製可直接同步目前相機的對焦設定。

手持晃動

手持晃動用於在自動化執行過程中切換相機的程式化輕微晃動,提供切換、開啟與關閉三種模式(初始預設為切換)。開啟後相機將產生自然呼吸感與微幅晃動;關閉則恢復完全平穩的機械機位。參數設定見 相機:手持晃動。

播放音訊

播放音訊用於播放素材庫 音訊 分類中的聲音檔案,支援設定以下控制項:

控制項可選值與說明
播放可選一次、重複或循環播放直到停止
總播放次數設為重複時的總循環輪次(含首次重播),上限 999 次
音量(%)音訊輸出增益,範圍 0 – 100(預設 50)
淡入(秒) · 淡出(秒)首尾漸變過渡時長,各 0 – 60 秒(預設 0)
再次觸發時衝突處理策略:從頭播放、重疊播放或繼續播放
驅動口型同步關聯唇形驅動:關閉、主模型或場景中指定的特定虛擬形象

淡入作用於第一次播放的開頭,淡出作用於最後一次重複的結尾;設為循環播放時,只在主動停止時淡出。

再次觸發時決定前一次播放尚未結束、操作又被觸發時的行為:

  • 從頭播放:立即結束之前的播放,從頭開始。
  • 重疊播放:再開一個並行的播放實例,與原本的重疊混音。
  • 繼續播放:忽略這次觸發,原音訊繼續播放。

不同條目播放同一音訊檔案時互不影響。

啟用驅動口型同步後,指定的虛擬形象將在音訊重播期間自動解析音訊波形驅動唇形(詳見 口型同步)。主模型動態指向音訊觸發時刻的主導虛擬形象。

條目標題列會顯示播放狀態和已播放時間,重複播放時還會標出目前次數(如第 2/3 次播放)。狀態包括正在載入…、播放中、循環播放中、已暫停、正在停止…、已完成、已停止和失敗。時間軸片段結束時,音訊隨之停止。

控制音訊對指定音訊檔案的所有播放實例執行暫停、繼續或停止(預設為停止),無論播放來自自動化還是素材庫。選取停止時,音訊會先完成設定的淡出再停止。

設定文字

設定文字允許在時間軸的指定時間點向指定的 文字圖層 推送一段動態文字內容。該操作僅暫時改變舞台畫面,既不寫入 scenes.json 場景設定檔,也不產生復原步驟。暫時文字將一直保持,直到該文字圖層觸發恢復已儲存文字操作、在屬性面板中手動修改儲存的文字,或該圖層被移出舞台。若執行階段目標圖層不存在或並非文字圖層,該操作會自動略過。

歌詞

歌詞操作允許在指定 文字圖層 上綁定素材庫中的 .lrc 歌詞檔案,隨時間軸驅動卡拉 OK 風格的逐行歌詞伴唱播放:

  • 自動對齊伴奏:新增歌詞操作時,系統會自動繼承同一自動化中第一個播放音訊片段的起始時間點、來源起點(Source In)與持續長度;若音訊為原生未截斷播放,歌詞片段亦保持原生自動長度(即以歌詞檔案自身時間為準,而非強制截斷於音訊終點)。新增完成後,兩者的片段時序完全分離獨立。
  • 長度推導:歌詞檔案的原生長度優先讀取中繼資料 [length:] 標籤;若未提供,則推導至最後一個歌詞單字的結束時間戳記;若均無則推導至最後一行起始時間戳記順延 5 秒。若歌詞片段的持續長度超出檔案本身長度,文字圖層將停留在最後一行文字狀態直至片段結束。
  • 兩行輪播:為防止歌詞重新整理時視線跳動,文字圖層始終以兩行固定版面配置呈現目前行與下一行歌詞(偶數行顯示在頂部,奇數行顯示在底部),各行在原位重新整理而不發生垂直跳位;在首行歌詞起唱前,兩行均呈現未唱狀態。
  • 逐字著色與逐行點亮:增強型 LRC 格式(包含 <分:秒.毫秒> 標記)支援逐字精準擦除著色;普通標準 LRC 則在每行起始時間點整行點亮。已唱部分字型的填滿色與邊框樣式由文字圖層自身的已唱顏色與已唱邊框決定。
  • 時間標籤解析:支援 [offset:] 整體微調偏移(正偏移提前顯示);針對重複時間戳記,保留首個包含文字的行;空時間戳記行將作為前一行的結束截斷標誌。檔案編碼自動按 BOM 辨識 UTF-8 或 UTF-16,無 BOM 時優先按 UTF-8 解析,失敗後切換回 GB18030。
  • 狀態恢復:當歌詞片段到達右側邊界結束、自動化被使用者手動停止或重播異常中斷時,該文字圖層將立即恢復為其自身原本儲存的文字內容(包含先前已生效的暫態文字)。
  • 驗證保障:若參照的歌詞檔案遺失、解析損壞,或目標文字圖層不存在/非文字圖層,自動化將在啟動前直接回報錯誤並中止,避免異常執行。

虛擬形象操作

切換表情、播放動作、清除所有表情、替換模型和模型位置作用於虛擬形象選擇器選定的對象:可以是某個虛擬形象圖層,也可以動態指向主模型。

表情選擇器和 Live2D 動作選擇器直接讀取模型中繼資料,無需先將模型載入舞台。VRM 模型的動作則透過「選擇動作…」在 素材庫 中選取,包括內建動作包和自訂匯入的片段;也可以點擊「開啟檔案…」即時匯入本機檔案。

模型位置可將虛擬形象目前的姿態座標儲存為快照,並支援使用標準的 2D 或 3D 變換控制項進行微調;修改參數不會直接移動模型,點擊從目前舞台複製可重新擷取視埠座標,操作執行時虛擬形象將平滑滑行至目標座標。替換模型作為準備步驟,在保留原圖層空間變換的前提下於時間軸啟動前預載新資產。若執行階段綁定的表情、動作或虛擬形象已失效,執行將直接回報錯誤並中斷。

Live2D 模型的播放動作片段始終要求自起始影格完整播放,系統禁止對其執行時間軸首部裁剪或中途跳播。VRM 動作片段支援自由裁剪與播放頭拖曳跳轉,但物理彈簧骨骼不會追溯模擬跳轉點之前的慣性軌跡。

時間軸編輯器

在展開的自動化卡片中點擊時間軸編輯器,將在控制面板底部(橫跨左右雙欄)展開一個停駐式時序編輯工作台。切換瀏覽其他卡片時,時間軸編輯器保持與目前自動化綁定;在時間軸軌道中選定片段,對應的卡片條目將自動捲動並高亮呈現。點擊關閉時間軸編輯器可將其收合,拖曳面板頂部分隔線可調整編輯區高度。

編輯器頂端工具列:

  • 左側:復原時間軸編輯、重做時間軸編輯、在播放頭處分割、複製所選操作、刪除所選操作和新增標記
  • 右側:播放(播放時變為暫停)、停止和關閉時間軸編輯器

工具列下方,左側是操作清單,右側是多軌時間軸,頂端有標明目前時間與總長度的走帶滑桿。

互動手勢/按鍵回應行為
單擊片段選定片段並連動展開對應操作條目;按住 Shift、⌘ 或 Ctrl 執行多選追加
在軌道空白處框選框選觸碰到的所有時間軸片段
拖曳選定片段整體平移選取範圍內的所有片段時序
拖曳片段邊界執行長度裁剪。裁剪音訊、歌詞、動作或運鏡片段的起點將連動調整來源起點(即媒體內部的起播偏移量)
← →按吸附格線微調選取範圍時序(按住 Shift 步進 10 倍,按住 Alt 採用最小步長微調)
⌘/Ctrl + D原地複製目前選定片段
Delete刪除目前選定片段
Alt + 滾輪以目前滑鼠指標為中心縮放時間軸檢視,最大支援 64× 放大
拖曳時按住 Alt暫時繞過格線吸附限制
Esc取消目前拖曳變換操作

軌道下方的屬性列可精確設定時間(單位均為秒):開始時間,片段的結束和持續時間,以及媒體的來源起點。點擊使用來源媒體長度可將音訊或歌詞片段還原為來源檔案的完整長度。

以下兩項均不改變實際播放時序:

  • 鎖定時間:清單項目旁的開關,防止誤拖曳或意外裁剪。
  • 新增標記:放置用於吸附定位和快速跳轉的標記。

在清單中拖曳條目控點可調整軌道的上下順序,拖曳清單右側的分隔線可調整清單寬度。

時間軸編輯遵循以下規則:

  • 移動、裁剪或刪除某個片段不會影響其他片段,空出的間隔也不會自動合攏。
  • 在播放頭處分割可在播放頭位置將選定的片段一分為二;淡入淡出區間內不能分割。
  • 控制相機運鏡、同一虛擬形象動作通道、同一特效或同一文字圖層的片段不能重疊。重疊的片段會標紅,解決衝突前自動化無法執行。
  • 每次修改都會產生復原步驟,可用 ⌘ + Z / ⌘ + Shift + Z 復原與重做(Windows 與 Linux 下為 Ctrl + Z / Ctrl + Y)。
  • 正在播放的序列繼續依觸發時的快照執行,不受編輯影響。

點擊右下角齒輪圖示可展開時間軸設定:

設定項說明
在舞台上預覽預設開啟。拖曳走帶滑桿時,舞台視埠即時呈現目前時間點的媒體、暫時特效與圖層可見性狀態(準備操作與其他單次操作不執行)
時間軸吸附可選關閉吸附、0.1 秒(預設)、0.5 秒、1 秒或 30 FPS 格線。片段同時對齊相鄰片段邊界與標記線
時間軸縮放提供符合檢視範圍以及 2× 至 64× 縮放倍率
自動長度預設開啟:當所有媒體長度確定後,時間軸自動以最後結束的操作為終點;未包含媒體時預設固定為 30 秒
序列長度(秒)關閉自動長度後手動指定時間軸總長度(上限 1 小時),允許在序列尾部留出靜默緩衝區

開啟在舞台上預覽後,圖層可見性條目(以及修改圖層可見性的套用預設條目)會隨播放頭位置即時追格計算:拖曳走帶滑桿時,舞台直接預覽播放頭所在時刻各目標圖層的顯隱狀態,而不寫入場景存檔,圖層清單中的眼睛圖示仍保持已儲存狀態,直到正式播放經過該時間點時才實際寫入。在播放或預覽期間,若透過眼睛圖示、場景預設或外掛 API 手動修改了某個圖層的儲存可見性,自動化會立即將該圖層的控制權交還場景,直到點擊停止、播放或編輯該自動化為止。

點擊播放將從目前播放頭位置啟動執行(若自動化先前處於停止狀態或前置準備步驟發生過改動,會先執行準備步驟,並將目前追格計算出的圖層可見性寫入場景後繼續播放),即使該自動化目前處於停用或冷卻狀態亦可完整試播至序列末尾;點擊暫停後再次點擊即可在暫停處斷點續播。點擊停止將立即終止目前執行,截斷音訊輸出,平滑淡出正在執行的動作,復原暫時特效與預覽中的圖層可見性,並將播放頭復位至 0 秒。移動走帶滑桿不會觸發準備步驟或除圖層可見性以外的單次操作。

執行自動化

除了觸發條件,還可以透過以下方式執行自動化:

  • 卡片選項選單:執行自動化
  • 攝影棚模式:在相機設定中選定自動化,從首個影格到最後一格完整錄製成影片
  • Web 控制台:自動化頁面
  • Stream Deck:Run Automation 按鍵
  • 外掛 API 與 MCP 伺服器:automation.run(以及時間軸走帶控制介面 automation.control)

這些方式都不佔用鍵盤快速鍵,很適合在外部控制器上密集配置動作。除了在桌面端介面編輯外,具備 automation-editing 與 automation-transport 能力的用戶端也可透過 外掛 API 讀取、建立、更新、刪除自動化或驅動時間軸走帶(透過 API 新建的自動化預設處於停用狀態且不綁定快速鍵)。已停用的自動化無法透過 automation.run 或外部快速按鍵觸發,但可在桌面端時間軸編輯器或透過 automation.control 走帶指令強制試播。

序列啟動後,系統首先執行前置準備,隨後啟動時間軸時鐘調度:單次指令與時段片段依照時間戳記精準調度執行,時間軸上的空閒間隔自然計時流逝;時間軸推進至序列終點時,仍在持續的一切媒體與效果統一停止。相關媒體資源在時鐘啟動前預載完畢;若某一片段到達執行時間點而外部大檔案尚未載入就緒,系統將暫停等待載入完成,確保動作與音訊節拍絕對對齊。

重播期間,自動化卡片標題列將伴隨時間軸進度自左向右填滿半透明強調色,正在播放音訊或運鏡的條目亦醒目提示閃爍。若執行遭遇未擷取異常,自動化將在出錯時刻停滯凍結,錯誤資訊直觀顯示於故障條目下方;在使用者手動點擊停止前,該自動化拒絕回應後續觸發。

場景切換將強制終止所有正在執行的自動化序列;停用或刪除某項自動化將立即中斷其自身的活動實例。開啟按鍵錄製彈出視窗將暫停正在播放的自動化,錄製器開啟期間抑制一切新的自動化啟動。自動化序列支援鏈式連動觸發(例如透過切換場景進入另一自動化監聽的場景,或透過播放動作與替換模型觸發相應的事件監聽),但同一輪觸發中每項自動化最多執行一次,避免無限循環。鍵盤按鍵、手動點擊、API 呼叫或硬體感測器輸入均會開啟一條新的觸發鏈,而在時間軸上拖曳預覽不會觸發任何自動化。

匯入與匯出

清單上方的匯入與匯出工具列提供匯入自動化和全部匯出;只匯出單一自動化時,使用卡片選項選單中的匯出自動化。

匯出的檔案為 JSON 格式,包含序列時序、操作、觸發條件和冷卻時間,透過 UUID 參照場景、圖層、模型和媒體資產,但不內嵌媒體檔案本身。檔案宣告了官方 JSON Schema,可在 VS Code 等編輯器中即時驗證和補完。

點擊匯入自動化後,系統將預先對檔案資料結構進行完整合規驗證;任何版本不相容或包含損毀操作/觸發器定義的檔案將被整體驗證攔截。成功匯入的項目將追加至清單底部,預設處於停用狀態且清除所有按鍵組合。若目前裝置缺失某些參照的場景、模型或媒體檔案,相關條目將顯示缺失警告,在重新指定可用資產前請逐項複核目標設定。

虛擬形象快速鍵

每個模型的快速鍵均擁有獨立的收合區塊,位於應用程式自動化清單下方。組頭標明模型格式圖示與名稱(主模型 額外帶有星標標識),各組收合展開狀態依模型獨立記憶;右側開關負責控制該分組是否回應輸入;分組內包含新增虛擬形象快速鍵入口及該模型的各條快速鍵條目。在桌面端與 Web 控制台中,鍵盤總開關與快速鍵控制項均完整保留在對應模型的專屬區塊內。每列快速鍵均標有格式圖示,暫留提示註明隨「模型名」一起儲存。

虛擬形象快速鍵歸屬於模型資產本身而非應用程式全域。每個模型均儲存各自的快速鍵設定,因此按鍵綁定可以隨模型在不同裝置之間移轉,並直接相容 Persona 與 VTube Studio。

舞台上的所有作用中模型均可獨立回應自身的快速鍵綁定,無論其是否為主模型、Live2D 還是 VRM 資產均遵循相同機制(與 VTube Studio 保持完全一致)。主模型分組預設排在首位。若同一模型資產被新增至兩個不同圖層,清單僅呈現一組快速鍵定義(快速鍵寫入模型私有設定檔,多圖層共享);模型離開舞台時,對應控制分組自動隱藏。

新增快速鍵

在對應模型分組中點擊新增虛擬形象快速鍵,選取目標動作類型(分組以模型名稱命名,每個動作均配有專屬圖示,清單項目亦使用相同圖示標識),隨後在相鄰選擇器中指定作用對象:

操作功能說明
切換表情啟用所選表情,若已啟用則予以清除(與模型控制面板中的表情開關按鈕行為一致)
播放動作播放指定的動作片段,接管目前正在播放的動作通道;單次播放完成後結束(即使動作檔案內部標記了循環亦然)
清除所有表情一次性清除所有已疊加的表情形態,包括被正在播放的動作所壓制的表情
替換模型將目前圖層資產熱替換為另一模型(支援跨格式切換,如從 Live2D 切換至 VRM;選擇器自動排除目前已載入模型)

上述操作針對目前分組對應的模型生效,不論模型格式,VRM 模型的表情與動作同樣支援綁定。對於切換表情與播放動作,除了在此處新增外,也可以直接在模型面板中展開任意表情或動作按鈕右側的下拉選單並選擇「設定快速鍵…」(多動作群組為設定快速鍵子選單),或在 Live2D 表情編輯器 與 動作錄製/編輯器 對話框內直接綁定。當模型未定義動作或表情時,對應的選擇器將自動停用;替換模型下拉選單羅列已註冊模型中除自身以外的所有可用資產,清單為空時同樣停用,且替換操作僅作用於目前模型所處的特定圖層。

新新增的快速鍵初始處於未綁定狀態。點擊「設定快速鍵…」喚出錄製彈出視窗,按下目標按鍵組合,隨後點擊儲存或按下 Enter 確認;點擊清除可重新解除按鍵對應。

錄製彈出視窗處於開啟狀態時,任何快速鍵都不會觸發,因此按下已綁定的組合鍵只會被錄入彈出視窗,而不會誤觸發既有的快速動作。

錄製器同時支援遊戲控制器輸入,允許對應單一控制器上的最多三個控制項(涵蓋搖桿與十字鍵的方向軸以及線性扳機,詳見 控制器快速鍵)。

單一快速鍵最多由三個按鍵或滑鼠按鍵組成,修飾鍵、一般按鍵與滑鼠左鍵、中鍵、右鍵可任意搭配:既可以是 E + 1 這樣的兩個一般按鍵,也可以只是單一修飾鍵或單一滑鼠按鍵。該上限對應 VTube Studio 設定檔為每個快速鍵分配的三個觸發槽位,因此 VTube Studio 模型內附的此類組合匯入後可直接使用。組合依同時按住的按鍵集合判定,與按下順序無關:E + 1 與 1 + E 視為同一組合,重複綁定警告同樣據此判斷。顯示時修飾鍵排在最前,其餘按鍵保留錄製時或設定檔中的順序;修飾鍵遵循目前系統的命名習慣,在 macOS 上顯示為 ⌥ 與 ⌘ 而非 Alt 與 Win。

錄製器依按下順序記錄每次按下時同時按住的所有按鍵與滑鼠按鍵;在彈出視窗內(視窗按鈕及其底部按鈕列除外)點擊即可錄入滑鼠按鍵。修飾鍵只有在單獨按下並原樣放開時才會錄為單鍵,因此按下 ⌘/Ctrl + Enter 這類組合的途中不會誤錄單一修飾鍵。控制器按鈕只能與同一控制器的按鈕組合,不能與鍵盤或滑鼠混用。

每個快速鍵條目的選項選單均提供觸發選項,便於在設定過程中即時測試動作。凡是 Persona 執行階段拒絕執行的狀態,該測試選項均自動停用:包括不支援的 VTube Studio 動作、模型端停用的條目,以及組頭總開關處於關閉狀態時的所有子項。

播放方式

對於切換表情與播放動作兩類快速鍵,條目選項選單中提供了進階重播參數設定。上述選項完全對應 VTube Studio 的同名參數,並在兩款軟體的設定檔中保持雙向互通:

選項功能說明
按住時生效表情形態僅在按鍵組合持續按住時保持啟用,放開按鍵立即淡出。預設關閉
淡入淡出時間本次狀態切換採用的平滑過渡時長;選取預設則沿用表情或動作資產檔案內部定義的時長
自動關閉時間表情啟用後持續該時間自動結束清除;選取永不則保持常駐啟用
播放時長上限適用於Live2D 動作重播的最長截止時間;選取永不則完整播放動作片段的原生長度
停在最後一格適用於Live2D 動作播放完畢後持續定格在最終姿態影格,直至該快速鍵被二次觸發結束;結束後各參數在動作的淡出時間內平滑回到靜止狀態。預設關閉

按住時生效與自動關閉時間僅適用於表情條目,停在最後一格與播放時長上限僅適用於 Live2D 動作條目(VRM 動作片段遵循標準播放邏輯)。兩類時間參數均預設了常用檔位,當資產設定檔中儲存了非標準自訂數值時,選單將同步列出。

按住時生效機制依賴於系統能夠準確擷取實體按鍵的放開事件(Key Up):組合中任意一個鍵放開,表情即淡出。鍵盤、滑鼠與控制器快速鍵無論是否在背景生效均能正常偵測放開。透過條目選單中的觸發按鈕、Stream Deck、MCP 或 外掛 API 發起的外部觸發不存在實體放開事件,系統統一依切換模式調度。

由開啟了按住時生效或自動關閉時間的快速鍵所啟用的表情,不會被 記住表情 儲存,避免在按住按鍵時儲存場景導致下次載入模型時殘留暫時表情。

背景與焦點快速鍵

每項自動化與虛擬形象快速鍵的選項選單中均包含背景生效開關,決定該組合鍵在外部其他應用程式處於前景焦點時是否仍可觸發。目前確實能在背景觸發的條目在介面中以地球圖示清晰標明。

Persona 不向作業系統註冊全域快速鍵,而是直接讀取按鍵狀態,因此任何組合(包括不帶修飾鍵的單鍵)都能在背景生效。前景應用程式照常收到每一次按鍵,不會被 Persona 攔截,也不存在與其他應用程式爭搶同一組合鍵的問題;macOS 上也無需授予「輸入監控」權限。滑鼠按鍵與遊戲控制器組合遵循相同規則。

  • 背景生效的單鍵在其他應用程式中打字時同樣會觸發;如不希望如此,請關閉該條目的背景生效,或改用帶修飾鍵的組合。單獨綁定的滑鼠按鍵同理,在任何應用程式中點擊都會觸發。
  • 關閉背景生效的條目只在 Persona 的舞台視窗或控制面板視窗處於焦點時回應。
  • 在 Persona 的文字輸入框中打字不會觸發任何快速鍵。
  • Wayland 不提供讀取按鍵狀態的途徑,因此所有快速鍵只在舞台視窗處於焦點時生效,含滑鼠按鍵的快速鍵則完全無法觸發。
  • 滑鼠按鍵以輪詢方式讀取,短於一次輪詢(約 16 毫秒)的按下(例如觸控板輕點)可能無法辨識,這與 VTube Studio 相同。
  • 在非 QWERTY 鍵盤配置的 Mac 上,字母鍵依該字母在美式鍵盤配置中的位置觸發,可能與鍵帽上的字母不同。

兩個快速鍵共用同一組合鍵時

當兩個虛擬形象快速鍵綁定了完全相同的按鍵組合時,兩者在按鍵按下時將同時觸發執行,對應條目均將標註警示三角形。該行為與 VTube Studio 完全一致,允許使用者透過單一按鍵複合觸發多個動作(例如同時啟用兩組互補表情),但在意外衝突時亦提供了明確的視覺提示。

歸屬於不同模型的兩條快速鍵若共享同一組合鍵,同樣會同時觸發,分別作用於各自的模型(例如透過單一快速鍵同步控制虛擬形象與獨立的手持道具模型)。VTube Studio 對這類跨模型按鍵衝突不作任何警示,Persona 則統一以警告三角形清晰標註。

自動化擁有絕對的執行優先級:當按鍵組合分配給某項自動化時,系統僅執行自動化序列,同一按鍵上的虛擬形象快速鍵將被抑制封鎖;若兩條自動化項目共用同一組合鍵,系統僅執行在清單中排序靠前的一項。相關條目均會標註警告三角形。

組合在其最後一個鍵按下時觸發。虛擬形象快速鍵與 VTube Studio 一致,不檢查同時按住的其他鍵(例如按住 Shift 再按 W 仍會觸發綁定 W 的虛擬形象快速鍵,方便以鍵盤或 WASD 操控的模型);自動化則要求按住的修飾鍵與綁定完全一致,並只在完全相符時從虛擬形象快速鍵手中接管該組合。

所有快速鍵均內建了硬體級的防抖連擊保護,持續長按按鍵僅激發一次觸發動作,不會引發無限連擊。

存放位置

模型類型設定寫入路徑
包含 .vtube.json寫入該檔案本身的快速鍵設定區段,遵循標準的 VTube Studio 格式規範
缺少 .vtube.json寫入模型主進入點檔案同級目錄下的 <model>.persona.json 隨附設定

Persona 原地編輯更新上述設定檔,並完整保留所有未識別的擴充欄位。對於參照了 Persona 尚未支援的 VTube Studio 進階操作的快速鍵條目,介面會反灰列出並標記為不支援,執行階段不會觸發,寫回檔案時原封不動,確保在 Persona 中修改快速鍵不會破壞現有的 VTube Studio 設定。

播放方式 中的進階設定欄位完全沿用 VTube Studio 原生欄位,在兩類設定檔中均能規範儲存;Persona 僅序列化寫入使用者實際修改過的設定項,未觸碰的預設欄位保持原樣。兩者存在一處格式差異:.vtube.json 中的淡入淡出時間強制為數值類型(選取預設時寫入為 0.5 秒),而 .persona.json 允許省略該欄位,直接在執行階段遵循模型原始資產的時序定義。

處於唯讀狀態的設定檔不會寫入,此時所做的修改不會儲存。

最後更新於 2026年11月4日

Tech otakus destroy the world