VRChat 非公式日本語ドキュメント

VRCSDK ヘルパー

Helper コンポーネントは、VRC SDK コンポーネントの動作を補助するためにオブジェクトに追加されます。これらのコンポーネントの役割は CyanEmu や Phase 2 と比較して変更されていませんが、オブジェクト自体の機能に直接関係のないロジックの一部は削除されました。例えば CyanEmu では、CyanEmuPickupHelper スクリプトがピックアップの保持に関するロジックを処理していました。現在は、この動作はピックアップヘルパークラスの外に移動され、ピックアップ管理システムに移管されています。現在の PickupHelper コードは、PlayerHand がどのようにピックアップを処理すべきかというデータを提供するのみとなっています。

Helper クラスは、ClientSim で使用されるインターフェースを拡張している場合があります。インターフェースには Usables(使用可能)と Handlers(ハンドラー)の2つのカテゴリがあります。

使用可能なインターフェース

使用可能なインターフェースは通常「able」で終わり、ClientSim内で何らかの形で使用できるアイテムを表します。これらはどのように使用できるかという情報を提供しますが、それらを使用するためのメソッド自体は含まれていません。

Name Description
IClientSimInteractable インタラクト可能なオブジェクトを表します
IClientSimPickupable 拾い上げ可能なオブジェクトを表します。IClientSimInteractableを継承します
IClientSimStation プレイヤーが座るために使用できるオブジェクトを表します
IClientSimSyncable オーナーを持つことができるオブジェクトを表します
IClientSimPositionSyncable 位置を同期するオブジェクトを表します。IClientSimSyncableを継承します

ハンドラーインターフェース

これら2種類のインターフェース型を使用することで、HelperクラスはVRChat SDKのコンポーネント情報をラップし、それをClientSimに提供する役割を果たします。

名前 説明
PositionSyncedHelperBase VRCObjectSync 用のヘルパー。SyncablePositionSyncableRespawnHandler を含む。
ObjectSyncHelper VRCObjectSync 用のヘルパー。PositionSyncedHelperBase を継承。SyncablePositionSyncableRespawnHandler を含む。
UdonHelper UdonBehaviour 用のヘルパー。PositionSyncedHelperBase を継承。SyncablePositionSyncableRespawnHandlerInteractablePickupHandlerStationHandlerSyncableHandler を含む。
PickupHelper VRCPickup 用のヘルパー。Pickupable を含む。
StationHelper VRCStation 用のヘルパー。IClientSimStation を実装。
ObjectPoolHelper VRCObjectPool 用のヘルパー。Syncable を含む。
CombatSystemHelper UdonCombatSetup 用のヘルパー。IVRC_Destructible を実装。初期化時にヘルパーコンポーネントがプレイヤーオブジェクトへ直接追加されます。
SpatialAudioHelper VRCSpatialAudioSource 用のヘルパー。

最終更新: