Skip to content

Desuq Cafe
ドキュメントメニュー

この翻訳は最新の英語版より遅れている場合があります。 英語版を表示

Details Panels

このプラグインには充実したカスタム詳細パネルが搭載されており、Play mode 不要でエディタから直接 OBS を操作できます。専用パネルが用意されているアクタは 2 種類です。OBS Component を持つ任意のアクタと、OBS Trigger Volume アクタです。

詳細 UI ではなくエディタコードから OBS を操作する方法については、Editor Subsystem を参照してください。以下の各セクションで共通して使用されるウィジェット・カラー・スペーシング規則は、Style System に記載されています。

OBS Component 詳細パネル

OBS Component を持つアクタを選択すると、詳細パネルに展開可能なセクションのセットが表示されます。多くのセクションはデフォルトで折りたたまれており、表示されるセクションはコンポーネントの機能ピッカー（後述）によっても決まります。

機能ピッカー / Component Picker

パネル上部に固定された機能ピッカーは、トグルカードのグリッドで構成されており、表示するセクションとコンポーネントが購読する OBS イベントストリームを制御します。

  • ロックされた Connection（常時オン） の基盤カード。
  • トグルカード（デフォルト: Scenes と録画・配信）。各カードには英語ラベルと 1 行のツールチップがあり、オン/オフ状態を示すステータスドットとアクセントボーダーが表示されます。
  • Enable all / Reset ボタン。

カードを切り替えると、そのビットがコンポーネントの EnabledFeatures プロパティに書き込まれ（永続化・アンドゥ可能）、有効になっているセクションのみを表示するようにパネルが再構築されます。一部の機能は有効化すると、より高頻度のイベントストリーム（例：シーントランスフォームイベント）にも購読します。

UI の見通しをよくし、選択していないイベントストリームへの購読を避けることが目的です。ハンドラー自体は遅延生成されるため、コストは低く抑えられます。

Connection セクション

Connection セクションは目立つ常時展開のアクセントカードで、パネル上部近くに固定されています。

  • Host / Port / Password: 接続設定（編集可能なプロパティ）。パスワードフィールドはデフォルトでマスクされており、目のアイコンで表示切り替えができます。
  • Auto Connect: BeginPlay 時に自動で接続します。
  • Status Indicator: 視覚的な接続状態（緑 = 接続済み、黄 = 接続中、グレー = 切断済み）。
  • Connect / Disconnect / Refresh: 制御ボタン。
  • 切断中のみ、接続を促す控えめなヒントが表示されます。

Configuration セクション（デフォルトで折りたたみ）

  • シーンコレクション
    • 現在のコレクションのドロップダウン: コレクションの選択・切り替え
    • 新規コレクション用テキスト入力と作成ボタン
    • 更新ボタン
  • プロファイル
    • 現在のプロファイルのドロップダウン: プロファイルの選択・切り替え
    • 削除ボタン（現在のプロファイルでは無効）
    • 新規プロファイル用テキスト入力と作成ボタン
    • 更新ボタン
  • 映像設定
    • 配信中・録画中の警告テキスト（設定がロックされる）
    • 基本解像度: 幅 × 高さのスピンボックス
    • 出力解像度: 幅 × 高さのスピンボックス
    • フレームレートのドロップダウン（30、60、120、29.97、59.94）
    • 適用ボタン（配信中・録画中は無効）
    • 更新ボタン
  • 配信サービス設定
    • 現在配信中の警告テキスト（変更は再起動後に適用）
    • サービスタイプのドロップダウン（Custom RTMP / Common Service）
    • サーバー URL 入力欄（Custom RTMP の場合に表示）
    • Common Service ドロップダウン: Twitch、YouTube、Facebook など（Common Service の場合に表示）
    • ストリームキー入力欄（表示/非表示トグル付きのパスワードマスク）
    • 認証を使用するチェックボックス
    • ユーザー名入力欄（認証有効時に表示）
    • パスワード入力欄（認証有効時に表示、常時マスク）
    • 適用 / 更新ボタン

