Electron版の開発Repositoryです。App versionは0.3.0-beta.2、内蔵Serverは独立して1.2.0です。
npm install
npm start初回起動時にElectronのuserData配下へserver.config.json、data/、logs/、user_gadgets/、user_assets/を作成します。
user_gadgets/はhttp://127.0.0.1:<Main Port>/user_gadgets/<folder>/...へ静的配信します。一覧掲載には検証可能なmanifest.jsonが必要で、公式ツールと区別してUserと表示します。Electron運用中のRemote管理Endpointは起動ごとの管理Tokenで保護され、持ち込みページや通常ブラウザーへPairing codeとSession情報を公開しません。
user_assets/はServer機能が使う利用者画像の保存領域です。画像パフォーマンスはscreen_effect_v2/image_performance/、Money Showerの肖像はscreen_effect_v2/money_shower/へPNGを置きます。STREAM DESIGNERはstream_designer/backgrounds/、stream_designer/panel-backgrounds/、stream_designer/characters/、stream_designer/background-decorations/、stream_designer/foreground-decorations/へPNG/JPEG/WebPを配置します。Main Serverだけが検証済み画像を配信し、Remote Serverからは公開しません。
Schedule BoardのServerモードは、予定とデザイン設定を選択中のAppデータルートにあるdata/schedule-board.jsonへ保存します。Installed版ではElectronのuserData、Portable版ではアプリ横のPortableデータルートが使われます。画像本体はStateへ含めず、上記STREAM DESIGNER素材への参照だけを保存します。
Calendar MakerのServerモードは、制作設定をdata/calendar-maker.jsonへ保存します。Schedule BoardとはState、revision、保存ファイルを分離し、画像本体ではなくSTREAM DESIGNER素材参照だけを共有します。
公式単品版・統合版・ユーザーガジェットで共通利用できるversion付き_vct_coreへの構造移行方針はCORE_MIGRATION.mdを参照してください。GP Multi CounterをPilotとし、Screen Effectの第三者Plugin対応は保留します。
配置方法、Trust境界、共有APIの未確定範囲はUSER_GADGETS.mdを参照してください。
Mainは127.0.0.1、Remoteは有効時のみ0.0.0.0へ固定します。管理UIではMain Port、Remote有効/無効、Remote Portを変更でき、保存時にServerを再起動します。
管理UIには正式ガジェット一覧、Sync/Server/Standalone URLのコピーと起動、Remote URL/QR、Pairing code再生成、全Remote Session破棄も集約します。Browserの/adminは単体Server運用と診断用として残します。
0.3.0-beta.2ではSTT字幕とBGM Controllerに加え、Material Hubの修正とOBS Screen Effectの追加演出を含むInstaller/Portable Buildを利用者テスト用に提供します。既知事項はRELEASE_NOTES.mdを参照してください。
BGM Controller / Display 0.2.0-beta.1は、App管理画面から独立したController Windowを開き、ローカルのMP3/WAVをPlaylistへ追加して再生できます。Playlist、曲順、音量、Shuffle、RepeatはAppデータルートのdata/bgm-controller-v1.jsonへ保存し、再起動後は停止状態で復元します。
BGM Controller Phase 2では、MP3等のTitle/Artist/埋め込みジャケットをmusic-metadataで取得し、操作UIを含まないDisplay Windowへ表示します。DisplayはJacket/Playlist/Queue/Simpleを切り替えられます。Playlistは保存済みの曲順、Queueは実際の次曲順を最大7曲表示します。「推奨サイズへ調整」は現在のモードに応じてJacketを640×640、Playlist/Queueを1000×600、Simpleを1000×260の内容領域へ明示的に変更します。モード切替だけではWindowサイズを変更しません。音声出力は1系統とし、OS既定または利用可能な出力Deviceを選択できます。保存済みDeviceが見つからない場合は別Deviceへ自動出力せず、再生を停止してControllerへ警告します。
OBS向け表示はDisplay Windowのウィンドウキャプチャに加え、ControllerからコピーできるBrowser Source URLを利用できます。Browser Source Viewerは表示専用で音声を再生せず、音声は引き続きApplication Audio Captureで取得します。Controllerの「Browser背景を透過」を有効にすると、コピーURLへ?transparent=1を付けてViewerの背景だけを透明にします。Server再接続時は最新Snapshotを再取得します。Simple/Jacketの曲名は表示幅を超えた場合だけ一定速度で往復スクロールします。
BGM Controller Phase 3では、複数Playlistの作成、名前変更、複製、削除、切替と、チェックボックスによる複数曲の一括選択・削除を追加します。既存のv1保存データは初回読込時にPlaylist 1へ移行します。再生中にPlaylistを切り替えたり現在曲を一覧から削除した場合も現在曲は停止せず、次曲から現在選択中のPlaylistを使用します。実行中のQueueはPlaylistとは別に表示し、選択曲を次または末尾へ移動、Queue内で上下移動、再生予定から除外できます。Queue表示は内部の再生順から現在曲より後ろだけを表示するため、曲送り時は現在曲が履歴へ移り、前の曲へ戻るとその位置より後ろの予定曲がQueueへ再表示されます。直近30件までの再生履歴も実行中だけ表示し、Queueと履歴は再起動後に復元しません。
試験導入中のSTT Subtitle Viewer 0.1.0-beta.1は、Main ServerのPOST /api/input-events/v1へ送られたvct.speech.event.v1をWS /events経由で表示します。字幕はinterim差し替えとfinal保持を行い、Event Hubはfinal発話のspeech.textだけをキーワード条件へ利用します。入力EndpointはRemote listenerへ公開しません。
STT Optional Module 0.1.0-beta.1は、開発環境では外部modules/stt-pocを検出すると、App画面からSTT管理UIを起動・停止して音声認識設定を開けます。Main Server稼働中は同じSTT欄から字幕Viewerの設定・プレビュー画面も開けます。配布版では実行ファイル隣接のmodules/stt、またはVCT_STT_MODULE_DIRで指定した外部Optional Moduleを検出します。音声認識runtimeとmodelはAppへ内蔵しません。