TSMPSetup

TSMPSetup を使用して、TSMP のシーンを準備します。

TSMP シーンに関する何かが変更されるたびに、このコンポーネントにアクセスする必要があります。エンコーダー、デコーダー、コーデック、レンダー テクスチャ、ネットワーク ID、生成されたバインディング データを接続します。

必要なときに

シーン構造が変更されるたびにセットアップを実行します。これにより、エンコーダ、デコーダ、Luma4 参照、ネットワーク ID、およびバインディング テーブルの位置が調整されます。

次の後に Apply Setup をクリックします。

• TSMPNetwork* コンポーネントの追加または削除。
• どのオブジェクトをエンコードまたはデコードするかを変更する。
• エンコーダ出力のレンダリング テクスチャを置き換えます。
• デコーダーのソース テクスチャを置き換えます。
• コーデックの選択を変更します。
• 手動ネットワーク ID の変更。
• TSMP コンポーネントをプレハブに移動したり、プレハブから移動したりする。

エンコードされたテクスチャが変化しても受信側オブジェクトが移動しない場合は、何かをデバッグする前に Apply Setup を実行してください。

一般的なワークフロー

1. TSMPController.prefab をシーンにドラッグします。
2. [リファレンス] タブでテクスチャとシーンのリファレンスを割り当てます。
3. [コーデック] タブで Luma4 が選択されていることを確認します。
4. TSMP 同期コンポーネントをオブジェクトに追加します。
5. 「Apply Setup」をクリックします。
6. 再生モードに入るか、VRChat でテストします。
7. 同期されたオブジェクトを移動または操作している間、TSMPDebugCanvas を監視します。

タブ

タブ	用途:
参照	エンコーダー、デコーダー、テクスチャ、レンダー テクスチャ、および共有シーン参照を割り当てます。
コーデック	Luma4 ハンドラーを選択し、コーデック パッケージのメタデータを表示し、コーデックの検出を更新します。
バインディング	同期された動作、生成されたバインディング、およびネットワーク ID を確認します。
デバッグ	手動エンコード アクションを実行し、セットアップ診断を検査します。

最初に何を割り当てるか

通常のプレハブ設定の場合は、Apply Setup を押す前に次のフィールドを確認してください。

フィールドグループ	何を割り当てるか
エンコーダ	コントローラー プレハブの TSMPEncoder。
デコーダ	コントローラー プレハブの TSMPDecoder、または受信機デコーダー。
エンコーダ出力	キャプチャまたは表示されるレンダー テクスチャ。
デコーダソース	受信した TSMP 画像を含むテクスチャ。
ペイロードバイトテクスチャ	ペイロード バイトの読み取り中に使用されるデコーダ作業テクスチャ。
コーデック	Luma4 ハンドラー。

デコーダが OBS または別のキャプチャ パスから受信している場合、Decoder source は生のエンコーダ出力テクスチャではなく、キャプチャされたテクスチャである必要があります。

セットアップを適用する

Apply Setup は設定を保存するだけではありません。エンコーダーとデコーダーによって使用されるランタイム データを更新します。

• 選択したコーデック参照を割り当てます。
• フレームのレイアウトと積載量を計算します。
• 有効な場合、TSMP レンダリング テクスチャのサイズを変更します。
• エンコーダーとデコーダーのバインディング テーブルを構築します。
• ネットワーク ID を割り当てまたは更新します。
• コーデックのデコード素材を設定します。
• 必要に応じてランタイム コーデック インスタンスを作成します。

適用後、「バインド」タブを確認してください。同期する予定のコンポーネントがリストにない場合、エンコーダーはそのコンポーネントを送信しません。

安全なデフォルト

以下から始めます:

• 自動コーデック検出が有効になっています。
• Luma4 が選択されました。
• 自動セットアップが有効になりました。
• 生成されたネットワーク ID。
• デフォルトのブロック サイズとサンプル サイズ。
• TSMPDebugCanvas はテスト中に表示されます。

手動 ID とカスタム参照は、基本ストリームが機能した後にのみロックダウンしてください。

よくある設定ミス

症状	おそらくセットアップの問題
エンコーダーは実行されますが、payload=0	有効な TSMP ネットワーク コンポーネントが見つからないか、セットアップが再適用されませんでした。
デコーダーはフレームを認識しますが、何も適用しません	バインディングが受信コンポーネントと一致しないか、受信補間が None です。
Luma4がありません	コーデック パッケージまたはカタログがインポートまたは検出されませんでした。
プレイヤーを追加するとデータが消える	ペイロード容量が新しいデータ セットに対して小さすぎます。
エディタの出力は古いコーデックを使用します	コーデックの選択は変更されましたが、セットアップ/マテリアルは再適用されませんでした。