Interface PlayerHandle

プレイヤーに速度を加えます。 プレイヤーの最終的な移動速度は、加えられた速度とプレイヤー入力の両方から決定されます。 プレイヤーが地面に接している間、加えられた速度は摩擦と似たような原理で減速し続けます。

ひとつのアイテムは、最大で10回/秒まで他のハンドルに対して操作することができます。 瞬間的にこの制限を超えることはできますが、平均回数はこの制限を下回るようにしてください。 制限を超えている場合、ClusterScriptError (rateLimitExceeded)が発生し操作は失敗します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーが入室中ならtrueを返し、退室済みならfalseを返します。 プレイヤーが通信の不具合などで一時的に非表示になっている場合もtrueを返します。

プレイヤーのヒューマノイドボーンの位置を取得します。 値はグローバル座標です。 アバターのロードが完了していない場合や、アバターにボーンが存在しない場合はnullが返されます。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーのヒューマノイドボーンの回転を取得します。 値はグローバル座標です。 アバターのロードが完了していない場合や、アバターにボーンが存在しない場合はnullが返されます。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーの位置（グローバル座標）を取得します。取得に失敗したときはnullを返します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーの向き（グローバル座標）を取得します。取得に失敗したときはnullを返します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーに文字列の入力を要求します。

入力要求を受けたプレイヤーには文字入力用のUIが表示されます。 プレイヤーが入力した文字列はClusterScript.onTextInputに設定したコールバックで受け取ることができます。 プレイヤーが入力できる文字列は、サイズが1000byte以下かつ文字数が250以下（ただしASCIIは1文字当たり0.5文字で換算します）に制限されます。 プレイヤーが入力要求に応答できない場合、送られた要求は自動的に拒否されます。 例えば、入力要求を受け取って文字列を入力している最中に新たに入力要求を受け取った場合はこれに該当します。 また、プレイヤーは入力要求を意図的に拒否することが可能です。 これらの入力要求の成否はTextInputStatusで表されます。

Example

$.onInteract(player => {
  player.requestTextInput("ask_name", "Hi, what is your name?");
});

ひとつのアイテムは、最大で10回/秒まで他のハンドルに対して操作することができます。 瞬間的にこの制限を超えることはできますが、平均回数はこの制限を下回るようにしてください。 制限を超えている場合、ClusterScriptError (rateLimitExceeded)が発生し操作は失敗します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーに設定された移動速度、ジャンプ速度、重力をリセットします。

ひとつのアイテムは、最大で10回/秒まで他のハンドルに対して操作することができます。 瞬間的にこの制限を超えることはできますが、平均回数はこの制限を下回るようにしてください。 制限を超えている場合、ClusterScriptError (rateLimitExceeded)が発生し操作は失敗します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーをリスポーンさせます。

ひとつのアイテムは、最大で10回/秒まで他のハンドルに対して操作することができます。 瞬間的にこの制限を超えることはできますが、平均回数はこの制限を下回るようにしてください。 制限を超えている場合、ClusterScriptError (rateLimitExceeded)が発生し操作は失敗します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーにかかる重力加速度（単位：m/s^2）を変更します。初期値は-9.81です。

ひとつのアイテムは、最大で10回/秒まで他のハンドルに対して操作することができます。 瞬間的にこの制限を超えることはできますが、平均回数はこの制限を下回るようにしてください。 制限を超えている場合、ClusterScriptError (rateLimitExceeded)が発生し操作は失敗します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーのアバターモデルの姿勢を、指定したHumanoidPoseで上書きします。 姿勢の上書き方法についてはoptionで指定することができます。optionで指定できるプロパティについては SetHumanoidPoseOption を参照してください。

引数のoptionは省略することができます。省略した場合にはデフォルトの設定値が用いられます。

HumanoidPoseのrootPosition, rootRotation, muscleのうち、指定されていない要素については上書きされません。 また、指定されていない要素についてはoption.timeoutSeconds、および option.timeoutTransitionSeconds は挙動に影響を与えず、上書きされない状態が継続します。 姿勢の上書きは、次にsetHumanoidPoseが呼び出される、もしくはoptionで指定したtimeoutで姿勢が解除されるまで継続します。

引数にnullまたは空のHumanoidPoseを渡すことで、setHumanoidPoseによるポーズの上書きを全て解除することができます。 引数にnullまたは空のHumanoidPoseをoptionと一緒に渡した場合、option.transitionSeconds かけて解除された状態に遷移します。

