概要

オブジェクトにアタッチすることで、そのオブジェクトのアクティブ切り替えに合わせて別オブジェクトのアクティブを切り替えたり、音を鳴らしたり、Animator のパラメーターを書き換えたり、指定したコンポーネントのオンオフをしたりする汎用コンポーネント集です。
オブジェクトのアクティブをオンオフするスイッチギミックと併用することで、スクリプトを書かずに機能のちょい足しができるようになります。

様々なイベントをトリガーにしてオブジェクトのアクティブを切り替える汎用ギミックもあります。

導入手順

導入手順

パッケージ内容

• ActiveRelay with ファミリー : アタッチしたオブジェクトのアクティブが切り替わると、選んだコンポーネントに応じた効果がアタッチしたオブジェクトに適用されます。
• ActiveRelay to ファミリー : アタッチしたオブジェクトのアクティブが切り替わると、選んだコンポーネントに応じた効果が指定したオブジェクト全てに実行されます。
• ActiveRelay by ファミリー : アタッチしたオブジェクトがコンポーネントに応じた Unity/VRChat イベントを受け取ると、指定したオブジェクト全てのアクティブを切り替えます。

使い方

ActiveRelay を付けたいオブジェクトを Hierarchy から選択し、「Add Comppnent」から ActiveRelay と検索して、使いたいコンポーネントを選んでアタッチしてください。
一部は Prefab 化されているため、 Packages > Fukuro Udon > Samples > ActiveRelay フォルダーから使いたい Prefab を Hierarchy に置く方法でもOKです。

ActiveRelay with Delay

ActiveRelay to GameObject から機能を絞った簡易版です。最後にアクティブが切り替わってから指定秒数後にアクティブ状態を反転操作します。
オブジェクトを一定時間だけアクティブにしたい時や、定期的にアクティブをトグル切り替えしたい時に使えます。

• Delay Time To Inactive : このオブジェクトが最後にアクティブになってから、ここで指定した時間後に非アクティブにします。0にすると無効になります。(単位 sec)
• Delay Time To Active : このオブジェクトが最後に非アクティブになってから、ここで指定した時間後にアクティブにします。0にすると無効になります。(単位 sec)

ActiveRelay with Return

ActiveRelay to Transform から機能を絞った簡易版です。このオブジェクトのアクティブが切り替わった際、Transform の指定の項目を初期値に戻します。
VRCObjectPool の同期オブジェクトなど、リターン処理が上手くいかないオブジェクトへの補助として使えます。

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
• Change Property : Transform のどの項目を初期化させるか。デフォルトは Position と Rotation が有効
• Position : 位置
• Rotation : 向き
• Scale : 大きさ
• Relative To : 初期値をワールド座標で扱うかローカル座標で扱うか

ActiveRelay with Drop

VRC Pickup と一緒に付けて使います。このオブジェクトのアクティブが切り替わった際、ピックアップを Drop() させます。

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ

ActiveRelay to GameObject

オブジェクトのアクティブを切り替えます。

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
• GameObjects : この配列にセットしたゲームオブジェクトは、このゲームオブジェクトがアクティブになった時にアクティブに、非アクティブになった時に非アクティブになります
• Invert : 動作を反転します(このオブジェクトがアクティブになった時に配列のゲームオブジェクトを非アクティブに、非アクティブになった時にアクティブにします)
• Delay Time : 動作を指定秒数だけ遅延させます。0なら無効(従来通り遅延無し動作)
• Delay Latest Only : 遅延動作を有効にしている場合、最後にアクティブが切り替わってからのみ実行するようにします

ActiveRelay to GameObject in PlayerObject

オブジェクトのアクティブを切り替えます。ただし、このコンポーネントが PlayerObject 外かつ、対象が PlayerObject 配下のオブジェクトに限られます。
現状 Udon 側から PlayerObject であるかを判別する手段が無いため、専用コンポーネントとして用意しています。将来的に to GameObject に統合される可能性があります。

PlayerObject の詳細は以下
https://creators.vrchat.com/worlds/udon/persistence/player-object/

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
• Accept Player Type : 実行対象にする PlayerObject のオーナープレイヤーの種類
  • All : 実行時にインスタンスにいる全プレイヤーの PlayerObject
  • Owner : このオブジェクトのオーナーの PlayerObject
  • Others : 自分自身を除く、実行時にインスタンスにいる全プレイヤーの PlayerObject
  • Self : 自分自身の PlayerObject