Scenes セクション

  • Current Scene: ステータスインジケーター付きの表示
  • Switch To: アクティブなシーンを変更するドロップダウン
  • Trigger Scene: トリガー時に切り替えるシーン（TriggerSceneName を設定）
  • Available Scenes Header: シーン数と + New Scene ボタン（シーン作成ダイアログを開く）が表示されるラベル
  • Scene List: シーンごとに展開可能なエリア:
    • Scene Row Header: シーン名（現在のシーンは太字の緑）、括弧内にソース数、名前変更ボタン、削除ボタン（赤、現在のシーンでは無効）
    • Transition Override（展開されたシーン内）: トランジションのドロップダウン（「(No Override)」でクリア）、時間のスピンボックス（50〜20000 ms）、クリアボタン
    • Source List: 各ソースに表示状態チェックボックス、ロックトグル、Z オーダーの上下ボタン、トランスフォーム編集ボタン、削除ボタン
    • + Add Source: ソースピッカーを開き（全 OBS 入力と、ネスト用の他シーンを一覧表示）、選択したものを CreateSceneItem で追加

Scene Item Transform セクション

  • Selection Header: 選択中のソース名とシーン
  • Fetch / Duplicate / Clear: OBS から更新、アイテムを複製、または選択をクリア
  • Position: X / Y 座標のスピンボックス
  • Scale: X / Y スケールのスピンボックス（精度 0.01）
  • Rotation: 度数のスピンボックス（° 記号付き）
  • Crop: 左 / 右 / 上 / 下のピクセルスピンボックス
  • Bounding Box: タイプのドロップダウン（None、Stretch、Scale Inner など）と幅 / 高さのスピンボックス
  • Source Info（読み取り専用）: ネイティブ寸法、現在の計算済み寸法
  • Blend Mode: 合成モードのドロップダウン（Normal、Additive、Subtract など）

注意: Scenes セクションの任意のソースにあるトランスフォーム編集ボタンをクリックすると、ここでトランスフォーム編集の対象として選択されます。

Studio Mode セクション

  • Studio Mode Status: インジケーター付きの有効 / 無効表示
  • Enable / Disable ボタン
  • Preview Scene: 現在のプレビューシーンの表示（有効時）
  • Set Preview: プレビューシーンを選択するドロップダウン（有効時）
  • Transition ボタン: プレビューをプログラムにトランジション（有効時）

Transitions セクション

  • Current Transition: ステータスインジケーター付きの表示（トランジション中は黄色）
  • Transitioning…: アクティブなトランジション中に表示されるステータス行
  • Type: トランジションの種類（Fade、Cut、Stinger など）
  • Duration: 現在の時間と編集可能な入力欄。固定トランジション（Cut など）では無効化され、「(fixed)」ラベルが表示されます。
  • Switch To: アクティブなトランジションを変更するドロップダウン

Recording & Streaming セクション

  • Recording Status: 録画中のタイムコード表示、ステータスインジケーター（赤 = 録画中、黄 = 一時停止中、グレー = 停止中）、開始 / 停止 / 一時停止ボタン
  • Record Directory: 現在のディレクトリ表示（読み取り専用）、参照ボタン（フォルダピッカー、次の録画から適用）、更新ボタン（OBS から現在のディレクトリを取得）
  • Record Split & Chapters（OBS 30.2 以降）: ファイル分割ボタン（録画中に有効）、チャプター名入力欄（任意）、チャプター追加ボタン（Hybrid MP4 のみ、録画中に有効）
  • Streaming Status: ライブ中のタイムコード表示、ステータスインジケーター（赤 = ライブ中、グレー = オフライン）、配信開始 / 配信終了ボタン
  • Stream Captions: キャプションテキスト入力欄、送信ボタン（配信中に有効）

