cyberdeck 0.1.2

A library for easily creating WebRTC data channel connections
Documentation

Cyberdeck

A library for easily creating WebRTC data channel connections in Rust.

cargo add cyberdeck

let mut peer = Peer::new(move |peer_id, e| async move {
    match e {
        PeerEvent::DataChannelMessage(c, m) => {
            println!(
                "{}::Recieved a message from channel {} with id {}!",
                peer_id,
                c.label(),
                c.id()
            );
            let msg_str = String::from_utf8(m.data.to_vec()).unwrap();
            println!(
                "{}::Message from DataChannel '{}': {}",
                peer_id,
                c.label(),
                msg_str
            );
        }
        PeerEvent::DataChannelStateChange(c) => {
            if c.ready_state() == RTCDataChannelState::Open {
                println!("{}::DataChannel '{}'", peer_id, c.label());
                c.send_text("Connected to client!".to_string())
                    .await
                    .unwrap();
            } else if c.ready_state() == RTCDataChannelState::Closed {
                println!("{}::DataChannel '{}'", peer_id, c.label());
            }
        }
        PeerEvent::PeerConnectionStateChange(s) => {
            println!("{}::Peer connection state: {} ", peer_id, s)
        }
    }
})
.await?;
let answer = peer.receive_offer(&offer).await?;

You can try out this code by going to https://jsfiddle.net/ndgvLuyc/

  1. Copy the code from "Browser base64 Session Description"
  2. Open up a terminal and type in echo <code you copied from above> | cargo run --example receiver
  3. Copy the response code in the terminal, and past it into "Rust base64 Session Description"
  4. Hit connect and send messages

Signaling server

WebRTC works in it's most basic form by having the client and server exchange strings that represent their networking information. A signaling server is just some API that you exchange that information through. You can see a simple signaling server implemented with a single POST http handler here in this example here.

cargo run --example signaling_server

License

This project is licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in cyberdeck by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.