SkeletonNode

公開類別 SkeletonNode

Node 提供膚色 ModelRenderable 的骨骼和一組 Node 之間的對應。

播放動畫時，系統會在 onUpdate(FrameTime) 期間設定附加的 Node 轉換。

操控附加的 Node 也會轉換相應的骨骼。子項架構不會自動轉換。如要變更子項骨骼的轉換，您必須將子骨頭附加至子項節點。在播放動畫時，節點和骨骼會在 onUpdate(FrameTime) 期間設為每個影格的動畫狀態。不過，您可以在每個影格的 onUpdate(FrameTime) 之後操作附加的 Node，以便在動畫播放時操控骨骼。

如果附加的 Node' 的 isActive() 為 false，系統就不會轉換這些轉換，也不會轉換布林值。

如果繫結的 Node 繫結至與 ModelRenderable 中的任何骨骼不相符的 boneName，則不會轉換。

呼叫 setRenderable(Renderable) 不會影響 Node 對應。附加的 Nodes' 轉換會立即設為新 ModelRenderable 中相符骨骼的姿勢。

公用建構函式

SkeletonNode()

公用方法

節點	getBoneAttachment(String boneName) 傳回附加至指定骨骼的 Node。
void	onUpdate(FrameTime frameTime) 在更新這個節點時處理。
void	setBoneAttachment(String boneName、Node 節點) 將 Node 附加至指定的 boneName。
void	setRenderable(可轉譯) 設定此節點顯示的 Renderable。

沿用的方法

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

公用建構函式

公開 SkeletonNode ()

公用方法

公開 Node getBoneAttachment (String boneName)

傳回附加至指定骨骼的 Node。如果此骨骼未附加 Node，則會傳回空值。

參數

骨骼名稱

public onUpdate (FrameTime frameTime)

在更新這個節點時處理。一個節點會在轉譯每個影格前更新。只有在節點處於啟用狀態時，才會呼叫此方法。

覆寫以執行每個頁框所需的更新。

參數

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

public setBoneAttachment(String boneName、Node節點)

將 Node 附加至指定的 boneName。系統會立即將 Node 的轉換設為 getRenderable() 中的骨骼名稱 (如果有的話)。

如果 Node 為空值，任何先前附加的 Node 都會卸離。一個 Node 只能附加至一個 BoneName。

參數

骨骼名稱
個節點

public void setRenderable (可轉譯可轉譯)

設定此節點顯示的 Renderable。如未設定 setCollisionShape(CollisionShape)，系統會使用 getCollisionShape() 偵測此 Node 的衝突。

參數

可轉譯	通常是 3D 模型。如果為空值，系統將移除這個節點的現有可轉譯內容。