相機

公開類別 相機

代表虛擬相機，用於判斷觀看場景的視角。

如果相機是 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位置) 設定相機的位置。
void	setLocalRotation(四元數旋轉) 設定相機的旋轉角度。
void	setParent (NodeParent 父項) 不支援的作業。
void	setVerticalFovDegrees (浮點垂直 Fov) 設定非陣列相機的垂直視野 (以度為單位)。
void	setWorldPosition(Vector3位置) 設定相機的位置。
void	setWorldRotation (「Quarernion」旋轉) 設定相機的旋轉角度。
Vector3	worldToScreenPoint (Vector3 點) 將世界空間的點轉換成螢幕空間。

沿用的方法

來自類別 com.google.ar.sceneform.Node

void	addLifecycleListener (Node.LifecycleListener LifecycleListener) 新增監聽器，以便在發生節點生命週期事件時呼叫。
void	addTransformChangedListener(Node.TransformChangedListenertransformChangedListener) 新增監聽器，以便在節點和轉換發生變化時呼叫。
void	callOnHierarchy(Consumer<Node>consumer) 掃遍階層，並在每個節點 (包括這個節點) 上呼叫方法。
最終布林值	canAddChild(Node 子項，StringBuilder failedReason)
節點	findInHierarchy(述詞<節點> 條件) 掃遍階層，以找出符合特定條件的第一個節點 (包括這個節點)。
最終 Vector3	getBack() 取得這個節點的世界空間返迴向量 (+z)。
CollisionShape	getCollisionShape() 取得用於與這個節點衝突的形狀。
最終 Vector3	getDown() 取得這個節點的世界空間向下向量 (-y)。
最終 Vector3	getForward() 取得這個節點的世界空間向前向量 (-z)。
最終 Vector3	getLeft() 取得這個節點的世界空間左側向量 (-x)。
淺色	getLight() 取得目前可變動的光源。
最終 Vector3	getLocalPosition() 取得相對於其父項 (本機空間) 的節點位置副本。
最終 四元數	getLocalRotation() 取得相對於其父項 (本機空間) 的節點旋轉副本。
最終 Vector3	getLocalScale() 取得根據父項 (本機空間) 縮放的節點副本。
最終 String	getName() 傳回節點名稱。
最終節點	getParent() 傳回這個節點的父項。
可轉譯	getRenderable() 取得此節點可顯示的可轉譯項目。
最終 Vector3	getRight() 取得這個節點的世界空間右側向量 (+x)。
最終場景	getScene() 傳回這個節點所屬的情境，如果不是任何場景的一部分，則傳回空值。
最終 Vector3	getUp() 取得此節點的世界空間向量 (+y)。
最終 Vector3	getWorldPosition() 取得節點世界空間位置的副本。
最終 四元數	getWorldRotation() 取得節點世界空間旋轉的副本。
最終 Vector3	getWorldScale() 取得節點全球空間規模的副本。
最終布林值	isActive() 如果節點處於啟用狀態，則傳回「是」。
最終布林值	isDescendantOf (NodeParent 祖系) 檢查特定節點父項是否是週期性的節點。
最終布林值	isEnabled() 取得這個節點的啟用狀態。
布林	isTopLevel() 如果這個節點是頂層，則傳回「是」。
最終 Vector3	localToWorldDirection(Vector3 方向) 將這個節點的本機空間方向轉換為世界空間。
最終 Vector3	localToWorldPoint (Vector3 點) 將此節點的本機空間中的點轉換為世界空間。
void	onActivate() 在這個節點啟用時處理。
Final void	onAddChild (Node 子項)
void	onDisable() 在這個節點變為停用時處理。
Final void	onRemoveChild(Node 子項)
布林	onTouchEvent(HitTestResult HitTestResult、MotionEventMotionEvent) 在輕觸這個節點時處理。
void	onTransformChange (Node originingNode) 在這個節點的轉換變更時處理。
void	onUpdate(FrameTime frameTime) 在更新這個節點時處理。
void	removeLifecycleListener(Node.LifecycleListener LifecycleListener) 移除會在發生節點生命週期事件時呼叫的事件監聽器。
void	removeTransformChangedListener(Node.TransformChangedListenertransformChangedListener) 移除當節點的轉換作業變更時，系統會呼叫的事件監聽器。
void	setCollisionShape(CollisionShape collisionShape) 設定用於偵測這個 Node 是否有衝突的形狀。
Final void	setEnabled(已啟用布林值) 設定這個節點的啟用狀態。
void	setLight(淺色) 設定要顯示的 Light。
void	setLocalPosition(Vector3位置) 設定這個節點相對於其父項 (本機空間) 的位置。
void	setLocalRotation(四元數旋轉) 設定這個節點相對於其父項 (本機空間) 的旋轉方式。
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 (「Quarernion」旋轉) 設定這個節點的世界空間旋轉。
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 failedReason)
節點	findByName(String 名稱) 瀏覽階層以尋找具有指定名稱的第一個節點。
節點	findInHierarchy(述詞<節點> 條件) 請展開階層結構，找出符合特定條件的第一個節點。
最終 List<Node>	getChildren() 傳回這個父項的不可變動清單。
void	onAddChild(Node 子項)
void	onRemoveChild(Node 子項)
Final void	removeChild (Node 子項) 從這個 NodeParent 的子項中移除節點。

