Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

OpenXRHand

已棄用: Use XRHandModifier3D instead.

繼承: Node3D < Node < Object

OpenXR 中支援手和手指追蹤的節點。

說明

該節點啟用 OpenXR 的手部追蹤功能。該節點應該是 XROrigin3D 節點的子節點,追蹤會將其位置更新為玩家被追蹤的手掌關節位置(中指的掌骨中心)。該節點還會更新正確蒙皮的手或頭像模型的骨架。

如果骨架是一隻手(手部骨骼之一是該骨架的根節點),則該骨架將相對於手掌位置放置,並且手部網格和骨架應該是 OpenXRHand 節點的子級。

如果手骨是完整骨架的一部分,假設使用 IK 來定位手和胳膊,則手的根部將保持其位置。

預設情況下,骨架手骨會被重新定位以匹配追蹤的手的大小。要保留建模的骨骼大小,請更改 bone_update 以僅應用旋轉。

屬性

BoneUpdate

bone_update

0

Hands

hand

0

NodePath

hand_skeleton

NodePath("")

MotionRange

motion_range

0

SkeletonRig

skeleton_rig

0


列舉

enum Hands: 🔗

Hands HAND_LEFT = 0

追蹤玩家的左手。

Hands HAND_RIGHT = 1

追蹤玩家的右手。

Hands HAND_MAX = 2

最大支援的手數。


enum MotionRange: 🔗

MotionRange MOTION_RANGE_UNOBSTRUCTED = 0

玩家抓握時,手部骨架呈握拳狀。

MotionRange MOTION_RANGE_CONFORM_TO_CONTROLLER = 1

玩家抓握時,手部骨架遵循玩家所持的控制器。

MotionRange MOTION_RANGE_MAX = 2

最大支援的運動範圍。


enum SkeletonRig: 🔗

SkeletonRig SKELETON_RIG_OPENXR = 0

符合 OpenXR 標準的骨架。

SkeletonRig SKELETON_RIG_HUMANOID = 1

符合 SkeletonProfileHumanoid 標準的骨架。

SkeletonRig SKELETON_RIG_MAX = 2

最大支援的手數。


enum BoneUpdate: 🔗

BoneUpdate BONE_UPDATE_FULL = 0

骨架骨骼已完全更新(位置和旋轉)以匹配追蹤的骨骼。

BoneUpdate BONE_UPDATE_ROTATION_ONLY = 1

骨架骨骼僅旋轉以與追蹤的骨骼對齊,從而保留骨骼長度。

BoneUpdate BONE_UPDATE_MAX = 2

最大支援的骨骼更新模式。


屬性說明

BoneUpdate bone_update = 0 🔗

指定要在骨骼上執行的更新型別。


Hands hand = 0 🔗

指定該節點是追蹤玩家的左手還是右手。


NodePath hand_skeleton = NodePath("") 🔗

設定一個Skeleton3D節點,該節點的姿勢位置將被更新。


MotionRange motion_range = 0 🔗

設定限制手部運動的運動範圍(前提是支援)。


SkeletonRig skeleton_rig = 0 🔗

設定 hand_skeleton 所相容的骨架綁定型別。