https://github.com/wngr/async-datachannel

Async Wrapper for datachannel-rs
https://github.com/wngr/async-datachannel

async datachannel rust webrtc

Last synced: 13 days ago
JSON representation

Async Wrapper for datachannel-rs

• Host: GitHub
• URL: https://github.com/wngr/async-datachannel
• Owner: wngr
• License: apache-2.0
• Created: 2021-09-14T18:37:08.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2022-11-29T08:22:42.000Z (almost 2 years ago)
• Last Synced: 2024-10-25T11:57:41.602Z (21 days ago)
• Topics: async, datachannel, rust, webrtc
• Language: Rust
• Homepage:
• Size: 128 KB
• Stars: 9
• Watchers: 2
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE2.md

Awesome Lists containing this project

README

        
# async-datachannel

This repository holds two crates, both of which share (mostly) the same API.

## async-datachannel

[![License](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue.svg)](https://github.com/wngr/async-datachannel)

[![Cargo](https://img.shields.io/crates/v/async-datachannel.svg)](https://crates.io/crates/async-datachannel)

[![Documentation](https://docs.rs/async-datachannel/badge.svg)](https://docs.rs/async-datachannel)

Async wrapper for the [`datachannel`] crate. For a complete example check the

[native/examples](./native/examples) directory.

Note that this crate currently is made to work only with the tokio runtime. If

you're interested in supporting other runtimes, let me know.

[`datachannel`]: https://crates.io/crates/datachannel

## async-datachannel-wasm

[![License](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue.svg)](https://github.com/wngr/async-datachannel-wasm)

[![Cargo](https://img.shields.io/crates/v/async-datachannel-wasm.svg)](https://crates.io/crates/async-datachannel-wasm)

[![Documentation](https://docs.rs/async-datachannel-wasm/badge.svg)](https://docs.rs/async-datachannel-wasm)

Same API as above, but targets browser environments. Uses the browser provided

WebRTC API.

------

## Quickstart

```rust

use async_datachannel::{Message, PeerConnection, RtcConfig};

use futures::io::{AsyncReadExt, AsyncWriteExt, channel::mpsc};

let ice_servers = vec!["stun:stun.l.google.com:19302"];

let conf = RtcConfig::new(&ice_servers);

let (tx_sig_outbound, mut rx_sig_outbound) = mpsc::channel(32);

let (tx_sig_inbound, rx_sig_inbound) = mpsc::channel(32);

let listener = PeerConnection::new(&conf, (tx_sig_outbound, rx_sig_inbound))?;

// TODO: Wire up `tx_sig_inbound` and `rx_sig_outbound` to a signalling

// mechanism.

let mut dc = listener.dial("Hangout").await?;

dc.write(b"Hello").await?;

let mut buf = vec![0; 32];

let n = dc.read(&mut buf).await?;

assert_eq!(b"World", &buf[..n]);

```

## License

Licensed under either of

 * Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)

 * MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

#### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted

for inclusion in the work by you, as defined in the Apache-2.0 license, shall be

dual licensed as above, without any additional terms or conditions.