カメラ

パブリック クラス カメラ

シーンが表示される視点を決定する仮想カメラを表します。

カメラが ArSceneView の一部である場合、カメラは ARCore からカメラのポーズを自動的に追跡します。また、以下のメソッドは、呼び出されると UnsupportedOperationException をスローします。

• setParent(NodeParent) - カメラの親は変更できず、常にシーンになります。
• setLocalPosition(Vector3) - カメラの位置は変更できません。ARCore のカメラ ポーズによって制御されます。
• setLocalRotation(Quaternion) - カメラの回転は変更できません。ARCore のカメラのポーズによって制御されます。
• setWorldPosition(Vector3) - カメラの位置は変更できません。ARCore のカメラ ポーズによって制御されます。
• setWorldRotation(Quaternion) - カメラの回転は変更できません。ARCore のカメラのポーズによって制御されます。

Node の他のすべての機能がサポートされています。カメラの位置と回転にアクセスしたり、カメラに衝突シェイプを割り当てたり、カメラに子を追加したりできます。カメラを無効にすると、レンダリングはオフになります。

パブリック メソッド

浮動小数点数	getFarClipPlane()
浮動小数点数	getNearClipPlane()
浮動小数点数	getVerticalFovDegrees() カメラの垂直視野を取得します。
Ray	screenPointToRay（浮動小数点数 x、浮動小数点数 y） カメラのほぼ平面から、画面空間の特定のポイントを経由するワールド空間の光線を計算します。
void	setLocalPosition(Vector3 position) カメラの位置を設定します。
void	setLocalRotation（Quaternion ローテーション） カメラの回転を設定します。
void	setParent（NodeParent の親） サポートされていない操作です。
void	setVerticalFovDegrees（float verticalFov） 非 AR カメラの垂直視野を度数で設定します。
void	setWorldPosition（Vector3 の位置） カメラの位置を設定します。
void	setWorldRotation（Quaternion ローテーション） カメラの回転を設定します。
Vector3	worldToScreenPoint（Vector3 ポイント） ポイントをワールド空間からスクリーン空間に変換します。

継承されるメソッド

クラス com.google.ar.sceneform.Node から

