Wszystko, co sgcWebRTC dodaje do TsgcRTCPeerConnection, pogrupowane według możliwości. Sygnalizacja i łączność pochodzą z komponentu bazowego w sgcWebSockets Enterprise; ten pakiet odblokowuje na nim silnik mediów — audio, wideo, przechwytywanie ekranu, kanały danych, szyfrowanie i szacowanie przepustowości. Każda funkcja działa tak samo w Delphi i C++ Builder, a każda licencja zawiera pełny kod źródłowy.
Baza Enterprise i SDP
Opus / G.711
VP8 / H.264 / MJPEG
RFC 8831 / 8832
Przechwytywanie i renderowanie
Szyfrowane media
Kontrola przeciążenia
Bazowa łączność jest już w sgcWebSockets. sgcWebRTC odblokowuje na tym samym komponencie powierzchnię SDP, kanałów danych i mediów.
| Możliwość | Dostępne w | Uwagi |
|---|---|---|
Klient STUN (TsgcSTUNClient) | sgcWebSockets Standard | Wykrywanie kandydatów server-reflexive, dostępne poniżej Enterprise. |
Klient i serwer TURN, klient ICE (TsgcTURNClient, TsgcICEClient) | sgcWebSockets Enterprise | Kandydaci przekazywani przez TURN oraz pełne zbieranie / nominacja kandydatów ICE. |
Bazowy TsgcRTCPeerConnection, dawna sygnalizacja przez przekaźnik WebSocket | sgcWebSockets Enterprise | GatherCandidates, WriteData oraz zdarzenia OnRTCWebSocket… / OnRTCCandidatePairNominated / OnRTCConnect sterują łącznością ICE i transportem DTLS przez wbudowany serwer protokołu RTCPeerConnection, bez SDP, kanałów danych ani mediów. |
| Ręczna sygnalizacja oferta/odpowiedź SDP | sgcWebRTC | CreateOffer, CreateAnswer, SetLocalDescription, SetRemoteDescription, AddIceCandidate, RestartIce — maszyna stanów JSEP (RFC 8829), której oczekuje przeglądarka. |
| Renegocjacja i rozwiązywanie konfliktów (glare) | sgcWebRTC | Ponowne oferty po AddTrack / RemoveTrack, OnNegotiationNeeded, wycofanie (rollback) oraz reguła W3C perfect-negotiation przez Polite. |
| Trickle ICE | sgcWebRTC | TrickleICE i RTCOptions.TrickleICEAuto przesyłają kandydatów strumieniowo w miarę ich znajdowania, zamiast czekać na pełny limit czasu zbierania. |
| Stan połączenia i sygnalizacji | sgcWebRTC | ConnectionState (podzbiór W3C RTCPeerConnectionState) i SignalingState (podzbiór RTCSignalingState), a do tego OnConnectionStateChange i OnError. |
| Kanały danych SCTP, audio/wideo RTP, szyfrowanie SRTP | sgcWebRTC | Zobacz sekcje poniżej — wszystkie trzy wymagają tego pakietu ponad bazą Enterprise. |
Jedno wywołanie AddTrack dołącza ścieżkę audio do połączenia peer; PCM wchodzi, RTP wychodzi, a ta sama ścieżka działa w odwrotnym kierunku dla ścieżki zdalnej.
| Możliwość | Składnik | Uwagi |
|---|---|---|
| Dołączenie ścieżki audio | AddTrack(rtctkAudio, aCodec) | Zwraca TsgcRTCTrack; RemoveTrack zatrzymuje jej wysyłanie. |
| Kodek Opus | cctAudioOpus | 48 kHz / stereo przez dynamicznie ładowane wiązanie z libopus. |
| Kodek G.711 | cctAudioPCMU / cctAudioPCMA | 8 kHz / mono μ-law i A-law, zawsze dostępny, bez biblioteki zewnętrznej. |
| Wysyłanie przechwyconego audio | TsgcRTCTrack.SendPCM(aPCM, aSamplesPerChannel) | 16-bitowe znakowane przeplatane PCM przy częstotliwości próbkowania i liczbie kanałów kodera. |
| Odbiór zdekodowanego audio | OnAudio(aPCM, aSampleRate, aChannels, aSamplesPerChannel) | Uruchamiane na ścieżce zdalnej w miarę napływania i dekodowania RTP. |
| Dostęp do kodera / dekodera | AudioEncoder / AudioDecoder | Bazowy obiekt TsgcAudioEncoderBase / TsgcAudioDecoderBase, wymienny dla każdej ścieżki. |
| Cykl życia ścieżki | Enabled, Ended, OnEnded | Enabled := False wycisza bez renegocjacji; Ended odzwierciedla ścieżkę porzuconą przez stronę zdalną lub ponowną ofertę. |
| Przechwytywanie mikrofonu | Potomkowie TsgcMediaCaptureSource | Natywne przechwytywanie per platforma (waveIn na Windows, a do tego backendy Linux, Apple i Android) zasila bezpośrednio SendPCM. |
Wideo działa w tym samym schemacie co audio — klatki wchodzą, RTP wychodzi — z kodekiem wybieranym dla każdej ścieżki, a dla H.264 z natywnym sprzętowym koderem platformy pod spodem.
| Możliwość | Składnik | Uwagi |
|---|---|---|
| Dołączenie ścieżki wideo | AddTrack(rtctkVideo, aCodec) | To samo wywołanie co dla audio, z wideo TsgcCodecType. |
| Kodek VP8 | cctVideoVP8 | Wiązanie z libvpx, ładowane dynamicznie, dostępne na Windows i Linux. |
| Kodek H.264 | cctVideoH264 | Natywny sprzętowy koder per platforma: Media Foundation (Windows), VideoToolbox (iOS/macOS), MediaCodec (Android). Strumień Annex-B, ładunek RFC 6184, SPS/PPS przenoszone w paśmie przy każdej klatce kluczowej. |
| Kodek Motion JPEG | cctVideoJPEG | Oparty na GDI+, Windows i Delphi XE lub nowszy. |
| Wysłanie surowej klatki | TsgcRTCTrack.SendVideoFrame(aFrame, aForceKeyFrame) | Koduje i wysyła TsgcVideoFrame (rodzina I420/NV12/RGB/BGR). |
| Wysłanie wstępnie zakodowanej klatki | SendEncodedFrame(aData, aIsKeyFrame) | Omija własny koder ścieżki dla klatki zakodowanej zewnętrznie. |
| Odbiór klatek zdekodowanych / surowych | OnVideoFrame / OnEncodedFrame | Zdekodowany TsgcVideoFrame albo surowy zakodowany strumień bitów z flagą klatki kluczowej. |
| Żądanie klatki kluczowej | RequestKeyFrame | Wysyła RTCP PLI do zdalnego nadawcy. |
| Dostęp do kodera / dekodera | VideoEncoder / VideoDecoder | Bazowy obiekt TsgcVideoEncoderBase / TsgcVideoDecoderBase. |
| Przechwytywanie z kamery | Potomkowie TsgcMediaCaptureSource | Backendy przechwytywania per platforma (Windows, Linux, Apple, Android) zasilają bezpośrednio SendVideoFrame. |
| Renderowanie | Potomkowie TsgcMediaRenderer | Backendy renderowania per platforma (Windows, Linux, Apple, Android) dla zdekodowanego wideo zdalnego. |
Uporządkowane lub nie, w pełni niezawodne albo ograniczone liczbą retransmisji lub czasem życia, przez SCTP-over-DTLS.
| Możliwość | Składnik | Uwagi |
|---|---|---|
| Otwarcie kanału | CreateDataChannel(aLabel, aOrdered, aMaxRetransmits, aMaxPacketLifeTime, aProtocol) | Zwraca TsgcRTCDataChannel; wymusza RTCOptions.DTLS. |
| Kanał otwarty zdalnie | OnDataChannel(aChannel) | Uruchamiane, gdy peer otwiera kanał na tym połączeniu. |
| Wysyłanie tekstu / danych binarnych | Send(aText) / SendBytes(aBytes) | Zwraca False, jeśli kanał nie jest jeszcze otwarty. |
| Odbiór | OnMessage(aText) / OnMessageBinary(aBytes) | Uruchamiane w wątku obsługującym SCTP. |
| Zdarzenia cyklu życia | OnOpen, OnClose, OnError(aError) | Zgodne z cyklem życia W3C RTCDataChannel. |
| Stan kanału | State, HasId, Id | Identyfikator strumienia SCTP jest ostateczny dopiero po rozstrzygnięciu roli DTLS (parzystość z RFC 8832). |
| Kontrola przepływu | BufferedAmount, MaxMessageSize | MaxMessageSize śledzi własne a=max-message-size peera i odrzuca lokalnie zbyt duże wysłanie. |
| Introspekcja niezawodności | Reliability, ReliabilityParam, Ordered, MaxRetransmits, MaxPacketLifeTime | Odczytaj dokładnie to, co wynegocjował kanał. |
| Zamknięcie | Close | Zamknięcie oparte na RE-CONFIG; State przechodzi w closing, a następnie closed z OnClose. |
| Poziom połączenia peer | DataChannelCount, DataChannels[i] | Wylicz każdy otwarty kanał na połączeniu. |
Każdy pakiet RTP, RTCP i SCTP na połączeniu jest szyfrowany od handshake'u DTLS — nie ma trybu jawnego tekstu.
| Możliwość | Szczegóły |
|---|---|
| Wymiana kluczy | Handshake DTLS na wynegocjowanej parze kandydatów ICE (RFC 5764 DTLS-SRTP), wyprowadzający materiał kluczowy SRTP. |
| Rola DTLS | W sygnalizacji ręcznej rola pochodzi z a=setup (oferujący pasywny, odpowiadający aktywny); IsDTLSClient zgłasza ją po rozstrzygnięciu. |
| Profile ochrony SRTP | SRTP_AES128_CM_SHA1_80, SRTP_AES128_CM_SHA1_32, SRTP_AEAD_AES_128_GCM, SRTP_AEAD_AES_256_GCM, negocjowane podczas handshake'u DTLS. |
| Stan kryptograficzny per SSRC | Jeden kontekst kryptograficzny (licznik rollover, okno odtwarzania) na SSRC, zgodnie z wymogiem RFC 3711 sekcja 3.2.3, nawet gdy BUNDLE umieszcza każdą linię m na jednym transporcie DTLS-SRTP. |
| Zakres | Obejmuje media RTP/RTCP oraz asocjację SCTP przenoszącą kanały danych — całe połączenie, nie tylko jedną linię m. |
| Backend | Implementacja SRTP oparta na OpenSSL. |
Estymator oparty na opóźnieniach, w stylu Google Congestion Control, śledzi łącze i steruje docelowym bitrate kodera wideo.
| Możliwość | Składnik | Uwagi |
|---|---|---|
| Estymator oparty na opóźnieniach | TsgcBWE_Estimator | Grupuje pakiety w 5 ms serie wysyłkowe, uruchamia filtr linii trendu na opóźnieniu między grupami i klasyfikuje łącze jako normalne, przeciążone lub niedociążone. |
| Kontrola szybkości | Kontroler AIMD | Przeciążenie zmniejsza do 85% potwierdzonej szybkości, niedociążenie utrzymuje, stan normalny zwiększa (multiplikatywnie z dala od ostatniego znanego sufitu, addytywnie blisko niego). |
| Sufit strat | Śledzenie współczynnika strat | Powyżej 10% strat sufit spada; poniżej 2% odzyskuje 8% na sekundę aż do MaxBitrate. |
| Informacja zwrotna transport-wide | TWCC (RTCP) | BuildRTCP_TWCC / ParseRTCP_TWCC, informacja zwrotna o przeciążeniu na poziomie całego transportu, z REMB jako sufitem zapasowym dla peerów, które obsługują tylko to. |
| Włączenie | RTCOptions.Media.CongestionControl | Działa tylko wtedy, gdy zdalny opis negocjuje też odpowiednie rozszerzenie nagłówka / informację zwrotną. |
| Odzyskiwanie po stratach | RTCOptions.Media.RTX | Retransmisja strumienia wideo z RFC 4588 na RTCP NACK. |
| Korekcja błędów w przód | RTCOptions.Media.FEC | Ochrona RED / ULPFEC na wychodzącym strumieniu wideo. |
| Pacing | RTCOptions.Media.Pacing | Rozkłada w czasie wychodzące pakiety wideo według szacowanego bitrate, zamiast wysyłać je seriami. |
| Odzyskiwanie klatki kluczowej | RTCP PLI | RequestKeyFrame na odbierającej ścieżce prosi nadawcę o świeżą klatkę kluczową po stracie. |