Struct bevy_async_ecs::AsyncWorld

pub struct AsyncWorld(/* private fields */);

Exposes asynchronous access to the Bevy ECS World.

Commands

Apply any Command asynchronously with AsyncWorld::apply_command.

Systems

Just like their synchronous variants, asynchronous Systems must be registered before they can be used. Systems can optionally accept and return values asynchronously if they are registered with AsyncWorld::register_io_system.

Entities

Spawn entities with the AsyncWorld::spawn_* family.

Resources

Insert, remove, and wait for resources to exist.

Implementations

impl AsyncWorld

pub async fn apply_command<C: Command>(&self, command: C)

Applies the given Command to the world.

pub async fn apply_operation(&self, operation: AsyncOperation)

Applies the given Operation to the world.

pub fn sender(&self) -> OperationSender

Returns a copy of the underlying OperationSender.

pub async fn register_system<M>( &self, system: impl IntoSystem<(), (), M> ) -> AsyncSystem

Registers a System and returns an AsyncSystem that can be used to run the system on demand.

pub async fn register_io_system<I: Send + 'static, O: Send + 'static, M>( &self, system: impl IntoSystem<I, O, M> ) -> AsyncIOSystem<I, O>

Registers a System and returns an AsyncIOSystem that can be used to run the system on demand while supplying an input value and receiving an output value.

pub fn entity(&self, id: Entity) -> AsyncEntity

Constructs an AsyncEntity for the given Entity. If the entity does not exist, any operation performed on it will panic.

pub async fn spawn_empty(&self) -> AsyncEntity

Spawns a new Entity and returns an AsyncEntity that represents it, which can be used to further manipulate the entity.

pub async fn spawn_named( &self, name: impl Into<Cow<'static, str>> ) -> AsyncEntity

Spawns a new Entity and returns an AsyncEntity that represents it, which can be used to further manipulate the entity. This function attaches a bevy Name component with the given value.

pub async fn spawn<B: Bundle + Reflect>(&self, bundle: B) -> AsyncEntity

Spawns a new Entity with the given Bundle and returns an AsyncEntity that represents it, which can be used to further manipulate the entity.

pub async fn insert_resource<R: Resource + Reflect>(&self, resource: R)

Inserts a new resource or updates an existing resource with the given value.

pub async fn remove_resource<R: Resource + Reflect>(&self)

Removes the resource of a given type, if it exists.

pub async fn start_waiting_for_resource<R: Resource + FromReflect>( &self ) -> AsyncResource<R>

Start waiting for the Resource of a given type. Returns an AsyncResource which can be further waited to receive the value of the resource.

AsyncWorld::wait_for_resource().await is equivalent to AsyncWorld::start_waiting_for_resource().await.wait().await.

pub async fn wait_for_resource<R: Resource + FromReflect>(&self) -> R

Wait for the Resource of a given type. Returns the value of the resource, once it exists.

AsyncWorld::wait_for_resource().await is equivalent to AsyncWorld::start_waiting_for_resource().await.wait().await.

Trait Implementations

impl Clone for AsyncWorld

fn clone(&self) -> AsyncWorld

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AsyncWorld

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<OperationSender> for AsyncWorld

fn from(sender: OperationSender) -> Self

Converts to this type from the input type.

impl FromWorld for AsyncWorld

fn from_world(world: &mut World) -> Self

Creates Self using data from the given World.