SuperAPI AI 工具集

platform-vr

通用与其它

查看项目

更新于 10-16 22:43

技能介绍

Platform: VR

资料将该主题定位为 VR 平台开发的专家蓝图,覆盖 Meta Quest、PSVR、SteamVR、Pico 等 VR 平台,并涉及 XR 工具包(OpenXR)、舒适度设置(暗角、瞬转、传送移动)、运动控制与性能等方向。资料未提供各平台的具体差异说明、支持版本或配置要求。

核心原则

资料指出,90+ FPS、舒适优先的设计和运动控制精度共同定义 VR 开发。

可用脚本

资料列出一个脚本:

  • vr_physics_hand.gd:专家级基于物理的手部控制器,具有抓取检测与速度投掷能力。

VR 开发中的禁止事项

资料以“NEVER”形式列出多条硬性约束:

  • 帧率不得低于 90 FPS:72 FPS 在 VR 中会立即引发眩晕。必须保持最低 90 FPS(Quest 2/3),建议 120 FPS。应积极使用 Debug → Profiler。
  • 不得在无暗角的情况下使用平滑旋转:平滑相机旋转会造成前庭不一致,导致晕动症。应提供瞬转(30°/45°)或在旋转时使用暗角。
  • UI 不得放得过近或过远:0.5m 处会造成眼疲劳,10m 处无法阅读。距玩家的最佳距离为 1-3m。
  • 不得忽视运动到光子延迟:延迟超过 20ms 会在手部追踪中出现可见滞后并破坏沉浸感。应最小化物理步进与渲染延迟。
  • 不得跳过传送移动选项:并非所有人都能适应平滑移动。必须提供传送作为无障碍替代方案。
  • 不得忘记物理边界:玩家在现实中打到墙可能引发法律诉讼。应使用 XRServer.get_reference_frame() 尊重 guardian/chaperone 边界。
  • 不得使用标准 3D 音频:VR 中的立体声音频会造成方向感混乱。应使用空间音频(AudioStreamPlayer3D)提供位置声音线索。

启用 XR 示例

资料提供以下代码片段:

# Enable XR
func _ready() -> void:
    var xr_interface := XRServer.find_interface("OpenXR")
    if xr_interface and xr_interface.initialize():
        get_viewport().use_xr = true

舒适度设置

资料列出的舒适度设置包括:

  • 移动时使用暗角(vignetting)
  • 瞬转(30°/45° 增量)
  • 传送移动选项
  • 坐姿模式支持

运动控制

资料提供以下运动控制代码片段:

# XRController3D for hands
@onready var left_hand := $XROrigin3D/LeftController
@onready var right_hand := $XROrigin3D/RightController

func _process(delta: float) -> void:
    if left_hand.is_button_pressed("trigger"):
        grab_with_left()

性能

资料列出的性能要求包括:

  • 最低 90 FPS——对舒适度至关重要
  • 低延迟——运动到光子低于 20ms
  • 在支持的情况下使用注视点渲染(foveated rendering)

最佳实践

资料汇总的最佳实践:

  • 舒适优先——防止晕动症
  • 高帧率——要求 90+ FPS
  • 物理空间——尊重边界
  • UI 距离——距玩家 1-3m

参考

资料注明相关主题为:camera-systems、input-handling。

未提供的信息

资料未提供具体安装步骤、依赖版本、各平台(Meta Quest、PSVR、SteamVR、Pico)的差异细节、收费或授权信息、以及 vr_physics_hand.gd 的完整源码内容。这些内容暂未提供。