Rust 3D游戏开发插件bevy_mod_raycast的使用：实现高效射线检测与拾取功能

完整示例代码

下面是一个完整的bevy_mod_raycast使用示例，实现了鼠标拾取3D物体的功能：

use bevy::prelude::*;
use bevy_mod_raycast::*;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        // 添加默认的射线拾取插件
        .add_plugins(DefaultRaycastingPlugin::default())
        .add_systems(Startup, setup_scene)
        .add_systems(Update, handle_picks)
        .run();
}

// 定义自定义的RaycastSet用于分组
#[derive(Reflect)]
struct MyRaycastSet;

fn setup_scene(
    mut commands: Commands,
    mut meshes: ResMut<Assets<Mesh>>,
    mut materials: ResMut<Assets<StandardMaterial>>,
) {
    // 创建可拾取的立方体
    commands.spawn((
        PbrBundle {
            mesh: meshes.add(Mesh::from(shape::Cube { size: 1.0 })),
            material: materials.add(Color::rgb(0.8, 0.7, 0.6).into()),
            transform: Transform::from_xyz(0.0, 0.5, 0.0),
            ..default()
        },
        // 使这个立方体可以被MyRaycastSet组的射线检测到
        RaycastMesh::<MyRaycastSet>::default(),
    ));

    // 创建可拾取的球体
    commands.spawn((
        PbrBundle {
            mesh: meshes.add(Mesh::from(shape::UVSphere { 
                radius: 0.5, 
                sectors: 32, 
                stacks: 32 
            })),
            material: materials.add(Color::rgb(0.3, 0.5, 0.9).into()),
            transform: Transform::from_xyz(2.0, 0.5, 0.0),
            ..default()
        },
        RaycastMesh::<MyRaycastSet>::default(),
    ));

    // 创建光源
    commands.spawn(PointLightBundle {
        point_light: PointLight {
            intensity: 1500.0,
            shadows_enabled: true,
            ..default()
        },
        transform: Transform::from_xyz(4.0, 8.0, 4.0),
        ..default()
    });

    // 创建相机并设置射线源
    commands.spawn((
        Camera3dBundle {
            transform: Transform::from_xyz(0.0, 2.0, 5.0).looking_at(Vec3::ZERO, Vec3::Y),
            ..default()
        },
        // 添加射线源组件，用于从相机发射射线
        RaycastSource::<MyRaycastSet>::new(),
    ));
}

fn handle_picks(
    mut cursor_events: EventReader<CursorMoved>,
    mut raycast: Raycast,
    mut pick_events: EventReader<RaycastMeshEvent<MyRaycastSet>>,
    mut materials: ResMut<Assets<StandardMaterial>>,
    picked_entities: Query<&Handle<StandardMaterial>>,
) {
    // 更新射线位置跟随鼠标移动
    for event in cursor_events.read() {
        raycast.update_raycast(event.position);
    }

    // 处理拾取事件
    for pick_event in pick_events.read() {
        if let Some((entity, _intersection)) = &pick_event.intersection {
            // 改变被拾取物体的颜色
            if let Ok(material_handle) = picked_entities.get(*entity) {
                if let Some(material) = materials.get_mut(material_handle) {
                    material.base_color = Color::rgb(1.0, 0.0, 0.0); // 变为红色
                }
            }
        }
    }
}

代码说明

1. 自定义RaycastSet：

   #[derive(Reflect)]
   struct MyRaycastSet;
   

   定义了一个自定义的射线检测组，用于区分不同类型的射线检测

2. 可拾取物体设置：

   RaycastMesh::<MyRaycastSet>::default()
   

   为物体添加这个组件使其可以被MyRaycastSet组的射线检测到

3. 射线源设置：

   RaycastSource::<MyRaycastSet>::new()
   

   为相机添加这个组件使其成为射线源

4. 射线更新：

   raycast.update_raycast(event.position);
   

   在鼠标移动时更新射线位置

5. 拾取事件处理：

   EventReader<RaycastMeshEvent<MyRaycastSet>>
   

   监听MyRaycastSet组的拾取事件，当射线与物体相交时会触发

6. 拾取反馈：

   material.base_color = Color::rgb(1.0, 0.0, 0.0);
   

   当物体被拾取时改变其颜色作为视觉反馈

这个完整示例展示了如何使用bevy_mod_raycast实现基本的3D物体拾取功能，包括场景设置、射线源管理、拾取检测和交互反馈等完整流程。