ดาวน์โหลด libdatachannel - ดาวน์โหลด libdatachannel ซอร์สโค้ด

libdatachannel

ซี/ซี++

Version 0.22.3

ดาวน์โหลด

libdatachannel - ไลบรารีเครือข่าย C/C++ WebRTC

libdatachannel เป็นการใช้งานแบบสแตนด์อโลนของ WebRTC Data Channels, WebRTC Media Transport และ WebSockets ใน C++17 พร้อมการเชื่อมโยง C สำหรับแพลตฟอร์ม POSIX (รวมถึง GNU/Linux, Android, FreeBSD, Apple macOS และ iOS) และ Microsoft Windows WebRTC เป็นมาตรฐาน W3C และ IETF ที่ช่วยให้สามารถแลกเปลี่ยนข้อมูลและสื่อระหว่างอุปกรณ์ทั้งสองแบบเรียลไทม์ได้

ไลบรารีมีเป้าหมายที่จะตรงไปตรงมาและมีน้ำหนักเบาโดยมีการพึ่งพาภายนอกน้อยที่สุด เพื่อให้สามารถเชื่อมต่อโดยตรงระหว่างแอปพลิเคชันดั้งเดิมและเว็บเบราว์เซอร์โดยไม่ต้องลำบากในการนำเข้าไลบรารีอ้างอิงที่ล้นหลามของ Google อินเทอร์เฟซประกอบด้วย JavaScript WebRTC และ WebSocket API ในเวอร์ชันที่ค่อนข้างเรียบง่ายซึ่งมีอยู่ในเบราว์เซอร์ เพื่อความสะดวกในการออกแบบแอปพลิเคชันข้ามสภาพแวดล้อม

สามารถคอมไพล์ได้หลายแบ็กเอนด์:

ชั้นความปลอดภัยสามารถระบุได้ผ่าน GnuTLS, Mbed TLS หรือ OpenSSL
การเชื่อมต่อสำหรับ WebRTC สามารถให้บริการผ่านไลบรารี ICE เฉพาะกิจของฉัน libjuice ในรูปแบบโมดูลย่อยหรือผ่าน libnice

สแตก WebRTC เข้ากันได้กับเบราว์เซอร์เช่น Firefox และ Chromium โดยสมบูรณ์ ดูความเข้ากันได้ด้านล่าง นอกจากนี้ โค้ดที่ใช้ Data Channels และ WebSockets จากไลบรารีอาจถูกคอมไพล์เช่นเดียวกับ WebAssembly สำหรับเบราว์เซอร์ที่มี datachannel-wasm

libdatachannel ได้รับอนุญาตภายใต้ MPL 2.0 ตั้งแต่เวอร์ชัน 0.18 โปรดดูใบอนุญาต (เวอร์ชันก่อนหน้าได้รับอนุญาตภายใต้ LGPLv2.1 หรือใหม่กว่า)

libdatachannel พร้อมใช้งานบนพอร์ต AUR, vcpkg และ FreeBSD การผูกพร้อมใช้งานสำหรับ Rust และ Node.js

การพึ่งพาอาศัยกัน

GnuTLS, Mbed TLS หรือ OpenSSL
usrsctp (เป็นโมดูลย่อยตามค่าเริ่มต้น)
plog (เป็นโมดูลย่อยตามค่าเริ่มต้น)
libjuice (เป็นโมดูลย่อยตามค่าเริ่มต้น) หรือ libnice เป็นแบ็กเอนด์ ICE
libsrtp (เป็นโมดูลย่อยตามค่าเริ่มต้น) จำเป็นหากคอมไพล์ด้วยการสนับสนุนสื่อ
nlohmann JSON (เป็นโมดูลย่อยตามค่าเริ่มต้น) จำเป็นในการสร้างตัวอย่าง

อาคาร

ดู BUILDING.md สำหรับคำแนะนำในการสร้าง

ตัวอย่าง

ดูตัวอย่างการใช้งานที่สมบูรณ์พร้อมเซิร์ฟเวอร์การส่งสัญญาณ (ภายใต้ MPL 2.0)

นอกจากนี้ คุณอาจต้องการดูเอกสารประกอบ C API

ส่งสัญญาณการเชื่อมต่อแบบเพียร์

# include " rtc/rtc.hpp "

rtc::Configuration config;
config.iceServers.emplace_back( " mystunserver.org:3478 " );

rtc::PeerConnection pc (config);

pc.onLocalDescription([](rtc::Description sdp) {
    // Send the SDP to the remote peer
    MY_SEND_DESCRIPTION_TO_REMOTE ( std::string (sdp));
});

pc.onLocalCandidate([](rtc::Candidate candidate) {
    // Send the candidate to the remote peer
    MY_SEND_CANDIDATE_TO_REMOTE (candidate. candidate (), candidate. mid ());
});

MY_ON_RECV_DESCRIPTION_FROM_REMOTE ([&pc](std::string sdp) {
    pc. setRemoteDescription ( rtc::Description (sdp));
});

MY_ON_RECV_CANDIDATE_FROM_REMOTE ([&pc](std::string candidate, std::string mid) {
    pc. addRemoteCandidate ( rtc::Candidate (candidate, mid));
});

สังเกตสถานะ PeerConnection

