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.
Checking the stable version of the documentation...
OpenXRHand
已棄用: Use XRHandModifier3D instead.
OpenXR 中支援手和手指追蹤的節點。
說明
該節點啟用 OpenXR 的手部追蹤功能。該節點應該是 XROrigin3D 節點的子節點,追蹤會將其位置更新為玩家被追蹤的手掌關節位置(中指的掌骨中心)。該節點還會更新正確蒙皮的手或頭像模型的骨架。
如果骨架是一隻手(手部骨骼之一是該骨架的根節點),則該骨架將相對於手掌位置放置,並且手部網格和骨架應該是 OpenXRHand 節點的子級。
如果手骨是完整骨架的一部分,假設使用 IK 來定位手和胳膊,則手的根部將保持其位置。
預設情況下,骨架手骨會被重新定位以匹配追蹤的手的大小。要保留建模的骨骼大小,請更改 bone_update 以僅應用旋轉。
屬性
|
||
|
||
|
||
|
||
|
列舉
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 🔗
void set_bone_update(value: BoneUpdate)
BoneUpdate get_bone_update()
指定要在骨骼上執行的更新型別。
指定該節點是追蹤玩家的左手還是右手。
NodePath hand_skeleton = NodePath("") 🔗
設定一個Skeleton3D節點,該節點的姿勢位置將被更新。
MotionRange motion_range = 0 🔗
void set_motion_range(value: MotionRange)
MotionRange get_motion_range()
設定限制手部運動的運動範圍(前提是支援)。
SkeletonRig skeleton_rig = 0 🔗
void set_skeleton_rig(value: SkeletonRig)
SkeletonRig get_skeleton_rig()
設定 hand_skeleton 所相容的骨架綁定型別。