Alles, was sgcWebRTC zu TsgcRTCPeerConnection hinzufügt, gruppiert nach Fähigkeit. Signaling und Konnektivität kommen von der Basiskomponente in sgcWebSockets Enterprise; dieses Paket schaltet die Media-Engine darauf frei — Audio, Video, Bildschirmaufnahme, Datenkanäle, Verschlüsselung und Bandbreitenschätzung. Jede Fähigkeit funktioniert in Delphi und C++ Builder identisch, und jede Lizenz enthält den vollständigen Quellcode.
Enterprise-Basis & SDP
Opus / G.711
VP8 / H.264 / MJPEG
RFC 8831 / 8832
Aufnahme & Rendering
Verschlüsselte Medien
Congestion Control
Die Basis-Konnektivität ist bereits in sgcWebSockets enthalten. sgcWebRTC schaltet die SDP-, Datenkanal- und Media-Oberfläche auf derselben Komponente frei.
| Fähigkeit | Enthalten in | Hinweise |
|---|---|---|
STUN-Client (TsgcSTUNClient) | sgcWebSockets Standard | Server-reflexive Kandidatenermittlung, bereits unterhalb von Enterprise verfügbar. |
TURN-Client & -Server, ICE-Client (TsgcTURNClient, TsgcICEClient) | sgcWebSockets Enterprise | Weitergeleitete Kandidaten und vollständiges ICE-Kandidaten-Gathering / -Nominierung. |
Basis-TsgcRTCPeerConnection, klassisches WebSocket-Relay-Signaling | sgcWebSockets Enterprise | GatherCandidates, WriteData und die Ereignisse OnRTCWebSocket… / OnRTCCandidatePairNominated / OnRTCConnect steuern die ICE-Konnektivität und einen DTLS-Transport über den eingebauten RTCPeerConnection-Protokollserver, ohne SDP, Datenkanäle oder Medien. |
| Manuelles SDP-Offer/Answer-Signaling | sgcWebRTC | CreateOffer, CreateAnswer, SetLocalDescription, SetRemoteDescription, AddIceCandidate, RestartIce — die JSEP-Zustandsmaschine (RFC 8829), die ein Browser erwartet. |
| Renegotiation & Glare-Auflösung | sgcWebRTC | Erneute Angebote nach AddTrack / RemoveTrack, OnNegotiationNeeded, Rollback und die W3C-Perfect-Negotiation-Regel über Polite. |
| Trickle ICE | sgcWebRTC | TrickleICE und RTCOptions.TrickleICEAuto streamen Kandidaten, sobald sie gefunden werden, statt auf das vollständige Gathering-Timeout zu warten. |
| Verbindungs- & Signaling-Status | sgcWebRTC | ConnectionState (Teilmenge von W3C RTCPeerConnectionState) und SignalingState (Teilmenge von RTCSignalingState), dazu OnConnectionStateChange und OnError. |
| SCTP-Datenkanäle, RTP-Audio/Video, SRTP-Verschlüsselung | sgcWebRTC | Siehe die Abschnitte unten — alle drei erfordern dieses Paket zusätzlich zur Enterprise-Basis. |
Ein einziger AddTrack-Aufruf hängt einen Audio-Track an die Peer-Verbindung; PCM geht rein, RTP geht raus, und derselbe Pfad läuft umgekehrt für den Remote-Track.
| Fähigkeit | Member | Hinweise |
|---|---|---|
| Audio-Track anhängen | AddTrack(rtctkAudio, aCodec) | Gibt einen TsgcRTCTrack zurück; RemoveTrack stoppt das Senden. |
| Opus-Codec | cctAudioOpus | 48 kHz / Stereo über eine dynamisch geladene libopus-Anbindung. |
| G.711-Codec | cctAudioPCMU / cctAudioPCMA | 8 kHz / Mono μ-Law und A-Law, immer verfügbar, keine externe Bibliothek. |
| Aufgenommenes Audio senden | TsgcRTCTrack.SendPCM(aPCM, aSamplesPerChannel) | 16-Bit-signed interleaved PCM in der Sample-Rate und Kanalzahl des Encoders. |
| Dekodiertes Audio empfangen | OnAudio(aPCM, aSampleRate, aChannels, aSamplesPerChannel) | Löst auf dem Remote-Track aus, sobald RTP eintrifft und dekodiert wird. |
| Encoder-/Decoder-Zugriff | AudioEncoder / AudioDecoder | Das zugrunde liegende TsgcAudioEncoderBase-/TsgcAudioDecoderBase-Objekt, pro Track ersetzbar. |
| Track-Lebenszyklus | Enabled, Ended, OnEnded | Enabled := False stummschaltet ohne Renegotiation; Ended spiegelt einen von der Gegenseite entfernten Track oder ein erneutes Angebot wider. |
| Mikrofonaufnahme | Nachfahren von TsgcMediaCaptureSource | Native Aufnahme pro Plattform (waveIn unter Windows, dazu Linux-, Apple- und Android-Backends) speist SendPCM direkt. |
Video funktioniert nach demselben Muster wie Audio — Frames rein, RTP raus —, mit dem pro Track gewählten Codec und, bei H.264, dem eigenen Hardware-Encoder der Plattform darunter.
| Fähigkeit | Member | Hinweise |
|---|---|---|
| Video-Track anhängen | AddTrack(rtctkVideo, aCodec) | Derselbe Aufruf wie bei Audio, mit einem Video-TsgcCodecType. |
| VP8-Codec | cctVideoVP8 | libvpx-Anbindung, dynamisch geladen, verfügbar unter Windows und Linux. |
| H.264-Codec | cctVideoH264 | Nativer Hardware-Encoder pro Plattform: Media Foundation (Windows), VideoToolbox (iOS/macOS), MediaCodec (Android). Annex-B-Stream, RFC 6184-Payloading, SPS/PPS bei jedem Keyframe im Stream mitgeführt. |
| Motion-JPEG-Codec | cctVideoJPEG | GDI+-basiert, Windows und Delphi XE oder neuer. |
| Rohes Frame senden | TsgcRTCTrack.SendVideoFrame(aFrame, aForceKeyFrame) | Kodiert und sendet ein TsgcVideoFrame (I420/NV12/RGB/BGR-Familie). |
| Vorkodiertes Frame senden | SendEncodedFrame(aData, aIsKeyFrame) | Umgeht den eigenen Encoder des Tracks für ein extern kodiertes Frame. |
| Dekodierte / rohe Frames empfangen | OnVideoFrame / OnEncodedFrame | Dekodiertes TsgcVideoFrame, oder der rohe kodierte Bitstream mit seinem Keyframe-Flag. |
| Keyframe anfordern | RequestKeyFrame | Sendet ein RTCP-PLI an den Remote-Sender. |
| Encoder-/Decoder-Zugriff | VideoEncoder / VideoDecoder | Das zugrunde liegende TsgcVideoEncoderBase-/TsgcVideoDecoderBase-Objekt. |
| Kameraaufnahme | Nachfahren von TsgcMediaCaptureSource | Plattformspezifische Aufnahme-Backends (Windows, Linux, Apple, Android) speisen SendVideoFrame direkt. |
| Rendering | Nachfahren von TsgcMediaRenderer | Plattformspezifische Renderer-Backends (Windows, Linux, Apple, Android) für das dekodierte Remote-Video. |
Geordnet oder ungeordnet, vollständig zuverlässig oder begrenzt durch eine Neuübertragungszahl oder eine Lebensdauer, über SCTP-over-DTLS.
| Fähigkeit | Member | Hinweise |
|---|---|---|
| Kanal öffnen | CreateDataChannel(aLabel, aOrdered, aMaxRetransmits, aMaxPacketLifeTime, aProtocol) | Gibt einen TsgcRTCDataChannel zurück; erzwingt RTCOptions.DTLS. |
| Von der Gegenseite geöffneter Kanal | OnDataChannel(aChannel) | Löst aus, wenn der Peer einen Kanal auf dieser Verbindung öffnet. |
| Text / Binär senden | Send(aText) / SendBytes(aBytes) | Gibt False zurück, wenn der Kanal noch nicht offen ist. |
| Empfangen | OnMessage(aText) / OnMessageBinary(aBytes) | Löst auf dem SCTP-steuernden Thread aus. |
| Lebenszyklus-Ereignisse | OnOpen, OnClose, OnError(aError) | Entspricht dem W3C-RTCDataChannel-Lebenszyklus. |
| Kanalstatus | State, HasId, Id | Die SCTP-Stream-ID steht erst fest, sobald die DTLS-Rolle geklärt ist (RFC 8832-Parität). |
| Flusskontrolle | BufferedAmount, MaxMessageSize | MaxMessageSize verfolgt das eigene a=max-message-size der Gegenseite und verweigert einen zu großen Sendevorgang bereits lokal. |
| Reliability-Introspektion | Reliability, ReliabilityParam, Ordered, MaxRetransmits, MaxPacketLifeTime | Liest exakt aus, was der Kanal ausgehandelt hat. |
| Schließen | Close | RE-CONFIG-basiertes Schließen; State geht zu closing, dann zu closed mit OnClose. |
| Ebene der Peer-Verbindung | DataChannelCount, DataChannels[i] | Zählt jeden offenen Kanal auf der Verbindung auf. |
Jedes RTP-, RTCP- und SCTP-Paket auf der Verbindung ist ab dem DTLS-Handshake verschlüsselt — es gibt keinen Klartext-Modus.
| Fähigkeit | Detail |
|---|---|
| Schlüsselaustausch | DTLS-Handshake über das nominierte ICE-Kandidatenpaar (RFC 5764 DTLS-SRTP), leitet das SRTP-Schlüsselmaterial ab. |
| DTLS-Rolle | Beim manuellen Signaling kommt die Rolle aus a=setup (Anbieter passiv, Antwortender aktiv); IsDTLSClient meldet sie, sobald sie geklärt ist. |
| SRTP-Schutzprofile | SRTP_AES128_CM_SHA1_80, SRTP_AES128_CM_SHA1_32, SRTP_AEAD_AES_128_GCM, SRTP_AEAD_AES_256_GCM, ausgehandelt während des DTLS-Handshakes. |
| Kryptostatus pro SSRC | Ein kryptografischer Kontext (Rollover-Zähler, Replay-Fenster) pro SSRC, wie es RFC 3711 Abschnitt 3.2.3 verlangt, selbst wenn BUNDLE jede m-Zeile auf einen DTLS-SRTP-Transport legt. |
| Umfang | Deckt RTP/RTCP-Medien und die SCTP-Assoziation der Datenkanäle ab — die gesamte Verbindung, nicht nur eine m-Zeile. |
| Backend | OpenSSL-gestützte SRTP-Implementierung. |
Ein verzögerungsbasierter Schätzer im Stil von Google Congestion Control verfolgt die Leitung und steuert die Ziel-Bitrate des Video-Encoders.
| Fähigkeit | Member | Hinweise |
|---|---|---|
| Verzögerungsbasierter Schätzer | TsgcBWE_Estimator | Gruppiert Pakete in 5 ms-Sendeschüben, führt einen Trendline-Filter über die Verzögerung zwischen den Gruppen aus und klassifiziert die Leitung als normal, überlastet oder unterlastet. |
| Ratenregelung | AIMD-Regler | Überlastung senkt auf 85 % der bestätigten Rate, Unterlastung hält, normal erhöht (multiplikativ, solange weit von der letzten bekannten Obergrenze entfernt, additiv in ihrer Nähe). |
| Verlustobergrenze | Verlustraten-Tracking | Über 10 % Verlust sinkt die Obergrenze; unter 2 % erholt sie sich um 8 % pro Sekunde bis zu MaxBitrate. |
| Transport-weites Feedback | TWCC (RTCP) | BuildRTCP_TWCC / ParseRTCP_TWCC transport-weites Congestion-Control-Feedback, mit REMB als Rückfall-Obergrenze für Peers, die nur das unterstützen. |
| Einschalten | RTCOptions.Media.CongestionControl | Wirkt nur, wenn die Remote-Description die passende Header-Erweiterung / das Feedback ebenfalls aushandelt. |
| Verlustwiederherstellung | RTCOptions.Media.RTX | RFC 4588-Neuübertragung des Video-Streams bei RTCP-NACK. |
| Vorwärtsfehlerkorrektur | RTCOptions.Media.FEC | RED-/ULPFEC-Schutz auf dem ausgehenden Video-Stream. |
| Pacing | RTCOptions.Media.Pacing | Taktet ausgehende Video-Pakete mit der geschätzten Bitrate, statt sie in Schüben zu senden. |
| Keyframe-Wiederherstellung | RTCP PLI | RequestKeyFrame auf dem empfangenden Track fordert nach einem Verlust ein frisches Keyframe vom Sender an. |