pc.onStateChange([](rtc::PeerConnection::State state) {
    std::cout << " State: " << state << std::endl;
});

pc.onGatheringStateChange([](rtc::PeerConnection::GatheringState state) {
    std::cout << " Gathering state: " << state << std::endl;
});

สร้างช่องข้อมูล

 auto dc = pc.createDataChannel( " test " );

dc-> onOpen ([]() {
    std::cout << " Open " << std::endl;
});

dc-> onMessage ([](std::variant<rtc::binary, rtc::string> message) {
    if (std::holds_alternative<rtc::string>(message)) {
        std::cout << " Received: " << get<rtc::string>(message) << std::endl;
    }
});

รับ DataChannel

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

เปิด WebSocket

rtc::WebSocket ws;

ws.onOpen([]() {
    std::cout << " WebSocket open " << std::endl;
});

ws.onMessage([](std::variant<rtc::binary, rtc::string> message) {
    if (std::holds_alternative<rtc::string>(message)) {
        std::cout << " WebSocket received: " << std::get<rtc::string>(message) << endl;
    }
});

ws.open( " wss://my.websocket/service " );

ความเข้ากันได้

ห้องสมุดใช้โปรโตคอลการสื่อสารต่อไปนี้:

ช่องข้อมูล WebRTC และการขนส่งสื่อ

WebRTC อนุญาตให้มีการแลกเปลี่ยนข้อมูลและสื่อแบบเรียลไทม์ระหว่างอุปกรณ์สองเครื่องผ่านการเชื่อมต่อแบบเพียร์ (หรือ RTCPeerConnection) ซึ่งเป็นการเชื่อมต่อแบบเพียร์ทูเพียร์ที่มีสัญญาณซึ่งสามารถรองรับทั้งช่องข้อมูลและแทร็กสื่อ มันเข้ากันได้กับเบราว์เซอร์ Firefox, Chromium และ Safari และไลบรารี WebRTC อื่น ๆ (ดู webrtc-echoes) การขนส่งสื่อเป็นทางเลือกและสามารถปิดใช้งานได้ในขณะคอมไพล์

สแต็คโปรโตคอล:

ช่องข้อมูลที่ใช้ SCTP (RFC8831)
การขนส่งสื่อที่ใช้ SRTP (RFC8834)
DTLS/UDP (RFC7350 และ RFC8261)
ICE (RFC8445) พร้อม STUN (RFC8489) และส่วนขยาย TURN (RFC8656)

คุณสมบัติ:

รองรับ IPv6 เต็มรูปแบบ (ตามที่ได้รับคำสั่งจาก RFC8835)
น้ำแข็งหยด (RFC8838)
การสร้างเซสชันที่เข้ากันได้กับ JSEP ด้วย SDP (RFC8829)
SCTP ผ่าน DTLS พร้อมข้อเสนอ/คำตอบ SDP (RFC8841)
DTLS พร้อมคีย์ ECDSA หรือ RSA (RFC8827)
การรับคีย์ SRTP และ SRTCP จาก DTLS (RFC5764)
บริการ QoS ที่แตกต่าง (RFC8837) เมื่อเป็นไปได้
ผู้สมัคร DNS แบบหลายผู้รับ (draft-ietf-rtcweb-mdns-ice-candidates-04)
การเชื่อมต่อแบบมัลติเพล็กซ์บนพอร์ต UDP เดียวพร้อม libjuice เป็นแบ็กเอนด์ ICE

โปรดทราบว่าเฉพาะโหมด SDP BUNDLE เท่านั้นที่รองรับสื่อมัลติเพล็กซ์ (RFC8843) ลักษณะการทำงานนี้เทียบเท่ากับนโยบายชุดรวม JSEP เท่านั้น: ไลบรารีจะเจรจาองค์ประกอบเครือข่ายที่ไม่ซ้ำกันเสมอ โดยที่สตรีมสื่อ SRTP จะถูกมัลติเพล็กซ์ด้วยแพ็กเก็ตควบคุม SRTCP (RFC5761) และการรับส่งข้อมูล SCTP/DTLS (RFC8261)

เว็บซ็อกเก็ต

WebSocket เป็นโปรโตคอลทางเลือกสำหรับการส่งสัญญาณ WebRTC การสนับสนุนเป็นทางเลือกและสามารถปิดใช้งานได้ในขณะคอมไพล์

สแต็คโปรโตคอล:

โปรโตคอล WebSocket (RFC6455) ฝั่งไคลเอ็นต์และเซิร์ฟเวอร์
HTTP ผ่าน TLS (RFC2818)

คุณสมบัติ:

รองรับ IPv6 และ IPv4/IPv6 แบบดูอัลสแต็ก
อยู่กับปิงปอง/ปิงปอง

ทรัพยากรภายนอก

การผูกสนิมสำหรับ libdatachannel: datachannel-rs
การผูก Node.js สำหรับ libdatachannel: node-datachannel
การรวมความสามัคคีสำหรับ Windows 10 และ Hololens: datachannel-unity
wrapper WebAssembly เข้ากันได้กับ libdatachannel: datachannel-wasm
เซิร์ฟเวอร์ STUN/TURN น้ำหนักเบา: สีม่วง
Wrapper แพลตฟอร์มดั้งเดิม (Android/iOS/macOS) สำหรับ libdatachannel: datachannel-native