Advanced Outputs セクション（デフォルトで折りたたみ）

名前を指定してカスタム出力やプラグイン出力を操作する上級者向けのセクションです。

  • Output Selection: 出力ドロップダウン（検出された出力）、更新ボタン
  • Output Controls: 開始 / 停止 / 切り替えボタン（出力が選択されている場合に有効）、ステータスボタン
  • Output Status Display: 選択中の出力名、アクティブ状態インジケーター（Active / Inactive / Reconnecting）、タイムコード、送受信バイト数（B/KB/MB/GB）、ネットワーク輻輳率、フレーム統計（配信済み / 合計 / スキップ済み）

仮想カメラ セクション

  • Status: インジケーター付きの Active / Inactive 表示
  • Start / Stop ボタン

リプレイバッファ セクション

  • Status: インジケーター付きの Recording / Inactive 表示
  • Start / Stop / Save ボタン（Save はバッファがアクティブな場合のみ有効）

Audio Inputs セクション（デフォルトで折りたたみ）

  • Create New Input（折りたたみ可能）: ターゲットシーンのドロップダウン、入力名フィールド、更新付きの入力の種類ドロップダウン、任意の JSON 設定（折りたたみ可能）、有効チェックボックス、作成ボタン（シーン・名前・種類が必要）
  • OBS のすべての音声入力を一覧表示し、各入力に以下を表示:
    • ミュートインジケーター: 緑（ミュート解除）、赤（ミュート）、グレー（不明）
    • インライン名前変更: 入力名をダブルクリックして編集
    • 音量表示: 現在の dB 値
    • 削除ボタン: 入力を削除（確認あり）
    • ミュート / ミュート解除 トグル
    • 音量スライダー: ドラッグして調整（-100〜+26 dB）
    • Reset: 0 dB にリセット
    • Advanced（入力ごとに折りたたみ可能）: バランス（L/R スライダー + センターリセット）、同期オフセット（-950〜20000 ms + リセット）、モニタリングドロップダウン（None / Monitor Only / Monitor and Output）、トラック（ルーティング 1〜6 の 6 つのチェックボックス）
  • 非アクティブなソース（どのシーンでも有効になっていないもの）はグレーアウトして表示されます。

Media Inputs セクション（デフォルトで折りたたみ）

  • すべてのメディアソース（ffmpeg、vlc、メディアタイプ）を一覧表示
  • 入力ごとのコントロール: アクティビティインジケーター（いずれかのシーンで有効）および再生 / 一時停止 / 停止 / 再スタートボタン
  • 非アクティブなソースはグレーアウトして表示

Input Settings セクション（デフォルトで折りたたみ）

  • Input Dropdown: 表示・編集する入力を選択
  • Input Type: 入力の種類（テキスト、ブラウザ、画像など）
  • Refresh Button: OBS から最新の設定を取得
  • Dynamic Settings UI: 入力タイプによって変化:
    • Text Sources: 複数行テキストエディタ
    • Browser Sources: URL フィールド、寸法の表示
    • Image Sources: ファイルパスフィールド
    • Media Sources: ファイルパスフィールド、ループチェックボックス
    • Color Sources: カラーピッカー（クリックで開く）
    • その他のタイプ: 読み取り専用の JSON 表示
  • 編集すると即座に変更が適用されます。

Source Filters セクション（デフォルトで折りたたみ）

  • Source Dropdown: フィルターを表示・編集するソースを選択
  • Refresh Buttons: フィルターリストまたは利用可能なフィルタータイプを更新
  • Filter List: 選択されたソースの全フィルター。有効化/無効化チェックボックス、名前と読みやすいタイプ名、インデックス位置、上下移動ボタン、削除ボタンが含まれます。
  • Add New Filter: フィルタータイプのドロップダウン（OBS より）、名前入力欄、フィルター追加ボタン

