#WebRTC #networking #p2p #tcp #udp #rtcpeerconnection

Paul-Louis Ageneau 64e23341ad Added STUN server to test 6 年之前
include c1e74d77ef Use proper mid in candidates instead of ICE stream name 6 年之前
src 686b468d7b Fixed double space in generated srflx candidates 6 年之前
test 64e23341ad Added STUN server to test 6 年之前
usrsctp @ 04d617c9c1 d7049e7322 Updated usrsctp 6 年之前
.clang-format 611c53191c Added .clang-format and .editorconfig 6 年之前
.editorconfig 611c53191c Added .clang-format and .editorconfig 6 年之前
.gitignore f19a0aa6c7 Simple local test with two peer connections 6 年之前
.gitmodules 1c0a97980b Added usrsctp submodule 6 年之前
LICENSE f844c71e0f Initial commit 6 年之前
Makefile 0188ebf391 Fixed include directive 6 年之前
README.md 9f3d54680d Added link to test.cpp 6 年之前

README.md

libdatachannel - C/C++ WebRTC DataChannels

libdatachannel is a standalone implementation of WebRTC DataChannels in C++17 with C bindings. It enables direct connectivity between native applications and web browsers without the pain of importing the entire WebRTC stack. Its API is modelled as a simplified version of the JavaScript WebRTC API, in order to ease the design of cross-environment applications.

This projet is originally inspired by librtcdcpp, however it is a complete rewrite from scratch, because the messy architecture of librtcdcpp made solving its implementation issues difficult.

Licensed under LGPLv2, see LICENSE.

Compatibility

This implementation has been tested to be compatible with Firefox and Chromium. It supports Multicast DNS candidates resolution provided the operating system also supports it.

Dependencies

Submodules:

Building

git submodule update --init --recursive
make

Example

In the following example, notes the callbacks are called in another thread.

Signal a PeerConnection

#include "rtc/rtc.hpp"
rtc::Configuration config;
config.iceServers.emplace_back("stunserver.org:3478");

auto pc = make_shared<rtc::PeerConnection>(config);

pc->onLocalDescription([](const rtc::Description &sdp) {
    // Send the SDP to the remote peer
    MY_SEND_DESCRIPTION_TO_REMOTE(string(sdp));
});

pc->onLocalCandidate([](const optional<rtc::Candidate> &candidate) {
    if (candidate) {
        MY_SEND_CANDIDATE_TO_REMOTE(candidate->candidate(), candidate->mid());
    } else {
        // Gathering finished
    }
});

MY_ON_RECV_DESCRIPTION_FROM_REMOTE([pc](string sdp) {
    pc->setRemoteDescription(rtc::Description(sdp));
});

MY_ON_RECV_CANDIDATE_FROM_REMOTE([pc](string candidate, string mid) {
    pc->addRemoteCandidate(rtc::Candidate(candidate, mid));
});

Create a DataChannel

auto dc = pc->createDataChannel("test");
dc->onOpen([]() {
    cout << "Open" << endl;
});
dc->onMessage([](const variant<binary, string> &message) {
    if (holds_alternative<string>(message)) {
        cout << "Received: " << get<string>(message) << endl;
    }
});

Receive a DataChannel

shared_ptr<rtc::DataChannel> dc;
pc->onDataChannel([&dc](const shared_ptr<rtc::DataChannel> &incoming) {
    dc = incoming;
    dc->send("Hello world!");
});

See test/main.cpp for a complete local connection example.