Todo lo que sgcWebRTC añade a TsgcRTCPeerConnection, agrupado por capacidad. La señalización y la conectividad vienen del componente base en sgcWebSockets Enterprise; este paquete desbloquea el motor de medios sobre él — audio, vídeo, captura de pantalla, canales de datos, cifrado y estimación de ancho de banda. Cada capacidad funciona igual en Delphi y C++ Builder, y cada licencia incluye código fuente completo.
Base Enterprise y SDP
Opus / G.711
VP8 / H.264 / MJPEG
RFC 8831 / 8832
Captura y renderizado
Medios cifrados
Control de congestión
La conectividad base ya está en sgcWebSockets. sgcWebRTC desbloquea la superficie de SDP, canales de datos y medios en el mismo componente.
| Capacidad | Incluido en | Notas |
|---|---|---|
Cliente STUN (TsgcSTUNClient) | sgcWebSockets Standard | Descubrimiento de candidatos server-reflexive, disponible por debajo de Enterprise. |
Cliente y servidor TURN, cliente ICE (TsgcTURNClient, TsgcICEClient) | sgcWebSockets Enterprise | Candidatos retransmitidos y recopilación / nominación completa de candidatos ICE. |
TsgcRTCPeerConnection base, señalización heredada por relé WebSocket | sgcWebSockets Enterprise | GatherCandidates, WriteData y los eventos OnRTCWebSocket… / OnRTCCandidatePairNominated / OnRTCConnect gobiernan la conectividad ICE y un transporte DTLS a través del servidor de protocolo RTCPeerConnection integrado, sin SDP, canales de datos ni medios. |
| Señalización manual de oferta/respuesta SDP | sgcWebRTC | CreateOffer, CreateAnswer, SetLocalDescription, SetRemoteDescription, AddIceCandidate, RestartIce — la máquina de estados JSEP (RFC 8829) que espera un navegador. |
| Renegociación y resolución de glare | sgcWebRTC | Nuevas ofertas tras AddTrack / RemoveTrack, OnNegotiationNeeded, rollback, y la regla de perfect-negotiation de W3C mediante Polite. |
| Trickle ICE | sgcWebRTC | TrickleICE y RTCOptions.TrickleICEAuto transmiten los candidatos a medida que se encuentran, en lugar de esperar al tiempo de espera completo de la recopilación. |
| Estado de conexión y de señalización | sgcWebRTC | ConnectionState (subconjunto de RTCPeerConnectionState de W3C) y SignalingState (subconjunto de RTCSignalingState), además de OnConnectionStateChange y OnError. |
| Canales de datos SCTP, audio/vídeo RTP, cifrado SRTP | sgcWebRTC | Ver las secciones siguientes — las tres requieren este paquete sobre la base Enterprise. |
Una sola llamada a AddTrack adjunta una pista de audio a la conexión de pares; entra PCM, sale RTP, y la misma ruta funciona a la inversa para la pista remota.
| Capacidad | Miembro | Notas |
|---|---|---|
| Adjuntar una pista de audio | AddTrack(rtctkAudio, aCodec) | Devuelve un TsgcRTCTrack; RemoveTrack detiene su envío. |
| Códec Opus | cctAudioOpus | 48 kHz / estéreo mediante un binding a libopus cargado dinámicamente. |
| Códec G.711 | cctAudioPCMU / cctAudioPCMA | 8 kHz / mono μ-law y A-law, siempre disponible, sin biblioteca externa. |
| Enviar audio capturado | TsgcRTCTrack.SendPCM(aPCM, aSamplesPerChannel) | PCM entrelazado de 16 bits con signo, a la frecuencia de muestreo y número de canales del codificador. |
| Recibir audio decodificado | OnAudio(aPCM, aSampleRate, aChannels, aSamplesPerChannel) | Se dispara en la pista remota a medida que llega y se decodifica el RTP. |
| Acceso al codificador / decodificador | AudioEncoder / AudioDecoder | El objeto subyacente TsgcAudioEncoderBase / TsgcAudioDecoderBase, reemplazable por pista. |
| Ciclo de vida de la pista | Enabled, Ended, OnEnded | Enabled := False silencia sin renegociar; Ended refleja una pista descartada por el lado remoto o por una nueva oferta. |
| Captura de micrófono | Descendientes de TsgcMediaCaptureSource | La captura nativa por plataforma (waveIn en Windows, además de los backends de Linux, Apple y Android) alimenta directamente SendPCM. |
El vídeo funciona con la misma forma que el audio — entran fotogramas, sale RTP — con el códec elegido por pista y, para H.264, el propio codificador por hardware de la plataforma debajo.
| Capacidad | Miembro | Notas |
|---|---|---|
| Adjuntar una pista de vídeo | AddTrack(rtctkVideo, aCodec) | La misma llamada que para audio, con un TsgcCodecType de vídeo. |
| Códec VP8 | cctVideoVP8 | Binding a libvpx, cargado dinámicamente, disponible en Windows y Linux. |
| Códec H.264 | cctVideoH264 | Codificador nativo por hardware según la plataforma: Media Foundation (Windows), VideoToolbox (iOS/macOS), MediaCodec (Android). Stream Annex-B, empaquetado según RFC 6184, SPS/PPS transportados en banda en cada keyframe. |
| Códec Motion JPEG | cctVideoJPEG | Basado en GDI+, Windows y Delphi XE o posterior. |
| Enviar un fotograma sin codificar | TsgcRTCTrack.SendVideoFrame(aFrame, aForceKeyFrame) | Codifica y envía un TsgcVideoFrame (familia I420/NV12/RGB/BGR). |
| Enviar un fotograma precodificado | SendEncodedFrame(aData, aIsKeyFrame) | Evita el codificador propio de la pista para un fotograma codificado externamente. |
| Recibir fotogramas decodificados / sin codificar | OnVideoFrame / OnEncodedFrame | Un TsgcVideoFrame decodificado, o el flujo de bits codificado en bruto con su indicador de keyframe. |
| Solicitar un keyframe | RequestKeyFrame | Envía un RTCP PLI al emisor remoto. |
| Acceso al codificador / decodificador | VideoEncoder / VideoDecoder | El objeto subyacente TsgcVideoEncoderBase / TsgcVideoDecoderBase. |
| Captura de cámara | Descendientes de TsgcMediaCaptureSource | Los backends de captura por plataforma (Windows, Linux, Apple, Android) alimentan directamente SendVideoFrame. |
| Renderizado | Descendientes de TsgcMediaRenderer | Los backends de renderizado por plataforma (Windows, Linux, Apple, Android) para el vídeo remoto decodificado. |
Ordenados o desordenados, totalmente fiables o acotados por un número de retransmisiones o una vida útil, sobre SCTP-sobre-DTLS.
| Capacidad | Miembro | Notas |
|---|---|---|
| Abrir un canal | CreateDataChannel(aLabel, aOrdered, aMaxRetransmits, aMaxPacketLifeTime, aProtocol) | Devuelve un TsgcRTCDataChannel; fuerza la activación de RTCOptions.DTLS. |
| Canal abierto por el remoto | OnDataChannel(aChannel) | Se dispara cuando el par abre un canal en esta conexión. |
| Enviar texto / binario | Send(aText) / SendBytes(aBytes) | Devuelve False si el canal todavía no está abierto. |
| Recibir | OnMessage(aText) / OnMessageBinary(aBytes) | Se dispara en el hilo que gobierna SCTP. |
| Eventos del ciclo de vida | OnOpen, OnClose, OnError(aError) | Coincide con el ciclo de vida de RTCDataChannel de W3C. |
| Estado del canal | State, HasId, Id | El id de stream SCTP solo es definitivo una vez que se resuelve el rol DTLS (paridad de RFC 8832). |
| Control de flujo | BufferedAmount, MaxMessageSize | MaxMessageSize sigue el propio a=max-message-size del par y rechaza localmente un envío de tamaño excesivo. |
| Introspección de fiabilidad | Reliability, ReliabilityParam, Ordered, MaxRetransmits, MaxPacketLifeTime | Permite leer exactamente lo que el canal negoció. |
| Cerrar | Close | Cierre basado en RE-CONFIG; State pasa a closing y luego a closed con OnClose. |
| A nivel de la conexión de pares | DataChannelCount, DataChannels[i] | Enumera todos los canales abiertos en la conexión. |
Todos los paquetes RTP, RTCP y SCTP de la conexión van cifrados a partir del handshake DTLS — no existe un modo en texto plano.
| Capacidad | Detalle |
|---|---|
| Intercambio de claves | Handshake DTLS sobre el par de candidatos ICE nominado (RFC 5764 DTLS-SRTP), que deriva el material de claves SRTP. |
| Rol DTLS | En la señalización manual el rol proviene de a=setup (el que ofrece es pasivo, el que responde es activo); IsDTLSClient lo indica una vez resuelto. |
| Perfiles de protección SRTP | SRTP_AES128_CM_SHA1_80, SRTP_AES128_CM_SHA1_32, SRTP_AEAD_AES_128_GCM, SRTP_AEAD_AES_256_GCM, negociados durante el handshake DTLS. |
| Estado criptográfico por SSRC | Un contexto criptográfico (contador de rollover, ventana de repetición) por SSRC, como exige la sección 3.2.3 de RFC 3711, incluso cuando BUNDLE coloca todas las líneas m en un único transporte DTLS-SRTP. |
| Alcance | Cubre los medios RTP/RTCP y la asociación SCTP que transporta los canales de datos — toda la conexión, no solo una línea m. |
| Backend | Implementación de SRTP respaldada por OpenSSL. |
Un estimador basado en retardo al estilo de Google Congestion Control monitoriza el enlace y ajusta la tasa de bits objetivo del codificador de vídeo.
| Capacidad | Miembro | Notas |
|---|---|---|
| Estimador basado en retardo | TsgcBWE_Estimator | Agrupa los paquetes en ráfagas de envío de 5 ms, ejecuta un filtro de tendencia sobre el retardo entre grupos, y clasifica el enlace como normal, sobreuso o infrautilización. |
| Control de tasa | Controlador AIMD | El sobreuso reduce al 85% de la tasa confirmada, la infrautilización mantiene, y lo normal incrementa (multiplicativo lejos del último techo conocido, aditivo cerca de él). |
| Techo por pérdidas | Seguimiento de la tasa de pérdidas | Por encima del 10% de pérdidas el techo baja; por debajo del 2% se recupera un 8% por segundo hasta MaxBitrate. |
| Retroalimentación a nivel de transporte | TWCC (RTCP) | BuildRTCP_TWCC / ParseRTCP_TWCC para la retroalimentación de control de congestión a nivel de transporte, con REMB como techo alternativo para los pares que solo lo admiten a él. |
| Activarlo | RTCOptions.Media.CongestionControl | Solo surte efecto cuando la descripción remota negocia también la extensión de cabecera / retroalimentación correspondiente. |
| Recuperación de pérdidas | RTCOptions.Media.RTX | Retransmisión según RFC 4588 del stream de vídeo ante un RTCP NACK. |
| Corrección de errores hacia adelante | RTCOptions.Media.FEC | Protección RED / ULPFEC en el stream de vídeo saliente. |
| Pacing | RTCOptions.Media.Pacing | Ritma los paquetes de vídeo salientes a la tasa de bits estimada en lugar de enviarlos en ráfaga. |
| Recuperación de keyframe | RTCP PLI | RequestKeyFrame en la pista receptora solicita al emisor un keyframe nuevo tras una pérdida. |