Tutto ciò che sgcWebRTC aggiunge a TsgcRTCPeerConnection, raggruppato per capacità. La segnalazione e la connettività provengono dal componente base in sgcWebSockets Enterprise, questo pacchetto sblocca sopra di esso il motore media: audio, video, cattura schermo, canali dati, crittografia e stima della banda. Ogni capacità funziona allo stesso modo in Delphi e C++ Builder, e ogni licenza include il codice sorgente completo.
Base Enterprise e SDP
Opus / G.711
VP8 / H.264 / MJPEG
RFC 8831 / 8832
Cattura e rendering
Media crittografati
Controllo della congestione
La connettività di base è già in sgcWebSockets. sgcWebRTC sblocca la superficie SDP, dei canali dati e dei media sullo stesso componente.
| Capacità | Incluso in | Note |
|---|---|---|
Client STUN (TsgcSTUNClient) | sgcWebSockets Standard | Scoperta di candidati server-reflexive, disponibile anche sotto Enterprise. |
Client e server TURN, client ICE (TsgcTURNClient, TsgcICEClient) | sgcWebSockets Enterprise | Candidati relayed e raccolta/nomina completa dei candidati ICE. |
TsgcRTCPeerConnection base, segnalazione legacy con relay WebSocket | sgcWebSockets Enterprise | GatherCandidates, WriteData e gli eventi OnRTCWebSocket… / OnRTCCandidatePairNominated / OnRTCConnect guidano la connettività ICE e un trasporto DTLS attraverso il server di protocollo RTCPeerConnection integrato, senza SDP, canali dati o media. |
| Segnalazione SDP offer/answer manuale | sgcWebRTC | CreateOffer, CreateAnswer, SetLocalDescription, SetRemoteDescription, AddIceCandidate, RestartIce: la macchina a stati JSEP (RFC 8829) che un browser si aspetta. |
| Rinegoziazione e risoluzione del glare | sgcWebRTC | Nuove offerte dopo AddTrack / RemoveTrack, OnNegotiationNeeded, rollback, e la regola W3C di perfect-negotiation tramite Polite. |
| Trickle ICE | sgcWebRTC | TrickleICE e RTCOptions.TrickleICEAuto trasmettono i candidati man mano che vengono trovati invece di attendere il timeout completo della raccolta. |
| Stato di connessione e segnalazione | sgcWebRTC | ConnectionState (sottoinsieme di RTCPeerConnectionState del W3C) e SignalingState (sottoinsieme di RTCSignalingState), più OnConnectionStateChange e OnError. |
| Canali dati SCTP, audio/video RTP, crittografia SRTP | sgcWebRTC | Vedi le sezioni seguenti: tutte e tre richiedono questo pacchetto sopra la base Enterprise. |
Una sola chiamata ad AddTrack collega una traccia audio alla connessione peer; il PCM entra, l'RTP esce, e lo stesso percorso funziona al contrario per la traccia remota.
| Capacità | Membro | Note |
|---|---|---|
| Collega una traccia audio | AddTrack(rtctkAudio, aCodec) | Restituisce un TsgcRTCTrack; RemoveTrack ne interrompe l'invio. |
| Codec Opus | cctAudioOpus | 48 kHz / stereo tramite un binding libopus caricato dinamicamente. |
| Codec G.711 | cctAudioPCMU / cctAudioPCMA | 8 kHz / mono μ-law e A-law, sempre disponibile, nessuna libreria esterna. |
| Invia l'audio catturato | TsgcRTCTrack.SendPCM(aPCM, aSamplesPerChannel) | PCM interleaved con segno a 16 bit, alla frequenza di campionamento e al numero di canali dell'encoder. |
| Ricevi l'audio decodificato | OnAudio(aPCM, aSampleRate, aChannels, aSamplesPerChannel) | Si attiva sulla traccia remota quando l'RTP arriva e viene decodificato. |
| Accesso a encoder / decoder | AudioEncoder / AudioDecoder | L'oggetto TsgcAudioEncoderBase / TsgcAudioDecoderBase sottostante, sostituibile per ogni traccia. |
| Ciclo di vita della traccia | Enabled, Ended, OnEnded | Enabled := False disattiva l'audio senza rinegoziare; Ended riflette una traccia interrotta dal lato remoto o da una nuova offerta. |
| Cattura del microfono | discendenti di TsgcMediaCaptureSource | Cattura nativa per piattaforma (waveIn su Windows, più i backend Linux, Apple e Android) alimenta direttamente SendPCM. |
Il video funziona con la stessa forma dell'audio: i frame entrano, l'RTP esce, con il codec scelto per ogni traccia e, per H.264, l'encoder hardware nativo della piattaforma sotto.
| Capacità | Membro | Note |
|---|---|---|
| Collega una traccia video | AddTrack(rtctkVideo, aCodec) | Stessa chiamata dell'audio, con un TsgcCodecType video. |
| Codec VP8 | cctVideoVP8 | Binding libvpx, caricato dinamicamente, disponibile su Windows e Linux. |
| Codec H.264 | cctVideoH264 | Encoder hardware nativo per piattaforma: Media Foundation (Windows), VideoToolbox (iOS/macOS), MediaCodec (Android). Stream Annex-B, payload RFC 6184, SPS/PPS trasportati in banda su ogni keyframe. |
| Codec Motion JPEG | cctVideoJPEG | Basato su GDI+, Windows e Delphi XE o successivo. |
| Invia un frame grezzo | TsgcRTCTrack.SendVideoFrame(aFrame, aForceKeyFrame) | Codifica e invia un TsgcVideoFrame (famiglia I420/NV12/RGB/BGR). |
| Invia un frame già codificato | SendEncodedFrame(aData, aIsKeyFrame) | Salta l'encoder della traccia per un frame codificato esternamente. |
| Ricevi frame decodificati / grezzi | OnVideoFrame / OnEncodedFrame | TsgcVideoFrame decodificato, oppure il bitstream codificato grezzo con il suo flag di keyframe. |
| Richiedi un keyframe | RequestKeyFrame | Invia un RTCP PLI al mittente remoto. |
| Accesso a encoder / decoder | VideoEncoder / VideoDecoder | L'oggetto TsgcVideoEncoderBase / TsgcVideoDecoderBase sottostante. |
| Cattura della fotocamera | discendenti di TsgcMediaCaptureSource | I backend di cattura per piattaforma (Windows, Linux, Apple, Android) alimentano direttamente SendVideoFrame. |
| Rendering | discendenti di TsgcMediaRenderer | Backend di rendering per piattaforma (Windows, Linux, Apple, Android) per il video remoto decodificato. |
Ordinati o non ordinati, completamente affidabili oppure limitati da un numero di ritrasmissioni o da una durata, su SCTP-over-DTLS.
| Capacità | Membro | Note |
|---|---|---|
| Apri un canale | CreateDataChannel(aLabel, aOrdered, aMaxRetransmits, aMaxPacketLifeTime, aProtocol) | Restituisce un TsgcRTCDataChannel; forza l'attivazione di RTCOptions.DTLS. |
| Canale aperto dal remoto | OnDataChannel(aChannel) | Si attiva quando il peer apre un canale su questa connessione. |
| Invia testo / binario | Send(aText) / SendBytes(aBytes) | Restituisce False se il canale non è ancora aperto. |
| Ricevi | OnMessage(aText) / OnMessageBinary(aBytes) | Si attiva sul thread che gestisce SCTP. |
| Eventi del ciclo di vita | OnOpen, OnClose, OnError(aError) | Corrisponde al ciclo di vita RTCDataChannel del W3C. |
| Stato del canale | State, HasId, Id | Lo stream id SCTP diventa definitivo solo quando il ruolo DTLS si risolve (parità RFC 8832). |
| Controllo di flusso | BufferedAmount, MaxMessageSize | MaxMessageSize tiene traccia dell'a=max-message-size del peer e rifiuta localmente un invio troppo grande. |
| Introspezione dell'affidabilità | Reliability, ReliabilityParam, Ordered, MaxRetransmits, MaxPacketLifeTime | Rilegge esattamente ciò che il canale ha negoziato. |
| Chiusura | Close | Chiusura basata su RE-CONFIG; State passa a closing, poi a closed con OnClose. |
| Livello della connessione peer | DataChannelCount, DataChannels[i] | Enumera ogni canale aperto sulla connessione. |
Ogni pacchetto RTP, RTCP e SCTP sulla connessione è crittografato a partire dall'handshake DTLS, non esiste una modalità in chiaro.
| Capacità | Dettaglio |
|---|---|
| Scambio di chiavi | Handshake DTLS sulla coppia di candidati ICE nominata (RFC 5764 DTLS-SRTP), che deriva il materiale di chiavi SRTP. |
| Ruolo DTLS | Nella segnalazione manuale il ruolo deriva da a=setup (offerente passivo, risponditore attivo); IsDTLSClient lo riporta una volta risolto. |
| Profili di protezione SRTP | SRTP_AES128_CM_SHA1_80, SRTP_AES128_CM_SHA1_32, SRTP_AEAD_AES_128_GCM, SRTP_AEAD_AES_256_GCM, negoziati durante l'handshake DTLS. |
| Stato crittografico per SSRC | Un contesto crittografico (contatore di rollover, finestra di replay) per SSRC, come richiesto dalla sezione 3.2.3 di RFC 3711, anche quando BUNDLE mette ogni m-line su un solo trasporto DTLS-SRTP. |
| Ambito | Copre i media RTP/RTCP e l'associazione SCTP che trasporta i canali dati: l'intera connessione, non solo una m-line. |
| Backend | Implementazione SRTP basata su OpenSSL. |
Uno stimatore basato sul ritardo, in stile Google Congestion Control, monitora il collegamento e guida il bitrate target dell'encoder video.
| Capacità | Membro | Note |
|---|---|---|
| Stimatore basato sul ritardo | TsgcBWE_Estimator | Raggruppa i pacchetti in burst di invio da 5 ms, esegue un filtro trendline sul ritardo tra gruppi, e classifica il collegamento come normale, overuse o underuse. |
| Controllo della velocità | Controller AIMD | L'overuse riduce all'85% della velocità confermata, l'underuse mantiene, il normale aumenta (moltiplicativo quando lontano dall'ultimo tetto noto, additivo quando vicino). |
| Tetto di perdita | Tracciamento del tasso di perdita | Sopra il 10% di perdita il tetto scende; sotto il 2% recupera dell'8% al secondo fino a MaxBitrate. |
| Feedback transport-wide | TWCC (RTCP) | BuildRTCP_TWCC / ParseRTCP_TWCC forniscono feedback di controllo della congestione transport-wide, con REMB come tetto di fallback per i peer che supportano solo quello. |
| Attivalo | RTCOptions.Media.CongestionControl | Ha effetto solo quando anche la descrizione remota negozia l'estensione di intestazione / il feedback corrispondente. |
| Recupero delle perdite | RTCOptions.Media.RTX | Ritrasmissione RFC 4588 dello stream video su RTCP NACK. |
| Correzione d'errore in avanti | RTCOptions.Media.FEC | Protezione RED / ULPFEC sullo stream video in uscita. |
| Pacing | RTCOptions.Media.Pacing | Scandisce i pacchetti video in uscita al bitrate stimato invece di inviarli in burst. |
| Recupero del keyframe | RTCP PLI | RequestKeyFrame sulla traccia ricevente chiede al mittente un nuovo keyframe dopo una perdita. |