PlayersetPosition() と setRotation() によるカメラ姿勢の操作を行っていない状態に相当するカメラ位置を計算します。
VR環境の場合、rotation や isFirstPersonView の値を無視し、 getPosition() と同じ値を返します。
VR環境ではない場合、rotation と isFirstPersonView の値に基づいたカメラの回転および視点に対応するカメラ位置を返します。
カメラのグローバル回転。ただし、ロール角成分は無視されます。
1人称視点の場合はtrue、3人称視点の場合はfalse。
現在のカメラ位置をグローバル座標で取得します。 VR環境の場合、プレイヤーの1人称視点の位置を取得します。 VR環境ではない場合、1人称視点/3人称視点の選択状態に基づいたカメラ位置を取得します。
VR環境以外でプレイヤーがアクセサリー編集を行っている場合、この関数ではアクセサリー編集中のカメラ位置は取得せず、 アクセサリー編集の終了後に適用予定のカメラ位置を取得します。
現在のカメラ回転をグローバル座標で取得します。 VR環境の場合、プレイヤーの1人称視点の回転を取得します。 VR環境ではない場合、1人称視点/3人称視点の選択状態に基づいたカメラ回転を取得します。
VR環境以外でプレイヤーがアクセサリー編集を行っている場合、この関数ではアクセサリー編集中のカメラ回転は取得せず、 アクセサリー編集の終了後に適用予定のカメラ回転を取得します。
プレイヤーが現在選択している視点が一人称視点であるかどうかを取得します。
VR環境のプレイヤーに対して呼び出した場合、つねにtrueが返ります。
VR環境ではないプレイヤーに対して呼び出した場合、現在そのプレイヤーが選んでいる視点が1人称視点ならばtrue、そうでなければfalseを返します。
この関数の結果は、カメラが特殊なモードになっていても有効な値を返します。
視点が有効であるかどうかを検証する場合、 CameraHandle.getPosition あるいは CameraHandle.getRotation を呼び出した結果がnullでないことを確認します。
プレイヤーが現在選択している視点が一人称視点かどうか
VR環境ではないプレイヤーに対して、視野角(Field of View)のデフォルト値を設定します。 視野角は画面の下端から上端までの、垂直方向の角度として指定します。
VR環境に対しても呼び出せますが、VR環境での視野角には影響しません。 この方法で視野角を変更したあとも、プレイヤーは引き続きズームイン/ズームアウト操作や、ズームによる1人称/3人称視点の切り替え操作を行えます。
この関数で指定した値はvalueにnullを指定して呼び出すか、またはPlayer Scriptの有効期間が終了した場合にリセットされます。
視野角のデフォルト値(degree)。指定した値は10以上80以下の範囲内に収められます。
trueにすると、補間を行わず、直ちに値を適用します。この値は省略可能で、省略するとfalse相当に扱われます
HUDやズームイン/ズームアウトによる1人称視点と3人称視点の切り替えをロックします。
この関数はプレイヤーがVR環境でも実行できますが、VR環境での挙動には影響しません。 この関数でプレイヤーによる視点切り替えの操作がロックされている場合でも、スクリプトからカメラ位置や視点を変更することは可能です。 また、Player Scriptの有効期間が終了した場合はHUDやズームイン/ズームアウトからの視点切り替えが可能になります。
ロックするかどうか
カメラ位置をグローバル座標で指定します。
この関数を呼び出したときの挙動は以下の通りです。
この関数で指定した値はpositionにnullを指定して呼び出すか、またはPlayer Scriptの有効期間が終了した場合にリセットされます。
リセットされた後は1人称視点/3人称視点の切り替え操作が再び有効になります。
また、この関数を呼び出す前に1人称視点であった場合は、リセット後に1人称視点に戻ります。
カメラのグローバル座標。
カメラ回転をグローバル回転で指定します。
この関数を呼び出したときの挙動は以下の通りです。
この関数でrotationにnullを指定して呼び出すか、またはPlayer Scriptの有効期間が終了した場合、プレイヤーがカメラ回転を操作できる状態に戻ります。
このときのカメラ回転は、最後にsetRotation()で指定していた回転からロール角成分を除去した値になります。
カメラのグローバル回転。
3人称視点のとき、アバターが正面方向に向くよう姿勢を固定するかどうかを設定します。 照準しながら使うようなアイテムを持っている場合にこの関数を呼び出すことで、3人称視点での挙動を最適化できます。
この関数はプレイヤーがVR環境や1人称視点の状態でも実行できますが、VR環境や1人称視点のときの挙動には影響しません。
この関数で指定した値はvalueにnullを指定して呼び出すか、またはPlayer Scriptの有効期間が終了した場合にリセットされます。
アバターの向きを正面方向に固定するかどうか
3人称視点のとき、アバターの頭部付近が画面上で映る位置を、スクリーン座標で指定します。
画面の左端がx=0、右端がx=1に対応します。
画面の下端がy=0、上端がy=1に対応します。
この関数はプレイヤーがVR環境や1人称視点の状態でも実行できますが、VR環境や1人称視点のときの挙動には影響しません。
この関数で指定した値はposにnullを指定して呼び出すか、またはPlayer Scriptの有効期間が終了した場合にリセットされます。
アバターの頭部付近が画面上に映る位置。x, yいずれの成分も0以上1以下の範囲内に収められます。
trueにすると、補間を行わず、直ちに値を適用します。この値は省略可能で、省略するとfalse相当に扱われます
3人称視点のときにアバターとカメラが取りうる最大の距離をメートル単位で指定します。
カメラとアバターの距離は必ずしも指定した値にはなりません。 アバターの周辺に壁や天井がある場合、指定した距離よりもアバターとカメラは近づく場合があります。
この関数はプレイヤーがVR環境や1人称視点の状態でも実行できますが、VR環境や1人称視点のときの挙動には影響しません。
この関数で指定した値はdistanceにnullを指定して呼び出すか、またはPlayer Scriptの有効期間が終了した場合にリセットされます。
アバターとカメラの距離の最大値。最小値は0.2で、これよも小さい値を指定した場合は0.2を指定したのと同様に扱われます。
trueにすると、補間を行わず、直ちに距離を適用します。この値は省略可能で、省略するとfalse相当に扱われます
1人称視点に切り替えます。
この関数はプレイヤーがVR環境や1人称視点の状態でも実行できますが、VR環境や1人称視点のときの挙動には影響しません。 また、 CameraHandle.setPosition によりカメラ位置が指定されている場合、この関数を呼び出しても視点は変更されません。
3人称視点に切り替えます。
この関数はプレイヤーがVR環境や3人称視点の状態でも実行できますが、VR環境や3人称視点のときの挙動には影響しません。 また、 CameraHandle.setPosition によりカメラ位置が指定されている場合、この関数を呼び出しても視点は変更されません。
プレイヤーのカメラワークを制御するハンドルです。 PlayerScript.cameraHandleで取得することができます。