Playerクラス
情報
Playerクラスは、自分自身のプレイヤー(アバター)を表すものです。
クラス定義
class Player {
}
Playerのユーティリティー関数
hsPlayerGet
Player hsPlayerGet()
自分自身の Player インスタンスを取得する。
hsPlayerGetByID
Player hsPlayerGetByID(string PlayerID)
PlayerIDを指定して他のプレイヤーの Player インスタンスを取得する。
Playerクラス関数の呼び出し仕様変更について
SDK Ver12.x以降より、Playerクラスの関数はコンストラクタでの呼び出しができなくなりました。
インスタンスの取得を行いたい際は、例として以下のようなフラグとなるbool変数を用意して呼び出してください。
component PlayerInitSample
{
//Playerオブジェクトを定義
//ここではhsPlayerGetなどの取得関数を含め、オブジェクトの初期化はできないためにご注意ください
Player ex_player;
bool ex_isPlayerInit; //Playerクラス初期化管理
//コンストラクタ関数
public PlayerInitSample()
{
ex_isPlayerInit = false;
//ここでhsPlayerGet()は実行できません
}
//アップデート関数
public void update()
{
//Playerのインスタンス取得がまだの場合、一度だけhsPlayerGet()を実行する
if(!ex_isPlayerInit){
//Playerを認識・取得
ex_player = hsPlayerGet();
ex_isPlayerInit = true;
}
}
}
メソッド
GetID
string GetID()
プレイヤーを識別するIDを取得する。
SetControlEnabled
bool SetControlEnabled(bool Enabled)
プレイヤーの操作許可を設定します。falseに設定すると、WASDキーによる移動、マウスドラッグによるカメラ回転などがおこなえなくなります。
GetHeadHeight()
public float GetHeadHeight()
アバターの身長を取得する。
GetCustomState()
public string GetCustomState(string CustomStateName)
カスタムステートを任意のタイミングで取得する。
SetPos
void SetPos(Vector3 pos, bool CameraRotate = true)
座標を設定する。TPSモードかつCameraRotateがfalseの場合はカメラ回転はおこなわれません。
GetPos
Vector3 GetPos()
座標を取得する。
SetRotate
void SetRotate(float angle, bool CameraRotate = true)
プレイヤーの向きを設定する。
GetRotate
float GetRotate()
プレイヤーの向きを取得する。
SetJumpVelocity
void SetJumpVelocity(float JumpVelocity)
プレイヤーのジャンプ時の初速度を設定します。 デフォルト値はPlayer Settingsにて設定した数値が参照されます。
GetName
string GetName()
プレイヤーの名前を取得する。
GetPhysicsID
int GetPhysicsID()
PhysicsIDを取得する。
Emote
bool Emote(int EmoteIndex)
エモートを再生する。
SetEmotion
bool SetEmotion(int Index, string FileName, bool Loop, string ActionList)
エモーションを読み込む。
ActionListの文字列はSceneファイルに記述する"actions":{}の文字列を渡します。
ChangeMotion
bool ChangeMotion(string MotionName)
モーションを再生する。
SetNextMotion
bool SetNextMotion(string MotionName)
次に再生するモーションを設定する。
ChangeActivityMotion
bool ChangeActivityMotion(string MotionName)
アクティビティファイルで定義されたモーションを再生する。
SetNextActivityMotion
bool SetNextActivityMotion(string MotionName)
次に再生するアクティビティファイルで定義されたモーションを設定する。
ShowChatBalloon
bool ShowChatBalloon(string Text)
チャットバルーンに指定のテキストを表示します。
SetMoveSpeed
bool SetMoveSpeed(float MoveSpeed)
移動速度を設定します。単位はm/sです。
GetMoveSpeed
float GetMoveSpeed()
移動速度を取得します。単位はm/sです。
SetMoveSpeedupRatio
bool SetMoveSpeedupRatio(float MoveSpeedupRatio)
高速移動の倍率を設定します。
GetMoveSpeedupRatio
float GetMoveSpeedupRatio()
高速移動の倍率を取得します。
ResetVelocity
public void ResetVelocity()
プレイヤーの速度をリセットします。
SetPresetAvatar
bool SetPresetAvatar(int AvatarIndex)
プリセットアバターに切り替えます。自分自身のPlayerオブジェクトにのみ有効です。
GetPresetAvatar
int GetPresetAvatar()
プリセットアバターのインデックスを取得します。
マイアバターを使用していたり、Playerオブジェクトが無効な状態の場合は-1が返ります。