setHumanoidPoseによるポーズの上書きは、エモートやRidableItemによる姿勢の変更よりも優先されます。

VRではプレイヤーが掴んでいるアイテムは指定されたポーズに追従しますが、1人称のカメラやUI操作などは影響を受けません。

Example

// MyAnimationというIdのHumanoidAnimationを取得する。
const animation = $.humanoidAnimation("MyAnimation");
// ポーズを上書きする。
playerHandle.setHumanoidPose(animation.getSample(0));
// 上書きを解除する。
playerHandle.setHumanoidPose(null);

const animation = $.humanoidAnimation("MyAnimation");
const interval = 0.1;
const animationLength = animation.getLength();

// Interactした人をアニメーションの対象にする
$.onInteract(player => {
    if ($.state.player) {
        // すでに対象がいるときは解除
        $.state.player.setHumanoidPose(null);
    }
    $.state.animationTime = 0;
    $.state.waitingTime = 0;
    $.state.player = player;
});

$.onUpdate(deltaTime => {
    let player = $.state.player;
    if (!player || !player.exists()) return;

    let animationTime = $.state.animationTime + deltaTime;
    if (animationTime > animationLength) {
        animationTime = animationTime % animationLength;
    }
    let waitingTime = $.state.waitingTime + deltaTime;
    if (waitingTime >= interval) {
        let pose = animation.getSample(animationTime);
        // 前回送信時からの時間分だけかけて姿勢を遷移させる
        player.setHumanoidPose(pose, {transitionSeconds: waitingTime});
        waitingTime = 0;
    }
    $.state.animationTime = animationTime;
    $.state.waitingTime = waitingTime;
});

ひとつのアイテムは、最大で10回/秒まで他のハンドルに対して操作することができます。 瞬間的にこの制限を超えることはできますが、平均回数はこの制限を下回るようにしてください。 制限を超えている場合、ClusterScriptError (rateLimitExceeded)が発生し操作は失敗します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーのジャンプ速度の倍率を変更します。初期値は1です。

ひとつのアイテムは、最大で10回/秒まで他のハンドルに対して操作することができます。 瞬間的にこの制限を超えることはできますが、平均回数はこの制限を下回るようにしてください。 制限を超えている場合、ClusterScriptError (rateLimitExceeded)が発生し操作は失敗します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーの移動速度の倍率を変更します。初期値は1です。

ひとつのアイテムは、最大で10回/秒まで他のハンドルに対して操作することができます。 瞬間的にこの制限を超えることはできますが、平均回数はこの制限を下回るようにしてください。 制限を超えている場合、ClusterScriptError (rateLimitExceeded)が発生し操作は失敗します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーの位置を変更します。

ひとつのアイテムは、最大で10回/秒まで他のハンドルに対して操作することができます。 瞬間的にこの制限を超えることはできますが、平均回数はこの制限を下回るようにしてください。 制限を超えている場合、ClusterScriptError (rateLimitExceeded)が発生し操作は失敗します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

プレイヤーにポストプロセスエフェクトを設定します。

このメソッドを呼び出すたびに、以前設定されていたPostProcessEffectsは新しいPostProcessEffectsで上書きされます。

nullを設定するとすべてのエフェクトがクリアされます。

ひとつのアイテムは、最大で10回/秒まで他のハンドルに対して操作することができます。 瞬間的にこの制限を超えることはできますが、平均回数はこの制限を下回るようにしてください。 制限を超えている場合、ClusterScriptError (rateLimitExceeded)が発生し操作は失敗します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。

Example

// Interactするととても眩しくなるアイテム
$.onInteract((player) => {
    const effects = new PostProcessEffects();
    effects.bloom.active = true;
    effects.bloom.threshold.setValue(0.5);
    effects.bloom.intensity.setValue(10.0);
    player.setPostProcessEffects(effects);
});

プレイヤーの向きを変更します。 体の向きは鉛直のままで、y軸回転以外は動きません

ひとつのアイテムは、最大で10回/秒まで他のハンドルに対して操作することができます。 瞬間的にこの制限を超えることはできますが、平均回数はこの制限を下回るようにしてください。 制限を超えている場合、ClusterScriptError (rateLimitExceeded)が発生し操作は失敗します。

このメソッドは、このスクリプトを実行しているアイテムから 30メートル以内のプレイヤーに対してのみ実行できます。 制限を超えている場合、ClusterScriptError (distanceLimitExceeded)が発生し操作は失敗します。