'''全局的相机管理器 ======= 外部调用函数 ======= ''' extends Node var _cached_player_camera: GlobalCamera var _cached_anchors: Array[CameraAnchor] = [] var _current_anchor: CameraAnchor var _switch_tween: Tween ## 玩家关卡内静态相机 const PLAYER_CAMERA_SCENE:= preload("res://_shared/camera/PlayerStaticCamera.tscn") ## 注册玩家相机 func register_player_camera(owner: Node) -> GlobalCamera: if not _cached_player_camera: _cached_player_camera = PLAYER_CAMERA_SCENE.instantiate() as GlobalCamera if _cached_player_camera: owner.add_child(_cached_player_camera) return _cached_player_camera ## 外部获取玩家全局相机 func get_cached_camera() -> GlobalCamera: return _cached_player_camera ## 注册一个相机锚点 func register_anchor(anchor: CameraAnchor) -> void: if anchor in _cached_anchors: return _cached_anchors.append(anchor) anchor.on_priority_change.connect(on_anchor_priority_changed) _sort_anchors() _try_auto_switch() ## 当相机锚点的权重改变时,向管理器触发事件 func on_anchor_priority_changed(priority:int, anchor: CameraAnchor) -> void: if _current_anchor: if _current_anchor._priority < priority: _sort_anchors() _try_auto_switch() ## 注销一个相机锚点 func unregister_anchor(anchor: CameraAnchor) -> void: _cached_anchors.erase(anchor) if _current_anchor == anchor: _current_anchor = null _try_auto_switch() ## 排序已有的锚点 func _sort_anchors() -> void: _cached_anchors.sort_custom(func(a, b): return a._priority > b._priority ) ## 尝试自切换 func _try_auto_switch() -> void: for a in _cached_anchors: if a.enabled: switch_anchor(a) _current_anchor = a return ## 重置所有的Camera的_priority func reset_all_camera_priority() -> void: for a in _cached_anchors: a._priority = 0 ## 切换相机 func switch_anchor(target_anchor: CameraAnchor) -> void: if target_anchor == null: return if target_anchor == _current_anchor: return if not is_instance_valid(_cached_player_camera): return # 中断旧 Tween if _switch_tween and _switch_tween.is_running(): _switch_tween.kill() _switch_tween = null var camera := _cached_player_camera var blend_time : float = max(target_anchor.blend_time, 0.001) # 创建 Tween(关键:ignore time scale) _switch_tween = get_tree().create_tween() _switch_tween.set_ignore_time_scale(true) _switch_tween.set_trans(Tween.TRANS_SINE) _switch_tween.set_ease(Tween.EASE_OUT) # ===== 位置 ===== _switch_tween.tween_property( camera, "global_position", target_anchor.global_position, blend_time ) # ===== Zoom ===== _switch_tween.tween_property( camera, "zoom", target_anchor.zoom, blend_time ) # ===== Offset ===== _switch_tween.tween_property( camera, "offset", target_anchor.offset, blend_time ) # 完成回调 _switch_tween.finished.connect(func(): _current_anchor = target_anchor ) _current_anchor = target_anchor