8 月節

公用類別 開始建立 FaceNode

使用 ARCore' AugmentedFace 功能在節點上算繪視覺效果的節點。

視覺效果可由兩個元件組成：臉孔網格和臉孔區域可轉譯。

臉部網格用於將 2D 圖片以視覺化方式顯示在他人的臉部上。可呈現的臉部區域會呈現視覺化的 3D 物件 (例如「狐狸」的鼻子和耳朵)，而這些物體會隨著 ARCore 追蹤的臉部區域移動。

建立可轉譯的臉孔區域時，這些區域會對應至模型中的骨骼。使用提供的範例 .fbx 檔案匯出能以正確格式轉譯的臉孔區域。

這個節點已放置於符合 getCenterPose() 姿勢中的位置。

系統不會追蹤 8mentedFace 的視覺特效，或設為將 DecmentedFace 設為空值。

公用建構函式

	8mentedFaceNode 建立不含 GumentedFace 的 8 個 DecmentedFaceNode。
	8mentedFaceNode (8mentedFace 擴增功能) 使用指定的 8mentedFace 建立 MaymentedFaceNode。

公用方法

擴增臉部	get8mentedFace() 傳回這個節點套用視覺效果的 8mentedFace。
材質	getFaceMeshMaterialOverride() 傳回目前覆寫臉孔網格轉譯內容的內容。
質地	getFaceMeshTexture() 傳回在臉孔網格上呈現的紋理。
ModelRenderable	getFaceRegionsRenderable() 傳回對應至面部區域的可轉譯項目。
void	onActivate() 在這個節點啟用時處理。
void	onUpdate(FrameTime frameTime) 在更新這個節點時處理。
void	set8mentedFace(8amentedFace 臉孔) 設定這個節點要套用視覺效果的 8mentedFace。
void	setFaceMeshMaterialOverride (材質材質) 設定用來轉譯臉孔網格的內容。
void	setFaceMeshTexture(紋理) 設定在臉孔網格上呈現的紋理。
void	setFaceRegionsRenderable(ModelRenderable可轉譯) 設定對應至臉部區域的可轉譯項目。

沿用的方法

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

公用建構函式

公開 8mentedFaceNode ()

建立不含 GumentedFace 的 8 個 DecmentedFaceNode。

公開 8mentedFaceNode (8mentedFace augmentedFace)

使用指定的 8mentedFace 建立 MaymentedFaceNode。

參數

擴增臉部

公用方法

項公開 GumentedFace get8mentedFace ()

傳回這個節點套用視覺效果的 8mentedFace。

publicMaterialgetFaceMeshMaterialOverride()

傳回目前覆寫臉孔網格轉譯內容的內容。預設值為空值。

publicTexturegetFaceMeshTexture()

傳回在臉孔網格上呈現的紋理。預設值為空值。

注意：只有在已覆寫臉孔網格材料時，才能使用這個選項。

公開 ModelRenderable getFaceRegionsRenderable ()

傳回對應至面部區域的可轉譯項目。且必須搭配與臉孔區域一致的骨骼。使用提供的範例 .fbx 檔案匯出以正確格式轉譯的臉孔區域。

public onActivate ()

在這個節點啟用時處理。節點已啟用，且在情境中，以及其父項為有效狀態。

覆寫即可在執行節點時，執行需要執行的任何設定。

public onUpdate (FrameTime frameTime)

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

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

參數

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

public void set8mentedFace (8mentedFace 臉孔)

設定這個節點要套用視覺效果的 8mentedFace。

參數

人臉

public setFaceMeshMaterialOverride (材質材質)

設定用來轉譯臉孔網格的內容。覆寫的內容不會使用 getFaceMeshTexture()。重設為空值，以還原為預設內容。

參數

material

public setFaceMeshTexture (紋理紋理)

設定在臉孔網格上呈現的紋理。

注意：只有在已覆寫臉孔網格材料時，才能使用這個選項。

參數

紋理

public void setFaceRegionsRenderable (ModelRenderable可轉譯)

設定對應至臉部區域的可轉譯項目。且必須搭配與臉孔區域一致的骨骼。使用提供的範例 .fbx 檔案匯出以正確格式轉譯的臉孔區域。

參數

可轉譯