00:00 / 00:00

Persona

自動化

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

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

建立自動化

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

每條自動化均以獨立卡片形式呈現。卡片頂端顯示項目名稱及觸發條件摘要,右側依序排列綁定的按鍵組合、啟用自動化開關以及自動化選項選單;重播播放期間,控制區前部還將呈現暫停自動化與停止自動化控制按鈕。關閉啟用開關將停用該自動化:摘要前綴變更為已暫停,系統將忽略一切觸發事件(包括來自 Persona 外部的 API 呼叫),正在執行中的時間軸序列亦會立即中止。

點擊卡片標題列可展開或收合詳細資訊。在名稱欄位中可自訂項目名稱;若保持留空,系統將自動使用各操作名稱並以 · 連接作為卡片標題。卡片主體自上而下依序為 觸發條件、用於調出 時間軸面板 的時間軸編輯器入口,以及具體的 執行操作 清單。

卡片選項選單提供執行自動化、複製自動化、匯出自動化、背景生效(詳見 背景與焦點快速鍵)以及刪除自動化功能。選取複製自動化將在目前項目下方插入一份完整副本並自動展開:副本完整繼承所有操作時序、觸發條件、冷卻時間及啟用狀態,名稱追加「副本」後綴,但基於安全性考量不繼承按鍵組合。匯出自動化可將該條目持久化匯出為獨立檔案(詳見 匯入與匯出)。

觸發條件

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

鍵盤或控制器

鍵盤或控制器觸發器始終置於首位。展開該項目後,點擊「設定快速鍵…」喚出按鍵錄製彈出視窗,按下目標按鍵組合,隨後點擊儲存或按下 Enter 鍵完成綁定;點擊清除可解綁現有組合。其回應規則與 虛擬形象快速鍵 完全一致:包含 Ctrl、Alt 或 Cmd 修飾鍵的組合鍵支援在其他應用程式處於前景時全域生效;未包含上述修飾鍵的普通按鍵僅在 Persona 視窗處於焦點啟用狀態時回應。錄製器亦支援對應同一控制器上的最多三個實體按鍵組合,控制器綁定無需修飾鍵即可原生支援背景無訊息生效(詳見 控制器快速鍵)。

標記說明
紅色三角目前自動化清單中存在另一項快速鍵佔用了完全相同的按鍵組合
琥珀色三角該按鍵組合已被作業系統中的其他第三方應用程式獨占註冊

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

事件觸發條件

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

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

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

參數值直接監聽圖層接收的原始訊號通道(初始預設為 MouthOpen,可在參數下拉選單中重新導向至任意臉部表情或控制器軸向輸入),其取樣點位於 參數對應 管線之前,因此其數值直接反映原始追蹤輸入,不受模型內部形變曲線影響。麥克風音量直接複用在 口型同步 中選定的實體麥克風輸入串流,繼承其增益、雜訊閘門檻與平滑濾波設定;即使使用者關閉了口型同步驅動,該監聽器仍可正常運作(僅不驅動虛擬形象唇形動作)。

當追蹤來源明確回報未偵測到人臉,或連續 1.5 秒未接收到任何追蹤資料影格時,系統即判定為人臉追蹤遺失。由場景切換觸發的操作始終作用於正在遷入的目標場景(即使觸發時機選定為離開時亦然);單純在編輯器中修改場景設定不視為觸發場景切換。

兩類數值臨界值觸發器遵循統一的訊號判定邏輯:觸發方向可選升至高於或降至低於,當訊號振幅越過臨界值後,必須持續至少設定的穩定時長(範圍 0 – 60 秒)方可激發執行。若需再次觸發,輸入訊號必須先回落至重設幅度死區之外;展開條目後,介面將動態標明重新觸發所需的數值邊界,並以即時電平儀表呈現目前輸入與臨界值的相對關係。麥克風音量正規化範圍為 0 – 1(初始臨界值 0.65);參數值則遵循對應輸入源的原生量程。

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

冷卻時間

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

操作

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

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

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

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

