AnchorNode

公開類別 AnchorNode

自動根據 ARCore Anchor 在世界空間自動定位的節點。

如果未追蹤錨定標記，系統會停用這個節點中的所有子項。

公用建構函式

	AnchorNode() 建立不含錨點的 AnchorNode，
	AnchorNode(Anchor 錨點) 使用指定錨點建立 AnchorNode，

公用方法

錨點	getAnchor() 傳回 ARCore 錨點 (如果有的話)，否則為空值。
布林	isSmoothed() 如果轉換是插補，則傳回「True」；如果立即套用轉換，則傳回「False」。
布林	isTracking() 如果 ARCore 錨點的追蹤狀態為「TRACKING」，則傳回「是」。
void	onUpdate(FrameTime frameTime) AnchorNode 會覆寫此節點，以更新節點的位置與 ARCore Anchor' 的位置。
void	setAnchor (Anchor (錨點)) 設定 ARCore 錨點，並強制立即更新這個節點的位置。
void	setLocalPosition(Vector3位置) 設定這個節點的錨定空間 (如果並未設定)。
void	setLocalRotation(四元數旋轉) 設定這個節點的錨定空間時，如果並未固定。
void	setSmoothed (布林值平滑) 設為 true 即可使節點目前位置和錨定位置之間的轉場效果順暢。
void	setWorldPosition(Vector3位置) 設定這個節點的錨定空間 (如果並未設定)。
void	setWorldRotation (「Quarernion」旋轉) 設定這個節點的錨定空間 (如果已錨定)。

沿用的方法

來自類別 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 AnchorNode ()

建立不含錨點的 AnchorNode，

公開 AnchorNode (Anchor 錨點)

使用指定錨點建立 AnchorNode，

參數

錨定標記	這個節點會自動定位的 ARCore 錨點。

公用方法

public錨定 getAnchor ()

傳回 ARCore 錨點 (如果有的話)，否則為空值。

公開布林值 isSmoothed ()

如果轉換是插補，則傳回「True」；如果立即套用轉換，則傳回「False」。

public 布林值 isTracking ()

如果 ARCore 錨點的追蹤狀態為「TRACKING」，則傳回「是」。

public onUpdate (FrameTime frameTime)

AnchorNode 會覆寫此節點，以更新節點的位置與 ARCore Anchor' 的位置。

參數

frametime	提供目前畫格的時間資訊

public setAnchor (Anchor 錨點)

設定 ARCore 錨點，並強制立即更新這個節點的位置。

參數

錨定標記	這個節點會自動定位的 ARCore 錨點。

public setLocalPosition (Vector3 位置)

設定這個節點的錨定空間 (如果並未設定)。如果節點是固定的，此呼叫就不會採取任何行動。

參數

position	要套用的位置。

public void setLocalRotation (Quaternion 輪替)

設定這個節點的錨定空間時，如果並未固定。如果節點是固定的，此呼叫就不會採取任何行動。

參數

輪替	要套用的旋轉效果。

public setSmoothed (布林值平滑)

設定 true 即可順暢處理節點目前位置和錨點位置之間的轉換。設定 false，即可立即套用轉換。根據預設，系統會採用流暢設定。

參數

平滑	轉換作業是否是內插。

public setWorldPosition (Vector3 位置)

設定這個節點的錨定空間 (如果並未設定)。如果節點是固定的，此呼叫就不會採取任何行動。

參數

position	要套用的位置。

public setWorldRotation (Quaternion 輪替)

設定這個節點的錨定空間 (如果已錨定)。如果節點是固定的，此呼叫就不會採取任何行動。

參數

輪替	要套用的旋轉效果。