00:00 / 00:00

Persona

網頁控制台

透過網頁控制台在瀏覽器中控制執行中的桌面應用程式。主控台的外觀與連線偏好儲存在目前的瀏覽器中。

連線

  1. 在桌面應用程式中開啟「設定 → 外掛 API」,啟用 API 並建立金鑰。
  2. 開啟 persona-console.laplace.live。
  3. 輸入桌面主機、API 連接埠和金鑰後連線。同一台電腦使用 127.0.0.1,預設連接埠為 25034。

連接區域網路中的另一台電腦時,在桌面端啟用「允許區域網路存取」。HTTPS 主控台不能連接遠端未加密的 ws:// 端點:請透過 HTTP 提供主控台,或使用 TLS 代理並啟用「使用 TLS (wss://)」。Persona 內建 API 不提供 TLS 終止。服務設定與金鑰管理請見 外掛 API。

瀏覽器偏好

「設定 → 網頁控制台」中的「語言」和「主題」僅影響目前的瀏覽器,不會改變桌面應用程式的外觀。「自動連線」會在開啟主控台時重複使用完整的已儲存連線。

連線頁面的「儲存 API 金鑰」決定是否將金鑰存入瀏覽器本機儲存空間。關閉後,目前的連線只在記憶體中保留金鑰,重新載入頁面後需要再次輸入。主動中斷後不會立即自動重新連線;已撤銷的金鑰需要更換。

「一般」和「效能」區域修改的是已連接桌面應用程式的設定。主控台各區域的展開狀態與面板寬度則由瀏覽器單獨儲存。

可控制的內容

主控台提供場景、圖層、模型、追蹤、特效及已儲存自動化的控制。選取圖層後可編輯它支援的屬性。虛擬形象快速鍵依模型分組,各組可獨立摺疊。詳細頁面頂端的區塊索引列可快速跳至頁面中的各個區塊。

  • 大綱檢視:與桌面端一致,「舞台」作為固定列常駐於圖層清單底部,點擊可快速開啟場景屬性並清除圖層選取範圍;在具備 object-pin-depth 能力的主機上,釘選到 Live2D 模型的 2D 圖片、影片或網頁支援深度滑桿調整(未宣告該能力的主機不顯示深度滑桿與圖釘標記;網頁圖層不再包含前置/後置圖層開關)。
  • 場景預設:在具備 scene-presets 能力的主機上,大綱檢視頂端列出目前場景的 場景預設,支援套用、新增、更新為目前配置、設定轉場、重新命名與刪除,與桌面端一致。
  • 文字圖層:需要主機宣告 object-text 能力(相容舊版 text-objects)。
    • 素材庫中的「文字」標籤頁和字型選取清單僅在支援該能力的主機上顯示。字型清單透過 fonts.list 讀取桌面主機上已安裝的字型,而非瀏覽器字型。
    • 在主控台中調整文字內容、排版與外觀時,變更透過 object.setContent 即時提交至桌面端。桌面端將其視為就地編輯,並在操作暫停時記錄一個復原步驟。
  • 影片圖層:需要主機宣告 object-video-sound 能力(相容舊版 video-sound)。
    • 選取影片圖層後可調整「循環」開關、「靜音」按鈕與「音量」滑桿,變更透過 object.setContent 就地提交。舊版主機每次調整都會替換場景並清空歷史紀錄,因此不顯示這個區域。
    • 主控台無法直接控制桌面舞台上正在播放的媒體元素,因此沒有播放/暫停與進度列拖曳控制項,已儲存的暫停狀態保持不變。
  • 色度鍵(去背):依賴主機端宣告的 object-chroma-key 能力。選取圖片、影片或網頁圖層時呈現色度鍵控制區塊,支援啟用色度鍵、選取去背顏色、調節相似度、平滑度與溢色抑制。未宣告該能力的主機不展示該區塊,防止提交後被舊版主機丟棄。
  • 模型整體移動:在具備 model-movement 能力的主機上,選取的 Live2D 模型支援調節水平、垂直與深度位移滑桿(範圍 −50 – 50);在具備 model-movement-pivot 能力的主機上,支援設定「前後縮放中心」或在舞台上點擊模型選取,使模型在靠近或遠離攝影機時圍繞指定中心縮放。
  • 隱私保護:當桌面端處於直播模式時,網頁圖層 URL 自動以來源網站加 /*** 遮罩(可透過一鍵複製按鈕取得完整真實 URL,且輸入框支援直接貼上取代新位址)。
  • 本機資產:模型和素材檔案位於桌面電腦上。素材庫列出已登記的素材;登記路徑需要位於允許的外掛資料夾中,並非透過瀏覽器上傳檔案。

自動化編輯、快速鍵錄製、API 金鑰管理、系統檔案對話方塊、舞台操作控制項及應用程式更新仍在桌面應用程式中完成。

最後更新於 2026年10月21日

Tech otakus destroy the world