• GameObjects : この配列にセットしたゲームオブジェクトは、このゲームオブジェクトがアクティブになった時にアクティブに、非アクティブになった時に非アクティブになります
• Invert : 動作を反転します(このオブジェクトがアクティブになった時に配列のゲームオブジェクトを非アクティブに、非アクティブになった時にアクティブにします)
• Delay Time : 動作を指定秒数だけ遅延させます。0なら無効(従来通り遅延無し動作)
• Delay Latest Only : 遅延動作を有効にしている場合、最後にアクティブが切り替わってからのみ実行するようにします

ActiveRelay to Transform

オブジェクトの Transform を操作します。

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
• Transforms : この配列にセットしたゲームオブジェクトの Transform は、このオブジェクトのアクティブ(activeInHierarchy)が反転した時に指定した値に移動・回転・拡縮します
• Change Property : Transform のどの項目を連動させるか。デフォルトは Position と Rotation が有効
• Position : 位置
• Rotation : 向き
• Scale : 大きさ
• Relative To : Position, Rotation, Scale の値をワールド座標で適用するかローカル座標で適用するか
• Reference Transform : ここにオブジェクトがセットされている場合、 Position, Rotation, Scale の値はセットされたオブジェクトの Transform の値が使われます

ActiveRelay to Component

コンポーネントの有効無効を切り替えます。一部コンポーネントは、そのコンポーネントが持つパラメーターのほうを操作します。

Hierarchy からオブジェクトを直接 D&D してもセットすることはできません。

1. ActiveRelay to Component を付けたオブジェクトの右クリックメニューから「Properties...」コマンドでプロパティ窓(一時表示用のロックの掛かった Inspector 窓みたいなもの)を出し

   