從 java.lang.Object 類別

物件	clone()
布林	等於(物件 arg0)
void	finalize()
最終 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 重新啟用前，第一個影格的呼叫開始前

publicRayscreenPointToRay(float x、float y)

計算世界空間中從相機近距離觀看到整個光源點的光源。螢幕空間位於 Android 裝置螢幕座標：TopLeft = (0, 0) BottomRight = (Screen Width, Screen Height) 裝置座標空間不受裝置的方向影響。

參數

x	裝置螢幕座標中的 X 位置。
年	裝置螢幕座標中的 Y 位置。

public setLocalPosition (Vector3 位置)

設定相機的位置。相機一律為 isTopLevel()，因此其行為與 setWorldPosition(Vector3) 相同。

如果相機是 ArSceneView 的一部分，系統不支援這項操作。無法變更相機的位置，由 ARCore 相機姿勢控制。

參數

position	要套用的位置。

public void setLocalRotation (Quaternion 輪替)

設定相機的旋轉角度。相機一律為 isTopLevel()，因此其行為與 setWorldRotation(Quaternion) 相同。

如果相機是 ArSceneView 的一部分，系統不支援這項操作。無法變更相機的旋轉角度，可由 ARCore 相機的姿勢控制。

參數

輪替	要套用的旋轉效果。

public setParent (NodeParent 父項)

不支援的作業。相機的家長無法變更，一律為場景。

參數

父項	這個節點所屬的子項的新父項。如果為空值，此節點就會從其上層卸離。

public setVerticalFovDegrees (float verticalFov)

設定非陣列相機的垂直視野 (以度為單位)。如果這是 AR 相機，則焦點來自 ARCore，而且無法設定，因此系統會擲回例外狀況。預設值為 90 度。

參數

verticalFov

擲回

SupportedOperationException	如果是 AR 相機

public setWorldPosition (Vector3 位置)

設定相機的位置。相機一律為 isTopLevel()，因此其行為與 setLocalPosition(Vector3) 相同。

如果相機是 ArSceneView 的一部分，系統不支援這項操作。無法變更相機的位置，由 ARCore 相機姿勢控制。

參數

position	要套用的位置。

public setWorldRotation (Quaternion 輪替)

設定相機的旋轉角度。相機一律為 isTopLevel()，因此其行為與 setLocalRotation(Quaternion) 相同。

如果相機是 ArSceneView 的一部分，系統不支援這項操作。無法變更相機的旋轉角度，可由 ARCore 相機的姿勢控制。

參數

輪替	要套用的旋轉效果。

public Vector3 worldToScreenPoint (Vector3 點)

將世界空間的點轉換成螢幕空間。

點在可視區域左側時，X 值會是負值，如果點位於可視區域內，X 的值就是 SceneView 的寬度；如果點位於可視區域右側，這個值就會大於寬度。

當 Y 值在可視區域下方時，Y 值會是負值，介於 0 到 SceneView 的高度時，如果該點位於可視區域內，則 Y 值大於高度。

Z 值一律為 0，因為傳回值是 2D 座標。

參數

分	世界的轉換點

傳回

• 一個新向量，代表畫面空間中的點。