268 lines
9.5 KiB
Python
268 lines
9.5 KiB
Python
"""
|
|
VR摇杆配置模块
|
|
|
|
提供摇杆交互的配置选项和预设：
|
|
- 不同的转向模式和灵敏度设置
|
|
- 传送参数调整
|
|
- 用户体验优化选项
|
|
"""
|
|
|
|
from enum import Enum
|
|
|
|
|
|
class TurnMode(Enum):
|
|
"""转向模式枚举"""
|
|
SMOOTH = "smooth" # 平滑转向
|
|
SNAP = "snap" # 分段转向
|
|
|
|
|
|
class JoystickProfile(Enum):
|
|
"""摇杆配置预设"""
|
|
COMFORTABLE = "comfortable" # 舒适模式 - 低灵敏度，平滑转向
|
|
STANDARD = "standard" # 标准模式 - 中等灵敏度，分段转向
|
|
GAMING = "gaming" # 游戏模式 - 高灵敏度，快速响应
|
|
ACCESSIBLE = "accessible" # 无障碍模式 - 更大死区，更高阈值
|
|
|
|
|
|
class VRJoystickConfig:
|
|
"""VR摇杆配置类"""
|
|
|
|
def __init__(self):
|
|
"""初始化默认配置"""
|
|
# 基础参数
|
|
self.deadzone = 0.15 # 摇杆死区 (0-1)
|
|
self.turn_threshold = 0.3 # 转向激活阈值
|
|
self.teleport_threshold = 0.5 # 传送激活阈值
|
|
|
|
# 转向设置
|
|
self.turn_mode = TurnMode.SNAP # 转向模式
|
|
self.turn_sensitivity = 250.0 # 转向灵敏度（度/秒）- 增加速度
|
|
self.snap_turn_angle = 30.0 # 分段转向角度（度）
|
|
self.snap_turn_cooldown = 0.3 # 分段转向间隔（秒）
|
|
|
|
# 传送设置
|
|
self.teleport_range = 20.0 # 最大传送距离
|
|
self.teleport_arc_resolution = 50 # 抛物线精度
|
|
self.teleport_initial_velocity = 10.0 # 传送初始速度
|
|
self.min_teleport_distance = 1.0 # 最小传送距离
|
|
|
|
# 反馈设置
|
|
self.haptic_feedback_enabled = True # 是否启用震动反馈
|
|
self.teleport_start_haptic = (0.002, 0.3) # 传送开始震动 (时长, 强度)
|
|
self.teleport_success_haptic = (0.005, 0.8) # 传送成功震动
|
|
self.teleport_fail_haptic = (0.001, 0.2) # 传送失败震动
|
|
|
|
# 可视化设置
|
|
self.show_teleport_arc = True # 显示传送抛物线
|
|
self.show_teleport_target = True # 显示传送目标标记
|
|
self.arc_valid_color = (0.2, 0.9, 0.2, 0.8) # 有效抛物线颜色
|
|
self.arc_invalid_color = (0.9, 0.2, 0.2, 0.8) # 无效抛物线颜色
|
|
|
|
def apply_profile(self, profile: JoystickProfile):
|
|
"""应用预设配置
|
|
|
|
Args:
|
|
profile: 配置预设
|
|
"""
|
|
if profile == JoystickProfile.COMFORTABLE:
|
|
self._apply_comfortable_profile()
|
|
elif profile == JoystickProfile.STANDARD:
|
|
self._apply_standard_profile()
|
|
elif profile == JoystickProfile.GAMING:
|
|
self._apply_gaming_profile()
|
|
elif profile == JoystickProfile.ACCESSIBLE:
|
|
self._apply_accessible_profile()
|
|
|
|
def _apply_comfortable_profile(self):
|
|
"""舒适模式 - 适合长时间使用"""
|
|
self.deadzone = 0.2
|
|
self.turn_threshold = 0.4
|
|
self.teleport_threshold = 0.6
|
|
self.turn_mode = TurnMode.SMOOTH
|
|
self.turn_sensitivity = 100.0 # 适中的转向速度
|
|
self.snap_turn_cooldown = 0.4
|
|
print("✓ 已应用舒适模式配置")
|
|
|
|
def _apply_standard_profile(self):
|
|
"""标准模式 - 平衡的体验"""
|
|
self.deadzone = 0.15
|
|
self.turn_threshold = 0.3
|
|
self.teleport_threshold = 0.5
|
|
self.turn_mode = TurnMode.SNAP
|
|
self.turn_sensitivity = 150.0 # 更快的转向速度
|
|
self.snap_turn_angle = 30.0
|
|
self.snap_turn_cooldown = 0.3
|
|
print("✓ 已应用标准模式配置")
|
|
|
|
def _apply_gaming_profile(self):
|
|
"""游戏模式 - 快速响应"""
|
|
self.deadzone = 0.1
|
|
self.turn_threshold = 0.2
|
|
self.teleport_threshold = 0.4
|
|
self.turn_mode = TurnMode.SMOOTH
|
|
self.turn_sensitivity = 200.0 # 高速转向
|
|
self.snap_turn_cooldown = 0.2
|
|
print("✓ 已应用游戏模式配置")
|
|
|
|
def _apply_accessible_profile(self):
|
|
"""无障碍模式 - 更容易控制"""
|
|
self.deadzone = 0.25
|
|
self.turn_threshold = 0.5
|
|
self.teleport_threshold = 0.7
|
|
self.turn_mode = TurnMode.SNAP
|
|
self.turn_sensitivity = 80.0 # 较慢但可控的转向
|
|
self.snap_turn_angle = 45.0
|
|
self.snap_turn_cooldown = 0.5
|
|
print("✓ 已应用无障碍模式配置")
|
|
|
|
def set_turn_mode(self, mode: TurnMode):
|
|
"""设置转向模式
|
|
|
|
Args:
|
|
mode: 转向模式
|
|
"""
|
|
self.turn_mode = mode
|
|
print(f"✓ 转向模式设置为: {mode.value}")
|
|
|
|
def set_turn_sensitivity(self, sensitivity: float):
|
|
"""设置转向灵敏度
|
|
|
|
Args:
|
|
sensitivity: 转向灵敏度（度/秒）
|
|
"""
|
|
self.turn_sensitivity = max(10.0, min(180.0, sensitivity))
|
|
print(f"✓ 转向灵敏度设置为: {self.turn_sensitivity}度/秒")
|
|
|
|
def set_deadzone(self, deadzone: float):
|
|
"""设置摇杆死区
|
|
|
|
Args:
|
|
deadzone: 死区大小 (0-1)
|
|
"""
|
|
self.deadzone = max(0.0, min(0.5, deadzone))
|
|
print(f"✓ 摇杆死区设置为: {self.deadzone}")
|
|
|
|
def set_teleport_range(self, range_meters: float):
|
|
"""设置传送范围
|
|
|
|
Args:
|
|
range_meters: 传送范围（米）
|
|
"""
|
|
self.teleport_range = max(5.0, min(50.0, range_meters))
|
|
print(f"✓ 传送范围设置为: {self.teleport_range}米")
|
|
|
|
def enable_haptic_feedback(self, enabled: bool):
|
|
"""启用或禁用震动反馈
|
|
|
|
Args:
|
|
enabled: 是否启用
|
|
"""
|
|
self.haptic_feedback_enabled = enabled
|
|
print(f"✓ 震动反馈: {'启用' if enabled else '禁用'}")
|
|
|
|
def get_config_dict(self):
|
|
"""获取配置字典
|
|
|
|
Returns:
|
|
dict: 配置参数字典
|
|
"""
|
|
return {
|
|
'deadzone': self.deadzone,
|
|
'turn_threshold': self.turn_threshold,
|
|
'teleport_threshold': self.teleport_threshold,
|
|
'turn_mode': self.turn_mode.value,
|
|
'turn_sensitivity': self.turn_sensitivity,
|
|
'snap_turn_angle': self.snap_turn_angle,
|
|
'snap_turn_cooldown': self.snap_turn_cooldown,
|
|
'teleport_range': self.teleport_range,
|
|
'haptic_feedback_enabled': self.haptic_feedback_enabled
|
|
}
|
|
|
|
def apply_to_joystick_manager(self, joystick_manager):
|
|
"""将配置应用到摇杆管理器
|
|
|
|
Args:
|
|
joystick_manager: VRJoystickManager实例
|
|
"""
|
|
try:
|
|
joystick_manager.deadzone = self.deadzone
|
|
joystick_manager.turn_threshold = self.turn_threshold
|
|
joystick_manager.teleport_threshold = self.teleport_threshold
|
|
joystick_manager.turn_sensitivity = self.turn_sensitivity
|
|
joystick_manager.smooth_turning = (self.turn_mode == TurnMode.SMOOTH)
|
|
joystick_manager.snap_turn_angle = self.snap_turn_angle
|
|
joystick_manager.snap_turn_cooldown = self.snap_turn_cooldown
|
|
|
|
# 应用传送系统配置
|
|
if hasattr(joystick_manager, 'teleport_system') and joystick_manager.teleport_system:
|
|
teleport_sys = joystick_manager.teleport_system
|
|
teleport_sys.teleport_range = self.teleport_range
|
|
teleport_sys.arc_resolution = self.teleport_arc_resolution
|
|
teleport_sys.initial_velocity = self.teleport_initial_velocity
|
|
teleport_sys.min_teleport_distance = self.min_teleport_distance
|
|
|
|
print("✅ 配置已成功应用到摇杆管理器")
|
|
|
|
except Exception as e:
|
|
print(f"⚠️ 应用配置失败: {e}")
|
|
|
|
|
|
# 预定义的配置实例
|
|
COMFORTABLE_CONFIG = VRJoystickConfig()
|
|
COMFORTABLE_CONFIG.apply_profile(JoystickProfile.COMFORTABLE)
|
|
|
|
STANDARD_CONFIG = VRJoystickConfig()
|
|
STANDARD_CONFIG.apply_profile(JoystickProfile.STANDARD)
|
|
|
|
GAMING_CONFIG = VRJoystickConfig()
|
|
GAMING_CONFIG.apply_profile(JoystickProfile.GAMING)
|
|
|
|
ACCESSIBLE_CONFIG = VRJoystickConfig()
|
|
ACCESSIBLE_CONFIG.apply_profile(JoystickProfile.ACCESSIBLE)
|
|
|
|
|
|
def create_custom_config(**kwargs):
|
|
"""创建自定义配置
|
|
|
|
Args:
|
|
**kwargs: 配置参数
|
|
|
|
Returns:
|
|
VRJoystickConfig: 自定义配置实例
|
|
"""
|
|
config = VRJoystickConfig()
|
|
|
|
for key, value in kwargs.items():
|
|
if hasattr(config, key):
|
|
setattr(config, key, value)
|
|
else:
|
|
print(f"⚠️ 未知的配置参数: {key}")
|
|
|
|
return config
|
|
|
|
|
|
def print_usage_guide():
|
|
"""打印使用指南"""
|
|
print("🎮 ======= VR摇杆交互使用指南 =======")
|
|
print()
|
|
print("📋 基本操作:")
|
|
print(" • 摇杆左右移动 → 转向（旋转视角）")
|
|
print(" • 摇杆向前推 → 显示传送抛物线")
|
|
print(" • 松开摇杆 → 执行传送到落点")
|
|
print()
|
|
print("⚙️ 配置选项:")
|
|
print(" • 舒适模式 → 低灵敏度，适合长时间使用")
|
|
print(" • 标准模式 → 平衡体验，推荐大多数用户")
|
|
print(" • 游戏模式 → 高灵敏度，快速响应")
|
|
print(" • 无障碍模式 → 更大死区，容易控制")
|
|
print()
|
|
print("🎯 使用建议:")
|
|
print(" • 首次使用建议从标准模式开始")
|
|
print(" • 根据个人喜好调整转向模式（平滑/分段）")
|
|
print(" • 可以随时调整死区和灵敏度")
|
|
print(" • 传送范围可根据场景大小调整")
|
|
print()
|
|
|
|
|
|
if __name__ == "__main__":
|
|
print_usage_guide() |