XrHandModel QML Type
表示一只手的3D模型。更多...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: | |
| Status: | Technology preview |
此类型处于技术预览阶段，可能会有变动。
属性
- hand : enumeration
详细描述
包含一个可追踪用户双手的动态3D模型。
仅当手部追踪功能处于激活状态时，XrHandModel 才可见。
注意：XrHandModel 依赖于底层系统提供的手部追踪数据，因此并非在所有平台上都可用。
平台说明
Apple Vision Pro
Apple Vision Pro 会直接叠加用户双手的视频，而 XrHandModel 将不显示任何内容。
Meta 设备
这需要在项目的 AndroidManifest.qml 文件中添加以下功能和权限行。
<uses-permission android:name="com.oculus.permission.HAND_TRACKING" />
<uses-feature android:name="oculus.software.handtracking" android:required="false" />如果您的应用仅针对双手实现了交互功能，请在uses-feature 标签中使用true 代替false 。
属性文档
hand : enumeration [default: XrHandModel.Unknown]
指定模型展示的是哪只手
| 常量 | 描述 |
|---|---|
XrHandModel.LeftHand | 左手。 |
XrHandModel.RightHand | 右手。 |
XrHandModel.Unknown | 未显示任何手。 |
此属性的值与XrController.controller 兼容。
警告： 必须在创建XrHandModel 时设置此 属性。目前不支持事后更改手部设置。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
