https://github.com/paullouisageneau/datachannel-wasm

C++ WebRTC Data Channels and WebSockets for WebAssembly in browsers
https://github.com/paullouisageneau/datachannel-wasm

cpp datachannel emscripten libdatachannel p2p peer-to-peer peerconnection rtcdatachannel rtcpeerconnection wasm webassembly webrtc webrtc-datachannel websocket

Last synced: 13 days ago
JSON representation

C++ WebRTC Data Channels and WebSockets for WebAssembly in browsers

• Host: GitHub
• URL: https://github.com/paullouisageneau/datachannel-wasm
• Owner: paullouisageneau
• License: mit
• Created: 2020-06-10T13:56:57.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-05-29T10:09:30.000Z (6 months ago)
• Last Synced: 2024-08-03T17:12:51.264Z (3 months ago)
• Topics: cpp, datachannel, emscripten, libdatachannel, p2p, peer-to-peer, peerconnection, rtcdatachannel, rtcpeerconnection, wasm, webassembly, webrtc, webrtc-datachannel, websocket
• Language: C++
• Homepage:
• Size: 155 KB
• Stars: 147
• Watchers: 4
• Forks: 24
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-webrtc - datachannel-wasm - C++ WebRTC Data Channels and WebSockets for WebAssembly in browsers. (Libraries / C/C++)

README

        
# datachannel-wasm - C++ WebRTC Data Channels for WebAssembly in browsers

[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Gitter](https://badges.gitter.im/libdatachannel/datachannel-wasm.svg)](https://gitter.im/libdatachannel/datachannel-wasm?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Discord](https://img.shields.io/discord/903257095539925006?logo=discord)](https://discord.gg/jXAP8jp3Nn)

datachannel-wasm is a C++ WebRTC Data Channels and WebSocket wrapper for [Emscripten](https://emscripten.org/) compatible with [libdatachannel](https://github.com/paullouisageneau/libdatachannel).

datachannel-wasm exposes the same API as [libdatachannel](https://github.com/paullouisageneau/libdatachannel), and therefore allows to compile the same C++ code using Data Channels and WebSockets to WebAssembly for browsers in addition to native targets supported by libdatachannel. The interface is only a subset of the one of [libdatachannel](https://github.com/paullouisageneau/libdatachannel), in particular, tracks and media transport are not supported. See what is available in [wasm/include](https://github.com/paullouisageneau/datachannel-wasm/tree/master/wasm/include/rtc).

These wrappers were originally written for my multiplayer game [Convergence](https://github.com/paullouisageneau/convergence) and were extracted from there to be easily reusable.

datachannel-wasm is licensed under MIT, see [LICENSE](https://github.com/paullouisageneau/datachannel-wasm/blob/master/LICENSE).

## Installation

You just need to add datachannel-wasm as a submodule in your Emscripten project:

```bash

$ git submodule add https://github.com/paullouisageneau/datachannel-wasm.git deps/datachannel-wasm

$ git submodule update --init --recursive

```

CMakeLists.txt:

```cmake

[...]

add_subdirectory(deps/datachannel-wasm EXCLUDE_FROM_ALL)

target_link_libraries(YOUR_TARGET datachannel-wasm)

```

Since datachannel-wasm is compatible with [libdatachannel](https://github.com/paullouisageneau/libdatachannel), you can easily leverage both to make the same C++ code compile to native (including Apple macOS and Microsoft Windows):

```bash

$ git submodule add https://github.com/paullouisageneau/datachannel-wasm.git deps/datachannel-wasm

$ git submodule add https://github.com/paullouisageneau/libdatachannel.git deps/libdatachannel

$ git submodule update --init --recursive --depth 1

```

CMakeLists.txt:

```cmake

if(CMAKE_SYSTEM_NAME MATCHES "Emscripten")

    add_subdirectory(deps/datachannel-wasm EXCLUDE_FROM_ALL)

    target_link_libraries(YOUR_TARGET datachannel-wasm)

else()

    option(NO_MEDIA "Disable media support in libdatachannel" ON)

    add_subdirectory(deps/libdatachannel EXCLUDE_FROM_ALL)

    target_link_libraries(YOUR_TARGET datachannel)

endif()

```

## Building

Building requires that you have [emsdk](https://github.com/emscripten-core/emsdk) installed and activated in your environment:

```bash

$ cmake -B build -DCMAKE_TOOLCHAIN_FILE=$EMSDK/upstream/emscripten/cmake/Modules/Platform/Emscripten.cmake

$ cd build

$ make -j2

```