2. Inspector からセットしたいコンポーネントのコンポーネント名のところを掴んで ActiveRelay to Component の配列に D&D することで追加できます。

   

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
• Components : この配列にセットしたコンポーネントは、このオブジェクトがアクティブになった時にコンポーネントを有効に、非アクティブになった時に無効にします。Udon の制約により汎用化が難しかったため需要の高そうな以下のもののみ。表記にないコンポーネントは要望があれば追加実装します。
  • *** Collider
  • *** Renderer
  • *** Constraint
  • Audio Source
  • Audio *** Filter
  • Audio Reverb Zone
  • Light
  • Camera
  • Animator
  • Occlusion Portal : このオブジェクトがアクティブになった時に Open を無効に、非アクティブになった時に有効にします
  • CanvasGroup : このオブジェクトがアクティブになった時に interactable を有効に、非アクティブになった時に無効にします
  • UdonBehaviour
  • UdonSharpBehaviour(UdonSharpBehaviour を継承しているコンポーネント、いわゆる U# スクリプトです)
  • VRC *** Constraint
  • VRC Physbone
  • VRC Contact Sender/Receiver
• Invert : 動作を反転します(このオブジェクトがアクティブになった時に配列のコンポーネントを無効に、非アクティブになった時に有効にします)

ActiveRelay to Animator

指定した Animator が持つパラメーターを書き換えます。

• Event Type : 連動させたい条件
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
• Animator : パラメーターを書き換える Animator
• Trigger Name : 指定した名前の Trigger型に true をセットします
• Bool Name : 指定した名前の Bool型に Bool Value の値をセットします
• Int Name : 指定した名前の Int型に Int Value の値をセットします
• Float Name : 指定した名前の Float型に Float Value の値をセットします

ActiveRelay to Effect

指定した AudioSource の再生状態を変更し、指定した ParticleSystem の放出状態を変更します。

• Audio Source For Active : このオブジェクトがアクティブになった時の操作対象の AudioSource
• Audio Source State For Active : このオブジェクトがアクティブになった時に実行する操作内容
  • NoC hange : 何もしません。Sound For Active だけ使いたい時用
  • Play : 頭から再生します
  • Pause : 再生を中断します
  • Stop : 再生を停止します
• Sound For Active : このオブジェクトがアクティブになった時に PlayOneShot() で再生される音声ファイル
• Particle For Active : このオブジェクトがアクティブになった時の操作対象の ParticleSystem
• Emission Module For Active : このオブジェクトがアクティブになった時に Emission モジュールの状態をどうするか
  • No Change : 何もしません。Emit For Active だけ使いたい時用
  • Enable : Emission モジュールを有効にします
  • Disable : Emission モジュールを無効にします
• Emit For Active : このオブジェクトがアクティブになった時に放出するパーティクルの数
• Audio Source For Inactive : このオブジェクトが非アクティブになった時の操作対象の AudioSource
• Audio Source State For Inactive : このオブジェクトが非アクティブになった時に実行する操作内容
  • NoC hange : 何もしません。Sound For Inactive だけ使いたい時用
  • Play : 頭から再生します
  • Pause : 再生を中断します
  • Stop : 再生を停止します
• Sound For Inactive : このオブジェクトが非アクティブになった時に PlayOneShot() で再生される音声ファイル
• Particle For Inactive : このオブジェクトが非アクティブになった時の操作対象の ParticleSystem
• Emission Module For Inactive : このオブジェクトが非アクティブになった時に Emission モジュールの状態をどうするか
  • No Change : 何もしません。Emit For Inactive だけ使いたい時用
  • Enable : Emission モジュールを有効にします
  • Disable : Emission モジュールを無効にします
• Emit For Inactive : このオブジェクトが非アクティブになった時に放出するパーティクルの数

ActiveRelay to UdonBehaviour

指定した UdonBehaviour へ指名したネットワークイベントを送信します。

• Network Target : ネットワークイベントとして実行する対象
  • All : 自分自身を含めた全員に SendCustomNetworkEvent として実行します
  • Owner : それぞれの UdonBehaviour のオーナーに向けて、 SendCustomNetworkEvent として実行します
  • Others : 自分を除く全員に SendCustomNetworkEvent として実行します
  • Self : 自分自身に対してのみ、SendCustomEvent として実行します
• Udon Behaviour For Active : このオブジェクトがアクティブになった時に、配列にある UdonBehaviour 全てに対し SendCustomEvent( Custom Event Name For Active ) を実行します
• Udon Behaviour For Inactive : このオブジェクトが非アクティブになった時に、配列にある UdonBehaviour 全てに対し SendCustomEvent( Custom Event Name For Inactive ) を実行します

[!WARNING] このコンポーネントがグローバルにアクティブ操作される場合、NetworkTarget の設定は慎重にしてください。インスタンスにいる人数回分、一気に実行される可能性があります。

ActiveRelay to VRCComponent

各種 VRChat 固有コンポーネントが持つパラメーターを操作します。

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
• Avatar Pedestals : 配列にある VRC Avatar Pedestal 全てに対し、このオブジェクトがアクティブになった時に Change Avatar On Use を有効に、非アクティブになった時に無効にします
• Pickups : 配列にある VRC Pickup 全てに対し、このオブジェクトがアクティブになった時に pickupable を有効に、非アクティブになった時に無効にします
• Stations : 配列にある VRC Station 全てに対し、このオブジェクトがアクティブになった時に Disable Station Exit を有効に、非アクティブになった時に無効にします
• UdonBehaviour : 配列にある Udon Behaviour 全てに対し、このオブジェクトがアクティブになった時に Disable Interactive を有効(つまりインタラクト不可)に、非アクティブになった時に無効(つまりインタラクト可能)にします
• Invert : 動作を反転します

ActiveRelay to ObjectSync

VRC Object Sync と Manual ObjectSync のパラメーターを操作したり、リスポーンを実行させられます。

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
• VRC Object Syncs : この配列にセットした VRC Object Sync は、このオブジェクトのアクティブ(activeInHierarchy)が反転した時に以下の動作をします
• Manual Object Syncs : この配列にセットした Manual Object Sync は、このオブジェクトのアクティブ(activeInHierarchy)が反転した時に以下の動作をします
• Is Kinematic
  • NoChange : 何もしません
  • Normal : 配列にある全てに対し、このオブジェクトがアクティブになった時に Is Kinematic を有効に、非アクティブになった時に無効にします。この動作は同期します
  • Invert : 配列にある全てに対し、このオブジェクトがアクティブになった時に Is Kinematic を無効に、非アクティブになった時に有効にします。この動作は同期します
• Use Gravity
  • NoChange : 何もしません
  • Normal : 配列にある全てに対し、このオブジェクトがアクティブになった時に Use Gravity を有効に、非アクティブになった時に無効にします。この動作は同期します
  • Invert : 配列にある全てに対し、このオブジェクトがアクティブになった時に Use Gravity を無効に、非アクティブになった時に有効にします。この動作は同期します
• Respawn
  • NoChange : 何もしません
  • Normal : 配列にある全てに対し、このオブジェクトがアクティブになった時に Respawn() を実行します。この動作は同期します
  • Invert : 配列にある全てに対し、このオブジェクトが非アクティブになった時に Respawn() を実行します。この動作は同期します

[!WARNING] このコンポーネントは同期が絡むため、高頻度で切り替わらないよう、使い方に気を付けてください。誰か一人が実行するだけで反映されます。

ActiveRelay to Physbone

ワールドに置いた VRC Phys Bone の Grab, Pose 状態を解除します。

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
• Physbones : この配列にセットした VRC Phys Bone は、このオブジェクトのアクティブ(activeInHierarchy)が反転した時に以下の動作をします
• Release Grab : 掴み状態を強制解除します。この動作はグローバルです
• Release Pose : 固定状態を強制解除します。この動作はグローバルです

ActiveRelay to Player Teleport

ローカルプレイヤーを瞬間移動させます。

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
• Teleport Target : 瞬間移動先の座標
• Spawn Orientation : 瞬間移動後の向きの基準
  • Default : VRChat のデフォルト設定(今のところ Align Player With Spawn Point と一緒です)
  • Align Player With Spawn Point : プレイヤーの向きが Teleport Target に揃います
  • Align Room With Spawn Point : プレイヤーのルームスケールの向きが Teleport Target に揃います
• Lerp On Remote : チェックすると、リモートプレイヤーから見た時に瞬間移動では無く高速移動になります
• Enable OnDeserialization Bug Fix : チェックすると、瞬間移動処理を1フレーム遅らせます

[!WARNING] Enable OnDeserialization Bug Fix プロパティは、このオブジェクトのアクティブ操作が OnDeserialization() などのネットワークイベント内で実行される場合にチェックしてください。
https://creators.vrchat.com/worlds/udon/players/player-positions#teleportto

ActiveRelay to Player Mobility

ローカルプレイヤーの移動関係の設定値を変更します。

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
• Set Walk Speed : チェックすると Walk Speed の変更を実行対象に含めます
• Walk Speed : プレイヤーの前後移動の早さ(VRモードでは Run Speed が優先)
• Set Strafe Speed : チェックすると Strafe Speed の変更を実行対象に含めます
• Strafe Speed : プレイヤーの左右移動の早さ
• Set Run Speed : チェックすると Run Speed の変更を実行対象に含めます
• Run Speed : プレイヤーのダッシュ移動(VRモードでは前後移動、DTモードでは左Shift を押しながら前後移動した時)の早さ
• Set Jump Impulse : チェックすると Jump Impluse の変更を実行対象に含めます
• Jump Impulse : プレイヤーのジャンプ力
• Set Gravity Strength : チェックすると Gravity Strength の変更を実行対象に含めます
• Gravity Strength : プレイヤーに掛かる重力
• Immobilize : プレイヤーを移動禁止にする
  • NoChange : 何もしません
  • Enable : プレイヤーを移動禁止にします
  • Disable : プレイヤーの移動禁止を解除します

ActiveRelay to AvatarScaling

ローカルプレイヤーのアバター身長(Avatar Eye Height)を変更します。

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
• Set Mode : Eye Height の変更方法
  • Meters : 直接この値に変更します。単位 [\m]
  • Multiply : アバターのデフォルトの Eye Height に倍率として掛けます
• Avatar Eye Height : この値を元に Eye Height を変更します

ActiveRelay to Drone

ローカルプレイヤーの VRC ドローンを瞬間移動させます。

• Event Type : 連動させたい条件
  • Active And Inactive : このオブジェクトがアクティブになった時と非アクティブになった時
  • Active : このオブジェクトがアクティブになった時のみ
  • Inactive : このオブジェクトが非アクティブになった時のみ
• Teleport Target : ここにオブジェクトがセットされている場合、ローカルプレイヤーのドローンがこの座標に瞬間移動します
• Lerp On Remote : チェックすると、リモートプレイヤーから見た時に瞬間移動では無く高速移動になります
• Enable Set Velocity : チェックすると、瞬間移動直後の速度を Velocity (ワールド座標)にします
• Velocity : 瞬間移動直後の速度(ワールド座標)

ActiveRelay by Interact

コライダーと共にアタッチすると、インタラクト(いわゆる Use判定)可能なオブジェクトになります。
インタラクトされる度に Action Type の内容を実行します。

[!IMPORTANT] アクティブ切り替え操作に同期が不要な場合(ローカルギミックとして使いたい場合)は、 Synchronization Method を None にしてください。
逆にアクティブ切り替え操作を同期したい場合は、 Synchronization Method を Manual にしてください。
Local Only のチェックも外す必要があります。

• Allowed Player Name List : この配列にセットした displayName のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Local Only : チェックすると、Synchronization Method が同期モードでもアクティブ状態の同期を反映しなくなります

ActiveRelay by Pickup

VRCPickup コンポーネントと共にアタッチすると、Event Type で選択したピックアップ系イベントをトリガーに Action Type の内容を実行します。

[!IMPORTANT] アクティブ切り替え操作に同期が不要な場合(ローカルギミックとして使いたい場合)は、 Synchronization Method を None にしてください。
逆にアクティブ切り替え操作を同期したい場合は、 Synchronization Method を Manual にしてください。
Local Only のチェックも外す必要があります。
(ピックアップオブジェクトに VRC ObjectSync を付けて位置同期もする場合は、 Synchronization Method を Continuous にしてください。)

• Allowed Player Name List : この配列にセットした displayName のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Event Type : 実行条件
  • Pickup : ピックアップした時
  • PickupUseDown : ピックアップ中に Use (マウスなら左クリック、VRコントローラーならトリガー)した時
  • PickupUseUp : ピックアップ中の Use (マウスなら左クリック、VRコントローラーならトリガー)をやめた時
  • Drop : ピックアップをやめた時
• Local Only : チェックすると、Synchronization Method が同期モードでもアクティブ状態を同期しなくなります

ActiveRelay by Station

VRCStation コンポーネントと共にアタッチすると、Event Type で選択した Station系(いわゆる Sit)イベントをトリガーに Action Type の内容を実行します。

• Allowed Player Name List : この配列にセットした displayName 名のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Event Type : 実行対象にするイベントの種類
  • Player Enter And Exit : 誰かがこの Station に座ったか降りた時
  • Player Enter : 誰かがこの Station に座った時
  • Player Exit : 誰かがこの Station から降りた時
• Accept Player Type : 実行対象にするプレイヤーの種類
  • All : 座った/降りたのが誰であっても実行する
  • Owner : このオブジェクトのオーナーの時
  • Others : 自分以外の誰かの時
  • Self : 自分自身の時

ActiveRelay by Physbone

VRC Physbone コンポーネントと共にアタッチすると、Event Type で選択したイベントをトリガーに Action Type の内容を実行します。

• Allowed Player Name List : この配列にセットした displayName 名のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Event Type : 実行対象にするイベントの種類
  • Physbone Grab And Release : 誰かがこの Physbone を握ったか離した時
  • Physbone Grab : 誰かがこの Physbone を握った時
  • Physbone Release : 誰かがこの Physbone を離した時
  • Physbone Pose And Unpose : 誰かがこの Physbone を固定したか固定解除した時
  • Physbone Pose : 誰かがこの Physbone を固定した時
  • Physbone Unpose : 誰かがこの Physbone を固定解除した時
• Accept Player Type : 実行対象にするプレイヤーの種類
  • All : 握った/固定したのが誰であっても実行する
  • Owner : このオブジェクトのオーナーの時
  • Others : 自分以外の誰かの時
  • Self : 自分自身の時

ActiveRelay by Contact

VRC Contact Receiver コンポーネントと共にアタッチすると、Event Type で選択したイベントをトリガーに Action Type の内容を実行します。
接触してきた VRC Contact Sender がアバターのものの場合は、そのアバターの操者プレイヤーを元に実行判断します。ワールドのものの場合はローカルプレイヤーとして実行判断します。

• Allowed Player Name List : 接触してきたコンタクトセンダーの持ち主が、この配列にセットした displayName 名のプレイヤーである場合のみ実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Event Type : 実行対象にするイベントの種類
  • Enter And Exit : コンタクトセンダーと"接触"したか接触状態から離れた時
  • Enter : コンタクトセンダーと"接触"した時
  • Exit : コンタクトセンダーとの接触状態から離れた時
• Accept Player Type : 実行対象にするプレイヤーの種類
  • All : 接触してきたコンタクトセンダーが誰のものであっても実行する
  • Owner : 接触してきたコンタクトセンダーがこのオブジェクトのオーナーのものの時 (この項目を使う機会は少ないと思います)
  • Others : 接触してきたコンタクトセンダーが自分以外の誰かのものの時
  • Self : 接触してきたコンタクトセンダーが自分のものの時
• Min Velociry : この速度以上でコンタクトセンダーが"接触"した時のみ実行します。接触状態から離れる時には影響しません

[!IMPORTANT] コンタクトレシーバーでできる制限はコンタクトレシーバーで設定してください。詳細は以下
https://vrc-beta-docs.netlify.app/common-components/contacts/

ActiveRelay by Join Leave

プレイヤーがインスタンスに参加または退室(Event Type で選択)した時に Action Type の内容を実行します。

• Allowed Player Name List : この配列にセットした displayName 名のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Event Type : 実行対象にするイベントの種類
  • Player Enter And Exit : 誰かが参加(Join)または退室(Leave)した時
  • Player Enter : 誰かが参加(Join)した時
  • Player Exit : 誰かが退室(Leave)した時
• Accept Player Type : 実行対象にするプレイヤーの種類
  • All : 参加/退室したのが誰であっても実行する
  • Owner : このオブジェクトのオーナーの時
  • Others : 自分以外の誰かの時
  • Self : 自分自身の時

ActiveRelay by PlayerRespawn

プレイヤーがリスポーンした時に Action Type の内容を実行します。

• Allowed Player Name List : この配列にセットした displayName のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Local Only : チェックすると、自分自身がリスポーンした時だけ実行します。デフォルト有効

ActiveRelay by PlayerCollision

Is Trigger チェックを外したコライダーと共にアタッチすると、プレイヤーが Event Type で選択したコリジョンイベントを発生させた時に Action Type の内容を実行します。
このオブジェクトはプレイヤーと衝突できるレイヤーになっている必要があります。

• Allowed Player Name List : この配列にセットした displayName のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Event Type : 実行対象にするイベントの種類
  • Player Enter And Exit : 誰かがコライダーに接触したか接触状態から離れた時
  • Player Enter : 誰かがコライダーに接触した時
  • Player Exit : 誰かがコライダー接触状態から離れた時
• Accept Player Type : 実行対象にするプレイヤーの種類
  • All : 接触した/離れたのが誰であっても実行する
  • Owner : このオブジェクトのオーナーの時
  • Others : 自分以外の誰かの時
  • Self : 自分自身の時

ActiveRelay by PlayerTrigger

Is Trigger チェックを入れたコライダーと共にアタッチすると、プレイヤーが Event Type で選択したトリガーイベントを発生させた時に Action Type の内容を実行します。
このオブジェクトはプレイヤーと衝突できるレイヤーになっている必要があります。

• Allowed Player Name List : この配列にセットした displayName のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Event Type : 実行対象にするイベントの種類
  • Player Enter And Exit : 自分含む誰かがコライダーに侵入したか侵入状態から離れた時
  • Player Enter : 自分含む誰かがコライダーに侵入した時
  • Player Exit : 自分含む誰かがコライダー侵入状態から離れた時
• Accept Player Type : 実行対象にするプレイヤーの種類
  • All : 侵入した/離れたのが誰であっても実行する
  • Owner : このオブジェクトのオーナーの時
  • Others : 自分以外の誰かの時
  • Self : 自分自身の時

ActiveRelay by PlayerParticleCollision

パーティクルシステムと共にアタッチすると、プレイヤーがパーティクルに接触した時に Action Type の内容を実行します。
パーティクルシステムの Collision モジュールが有効で、Send Collision Messages が有効になっている必要があります。

• Allowed Player Name List : この配列にセットした displayName のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Accept Player Type : 実行対象にするプレイヤーの種類
  • All : 接触したのが誰であっても実行する
  • Owner : このオブジェクトのオーナーの時
  • Others : 自分以外の誰かの時
  • Self : 自分自身の時

ActiveRelay by DroneTrigger

Is Trigger チェックを入れたコライダーと共にアタッチすると、VRC ドローンが Event Type で選択したトリガーイベントを発生させた時に Action Type の内容を実行します。
このオブジェクトは VRC ドローンと衝突できるレイヤーになっている必要があります。

• Allowed Player Name List : この配列にセットした displayName のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Event Type : 実行対象にするイベントの種類
  • Drone Enter And Exit : 自分含む誰かのドローンがコライダーに侵入したか侵入状態から離れた時
  • Drone Enter : 自分含む誰かのドローンがコライダーに侵入した時
  • Drone Exit : 自分含む誰かのドローンがコライダー侵入状態から離れた時
• Accept Player Type : 実行対象にするプレイヤーの種類
  • All : ドローンが誰のものであっても実行する
  • Owner : ドローンがこのオブジェクトのオーナーのものの時
  • Others : ドローンが自分以外の誰かのものの時
  • Self : ドローンが自分のものの時

ActiveRelay by Visible

Renderer系(Mesh Renderer, SkinnedMesh Renderer, Sprite Renderer, etc...)コンポーネントと共にアタッチすると、そのレンダラー(メッシュ)が視界内/外になった時に Action Type の内容を実行します。
視界内かどうかは、メッシュのBoundsとカメラの視錐台範囲によって判断されます。

• Allowed Player Name List : この配列にセットした displayName のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Event Type : 実行条件
  • Became Visible And Invisible : レンダラーが視界内になったか視界外になった時
  • Became Visible : レンダラーが視界内になった時
  • Became Invisible : レンダラーが視界外になった時

ActiveRelay by Collision

コライダーと共にアタッチすると、Reactive Colliders にセットしたコライダーと"衝突"した時に Action Type の内容を実行します。

• Allowed Player Name List : この配列にセットした displayName のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Event Type : 実行対象にするイベントの種類
  • Enter And Exit : 反応対象のコライダーと"衝突"したか衝突状態から離れた時
  • Enter : 反応対象のコライダーと"衝突"した時
  • Exit : 反応対象のコライダーとの衝突状態から離れた時
• Reactive Colliders : この配列にセットしたコライダーが反応対象となります

[!IMPORTANT] 衝突(Collision)や接触(Trigger)にはコライダーに加えて、片方に Rigidbody が必要です。詳細は以下
https://docs.unity3d.com/ja/2021.3/Manual/CollidersOverview.html

ActiveRelay by Trigger

コライダーと共にアタッチすると、Reactive Colliders にセットしたコライダーと"接触"した時に Action Type の内容を実行します。

• Allowed Player Name List : この配列にセットした displayName のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Event Type : 実行対象にするイベントの種類
  • Enter And Exit : 反応対象のコライダーと"接触"したか接触状態から離れた時
  • Enter : 反応対象のコライダーと"接触"した時
  • Exit : 反応対象のコライダーとの接触状態から離れた時
• Reactive Colliders : この配列にセットしたコライダーが反応対象となります

[!IMPORTANT] 衝突(Collision)や接触(Trigger)にはコライダーに加えて、片方に Rigidbody が必要です。詳細は以下
https://docs.unity3d.com/ja/2021.3/Manual/CollidersOverview.html

ActiveRelay by ParticleCollision

パーティクルシステムと共にアタッチすると、Reactive Colliders にセットしたコライダーと"衝突"した時に Action Type の内容を実行します。
パーティクルシステムの Collision モジュールが有効で、Send Collision Messages が有効になっている必要があります。

• Allowed Player Name List : この配列にセットした displayName のプレイヤーのみが実行できるようになります。配列 Size が0の時は制限されません
• Game Objects : この配列にセットしたゲームオブジェクトに対して Action Type の内容を実行します
• Action Type : オブジェクトのアクティブ操作の実行内容
  • Toggle Active : それぞれのオブジェクトのアクティブ状態を反転します
  • Activate : オブジェクトをアクティブにします
  • Deactivate : オブジェクトを非アクティブにします
• Event Type : 実行対象にするイベントの種類
  • Enter And Exit : 反応対象のコライダーと"衝突"したか衝突状態から離れた時
  • Enter : 反応対象のコライダーと"衝突"した時
  • Exit : 反応対象のコライダーとの衝突状態から離れた時
• Reactive Colliders : この配列にセットしたコライダーが反応対象となります