TSMPEncoder

送信者側では TSMPEncoder を使用します。 TSMP データを出力レンダー テクスチャに書き込みます。

ほとんどのユーザーは、各フィールドを直接編集するのではなく、TSMPSetup を通じて設定します。

自動変数は TransSync 送信スケジューリング に従います。変化のない値は既定で 1 秒ごとに再送するため、静止したシーンで再送の間にフレーム番号が止まるのは正常です。他のコンポーネントの再送間隔を変えずに、特定のコンポーネントだけを頻繁に送るには、そのコンポーネントで Send Mode: Always を選びます。最小間隔と容量制限は引き続き適用されます。

必要なもの

• 出力 RenderTexture。
• TSMPSetup を通じて選択された Luma4 ハンドラー。
• 少なくとも 1 つの有効な TSMP ネットワーク コンポーネント、またはキューに入れられた RPC 呼び出し。
• 選択したデータに対して十分なペイロード容量。

使い方

1. TSMPSetup を通じて出力テクスチャを割り当てます。
2. [コーデック] タブで Luma4 を選択します。
3. 目標フレームレートを設定します。
4. 「Apply Setup」をクリックします。
5. 同期されたオブジェクトが移動する間の出力テクスチャを観察します。

ペイロード データが変更されると、出力テクスチャが目に見えて変化するはずです。平坦なままの場合、または静的なパターンのみが表示される場合は、セットアップ参照とペイロード診断を確認してください。

出力はどのようになるか

正常な TSMP 出力には通常、次の内容が含まれます。

• 構造化されたヘッダー領域。
• 同期値が変更された場合に変更されるペイロード領域。
• テクスチャに現在のペイロードが必要とする容量よりも多くの容量がある場合、空の黒いスペースまたは未使用のスペース。

設定やペイロード サイズを変更した後は、古いブロックが残らないようにしてください。存在する場合は、出力クリアが有効になっていて、出力レンダー テクスチャが表示されているものであることを確認してください。

ペイロードと容量

エンコーダーはフレームごとに 1 つのペイロードを構築します。ペイロードには以下が含まれます:

• [TransSync] フィールドからの変数状態メッセージ。
• SendTransRPC によってキューに入れられた RPC メッセージ。

自動変数の合計が容量を超えた場合は高優先度のフィールドから書き込み、残りを後の試行に回します。Deferred Variables と頻度制限付きの警告で確認できます。フィールド単体がペイロード全体より大きい場合、サイズを減らすか出力容量を増やす必要があります。不正な値や大きすぎる RPC・手動メッセージは、引き続きエンコード失敗になる場合があります。

高帯域幅のソースには次のものが含まれます。

• 完全な VRChat アバターのポーズの同期。
• 多くのボーンを備えた人型のポーズ。
• 幅広いブレンド形状の選択。 ・現役選手が多い。
• 多数の独立した変換オブジェクト。

RPC の使用

TSMPNetworkBehaviour から次のように呼び出します。

SendTransRPC(nameof(MyMethod), RPCTarget.All);

エンコーダには、いくつかのフレームのペイロードにキューに入れられた RPC が含まれるため、短いイベントがテクスチャ トランスポートによって見逃される可能性が低くなります。

対象:

ターゲット	送信者	受信機
Local	すぐに実行されます。	送信されませんでした。
Remote	ローカルでは実行されません。	デコード後に実行されます。
All	すぐに実行されます。	デコード後に再度実行します。

ランタイム診断

重要なフィールドと警告:

診断	意味
フレームインデックス	フレームがエンコードされているときに増加します。
ペイロードバイト	このフレームに書き込まれたペイロードのバイト数。
メッセージ数	ペイロード内のネットワーク メッセージの数。
Payload buffer is full	現在のフレームは、すべての同期データを収めることができません。
Failed to write TSMP value	フィールドをエンコードできませんでした。
コーデックまたは出力テクスチャがありません	エンコーダは有効なフレームを生成できません。

一般的な修正

症状	これを試してください
フレームインデックスが増加しない	自動エンコードを有効にするか、「デバッグ」タブから「今すぐエンコード」を呼び出します。
ペイロードは常にゼロです	有効な TSMP ネットワーク コンポーネントを追加し、Apply Setup を実行します。
ペイロードバッファがいっぱいです	同期データを減らすか、出力容量を増やしてください。
RPC が失敗しました	フレーム損失を確認し、RPC リピート フレームを有効のままにします。
コーデック変更後も出力が変化していないように見える	Apply Setup を再実行し、出力レンダリング テクスチャがクリアされていることを確認します。