Alles wat sgcWebRTC toevoegt aan TsgcRTCPeerConnection, gegroepeerd per mogelijkheid. Signalering en connectiviteit komen van de basiscomponent in sgcWebSockets Enterprise; dit pakket ontgrendelt de media-engine erbovenop — audio, video, schermopname, datakanalen, versleuteling en bandbreedteschatting. Elke mogelijkheid werkt hetzelfde in Delphi en C++ Builder, en elke licentie bevat volledige broncode.
Enterprise-basis & SDP
Opus / G.711
VP8 / H.264 / MJPEG
RFC 8831 / 8832
Opname & weergave
Versleutelde media
Congestiecontrole
De basisconnectiviteit zit al in sgcWebSockets. sgcWebRTC ontgrendelt het SDP-, datakanaal- en media-oppervlak op dezelfde component.
| Mogelijkheid | Zit in | Opmerkingen |
|---|---|---|
STUN-client (TsgcSTUNClient) | sgcWebSockets Standard | Server-reflexive candidate-detectie, beschikbaar vanaf onder Enterprise. |
TURN-client & -server, ICE-client (TsgcTURNClient, TsgcICEClient) | sgcWebSockets Enterprise | Relayed candidates en volledige ICE-candidate-gathering / -nominatie. |
Basis-TsgcRTCPeerConnection, legacy WebSocket-relay-signalering | sgcWebSockets Enterprise | GatherCandidates, WriteData en de events OnRTCWebSocket… / OnRTCCandidatePairNominated / OnRTCConnect sturen ICE-connectiviteit en een DTLS-transport aan via de ingebouwde RTCPeerConnection-protocolserver, zonder SDP, datakanalen of media. |
| Handmatige SDP-offer/answer-signalering | sgcWebRTC | CreateOffer, CreateAnswer, SetLocalDescription, SetRemoteDescription, AddIceCandidate, RestartIce — de JSEP-toestandsmachine (RFC 8829) die een browser verwacht. |
| Renegotiatie & glare-resolutie | sgcWebRTC | Nieuwe offers na AddTrack / RemoveTrack, OnNegotiationNeeded, rollback, en de W3C-perfect-negotiation-regel via Polite. |
| Trickle ICE | sgcWebRTC | TrickleICE en RTCOptions.TrickleICEAuto streamen candidates zodra ze gevonden worden in plaats van te wachten op de volledige gathering-timeout. |
| Verbindings- en signaleringsstatus | sgcWebRTC | ConnectionState (subset van W3C RTCPeerConnectionState) en SignalingState (subset van RTCSignalingState), plus OnConnectionStateChange en OnError. |
| SCTP-datakanalen, RTP-audio/video, SRTP-versleuteling | sgcWebRTC | Zie de secties hieronder — alle drie vereisen dit pakket bovenop de Enterprise-basis. |
Eén aanroep van AddTrack koppelt een audiotrack aan de peer-connectie; PCM gaat erin, RTP komt eruit, en hetzelfde pad loopt omgekeerd voor de remote track.
| Mogelijkheid | Member | Opmerkingen |
|---|---|---|
| Audiotrack koppelen | AddTrack(rtctkAudio, aCodec) | Geeft een TsgcRTCTrack terug; RemoveTrack stopt het versturen ervan. |
| Opus-codec | cctAudioOpus | 48 kHz / stereo via een dynamisch geladen libopus-binding. |
| G.711-codec | cctAudioPCMU / cctAudioPCMA | 8 kHz / mono μ-law en A-law, altijd beschikbaar, geen externe bibliotheek. |
| Opgenomen audio versturen | TsgcRTCTrack.SendPCM(aPCM, aSamplesPerChannel) | 16-bit signed interleaved PCM op de samplerate en het kanaalaantal van de encoder. |
| Gedecodeerde audio ontvangen | OnAudio(aPCM, aSampleRate, aChannels, aSamplesPerChannel) | Wordt geactiveerd op de remote track zodra RTP binnenkomt en wordt gedecodeerd. |
| Toegang tot encoder / decoder | AudioEncoder / AudioDecoder | Het onderliggende object TsgcAudioEncoderBase / TsgcAudioDecoderBase, per track vervangbaar. |
| Levenscyclus van de track | Enabled, Ended, OnEnded | Enabled := False dempt zonder renegotiatie; Ended weerspiegelt een track die door de remote kant of een nieuw offer is verwijderd. |
| Microfoonopname | afgeleiden van TsgcMediaCaptureSource | Native opname per platform (waveIn op Windows, plus backends voor Linux, Apple en Android) voedt SendPCM rechtstreeks. |
Video werkt naar dezelfde vorm als audio — frames erin, RTP eruit — met de codec gekozen per track en, voor H.264, de eigen hardware-encoder van het platform eronder.
| Mogelijkheid | Member | Opmerkingen |
|---|---|---|
| Videotrack koppelen | AddTrack(rtctkVideo, aCodec) | Dezelfde aanroep als audio, met een video-TsgcCodecType. |
| VP8-codec | cctVideoVP8 | libvpx-binding, dynamisch geladen, beschikbaar op Windows en Linux. |
| H.264-codec | cctVideoH264 | Native hardware-encoder per platform: Media Foundation (Windows), VideoToolbox (iOS/macOS), MediaCodec (Android). Annex-B-stream, RFC 6184-payloading, SPS/PPS in-band bij elke keyframe. |
| Motion JPEG-codec | cctVideoJPEG | Gebaseerd op GDI+, Windows en Delphi XE of later. |
| Ruwe frame versturen | TsgcRTCTrack.SendVideoFrame(aFrame, aForceKeyFrame) | Codeert en verstuurt een TsgcVideoFrame (familie I420/NV12/RGB/BGR). |
| Voorgecodeerde frame versturen | SendEncodedFrame(aData, aIsKeyFrame) | Omzeilt de eigen encoder van de track voor een extern gecodeerde frame. |
| Gedecodeerde / ruwe frames ontvangen | OnVideoFrame / OnEncodedFrame | Gedecodeerde TsgcVideoFrame, of de ruwe gecodeerde bitstream met de keyframe-vlag. |
| Keyframe aanvragen | RequestKeyFrame | Verstuurt een RTCP PLI naar de remote sender. |
| Toegang tot encoder / decoder | VideoEncoder / VideoDecoder | Het onderliggende object TsgcVideoEncoderBase / TsgcVideoDecoderBase. |
| Camera-opname | afgeleiden van TsgcMediaCaptureSource | Opnamebackends per platform (Windows, Linux, Apple, Android) voeden SendVideoFrame rechtstreeks. |
| Weergave | afgeleiden van TsgcMediaRenderer | Renderer-backends per platform (Windows, Linux, Apple, Android) voor de gedecodeerde remote video. |
Geordend of ongeordend, volledig betrouwbaar of begrensd door een hertransmissieaantal of een levensduur, over SCTP-over-DTLS.
| Mogelijkheid | Member | Opmerkingen |
|---|---|---|
| Kanaal openen | CreateDataChannel(aLabel, aOrdered, aMaxRetransmits, aMaxPacketLifeTime, aProtocol) | Geeft een TsgcRTCDataChannel terug; forceert RTCOptions.DTLS aan. |
| Door remote geopend kanaal | OnDataChannel(aChannel) | Wordt geactiveerd wanneer de peer een kanaal opent op deze verbinding. |
| Tekst / binair versturen | Send(aText) / SendBytes(aBytes) | Geeft False terug als het kanaal nog niet open is. |
| Ontvangen | OnMessage(aText) / OnMessageBinary(aBytes) | Wordt geactiveerd op de SCTP-aansturende thread. |
| Levenscyclusevents | OnOpen, OnClose, OnError(aError) | Komt overeen met de W3C RTCDataChannel-levenscyclus. |
| Kanaalstatus | State, HasId, Id | Het SCTP-stream-id is pas definitief zodra de DTLS-rol is opgelost (RFC 8832-pariteit). |
| Flowcontrole | BufferedAmount, MaxMessageSize | MaxMessageSize volgt de eigen a=max-message-size van de peer en weigert lokaal een te grote verzending. |
| Betrouwbaarheidsintrospectie | Reliability, ReliabilityParam, Ordered, MaxRetransmits, MaxPacketLifeTime | Lees precies terug wat het kanaal onderhandelde. |
| Sluiten | Close | Gebaseerd op RE-CONFIG; State gaat naar closing, dan closed met OnClose. |
| Niveau van de peer-connectie | DataChannelCount, DataChannels[i] | Somt elk open kanaal op de verbinding op. |
Elk RTP-, RTCP- en SCTP-pakket op de verbinding is versleuteld vanaf de DTLS-handshake — er is geen plaintext-modus.
| Mogelijkheid | Detail |
|---|---|
| Sleuteluitwisseling | DTLS-handshake over het genomineerde ICE-candidate-paar (RFC 5764 DTLS-SRTP), die het SRTP-sleutelmateriaal afleidt. |
| DTLS-rol | Bij handmatige signalering komt de rol van a=setup (offerer passief, answerer actief); IsDTLSClient meldt dit zodra bekend. |
| SRTP-beveiligingsprofielen | SRTP_AES128_CM_SHA1_80, SRTP_AES128_CM_SHA1_32, SRTP_AEAD_AES_128_GCM, SRTP_AEAD_AES_256_GCM, onderhandeld tijdens de DTLS-handshake. |
| Crypto-status per SSRC | Eén cryptografische context (rollover-teller, replay-venster) per SSRC, zoals RFC 3711 sectie 3.2.3 vereist, ook wanneer BUNDLE elke m-line op één DTLS-SRTP-transport plaatst. |
| Bereik | Dekt RTP/RTCP-media en de SCTP-associatie met de datakanalen — de hele verbinding, niet alleen één m-line. |
| Backend | Op OpenSSL gebaseerde SRTP-implementatie. |
Een delay-based estimator in de stijl van Google Congestion Control volgt de verbinding en stuurt de doelbitrate van de video-encoder aan.
| Mogelijkheid | Member | Opmerkingen |
|---|---|---|
| Delay-based estimator | TsgcBWE_Estimator | Groepeert pakketten in bursts van 5 ms, draait een trendlinefilter over de vertraging tussen groepen, en classificeert de verbinding als normaal, overuse of underuse. |
| Ratecontrole | AIMD-controller | Overuse verlaagt naar 85% van het bevestigde tempo, underuse houdt vast, normaal verhoogt (multiplicatief ver van het laatst bekende plafond, additief dichtbij). |
| Verliesplafond | Verliespercentagevolging | Boven 10% verlies daalt het plafond; onder 2% herstelt het 8% per seconde tot MaxBitrate. |
| Transport-brede feedback | TWCC (RTCP) | BuildRTCP_TWCC / ParseRTCP_TWCC transport-brede congestiecontrolefeedback, met REMB als terugvalplafond voor peers die alleen dat ondersteunen. |
| Inschakelen | RTCOptions.Media.CongestionControl | Heeft alleen effect wanneer de remote description ook de bijbehorende header-extensie / feedback onderhandelt. |
| Verliesherstel | RTCOptions.Media.RTX | RFC 4588-hertransmissie van de videostream bij RTCP NACK. |
| Voorwaartse foutcorrectie | RTCOptions.Media.FEC | RED / ULPFEC-bescherming op de uitgaande videostream. |
| Pacing | RTCOptions.Media.Pacing | Verdeelt uitgaande videopakketten over de geschatte bitrate in plaats van ze in bursts te versturen. |
| Keyframe-herstel | RTCP PLI | RequestKeyFrame op de ontvangende track vraagt de sender om een verse keyframe na verlies. |