AugmentedFaceNode

public class AugmentedFaceNode

使用 ARCore 的 AugmentedFace 功能在人脸上渲染视觉效果的节点。

视觉效果最多可包含两个组件：面部网格和可渲染的面部区域。

人脸网格用于直观呈现映射到人脸的 2D 图像。可渲染的面部区域用于可视化将与 ARCore 追踪的面部区域移动的 3D 对象（例如，鼻子和耳朵）。

创建可渲染的人脸区域时，这些区域会映射到模型中的骨架。使用提供的示例 .fbx 文件以正确格式导出可渲染的面部区域。

此节点的位置与 getCenterPose() 中的姿势一致。

当 AugmentedFace 未跟踪或 AugmentedFace 设置为 null 时，视觉效果将停用。

公共构造函数

	AugmentedFaceNode() 创建不带 AugmentedFace 的 AugmentedFaceNode。
	AugmentedFaceNode(AugmentedFace augmentedFace) 使用给定的 AugmentedFace 创建一个 AugmentedFaceNode。

公共方法

AugmentedFace	getAugmentedFace() 返回此节点正在应用视觉效果的 AugmentedFace。
材质	getFaceMeshMaterialOverride() 返回当前替换面网格渲染方式的材质。
纹理	getFaceMeshTexture() 返回在面网格上渲染的纹理。
ModelRenderable	getFaceRegionRenderable() 返回映射到人脸区域的 Renderable。
无效	onActivate() 处理此节点何时变为活动状态。
无效	onUpdate(FrameTime frameTime) 此节点更新时处理。
无效	setAugmentedFace(AugmentedFace 人脸) 设置此节点对其应用视觉效果的 AugmentedFace。
无效	setFaceMeshMaterialOverride（Material 材料） 设置用于渲染人脸网格的材质。
无效	setFaceMeshTexture（纹理纹理） 设置在面网格上渲染的纹理。
无效	setFaceRegionRenderable（ModelRenderable 可渲染对象） 设置映射到人脸区域的 Renderable。

继承的方法

继承自 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 AugmentedFaceNode ()

创建不带 AugmentedFace 的 AugmentedFaceNode。

public AugmentedFaceNode (AugmentedFace augmentedFace)

使用给定的 AugmentedFace 创建一个 AugmentedFaceNode。

参数

脸部强化

公共方法

public AugmentedFace getAugmentedFace ()

返回此节点正在应用视觉效果的 AugmentedFace。

public Material getFaceMeshMaterialOverride ()

返回当前替换面网格渲染方式的材质。默认值为 null。

public Texture getFaceMeshTexture ()

返回在面网格上渲染的纹理。默认值为 null。

注意：仅当面部网格材料未替换时，才会使用此方法。

public ModelRenderable getFaceRegionRenderable ()

返回映射到人脸区域的 Renderable。必须使用与面部区域一致的骨架进行装饰。使用提供的示例 .fbx 文件以正确格式导出可渲染的面部区域。

public void onActivate ()

处理此节点何时变为活动状态。如果某节点已启用，但属于场景的一部分且其父节点也处于活动状态，则该节点处于活动状态。

覆盖在节点激活时需要进行的任何设置。

public void onUpdate (FrameTime frameTime)

此节点更新时处理。节点会在呈现每一帧之前更新。仅当节点处于活动状态时才调用此方法。

执行替换，以执行每帧需要发生的任何更新。

参数

帧时间	提供当前帧的时间信息

public void setAugmentedFace (AugmentedFace face)

设置此节点对其应用视觉效果的 AugmentedFace。

参数

脸

public void setFaceMeshMaterialOverride (Material 材质)

设置用于渲染人脸网格的材质。覆盖材料不会使用 getFaceMeshTexture()。重新设为 null 可还原为默认材质。

参数

material

public void setFaceMeshTexture （Text 纹理）

设置在面网格上渲染的纹理。

注意：仅当面部网格材料未替换时，才会使用此方法。

参数

纹理

public void setFaceRegionRenderable (ModelRenderable renderable)

设置映射到人脸区域的 Renderable。必须使用与面部区域一致的骨架进行装饰。使用提供的示例 .fbx 文件以正确格式导出可渲染的面部区域。

参数

可渲染