メインコンテンツまでスキップ

内蔵ネットワークコンポーネント

TSMP には、一般的な VRChat 世界同期ケースをカバーするいくつかの TSMPNetworkBehaviour コンポーネントが含まれています。これらはすべて networkId を共有し、補間、アクティブ状態チェック、およびセットアップ バインディングを受信します。

よくある行動​

特徴意味
networkId送信側コンポーネントと受信側コンポーネントを照合するために使用される安定した ID。
receiveInterpolationNone、Discrete、または Continuous 受信値の処理。
アクティブ状態無効化されたコンポーネントまたは非アクティブなゲームオブジェクトは参加しません。
TSMPBeforeEncode()エンコーダが [TransSync] フィールドを読み取る前にコンポーネントの状態をキャプチャします。
OnTSMPVariableReceived()フレームの受信後にデコードされた状態を適用します。

コンポーネントの概要​

成分同期するもの
TSMPNetworkTransformSync位置、回転、スケール、圧縮範囲、およびオプションの Rigidbody 状態を変換します。
TSMPNetworkHumanoidPoseSync選択された人型のボーンとルート モーションの位置。
TSMPNetworkBlendShapesSync1 つの SkinnedMeshRenderer に対して選択されたブレンドシェイプ ウェイト。
TSMPNetworkVrchatAvatarPoseSyncVRChat アバター プール再生用のプレーヤー トラッキング ポーズ。
TSMPNetworkAnimatorSyncランタイム パスでサポートされるアニメーター パラメーターとレイヤー関連の状態。
TSMPNetworkTimelineSyncUdon でサポートされている PlayableDirector のタイムライン時間/再生状態。
TSMPNetworkGameObjectToggleTSMP RPC を介してイベントを切り替えます。
TSMPDebugCanvasフレーム カウンター、ビットレート、損失、ヘッダー メタデータのテキスト UI。

Timeline 制御​

TSMPNetworkTimelineSync は引数なしのメソッドを四つ公開しています。Udon custom event としても呼び出せます。

メソッド動作
Play()Director を再生して Playing を記録します。
Pause()再生中の Director を一時停止します。時刻 0 でも有効ですが、停止済みの場合は graph を作成しません。
Resume()一時停止した再生を再開し、停止済みなら再生を開始します。Play と同様、再生中の Director を最初から再開しません。
Stop()Director を停止して Stopped を記録します。

Seek(float time) は Playing/Paused 状態を維持して指定時刻を評価します。Stopped の場合は一時停止した graph を準備します。非ループの場合はローカルの長さの範囲に制限し、ループの場合は時刻を循環させます。負数、NaN、無限大は無視します。引数なしの custom event ではなく、スクリプトから引数を渡して呼び出してください。明示的な制御命令は進行中の受信補正を取り消しますが、次の有効なパケットで再び受信状態を反映します。

timeline.packed は既存の v1 形式を維持します。バージョン 1 byte、状態 1 byte（0 Stopped、1 Paused、2 Playing）、Float32 時刻（秒）、Float32 長さの計 10 bytes で、数値は little-endian です。不正な長さ・バージョン・状態、NaN/無限大/負数の時刻・長さ、送信された長さを超える時刻は再生を変更する前に拒否します。警告は 1 秒に 1 回、各有効化サイクルで最大 16 回に制限します。送信元 Director が存在しないか無効な場合は、古いデータを再送せず payload と encodedTimelineBytes を空にします。通常の Unity では Timeline アセットがない場合も同様です。

これらの命令はローカル再生を制御し、Encoder が次の取得時に状態を送信します。通常の Unity では director.state と graph の有効性を読むため、外部スクリプトの操作も反映されます。Udon では命令を追跡するので、このコンポーネントを通して制御し、シーケンス終了時にも明示的に命令を送ってください。Director の直接操作や自動終了は確実には検出できません。Director を交換すると、新しい Director の playOnAwake を基準に状態を初期化します。

コンポーネントの選択​

データ モデルがオブジェクトと一致する場合は、組み込みコンポーネントを使用します。次の場合にカスタム TSMPNetworkBehaviour を書き込みます。

  • 別のパックされたバイト形式が必要です。
  • 複数のフィールドを 1 つのパケットとして同期する必要があります。
  • カスタムの受信補間ポリシーが必要です。
  • TSMP RPC からロジックを実行する必要があります。

バインドルール​

ネットワーク コンポーネントを追加または削除した後、Apply Setup を実行します。エンコーダとデコーダは、ランタイム ワールドでフレームごとにフィールドを検出しません。セットアップでは、パフォーマンスと Udon の互換性のために明示的なバインディング テーブルを作成します。