bevy_rand功能激活

rand_core = "0.6"
bevy_rand = { version = "0.7", features = ["rand_chacha", "wyrand"] }

bevy_prng功能激活

rand_core = "0.6"
bevy_rand = "0.7"
bevy_prng = { version = "0.7", features = ["rand_chacha", "wyrand"] }

选择随机数生成算法的总结是：在几乎所有情况下选择 wyrand，因为它比其他算法更快、更便携。对于需要额外确保熵质量（如安全性等）的情况，请使用 rand_chacha。更多信息，请访问此处。

为 Bevy Rand 注册 PRNG

在使用 GlobalEntropy 或 EntropyComponent 之前，必须通过插件进行注册。

use bevy::prelude::*;
use bevy_prng::WyRand;
use bevy_rand::prelude::EntropyPlugin;
use rand_core::RngCore;

fn main() {
    App::new()
        .add_plugins(EntropyPlugin::<WyRand>::default())
        .run();
}

基本用法

在最简单的情况下，直接使用 GlobalEntropy 进行所有随机数生成，尽管这限制了使用 GlobalEntropy 的系统并行化的程度。所有访问 GlobalEntropy 的系统都将相互串行运行。

use bevy::prelude::ResMut;
use bevy_prng::WyRand;
use bevy_rand::prelude::GlobalEntropy;
use rand_core::RngCore;

fn print_random_value(mut rng: ResMut<GlobalEntropy<WyRand>>) {
    println!("Random value: {}", rng.next_u32());
}

分叉 RNG

要从全局源为 EntropyComponent 基准，最好使用分叉而不是直接生成种子值。由于 GlobalEntropy 只能作为一个实例存在，因此在正常分叉时，它始终作为 EntropyComponent 实例进行分叉。

use bevy::prelude::*;
use bevy_prng::WyRand;
use bevy_rand::prelude::{GlobalEntropy, ForkableRng};

#[derive(Component)]
struct Source;

fn setup_source(mut commands: Commands, mut global: ResMut<GlobalEntropy<WyRand>>) {
    commands
        .spawn((
            Source,
            global.fork_rng(),
        ));
}

EntropyComponent 还可以从其他 EntropyComponent 中进行基准/分叉。

use bevy::prelude::*;
use bevy_prng::WyRand;
use bevy_rand::prelude::{EntropyComponent, ForkableRng};

#[derive(Component)]
struct Npc;

#[derive(Component)]
struct Source;

fn setup_npc_from_source(
   mut commands: Commands,
   mut q_source: Query<&mut EntropyComponent<WyRand>, (With<Source>, Without<Npc>)>,
) {
   let mut source = q_source.single_mut();
   for _ in 0..2 {
       commands
           .spawn((
               Npc,
               source.fork_rng()
           ));
   }
}

功能

• thread_local_entropy - 启用 ThreadLocalEntropy，覆盖 SeedableRng::from_entropy 实现，以使用线程本地熵源进行更快的 PRNG 初始化。默认启用。
• serialize - 启用 Serialize 和 Deserialize derive。默认启用。
• rand_chacha - 这启用了导出新的 ChaCha*Rng 结构体，供需要/需要使用 CSPRNG 级别源的人使用。
• rand_pcg - 这启用了从 rand_pcg 导出新的 Pcg* 结构体。
• rand_xoshiro - 这启用了从 rand_xoshiro 导出新的 Xoshiro* 结构体。它还重新导出 Seed512，以便在不显式引入 rand_xoshiro 的情况下设置 Xoshiro512StarStar 等等。
• wyrand - 这启用了从 wyrand 导出新的 WyRand，与在 fastrand/turborand 中使用的相同算法。