Interface OverlapEffectItem

アイテムに「触れた参加者への効果」（Overlap Effect）を設定するハンドルです。 ClusterScript.overlapEffectからアクセスできます。

効果が設定されている間、アイテムのOverlapDetectorShapeに触れた参加者に効果が適用されます。 ここでの参加者には、通常の参加者だけでなく、イベントのゴーストやグループビューイングの参加者も含まれます。 詳細はゴースト参加者についてを参照してください。

効果は種類ごとに1つ設定できます。効果を設定するメソッドを呼び出すたびに、同じ種類の以前の効果は新しい効果で置き換えられます。 異なる種類の効果は組み合わせて設定できます。

効果には単発効果と持続効果があります。 単発効果（setPosition / setRotation / respawn / addVelocity）は、参加者が範囲に入るたびに1回ずつ適用されます。 複数の単発効果が同時に適用される場合、その順序はそれぞれの効果が最後に設定された順になります。 持続効果（setMoveSpeedRate / setJumpSpeedRate / setGravity / setPostProcessEffects）は、参加者が範囲に入っている間適用され、 範囲から出るか、効果が解除されると適用されなくなります。 同じ種類の持続効果がほかに適用されていなければ、PlayerHandleなどで設定されている値に戻ります。 持続効果は、PlayerHandleやPlayerScriptによる同じ種類の設定より優先されます。 参加者に同じ種類の持続効果が複数適用されている場合、最後に設定された効果が有効になります。

効果の設定はアイテムの状態として同期され、後から入室した参加者が範囲に入った場合にも適用されます。 単発効果を設定・変更すると、既に範囲内にいる参加者にも1回適用されます。 同じ種類の単発効果を短い間隔で続けて設定した場合、途中の効果は適用されないことがあります。 持続効果を設定・変更すると、範囲内にいる参加者にもその場で適用・更新されます。

アイテムにOverlapDetectorShapeがない場合、効果は適用されません。