片段操作覆蓋一段連續的時間區間(例如標註為 2–7 秒 · 長度 5 秒),並在區間終點主動釋放所佔用的控制通道:臨時特效平滑恢復至場景基礎設定,運鏡動畫、音訊媒體與動作播放自然停止。未經裁剪縮放的播放相機運動、播放音訊、歌詞與播放動作片段預設沿用檔案原生長度,標註為從第 X 秒開始 · 自動長度。相機運鏡、同一虛擬形象的動作通道、同一特定特效以及每個文字圖層在同一時間片內僅允許被單一活動片段獨占控制;多個音訊片段支援自由重疊混音。

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

重播執行期間,各條目標題旁將即時呈現該動作的執行狀態——等待執行、執行中…、已完成、已略過、失敗或已取消,並附帶執行耗時;音訊與運鏡條目則呈現重播百分比進度列。將滑鼠游標暫留於狀態標籤上可檢視操作失敗或略過的詳細診斷資訊。

操作的目標綁定連動繼承自前置準備步驟:若序列包含切換場景,則後續選擇器將自動索引目標場景中的圖層;若包含替換模型,則自動索引替換後的新模型資產。若參照的外部目標資產被刪除,條目將保留並標紅顯示為場景不存在、圖層已遺失、預設不存在、虛擬形象不存在、模型不存在、表情不存在、動作不存在、音訊不存在或相機運動遺失。重播執行時,圖層已遺失的圖層可見性操作與預設不存在的套用預設操作將自動無訊息略過,而其他關鍵資產遺失將導致 整體執行失敗。

圖層可見性條目配備圖層選擇器(可選具體圖層,或動態指向執行瞬間主導形象的主模型)以及切換 / 顯示 / 隱藏行為選項;直播模式與手持晃動條目配備切換 / 開啟 / 關閉選項,初始預設均為切換。直播模式是唯一直接修改全域應用程式設定而非場景瞬態狀態的操作,因此其生效狀態在切換場景後依然持久保持。重設相機不依賴快照資料:無論目前視埠機位如何偏移,其均平滑插值復位至目前場景初始設定的取景視界。

套用效果設定

新建套用效果設定條目時,系統會自動擷取目前場景中該特效的即時參數作為初始快照;此後在條目中調整數值僅對該自動化生效,不干擾目前場景。該條目包含該特效的所有原生滑桿控制項,並附带觸發時啟用開關(決定操作執行後該特效的啟閉狀態)。點擊從目前舞台複製可用視埠目前畫面的即時參數覆寫預存快照;點擊重設為預設值可將參數還原至濾鏡出廠預設狀態,同時保留現有的觸發時啟用設定。

執行該操作時,浮點數值與色彩參數將在 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 次播放)。當時間軸片段到達終點時,音訊實例將強制停止。

控制音訊用於對其參照的目標音訊檔案執行全域傳輸控制(可選暫停、繼續或停止,預設停止),該控制同時作用於由自動化或素材庫發起的所有並行播放實例。選取停止時,正在重播的音訊將等待其設定的淡出時長完全釋放後靜音結束。

設定文字

設定文字允許在時間軸的指定時間點向指定的 文字圖層 推送一段動態文字內容。該操作以暫態模式(transient)直接生效於舞台算繪管線:既不寫入 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 小時),允許在序列尾部留出靜默緩衝區

點擊播放將從目前播放頭位置啟動執行(前置準備步驟優先執行),即使該自動化目前處於停用或冷卻狀態亦可強制試播;點擊暫停後再次點擊即可在暫停處斷點續播。點擊停止將立即終止目前執行,截斷音訊輸出,平滑淡出正在執行的動作,復原暫時特效並將播放頭復位至 0 秒。移動走帶滑桿不會觸發單次操作或準備步驟,倒帶拖曳亦不會反向復原狀態。

執行自動化

除各類預設觸發器外,自動化項目亦可透過卡片選項選單中的執行自動化手動執行、在 Web 控制台 的自動化頁面點擊觸發、透過 Stream Deck 的 Run Automation 按鍵操作,或由外部外掛經由 外掛 API 呼叫 automation.run 介面觸發。上述控制管道均不佔用實體快速鍵——非常適合在多功能主控台或外部控制器上建構密集的觸控動作矩陣。自動化序列僅支援在桌面端中編輯;處於暫停停用狀態的自動化在上述外部管道中均拒絕執行。

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

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

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