void	addLifecycleListener(Node.LifecycleListenerlifecycleListener) ノードのライフサイクル イベントが発生したときに呼び出されるリスナーを追加します。
void	addTransformChangedListener（Node.TransformChangedListener transformChangedListener） ノードの変換が変更されたときに呼び出されるリスナーを追加します。
void	callOnHierarchy(Consumer<Node> consumer) 階層を走査し、各ノード（このノードを含む）でメソッドを呼び出します。
最終ブール値	canAddChild（Node 子、StringBuilder failureReason）
ノード	findInHierarchy(Predicate<Node> condition) 階層を走査して、条件を満たす最初のノード（このノードを含む）を探します。
最終 Vector3	getBack() このノードのワールド空間バックベクトル（+z）を取得します。
CollisionShape	getCollisionShape() このノードとの衝突に使用するシェイプを取得します。
最終 Vector3	getDown() このノードの世界空間ダウン ベクトル（-y）を取得します。
最終 Vector3	getForward() このノードの世界空間フォワード ベクトル（-z）を取得します。
最終 Vector3	getLeft() このノードのワールド空間左ベクトル（-x）を取得します。
軽め	getLight() 現在のライトを取得します。これは可変です。
最終 Vector3	getLocalPosition() 親（ローカル空間）に対するノードの位置のコピーを取得します。
最終四分位	getLocalRotation() 親（ローカル空間）に対するノードの回転のコピーを取得します。
最終 Vector3	getLocalScale() 親（ローカル空間）を基準にしてスケールされるノードのコピーを取得します。
final 文字列	getName() ノードの名前を返します。
最終ノード	getParent() このノードの親を返します。
レンダリング可能	getRenderable() このノード用にレンダリングするレンダリング可能なものを取得します。
最終 Vector3	getRight() このノードのワールド空間右ベクトル（+x）を取得します。
最終 シーン	getScene() このノードが属しているシーンを返します。シーンの一部でない場合は null を返します。
最終 Vector3	getUp() このノードの世界空間上ベクトル（+y）を取得します。
最終 Vector3	getWorldPosition() ノードの世界空間位置のコピーを取得します。
最終四分位	getWorldRotation() ノードの世界空間回転のコピーを取得します。
最終 Vector3	getWorldScale() ノードの世界空間スケールのコピーを取得します。
最終ブール値	isActive() ノードがアクティブな場合は true を返します。
最終ブール値	isDescendantOf（NodeParent 祖先） 特定のノードの親がこのノードの祖先を再帰的かどうかを確認します。
最終ブール値	isEnabled() このノードの有効状態を取得します。
ブール値	isTopLevel() このノードが最上位である場合、true を返します。
最終 Vector3	localToWorldDirection（Vector3 方向） ルートがこのノードのローカル空間からワールド空間に変換されます。
最終 Vector3	localToWorldPoint（Vector3 ポイント） このノードのローカル空間内の点をワールド空間に変換します。
void	onActivate() このノードがアクティブになった場合を処理します。
final void	onAddChild（Node 子）
void	onActivate() このノードが無効になったときに対処します。
final void	onRemoveChild（Node 子）
ブール値	onTouchEvent（HitTestResult HitTestResult、MotionEvent motionEvent） このノードがタップされた場合を処理します。
void	onTransformChange（ノード送信元ノード） このノードの変換が変更された場合を処理します。
void	onUpdate（FrameTime frameTime） このノードが更新されたときを処理します。
void	removeLifecycleListener（Node.LifecycleListenerlifecycleListener） ノードのライフサイクル イベントが発生したときに呼び出されるリスナーを削除します。
void	removeTransformChangedListener（Node.TransformChangedListener transformChangedListener） ノードの変換が変更されたときに呼び出されるリスナーを削除します。
void	setCollisionShape（CollisionShape collisionShape） この Node との競合を検出するために使用される形状を設定します。
final void	setEnabled（ブール値が有効） このノードの有効状態を設定します。
void	setLight（Light ライト） 表示する Light を設定します。
void	setLocalPosition(Vector3 position) このノードを親（ローカル空間）に対する相対位置で設定します。
void	setLocalRotation（Quaternion ローテーション） このノードの親（ローカル空間）に対する回転を設定します。
void	setLocalScale（Vector3 スケール） このノードのスケールを親（ローカル空間）に対する相対値で設定します。
final void	setLookDirection（Vector3 lookDirection） ワールド空間内でノードが向いている方向を設定します。
final void	setLookDirection（Vector3 lookDirection、Vector3 upDirection） ワールド空間内でノードが向いている方向を設定します。
final void	setName（String 名） このノードの名前を設定します。
void	setOnTapListener（Node.OnTapListener onTapListener） このノードがタップされたときに呼び出されるコールバックを登録します。
void	setOnTouchListener（Node.OnTouchListener onTouchListener） タッチイベントがこのノードにディスパッチされたときに呼び出されるコールバックを登録します。
void	setParent（NodeParent の親） このノードの親ノードを変更します。
void	setRenderable（レンダリング可能レンダリング可能） このノードに表示する Renderable を設定します。
void	setWorldPosition（Vector3 の位置） このノードの世界空間の位置を設定します。
void	setWorldRotation（Quaternion ローテーション） このノードの世界空間の回転を設定します。
void	setWorldScale（Vector3 スケール） このノードの世界空間スケールを設定します。
文字列	toString()
最終 Vector3	worldToLocalDirection（Vector3 方向） 方向をワールド空間からこのノードのローカル空間に変換します。
最終 Vector3	worldToLocalPoint（Vector3 ポイント） ワールド空間内の点をこのノードのローカル空間に変換します。

クラス com.google.ar.sceneform.NodeParent から

final void	addChild（Node 子） この NodeParent の子としてノードを追加します。
void	callOnHierarchy(Consumer<Node> consumer) 階層を走査し、各ノードでメソッドを呼び出します。
ブール値	canAddChild（Node 子、StringBuilder failureReason）
ノード	findByName（String 名） 階層を走査して、指定した名前の最初のノードを探します。
ノード	findInHierarchy(Predicate<Node> condition) 階層を走査して、条件を満たす最初のノードを見つける。
最終リスト<ノード>	getChildren() この親の子の不変のリストを返します。
void	onAddChild（Node 子）
void	onRemoveChild（Node 子）
final void	removeChild（Node 子） この NodeParent の子からノードを削除します。

