相机

public class Camera

表示虚拟摄像头，用于确定通过哪个视角查看场景。

如果摄像头属于 ArSceneView，它会自动跟踪来自 ARCore 的摄像头姿势。此外，以下方法会在调用时抛出 UnsupportedOperationException：

• setParent(NodeParent) - 相机的父级无法更改，始终是场景。
• setLocalPosition(Vector3) - 相机的位置无法更改，它由 ARCore 相机姿势控制。
• setLocalRotation(Quaternion) - 相机的旋转角度无法更改，由 ARCore 相机姿势控制。
• setWorldPosition(Vector3) - 相机的位置无法更改，它由 ARCore 相机姿势控制。
• setWorldRotation(Quaternion) - 相机的旋转角度无法更改，由 ARCore 相机姿势控制。

Node 支持所有其他功能。您可以访问相机的位置和旋转，为相机指定碰撞形状，或向相机添加子项。停用相机会关闭渲染功能。

公共方法

浮点数	getFarClipPlane()
浮点数	getNearClipPlane()
浮点数	getVerticalFovDegrees() 获取相机的垂直视野范围。
射线	screenPointToRay（浮点数 x、浮点数 y） 计算从相机近平面进入屏幕空间点的一条光线。
无效	setLocalPosition(Vector3 位置) 设置相机的位置。
无效	setLocalRotation（四元数旋转） 设置相机的旋转角度。
无效	setParent(NodeParent) 操作不受支持。
无效	setVerticalFovDegrees（浮点数行业 Fov） 设置非 ar 摄像头的垂直视野范围（以度为单位）。
无效	setWorldPosition(Vector3 位置) 设置相机的位置。
无效	setWorldRotation（四元数旋转） 设置相机的旋转角度。
Vector3	worldToScreenPoint（Vector3 点） 将点从世界空间转换为屏幕空间。

继承的方法

继承自 com.google.ar.sceneform.Node 类

无效	addLifecycleListener(Node.LifecycleListener lifecycleListener) 添加将在节点生命周期事件发生时调用的监听器。
无效	addTransformChangedListener(Node.TransformChangedListener TransformChangedListener) 添加将在节点的转换发生变化时调用的监听器。
无效	callOnHierarchy（消费者节点&gt；消费者） 遍历层次结构并在每个节点（包括该节点）上调用方法。
final 布尔值	canAddChild（Node 子节点、StringBuilder失败原因）
节点	findInHierarchy(Predicate<Node>condition) 遍历层次结构以查找第一个满足条件的节点（包括该节点）。
final Vector3	getBack() 获取此节点的世界空间返回矢量 (+z)。
CollisionShape	getCollisionShape() 获取用于与此节点冲突的形状。
final Vector3	getDown() 获取此节点的世界空间向下矢量 (-y)。
final Vector3	getForward() 获取此节点的世界空间正向量 (-z)。
final Vector3	getLeft() 获取此节点的世界空间左矢量 (-x)。
浅色	getLight() 获取可变的当前光照。
final Vector3	getLocalPosition() 获取节点相对于其父级（本地空间）位置的副本。
最终 四元数	getLocalRotation() 获取节点相对于其父级（本地空间）旋转的副本。
final Vector3	getLocalScale() 获取节点相对于其父项（本地空间）的比例的副本。
final String	getName() 返回节点的名称。
final Node	getParent() 返回此节点的父级。
可渲染对象	getRenderable() 获取为此节点显示的可渲染对象。
final Vector3	getRight() 获取此节点的世界空间右向量 (+x)。
最终 场景	getScene() 返回此节点所属的场景；如果此节点不是任何场景的一部分，则返回 null。
final Vector3	getUp() 获取此节点的世界空间向上矢量 (+y)。
final Vector3	getWorldPosition() 获取节点世界空间位置的副本。
最终 四元数	getWorldRotation() 获取节点世界空间旋转的副本。
final Vector3	getWorldScale() 获取节点世界空间比例的副本。
final 布尔值	isActive() 如果节点处于活动状态，则返回 true。
final 布尔值	isDescendantOf（NodeParent 祖先实体） 检查给定节点父项是否为递归的此节点的祖先实体。
final 布尔值	isEnabled() 获取此节点的启用状态。
布尔值	isTopLevel() 如果该节点是顶级，则返回 true。
final Vector3	localToWorldDirection(Vector3 方向) 将方向从此节点的本地空间转换为真实世界空间。
final Vector3	localToWorldPoint（Vector3 点） 将此节点的本地空间中的点转换为世界空间。
无效	onActivate() 处理此节点何时变为活动状态。
final void	onAddChild（子节点）
无效	onDisable() 处理此节点何时变为非活跃状态。
final void	onRemoveChild（Node 子项）
布尔值	onTouchEvent（HitTestResulthitTestResult、MotionEvent motionEvent） 处理轻触此节点时的操作。
无效	onTransformChange(Node源节点) 处理此节点的转换发生更改时。
无效	onUpdate(FrameTime frameTime) 此节点更新时处理。
无效	removeLifecycleListener(Node.LifecycleListener lifecycleListener) 移除在节点生命周期事件发生时调用的监听器。
无效	removeTransformChangedListener(Node.TransformChangedListener TransformChangedListener) 移除节点转换更改时调用的监听器。
无效	setCollisionShape(CollisionShape collisionShape) 将形状设置为用于检测此 Node 的冲突。
final void	setEnabled（布尔值已启用） 设置此节点的启用状态。
无效	setLight（浅色） 设置要显示的 Light。
无效	setLocalPosition(Vector3 位置) 设置此节点相对于其父级（本地空间）的位置。
无效	setLocalRotation（四元数旋转） 设置此节点相对于其父项（本地空间）的旋转角度。
无效	setLocalScale（Vector3 缩放） 设置此节点相对于其父项（本地空间）的缩放比例。
final void	setLookDirection(Vector3 LookDirection) 设置节点在真实世界空间中的方向。
final void	setLookDirection（Vector3 LookDirection、Vector3 upDirection） 设置节点在真实世界空间中的方向。
final void	setName(String name) 设置此节点的名称。
无效	setOnTapListener(Node.OnTapListener onTapListener) 注册点按此节点时要调用的回调。
无效	setOnTouchListener(Node.OnTouchListener onTouchListener) 注册在将触摸事件分派给此节点时要调用的回调。
无效	setParent(NodeParent) 更改此节点的父节点。
无效	setRenderable（可渲染对象） 设置要为此节点显示的 Renderable。
无效	setWorldPosition(Vector3 位置) 设置此节点的世界空间位置。
无效	setWorldRotation（四元数旋转） 设置此节点的世界空间旋转角度。
无效	setWorldScale（Vector3 缩放） 设置此节点的世界空间比例。
字符串	toString
final Vector3	worldToLocalDirection（Vector3 方向） 将方向从真实世界转换为此节点的本地空间。
final Vector3	worldToLocalPoint（Vector3 点） 将真实世界空间中的点转换为此节点的本地空间。