匯入與匯出

自動化清單頂部的匯入與匯出功能區提供匯入自動化與全部匯出按鈕,卡片選項選單中的匯出自動化則僅匯出目前單個項目。匯出的資料檔案為標準 JSON 格式,完整描述序列時序、操作定義、觸發條件與冷卻參數,並透過唯一 UUID 參照關聯的場景、圖層、模型與媒體資產,但不內嵌媒體資產二進位檔案。匯出的檔案內建關聯了官方 JSON Schema 約束,支援在 VS Code 等程式碼編輯器中實現即時驗證與補完。

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

虛擬形象快速鍵

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

虛擬形象快速鍵歸屬於模型資產本身而非應用程式全域。每個模型均攜帶專屬的快速鍵定義方案——因此模型的按鍵綁定關係能夠在不同工作站之間無縫流轉,並原生相容 Persona 與 VTube Studio 環境。

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

新增快速鍵

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

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

上述操作針對目前分組對應的模型實體生效,格式通用——VRM 模型的表情形態與動畫動作同樣支援完整綁定。當模型未定義動作或表情時,對應的選擇器將自動停用;替換模型下拉選單羅列已註冊模型中除自身以外的所有可用資產,清單為空時同樣停用,且替換操作僅作用於目前模型所處的特定圖層。

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

錄製彈出視窗處於開啟狀態時,所有已註冊的應用程式快速鍵將被臨時釋放接管,因此已被佔用的組合鍵會直接傳遞輸入至彈出視窗中,而不會誤觸發既有的快速動作。

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

單一快速鍵至多由兩個修飾鍵加一個實體按鍵組成。該限制源於底層儲存規範而非介面約束——VTube Studio 設定檔標準為每個快速鍵嚴格分配三個觸發槽位,Persona 僅接受能夠被規範寫入該格式的按鍵組合。修飾鍵遵循宿主系統命名習慣,在 macOS 上顯示為 ⌥ 與 ⌘ 而非 Alt 與 Win。

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

播放方式

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

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

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

按住時生效機制依賴於系統能夠準確擷取實體按鍵的放開事件(Key Up)。在背景生效的鍵盤快速鍵無法監聽按鍵放開,因此系統會自動回退至切換觸發模式;若某一組按鍵上存在任意一條背景快速鍵,共享該組合的所有其他條目均將退化為切換模式(選單中會明確註明原因)。控制器組合不受此限制。透過條目選單中的觸發按鈕、Stream Deck、MCP 或 外掛 API 發起的外部觸發亦不存在實體放開事件,系統統一依切換模式調度。

由開啟了按住時生效或自動關閉時間的快速鍵所啟用的表情,不會被 記住表情 機制持久化記錄——以確保在按鍵按住期間儲存場景時,下次載入模型不會錯誤殘留瞬態表情。

背景與焦點快速鍵

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

背景全域快速鍵必須包含 Ctrl、Alt 或 Cmd 修飾鍵。單純的無修飾單鍵或僅包含 Shift 的組合屬於標準文字輸入範疇——若將其註冊為作業系統全域快速鍵,將攔截導致其他桌面應用程式無法正常輸入文字——因此這類按鍵綁定強制限定為僅在 Persona 取得焦點時生效,其背景開關自動停用。遊戲控制器組合不在此限:控制器輸入不佔用作業系統的全域按鍵攔截表,因此背景生效對其始終可用且無需修飾鍵。

已被宿主系統中其他應用程式獨占註冊的按鍵組合無法被 Persona 擷取。快速鍵不會因此遺失失效:系統會自動將其降級為僅在 Persona 取得焦點時生效,並在組合鍵旁以琥珀色警示三角形明確標註降級原因。

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

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

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

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

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

存放位置

模型類型設定寫入路徑
包含 .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年10月15日

Tech otakus destroy the world