Screenshots セクション（デフォルトで折りたたみ）

  • Status: インジケーター付きの Ready / Capturing / Success / Error 表示
  • Source Dropdown: 任意のシーンまたは入力（[Scene] SceneName または [Input] InputName の形式で表示）
  • Format Dropdown: PNG、JPG、WebP、BMP
  • Quality Slider: 0〜100%（JPG / WebP の場合のみ表示）
  • Size: 幅 × 高さのスピンボックス（0 = ネイティブ解像度）
  • Capture Button: メモリにキャプチャしてプレビューを表示
  • Save to File: ファイルパス入力欄（OBS マシン上のパス）と保存ボタン
  • Preview: 最後にキャプチャしたスクリーンショットを表示
  • Last Saved: 最後に保存されたファイルのパス

Trigger Volume 詳細パネル

OBS Trigger Volume アクタを選択すると、カスタマイズされた OBS Trigger Volume カテゴリが 1 つ表示され、以下のセクションが含まれます。トリガーの背景にあるゲームプレイモデルについては、Trigger Volume ガイドを参照してください。

Trigger Shape セクション

  • Shape Type: Box または Sphere のドロップダウン
  • Box Extent: 半サイズベクトル（ボックスは各方向にこの値の 2 倍の範囲に広がる）。Box の場合のみ表示。
  • Sphere Radius: 浮動小数点値。Sphere の場合のみ表示。

Appearance セクション

  • Debug Draw: Show in Editor / Show at Runtime、Draw Solid（ボックスのみ）、Line Thickness、Volume Color、Action Label
  • Styled Mesh: Volume Style（None / Glow / Hologram / Pulse / Custom）。Volume Style = Custom の場合のみ、カスタムマテリアルピッカーが表示されます。

ボリュームのスタイリングの概要については Style System を、マテリアルのレシピについては専用のスタイルシステムドキュメントを参照してください。

Trigger Settings セクション

  • Trigger Event: OnEnter、OnExit、または Both
  • Actor Filtering: Actor Class フィルター、特定のアクタの参照
  • Behavior: クールダウン（秒）、Enabled、One-Shot
  • Connection（任意）: ターゲット OBS Component（グローバルサブシステムへのフォールバック）

Conditions セクション

  • すべて AND 論理で評価されることを説明するインフォテキスト
  • Output State: Recording Requirement と Streaming Requirement。それぞれ 3 段階のドロップダウン（Any / Required / Disallowed）
  • Scene Conditions: Required / Excluded シーン。ライブの OBS シーンドロップダウンから選択
  • Audio Activity: 入力ごとの発話中 / アイドル条件。入力ピッカーとライブの発話中ドットあり
  • Source Visibility: ソースごとの表示 / 非表示条件。シーンとソースのピッカー、ライブの表示状態ドットあり

Actions セクション

  • On Enter Actions / On Exit Actions: 配列エディタ（Trigger Event に基づいて表示）
  • 各アクションはライブの OBS 名ドロップダウン（シーン / 入力 / ソース、さらにオンデマンドのフィルターとホットキーピッカー）を使用し、行ヘッダーにインラインで {Type}: {target} のサマリーを表示

Test Controls セクション

  • Warning Box: OBS 接続が利用できない場合に表示（接続のセットアップ方法を説明）
  • Connection Status: インジケーター付き
  • Conditions Status: すべての条件が満たされているかどうかを表示
  • Refresh ボタン: ステータスを再確認
  • Execute Enter / Exit ボタン: テスト用にアクションを手動で発火

注意: 手動実行は条件を無視します（接続要件を除く）。

Style System

上記のすべてのセクションは、共有の FOBSDetailsPanelStyle ヘルパーをもとに構築されており、一貫したスペーシング定数、ステータスカラー、ウィジェットファクトリ（ステータスドット、ラベル付き行、値テキスト、セパレーター、サブセクションヘッダー）を提供します。詳細なリファレンスは Style System を参照してください。