继承自 com.google.ar.sceneform.NodeParent 类

final void	addChild(Node 子节点) 添加节点作为此 NodeParent 的子节点。
无效	callOnHierarchy（消费者节点&gt；消费者） 遍历层次结构，并在每个节点上调用一个方法。
布尔值	canAddChild（Node 子节点、StringBuilder失败原因）
节点	findByName（字符串名称） 遍历层次结构以查找具有给定名称的第一个节点。
节点	findInHierarchy(Predicate<Node>condition) 遍历层次结构以查找第一个满足条件的节点。
final List<Node&g;	getChildren() 返回此父级的子级的不可变列表。
无效	onAddChild（子节点）
无效	onRemoveChild（Node 子项）
final void	removeChild（节点子项） 从此 NodeParent 的子项中移除节点。

继承自类 java.lang.Object

对象	clone()
布尔值	equals(Object arg0)
无效	finalize()
final Class<?>	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 会话恢复后的第一帧才会恢复，在这种情况下，系统会抛出 IllegalStateException。

否则，将返回由 setVerticalFovDegrees(float) 设置的值，默认值为 90 度。

抛出

IllegalStateException	如果在 ARCore 恢复后的第一帧之前调用，

public Ray screenPointToRay (float x, float y)

计算从相机近平面进入屏幕空间点的一条光线。屏幕空间采用 Android 设备屏幕坐标：TopLeft = (0, 0) BottomRight =（屏幕宽度、屏幕高度）设备坐标空间不受设备的屏幕方向影响。

参数

x	设备屏幕坐标中的 X 轴位置。
y	设备屏幕坐标中的 Y 轴位置。

public void setLocalPosition (Vector3 position)

设置相机的位置。相机始终为 isTopLevel()，因此它的行为与 setWorldPosition(Vector3) 相同。

如果相机是 ArSceneView 的一部分，则此操作不受支持。相机的位置无法更改，它由 ARCore 相机姿势控制。

参数

position	要应用的职位。

public void setLocalRotation (Quaternionrot)

设置相机的旋转角度。相机始终为 isTopLevel()，因此它的行为与 setWorldRotation(Quaternion) 相同。

如果相机是 ArSceneView 的一部分，则此操作不受支持。无法更改相机的旋转角度，旋转角度由 ARCore 相机姿势控制。

参数

旋转	要应用的旋转角度。

public void setParent (NodeParent parent)

操作不受支持。无法更改摄像头的父项，它始终是场景。

参数

父级	此节点将作为其子节点的新父节点。如果为 null，此节点将与父节点分离。

public void setVerticalFovDegrees (float verticalFov)

设置非 ar 摄像头的垂直视野范围（以度为单位）。如果这是 AR 相机，则 fov 来自 ARCore 且无法设置，因此会抛出异常。默认值为 90 度。

参数

verticalFov

抛出

UnsupportedOperationException	如果这是 AR 相机

public void setWorldPosition (Vector3 position)

设置相机的位置。相机始终为 isTopLevel()，因此它的行为与 setLocalPosition(Vector3) 相同。

如果相机是 ArSceneView 的一部分，则此操作不受支持。相机的位置无法更改，它由 ARCore 相机姿势控制。

参数

position	要应用的职位。

public void setWorldRotation (Quaternion 旋转)

设置相机的旋转角度。相机始终为 isTopLevel()，因此它的行为与 setLocalRotation(Quaternion) 相同。

如果相机是 ArSceneView 的一部分，则此操作不受支持。无法更改相机的旋转角度，旋转角度由 ARCore 相机姿势控制。

参数

旋转	要应用的旋转角度。

public Vector3 worldToScreenPoint (Vector3 point)

将点从世界空间转换为屏幕空间。

当该点位于视口左侧时，X 值为负值；该点位于视口内时，X 值介于 0 和 SceneView 宽度之间；当该点位于视口右侧时，X 值大于宽度。

当该点位于视口下方时，Y 值为负值；当该点在视口内时，Y 值介于 SceneView 和 0 之间；当该点在视口上方时，Y 值会大于该高度。

Z 值始终为 0，因为返回值是 2D 坐标。

参数

point	要转换的世界空间中的点

返回

• 表示屏幕空间中点的新矢量。