要实现蓝图（Blueprint）中设置的函数能被Python端调用，核心在于Unreal Engine内置的“**Python脚本化功能**”（Unreal Python Scripting）和“**蓝图公开为Python可调用对象**”的机制。这个问题的本质是理解UE如何桥接其内部的C++/蓝图运行时系统与外部的Python解释器[ref_1]。 首先明确一个核心概念：当你在UE编辑器里编写蓝图或C++代码并运行项目时，UE引擎会启动一个**内嵌的Python解释器**。这个解释器可以通过`unreal`模块访问到UE运行时的大部分对象和类[ref_1]。Python端“知道”蓝图函数的关键，在于UE在启动时**自动将符合特定条件的蓝图节点（特别是函数和事件）暴露给Python运行时**。 具体原理和实现步骤如下表所示： | 步骤 | 操作位置 | 关键动作 | 目的与原理 | | :--- | :--- | :--- | :--- | | **1. 蓝图侧：定义与暴露** | Unreal Engine 编辑器 | 在蓝图中创建一个**自定义事件（Custom Event）** 或**函数（Function）**。确保其**节点是可执行的（有执行引脚）**。 | 创建一个可供蓝图序列或其他蓝图调用的逻辑单元。这是被调用的目标。 | | **2. 蓝图侧：标记为可调用** | Unreal Engine 编辑器 | 在蓝图编辑器中将该函数/事件的**细节（Details）面板**中的 **“Call In Editor”** 或相关暴露给脚本的选项勾选（具体名称可能因版本而异，但核心是暴露接口）。更标准的方式是，在包含该函数的**蓝图类（Blueprint Class）** 上，确保其基类（如Actor）已被Python系统支持。 | 此举相当于在UE的反射系统中注册了这个接口，使其能被外部系统（如Python）发现。底层是UE的C++反射系统（UHT）在工作[ref_3][ref_4]。 | | **3. Python侧：获取与调用** | Python 脚本 (通过 `unreal` 模块) | 通过 `unreal.find_asset()` 或 `unreal.load_object()` 加载蓝图资产，或直接在场景中通过 `unreal.GameplayStatics.get_all_actors_of_class()` 查找蓝图Actor实例。然后像调用普通Python方法一样调用其函数。 | Python通过`unreal`模块这个桥梁，利用UE的反射信息，将函数调用转发给蓝图虚拟机（Kismet VM）执行[ref_3]。 | 下面通过一个具体示例来演示全过程。假设我们有一个名为 `BP_CameraManager` 的蓝图Actor，它有一个用于切换镜头的函数 `SwitchToDroneCamera`。 **步骤1：在UE蓝图中创建可调用的函数** 1. 在内容浏览器中创建或打开 `BP_CameraManager`。 2. 在蓝图图表中，点击“我的蓝图”面板的“函数”部分旁边的“+”号，新建一个函数，命名为 `SwitchToDroneCamera`。 3. 为该函数添加一个输入参数，命名为 `DroneIndex`，类型为“Integer”。 4. 在该函数内部实现你的镜头切换逻辑（例如，设置一个跟踪目标的SpringArm组件）。 5. **关键**：确保函数编译保存。函数默认就是可被调用的，因为它是蓝图类公共接口的一部分。 **步骤2：在Python脚本中定位并调用该蓝图函数** 以下是完整的Python脚本示例，展示了如何找到场景中的 `BP_CameraManager` 实例并调用其函数。 ```python import unreal import airsim # 假设同时在使用AirSim def setup_ue_python_connection(): """ 初始化并演示如何调用蓝图中的函数。 """ # 加载Unreal的Python模块 # 注意：此脚本需在UE的Python环境中运行，或通过AirSim的simRunConsoleCommand调用 # 方法1：通过类型查找场景中已有的Actor实例（最常用） # 首先需要知道蓝图生成的C++类名。通常在编辑器中，蓝图类名会带有`_C`后缀作为运行时类。 # 更可靠的方式是使用 `unreal.EditorAssetLibrary.find_asset_data` 先找到资产，再获取其生成的类。 # 查找所有 `CameraManager` 类的实例（假设我们通过父类查找） # 我们需要蓝图的实际游戏线程对象，而非资产数据。 import world = unreal.get_editor_subsystem(unreal.UnrealEditorSubsystem).get_editor_world() all_actors = unreal.GameplayStatics.get_all_actors_of_class(world, unreal.Actor) camera_manager = None for actor in all_actors: # 通过actor的名字或标签来识别我们的特定管理器 if actor.get_name() == "CameraManager_Instance": camera_manager = actor break # 方法2：直接通过路径加载蓝图类并生成实例（如需动态生成） # blueprint_path = "/Game/Path/To/BP_CameraManager.BP_CameraManager" # blueprint_class = unreal.load_object(None, blueprint_path + "_C") # 加载生成的类 # if blueprint_class: # camera_manager = world.spawn_actor(blueprint_class, unreal.Vector(0,0,0), unreal.Rotator(0,0,0)) if camera_manager: print(f"找到 CameraManager: {camera_manager}") # 关键步骤：像调用Python对象方法一样调用蓝图函数 # 函数名必须完全匹配，参数按顺序传入 try: # 切换到跟踪第1架无人机（索引0） camera_manager.switch_to_drone_camera(0) print("成功调用蓝图函数：switch_to_drone_camera(0)") except Exception as e: print(f"调用蓝图函数失败: {e}") else: print("未在场景中找到 CameraManager Actor。") # 结合AirSim的场景，通常在AirSim的Python客户端中，通过控制台命令触发上述Python逻辑 def airsim_client_example(): """ 在AirSim脚本中，通过运行控制台命令来触发UE蓝图函数调用。 """ client = airsim.VehicleClient() client.confirmConnection() # 假设无人机0的位姿 drone_pose = client.simGetVehiclePose("Drone0") # 方案：通过AirSim的simRunConsoleCommand执行一个Python脚本文件 # 该脚本文件包含上面的 setup_ue_python_connection 函数逻辑 # 注意：这需要确保UE的Python环境可以访问该脚本路径 # 例如，将上面的函数保存为 `camera_control.py` console_command = 'py "C:/YourProjectPath/camera_control.py"' client.simRunConsoleCommand(console_command) # 更直接的集成：如果蓝图函数调用非常频繁，更好的做法是 # 1. 在UE端启动一个TCP/HTTP服务器（用蓝图或C++插件实现）。 # 2. Python端通过socket发送指令（如 `{"command": "switch_camera", "index": 0}`）。 # 3. UE服务器接收指令后，调用对应的蓝图函数。 # 这种方式性能更好，耦合度更低[ref_1]。 if __name__ == "__main__": # 根据执行环境选择 # 如果直接在UE的Python终端运行： setup_ue_python_connection() # 如果作为独立AirSim脚本运行： # airsim_client_example() ``` **原理解析**： 1. **反射（Reflection）**：UE的编译工具（Unreal Header Tool, UHT）会分析C++代码，并为蓝图中定义的函数生成反射数据[ref_3]。当你将蓝图编译并加载到编辑器中时，这些反射数据同样对蓝图有效。 2. **Python桥接（Python Bridge）**：UE的 `UnrealEnginePython` 或其他内置Python集成模块，会读取这些反射数据，并在Python的 `unreal` 模块中动态创建对应的Python类和方法[ref_1]。当你调用 `camera_manager.switch_to_drone_camera(0)` 时，Python桥接层会将调用请求、参数打包，通过引擎的内部接口转发给该蓝图Actor实例。 3. **蓝图虚拟机执行**：请求最终被送达蓝图虚拟机（Kismet Virtual Machine），虚拟机找到对应的函数节点，并按其连线逻辑执行，从而完成镜头切换等游戏逻辑[ref_3][ref_4]。 **注意事项**： * **执行环境**：这种直接调用方式，要求Python脚本在**UE编辑器进程内**或**打包游戏的Python环境中**运行。如果是从完全外部的进程（如单独的AirSim Python脚本）调用，则需要借助中间桥梁，例如`simRunConsoleCommand`执行内嵌命令，或者在UE中启动一个RPC服务器（这可能需要C++插件辅助）[ref_1]。 * **函数签名**：Python中调用的函数名需与蓝图中完全一致（大小写不敏感，但通常转为下划线风格）。参数类型需要能自动转换（如Python的`int`转蓝图的`Integer`）。 * **性能**：对于高频调用（如每帧更新相机位置），建议使用更高效的通信方式，例如在蓝图端实现一个Tick函数，从某个共享数据结构（如一个由Python写入的`TArray`）读取目标位置，而不是每帧通过Python反射调用一次[ref_2]。 综上所述，Python端能调用蓝图函数，本质是UE强大的反射系统和Python集成层共同作用的结果，无需开发者手动进行繁琐的绑定工作[ref_1][ref_3]。这为实现类似无人机跟踪这类需要动态、脚本化控制游戏逻辑的场景提供了极大的便利。