资源管理

use bevy::{asset::LoadedFolder, prelude::*};

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_systems(Startup, setup)
        .run();
}

fn setup(
    mut commands: Commands,
    asset_server: Res<AssetServer>,
    meshes: Res<Assets<Mesh>>,
    mut materials: ResMut<Assets<StandardMaterial>>,
) {
    // 默认情况下，AssetServer 将从 "assets" 文件夹内加载资源
    // 例如，下一行将加载 "ROOT/assets/models/cube/cube.gltf"
    // 其中 "ROOT" 是应用程序的目录
    //
    // 这可以通过设置 [`AssetPlugin.file_path`] 来覆盖
    let cube_handle = asset_server.load(
        GltfAssetLabel::Primitive {
            mesh: 0,
            primitive: 0,
        }
        .from_asset("models/cube/cube.gltf"),
    );
    let sphere_handle = asset_server.load(
        GltfAssetLabel::Primitive {
            mesh: 0,
            primitive: 0,
        }
        .from_asset("models/sphere/sphere.gltf"),
    );

    // 所有资源在加载完成后都会进入它们的 Assets<T> 集合
    if let Some(sphere) = meshes.get(&sphere_handle) {
        // 你可能会注意到这不会运行！这是因为资源在并行加载时不会阻塞
        // 当资源加载完成时，它将出现在相关的 Assets<T> 集合中
        info!("{:?}", sphere.primitive_topology());
    } else {
        info!("sphere 尚未加载");
    }

    // 你可以像这样加载文件夹中的所有资源。它们将在不阻塞的情况下并行加载
    // LoadedFolder 资源保存文件夹中每个资源的句柄
    // 这些都是 LoadedFolder 资源的依赖项，这意味着如果你想要等待文件夹中的所有资源加载
    // 可以等待 LoadedFolder 资源触发 AssetEvent::LoadedWithDependencies
    // 如果你想保持文件夹中的资源存活，请确保存储返回的句柄
    let _loaded_folder: Handle<LoadedFolder> = asset_server.load_folder("models/torus");

    // 如果你想要文件夹中特定资源的句柄，最简单的方法是调用 load
    // 它不会再次加载
    // LoadedFolder 资源最终也会保存资源的句柄，但等待它加载并找到正确的句柄需要更多工作
    let torus_handle = asset_server.load(
        GltfAssetLabel::Primitive {
            mesh: 0,
            primitive: 0,
        }
        .from_asset("models/torus/torus.gltf"),
    );

    // 你也可以直接将资源添加到它们的 Assets<T> 存储中
    let material_handle = materials.add(StandardMaterial {
        base_color: Color::srgb(0.8, 0.7, 0.6),
        ..default()
    });

    // 使用加载的资源创建实体
    commands.spawn((
        Mesh3d(torus_handle),
        MeshMaterial3d(material_handle.clone()),
        Transform::from_xyz(-3.0, 0.0, 0.0),
    ));
}

use bevy::{
    asset::{io::Reader, AssetLoader, LoadContext},
    prelude::*,
    reflect::TypePath,
};
use serde::Deserialize;

#[derive(Asset, TypePath, Debug, Deserialize)]
struct CustomAsset {
    value: i32,
}

#[derive(Default)]
struct CustomAssetLoader;

impl AssetLoader for CustomAssetLoader {
    type Asset = CustomAsset;
    type Settings = ();
    type Error = CustomAssetLoaderError;

    async fn load(
        &self,
        reader: &mut dyn Reader,
        _settings: &(),
        _load_context: &mut LoadContext<'_>,
    ) -> Result<Self::Asset, Self::Error> {
        let mut bytes = Vec::new();
        reader.read_to_end(&mut bytes).await?;
        let custom_asset = ron::de::from_bytes::<CustomAsset>(&bytes)?;
        Ok(custom_asset)
    }

    fn extensions(&self) -> &[&str] {
        &["custom"]
    }
}

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .init_asset::<CustomAsset>()
        .init_asset_loader::<CustomAssetLoader>()
        .run();
}

use bevy::prelude::*;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_systems(Startup, setup)
        .run();
}

fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
    // 加载我们的网格
    let scene_handle =
        asset_server.load(GltfAssetLabel::Scene(0).from_asset("models/torus/torus.gltf"));

    // 对网格的任何更改都会自动重新加载！尝试修改 torus.gltf
    // 你应该会立即看到更改出现在应用中

    commands.spawn(SceneRoot(scene_handle));
}