bevy_flurx_wry

[!警告] 此包处于开发早期阶段，可能面临破坏性更改。

目的

此包的目的是使用 bevy_flurx 整合 bevy 和 wry。

除此之外，我还想利用bevy的可扩展性，并发现bevy超越现有游戏引擎框架的潜力。

平台支持

已在 Windows 和 MacOS 上确认运行。

Ubuntu 目前不支持。

用法

创建webview有两种方式

将现有窗口转换为webview窗口。

examples/simple.rs

use bevy::prelude::*;
use bevy::window::PrimaryWindow;
use bevy_flurx_wry::prelude::*;

fn spawn_webview(
    mut commands: Commands,
    window: Query<Entity, With<PrimaryWindow>>,
) {
    // Converts the `Window` attached the entity into a webview window. 
    commands.entity(window.single()).insert(
        WryWebViewBundle {
            uri: WebviewUri::new("https://bevy.rust-lang.net.cn/"),
            ..default()
        }
    );
}

在窗口内部创建作为子窗口的webview。

examples/child_view.rs

use bevy::prelude::*;
use bevy::window::PrimaryWindow;
use bevy_flurx_wry::prelude::*;

fn spawn_webview(
    mut commands: Commands,
    window: Query<Entity, With<PrimaryWindow>>,
) {
    commands.spawn((
        WryWebViewBundle {
            ..default()
        },
        AsChildBundle {
            // Here, create a webview as child inside a given window.
            parent: ParentWindow(window.single()),
            bounds: Bounds {
                position: Vec2::new(100., 100.),
                size: Vec2::new(500., 500.),
                min_size: Vec2::new(100., 100.),
            },
            ..default()
        },
    ));
}

Ipc

IpcEvent

您可以监听来自webview的事件，反之亦然，向webview发送事件。

Webview(javascript) -> bevy

examples/event_listen.rs

javascript

// you can use any type.
const event = {
    message: "message"
};
window.__FLURX__.emit("event_id", event);

rust

use bevy::prelude::*;
use bevy_flurx_wry::prelude::*;
use serde::Deserialize;

#[derive(Deserialize, Debug)]
struct MessageFromWebview {
    message: String,
}

fn read_webview_message(
    mut er: EventReader<IpcEvent<MessageFromWebview>>
) {
    for e in er.read() {
        println!("webview message: {}", e.payload.message);
    }
}

bevy -> Webview(javascript)

examples/event_emit.rs

javascript

window.__FLURX__.listen("event_id", ({message}) => {
    console.log(message);
});

rust

use bevy::prelude::*;
use bevy_flurx_wry::prelude::*;
use serde_json::json;

fn emit_event(
    mut views: Query<&mut EventEmitter>
) {
    for mut emitter in views.iter_mut() {
        emitter.emit("event_id", &serde_json::json!({
            "message" : "hello world!"
        }));
    }
}

IpcCommand

IpcEvent 不能接收另一侧的输出值。在这种情况下，可以使用 IpcCommand。

IpcComamnd 可以分为两种命令模式：action-command，task-command

请查看 examples/ipc_command.rs 以获取详细信息。

待办事项

• 增强安全性
• 错误修复
• 添加API
• 支持Linux(X11)
• 支持Linux(Wayland)

变更日志

请参见 此处。

兼容Bevy版本

许可证

此包根据MIT许可证或Apache许可证2.0授权。