java.lang.Object クラスから

オブジェクト	clone()
ブール値	equals(Object arg0)
void	finalize()
finalClass<PLURALgt;	getClass()
整数	hashCode()
final void	notify()
final void	notifyAll()
文字列	toString()
final void	wait(long arg0, int arg1)
final void	wait（long arg0）
final void	wait()

パブリック メソッド

public float getFarClipPlane ()

public float getNearClipPlane ()

public float getVerticalFovDegrees ()

カメラの垂直画角を取得します。

これが AR カメラの場合、ARCore のカメラ情報に基づいて計算され、デバイスによって異なる場合があります。ARCore セッションが再開された後の最初のフレームまで計算できません。この場合、違法状態例外がスローされます。

それ以外の場合は、setVerticalFovDegrees(float) によって設定された値を返します。デフォルトは 90 度です。

スロー値

IllegalStateException	ARCore が再開したら、最初のフレームの前に呼び出された場合

public Ray screenPointToRay (float x, float y)

カメラのほぼ平面から、画面空間の特定のポイントを経由するワールド空間の光線を計算します。画面スペースは Android デバイスの画面座標です。TopLeft = (0, 0) BottomRight = (Screen Width, Screen Height) デバイスの座標空間はデバイスの向きの影響を受けません。

パラメータ

x	デバイスの画面座標における X 座標。
y	デバイスの画面座標の Y 位置。

public void setLocalPosition (Vector3 の位置)

カメラの位置を設定します。カメラは常に isTopLevel() であるため、これは setWorldPosition(Vector3) と同じように動作します。

カメラが ArSceneView の一部である場合、これはサポートされていない操作です。 カメラの位置は変更できず、ARCore のカメラ ポーズで制御されます。

パラメータ

position	適用する位置。

public void setLocalRotation (Quaternion ローテーション)

カメラの回転を設定します。カメラは常に isTopLevel() であるため、これは setWorldRotation(Quaternion) と同じように動作します。

カメラが ArSceneView の一部である場合、これはサポートされていない操作です。 カメラの回転は ARCore カメラのポーズによって制御され、変更できません。

パラメータ

回転	適用するローテーション。

public void setParent (NodeParent の親)

サポートされていない操作です。カメラの親は変更できず、常にシーンです。

パラメータ

親	このノードが子になる新しい親。null の場合、このノードはその親から切り離されます。

public void setVerticalFovDegrees (float verticalFov)

非 AR カメラの垂直視野を度数で設定します。AR カメラの場合、fov は ARCore から発生し、設定できないため、例外がスローされます。デフォルトは 90 度です。

パラメータ

VerticalFov

スロー値

UnsupportedOperationException	AR カメラの場合

public void setWorldPosition (Vector3 の位置)

カメラの位置を設定します。カメラは常に isTopLevel() であるため、これは setLocalPosition(Vector3) と同じように動作します。

カメラが ArSceneView の一部である場合、これはサポートされていない操作です。 カメラの位置は変更できず、ARCore のカメラ ポーズで制御されます。

パラメータ

position	適用する位置。

public void setWorldRotation （四元数の回転）

カメラの回転を設定します。カメラは常に isTopLevel() であるため、これは setLocalRotation(Quaternion) と同じように動作します。

カメラが ArSceneView の一部である場合、これはサポートされていない操作です。 カメラの回転は ARCore カメラのポーズによって制御され、変更できません。

パラメータ

回転	適用するローテーション。

public Vector3 worldToScreenPoint (Vector3 ポイント)

ポイントをワールド空間から画面スペースに変換します。

X の値は、ポイントがビューポートの左側にあり、0 から SceneView の幅（ビューポート内にある場合）または SceneView の幅（ポイントがビューポートの右側にある場合）の負の値になります。

点がビューポートの下にある場合、Y 値は負であり、0 から SceneView の高さは（ポイントがビューポート内にある場合）、その位置がビューポートより上にある場合の高さよりも大きくなります。

戻り値は 2D 座標であるため、Z 値は常に 0 です。

パラメータ

point	コンバージョンを達成する地点

戻り値

• 画面空間の点を表す新しいベクトル。