Tout ce que sgcWebRTC ajoute à TsgcRTCPeerConnection, réparti par capacité. La signalisation et la connectivité viennent du composant de base dans sgcWebSockets Enterprise ; ce pack débloque le moteur média par-dessus — audio, vidéo, capture d'écran, canaux de données, chiffrement et estimation de bande passante. Chaque capacité fonctionne de la même façon en Delphi et C++ Builder, et chaque licence inclut le code source complet.
Base Enterprise & SDP
Opus / G.711
VP8 / H.264 / MJPEG
RFC 8831 / 8832
Capture & rendu
Média chiffré
Contrôle de congestion
La connectivité de base est déjà dans sgcWebSockets. sgcWebRTC débloque la surface SDP, canaux de données et média sur le même composant.
| Capacité | Livré avec | Notes |
|---|---|---|
Client STUN (TsgcSTUNClient) | sgcWebSockets Standard | Découverte de candidats server-reflexive, disponible en dessous d'Enterprise. |
Client et serveur TURN, client ICE (TsgcTURNClient, TsgcICEClient) | sgcWebSockets Enterprise | Candidats relayés et collecte / nomination complète des candidats ICE. |
Base TsgcRTCPeerConnection, signalisation historique par relais WebSocket | sgcWebSockets Enterprise | GatherCandidates, WriteData et les événements OnRTCWebSocket… / OnRTCCandidatePairNominated / OnRTCConnect pilotent la connectivité ICE et un transport DTLS via le serveur de protocole RTCPeerConnection intégré, sans SDP, canaux de données ni média. |
| Signalisation SDP manuelle offre/réponse | sgcWebRTC | CreateOffer, CreateAnswer, SetLocalDescription, SetRemoteDescription, AddIceCandidate, RestartIce — la machine à états JSEP (RFC 8829) qu'attend un navigateur. |
| Renégociation & résolution des conflits | sgcWebRTC | Ré-offres après AddTrack / RemoveTrack, OnNegotiationNeeded, rollback, et la règle de perfect-negotiation du W3C via Polite. |
| Trickle ICE | sgcWebRTC | TrickleICE et RTCOptions.TrickleICEAuto transmettent les candidats au fil de l'eau plutôt que d'attendre le délai complet de collecte. |
| État de connexion & de signalisation | sgcWebRTC | ConnectionState (sous-ensemble RTCPeerConnectionState du W3C) et SignalingState (sous-ensemble RTCSignalingState), plus OnConnectionStateChange et OnError. |
| Canaux de données SCTP, audio/vidéo RTP, chiffrement SRTP | sgcWebRTC | Voir les sections ci-dessous — les trois nécessitent ce pack au-dessus de la base Enterprise. |
Un seul appel à AddTrack attache une piste audio à la connexion ; le PCM entre, le RTP sort, et le même chemin fonctionne en sens inverse pour la piste distante.
| Capacité | Membre | Notes |
|---|---|---|
| Attacher une piste audio | AddTrack(rtctkAudio, aCodec) | Renvoie un TsgcRTCTrack ; RemoveTrack arrête son envoi. |
| Codec Opus | cctAudioOpus | 48 kHz / stéréo via un binding libopus chargé dynamiquement. |
| Codec G.711 | cctAudioPCMU / cctAudioPCMA | 8 kHz / mono μ-law et A-law, toujours disponible, aucune bibliothèque externe. |
| Envoyer de l'audio capturé | TsgcRTCTrack.SendPCM(aPCM, aSamplesPerChannel) | PCM entrelacé signé 16 bits, au taux d'échantillonnage et au nombre de canaux de l'encodeur. |
| Recevoir de l'audio décodé | OnAudio(aPCM, aSampleRate, aChannels, aSamplesPerChannel) | Se déclenche sur la piste distante à l'arrivée et au décodage du RTP. |
| Accès encodeur / décodeur | AudioEncoder / AudioDecoder | L'objet TsgcAudioEncoderBase / TsgcAudioDecoderBase sous-jacent, remplaçable par piste. |
| Cycle de vie de la piste | Enabled, Ended, OnEnded | Enabled := False coupe le son sans renégocier ; Ended reflète une piste abandonnée par le côté distant ou une nouvelle offre. |
| Capture microphone | Descendants de TsgcMediaCaptureSource | Capture native par plateforme (waveIn sous Windows, plus les backends Linux, Apple et Android) alimente directement SendPCM. |
La vidéo suit la même forme que l'audio — des trames en entrée, du RTP en sortie — avec le codec choisi par piste et, pour H.264, l'encodeur matériel propre à la plateforme en dessous.
| Capacité | Membre | Notes |
|---|---|---|
| Attacher une piste vidéo | AddTrack(rtctkVideo, aCodec) | Même appel que pour l'audio, avec un TsgcCodecType vidéo. |
| Codec VP8 | cctVideoVP8 | Binding libvpx, chargé dynamiquement, disponible sous Windows et Linux. |
| Codec H.264 | cctVideoH264 | Encodeur matériel natif par plateforme : Media Foundation (Windows), VideoToolbox (iOS/macOS), MediaCodec (Android). Flux Annex-B, payload RFC 6184, SPS/PPS transportés en bande sur chaque image clé. |
| Codec Motion JPEG | cctVideoJPEG | Basé sur GDI+, Windows et Delphi XE ou ultérieur. |
| Envoyer une trame brute | TsgcRTCTrack.SendVideoFrame(aFrame, aForceKeyFrame) | Encode et envoie un TsgcVideoFrame (famille I420/NV12/RGB/BGR). |
| Envoyer une trame pré-encodée | SendEncodedFrame(aData, aIsKeyFrame) | Contourne l'encodeur propre à la piste pour une trame encodée en externe. |
| Recevoir des trames décodées / brutes | OnVideoFrame / OnEncodedFrame | TsgcVideoFrame décodé, ou le flux binaire brut encodé avec son indicateur d'image clé. |
| Demander une image clé | RequestKeyFrame | Envoie un PLI RTCP à l'émetteur distant. |
| Accès encodeur / décodeur | VideoEncoder / VideoDecoder | L'objet TsgcVideoEncoderBase / TsgcVideoDecoderBase sous-jacent. |
| Capture caméra | Descendants de TsgcMediaCaptureSource | Backends de capture par plateforme (Windows, Linux, Apple, Android) alimentent directement SendVideoFrame. |
| Rendu | Descendants de TsgcMediaRenderer | Backends de rendu par plateforme (Windows, Linux, Apple, Android) pour la vidéo distante décodée. |
Ordonnés ou non, entièrement fiables ou bornés par un nombre de retransmissions ou une durée de vie, sur SCTP-over-DTLS.
| Capacité | Membre | Notes |
|---|---|---|
| Ouvrir un canal | CreateDataChannel(aLabel, aOrdered, aMaxRetransmits, aMaxPacketLifeTime, aProtocol) | Renvoie un TsgcRTCDataChannel ; force RTCOptions.DTLS à vrai. |
| Canal ouvert par le distant | OnDataChannel(aChannel) | Se déclenche quand le pair ouvre un canal sur cette connexion. |
| Envoyer texte / binaire | Send(aText) / SendBytes(aBytes) | Renvoie False si le canal n'est pas encore ouvert. |
| Recevoir | OnMessage(aText) / OnMessageBinary(aBytes) | Se déclenche sur le thread qui pilote SCTP. |
| Événements de cycle de vie | OnOpen, OnClose, OnError(aError) | Correspond au cycle de vie RTCDataChannel du W3C. |
| État du canal | State, HasId, Id | L'id de stream SCTP n'est final qu'une fois le rôle DTLS résolu (parité RFC 8832). |
| Contrôle de flux | BufferedAmount, MaxMessageSize | MaxMessageSize suit le a=max-message-size du pair et refuse localement un envoi trop volumineux. |
| Introspection de fiabilité | Reliability, ReliabilityParam, Ordered, MaxRetransmits, MaxPacketLifeTime | Relit exactement ce que le canal a négocié. |
| Fermeture | Close | Fermeture basée sur RE-CONFIG ; State passe à closing, puis closed avec OnClose. |
| Niveau connexion | DataChannelCount, DataChannels[i] | Énumère chaque canal ouvert sur la connexion. |
Chaque paquet RTP, RTCP et SCTP sur la connexion est chiffré dès le handshake DTLS — il n'y a pas de mode en clair.
| Capacité | Détail |
|---|---|
| Échange de clés | Handshake DTLS sur la paire de candidats ICE nommée (RFC 5764 DTLS-SRTP), dérivant le matériel de clé SRTP. |
| Rôle DTLS | En signalisation manuelle, le rôle vient de a=setup (offreur passif, répondeur actif) ; IsDTLSClient le rapporte une fois résolu. |
| Profils de protection SRTP | SRTP_AES128_CM_SHA1_80, SRTP_AES128_CM_SHA1_32, SRTP_AEAD_AES_128_GCM, SRTP_AEAD_AES_256_GCM, négociés pendant le handshake DTLS. |
| État cryptographique par SSRC | Un contexte cryptographique (compteur de rollover, fenêtre anti-rejeu) par SSRC, comme l'exige la RFC 3711 section 3.2.3, même quand BUNDLE place toutes les lignes m sur un seul transport DTLS-SRTP. |
| Portée | Couvre le média RTP/RTCP et l'association SCTP portant les canaux de données — toute la connexion, pas une seule ligne m. |
| Backend | Implémentation SRTP adossée à OpenSSL. |
Un estimateur basé sur le délai, dans l'esprit du Google Congestion Control, suit le lien et pilote le débit cible de l'encodeur vidéo.
| Capacité | Membre | Notes |
|---|---|---|
| Estimateur basé sur le délai | TsgcBWE_Estimator | Groupe les paquets en rafales d'envoi de 5 ms, applique un filtre de tendance sur le délai inter-groupe, et classe le lien comme normal, en surutilisation ou en sous-utilisation. |
| Contrôle de débit | Contrôleur AIMD | La surutilisation réduit à 85% du débit acquitté, la sous-utilisation maintient, le normal augmente (multiplicatif loin du dernier plafond connu, additif près de celui-ci). |
| Plafond de pertes | Suivi du taux de perte | Au-delà de 10% de pertes le plafond baisse ; en dessous de 2% il récupère 8% par seconde jusqu'à MaxBitrate. |
| Feedback transport-wide | TWCC (RTCP) | BuildRTCP_TWCC / ParseRTCP_TWCC feedback de contrôle de congestion transport-wide, avec REMB comme plafond de repli pour les pairs qui ne supportent que celui-ci. |
| L'activer | RTCOptions.Media.CongestionControl | Ne prend effet que si la description distante négocie aussi l'extension d'en-tête / le feedback correspondant. |
| Récupération de pertes | RTCOptions.Media.RTX | Retransmission RFC 4588 du flux vidéo sur NACK RTCP. |
| Correction d'erreur en avant | RTCOptions.Media.FEC | Protection RED / ULPFEC sur le flux vidéo sortant. |
| Lissage | RTCOptions.Media.Pacing | Lisse les paquets vidéo sortants au débit estimé plutôt que de les envoyer en rafale. |
| Récupération d'image clé | PLI RTCP | RequestKeyFrame sur la piste réceptrice demande à l'émetteur une nouvelle image clé après une perte. |