Tudo o que o sgcWebRTC adiciona ao TsgcRTCPeerConnection, agrupado por capacidade. A sinalização e a conectividade vêm do componente base no sgcWebSockets Enterprise; este pacote desbloqueia o mecanismo de mídia sobre ele — áudio, vídeo, captura de tela, canais de dados, criptografia e estimativa de largura de banda. Toda capacidade funciona da mesma forma em Delphi e C++ Builder, e toda licença inclui código-fonte completo.
Base Enterprise & SDP
Opus / G.711
VP8 / H.264 / MJPEG
RFC 8831 / 8832
Captura & renderização
Mídia criptografada
Controle de congestionamento
A conectividade base já está no sgcWebSockets. O sgcWebRTC desbloqueia a superfície de SDP, canais de dados e mídia no mesmo componente.
| Capacidade | Vem com | Notas |
|---|---|---|
Cliente STUN (TsgcSTUNClient) | sgcWebSockets Standard | Descoberta de candidatos server-reflexive, disponível abaixo do Enterprise. |
Cliente e servidor TURN, cliente ICE (TsgcTURNClient, TsgcICEClient) | sgcWebSockets Enterprise | Candidatos retransmitidos e coleta/nomeação completa de candidatos ICE. |
TsgcRTCPeerConnection base, sinalização legada por relay WebSocket | sgcWebSockets Enterprise | GatherCandidates, WriteData e os eventos OnRTCWebSocket… / OnRTCCandidatePairNominated / OnRTCConnect controlam a conectividade ICE e um transporte DTLS através do servidor de protocolo RTCPeerConnection embutido, sem SDP, canais de dados ou mídia. |
| Sinalização manual de oferta/resposta SDP | sgcWebRTC | CreateOffer, CreateAnswer, SetLocalDescription, SetRemoteDescription, AddIceCandidate, RestartIce — a máquina de estados JSEP (RFC 8829) que um navegador espera. |
| Renegociação & resolução de glare | sgcWebRTC | Novas ofertas após AddTrack / RemoveTrack, OnNegotiationNeeded, rollback, e a regra de perfect-negotiation do W3C via Polite. |
| ICE Trickle | sgcWebRTC | TrickleICE e RTCOptions.TrickleICEAuto transmitem os candidatos assim que são encontrados, em vez de esperar o timeout completo de coleta. |
| Estado de conexão & sinalização | sgcWebRTC | ConnectionState (subconjunto de RTCPeerConnectionState do W3C) e SignalingState (subconjunto de RTCSignalingState), além de OnConnectionStateChange e OnError. |
| Canais de dados SCTP, áudio/vídeo RTP, criptografia SRTP | sgcWebRTC | Veja as seções abaixo — os três exigem este pacote sobre a base Enterprise. |
Uma única chamada a AddTrack anexa uma faixa de áudio à peer connection; PCM entra, RTP sai, e o mesmo caminho roda no sentido inverso para a faixa remota.
| Capacidade | Membro | Notas |
|---|---|---|
| Anexar uma faixa de áudio | AddTrack(rtctkAudio, aCodec) | Retorna um TsgcRTCTrack; RemoveTrack interrompe o envio. |
| Codec Opus | cctAudioOpus | 48 kHz / estéreo via um binding para libopus carregado dinamicamente. |
| Codec G.711 | cctAudioPCMU / cctAudioPCMA | 8 kHz / mono μ-law e A-law, sempre disponível, sem biblioteca externa. |
| Enviar áudio capturado | TsgcRTCTrack.SendPCM(aPCM, aSamplesPerChannel) | PCM intercalado de 16 bits com sinal, na taxa de amostragem e quantidade de canais do codificador. |
| Receber áudio decodificado | OnAudio(aPCM, aSampleRate, aChannels, aSamplesPerChannel) | Disparado na faixa remota à medida que o RTP chega e é decodificado. |
| Acesso ao codificador / decodificador | AudioEncoder / AudioDecoder | O objeto subjacente TsgcAudioEncoderBase / TsgcAudioDecoderBase, substituível por faixa. |
| Ciclo de vida da faixa | Enabled, Ended, OnEnded | Enabled := False silencia sem renegociar; Ended reflete uma faixa descartada pelo lado remoto ou por uma nova oferta. |
| Captura de microfone | Descendentes de TsgcMediaCaptureSource | Captura nativa por plataforma (waveIn no Windows, além de backends Linux, Apple e Android) alimenta SendPCM diretamente. |
O vídeo funciona no mesmo formato do áudio — frames entram, RTP sai — com o codec escolhido por faixa e, no caso do H.264, o próprio codificador de hardware da plataforma por baixo.
| Capacidade | Membro | Notas |
|---|---|---|
| Anexar uma faixa de vídeo | AddTrack(rtctkVideo, aCodec) | Mesma chamada do áudio, com um TsgcCodecType de vídeo. |
| Codec VP8 | cctVideoVP8 | Binding para libvpx, carregado dinamicamente, disponível no Windows e Linux. |
| Codec H.264 | cctVideoH264 | Codificador de hardware nativo por plataforma: Media Foundation (Windows), VideoToolbox (iOS/macOS), MediaCodec (Android). Stream Annex-B, payloading conforme RFC 6184, SPS/PPS transportados in-band em cada keyframe. |
| Codec Motion JPEG | cctVideoJPEG | Baseado em GDI+, Windows e Delphi XE ou posterior. |
| Enviar um frame bruto | TsgcRTCTrack.SendVideoFrame(aFrame, aForceKeyFrame) | Codifica e envia um TsgcVideoFrame (família I420/NV12/RGB/BGR). |
| Enviar um frame pré-codificado | SendEncodedFrame(aData, aIsKeyFrame) | Ignora o codificador da própria faixa para um frame codificado externamente. |
| Receber frames decodificados / brutos | OnVideoFrame / OnEncodedFrame | TsgcVideoFrame decodificado, ou o bitstream codificado bruto com sua flag de keyframe. |
| Solicitar um keyframe | RequestKeyFrame | Envia um RTCP PLI ao emissor remoto. |
| Acesso ao codificador / decodificador | VideoEncoder / VideoDecoder | O objeto subjacente TsgcVideoEncoderBase / TsgcVideoDecoderBase. |
| Captura de câmera | Descendentes de TsgcMediaCaptureSource | Backends de captura por plataforma (Windows, Linux, Apple, Android) alimentam SendVideoFrame diretamente. |
| Renderização | Descendentes de TsgcMediaRenderer | Backends de renderização por plataforma (Windows, Linux, Apple, Android) para o vídeo remoto decodificado. |
Ordenados ou não ordenados, totalmente confiáveis ou limitados por uma contagem de retransmissão ou por um tempo de vida, sobre SCTP-over-DTLS.
| Capacidade | Membro | Notas |
|---|---|---|
| Abrir um canal | CreateDataChannel(aLabel, aOrdered, aMaxRetransmits, aMaxPacketLifeTime, aProtocol) | Retorna um TsgcRTCDataChannel; força RTCOptions.DTLS a ligado. |
| Canal aberto pelo remoto | OnDataChannel(aChannel) | Disparado quando o par abre um canal nesta conexão. |
| Enviar texto / binário | Send(aText) / SendBytes(aBytes) | Retorna False se o canal ainda não estiver aberto. |
| Receber | OnMessage(aText) / OnMessageBinary(aBytes) | Disparado na thread que conduz o SCTP. |
| Eventos de ciclo de vida | OnOpen, OnClose, OnError(aError) | Corresponde ao ciclo de vida do RTCDataChannel do W3C. |
| Estado do canal | State, HasId, Id | O stream id do SCTP só é definitivo depois que o papel DTLS é resolvido (paridade da RFC 8832). |
| Controle de fluxo | BufferedAmount, MaxMessageSize | MaxMessageSize acompanha o próprio a=max-message-size do par e recusa localmente um envio acima do tamanho. |
| Introspecção de confiabilidade | Reliability, ReliabilityParam, Ordered, MaxRetransmits, MaxPacketLifeTime | Lê de volta exatamente o que o canal negociou. |
| Fechar | Close | Fechamento baseado em RE-CONFIG; State passa para closing, depois closed com OnClose. |
| Nível da peer connection | DataChannelCount, DataChannels[i] | Enumera todos os canais abertos na conexão. |
Todo pacote RTP, RTCP e SCTP na conexão é criptografado a partir do handshake DTLS — não existe modo em texto plano.
| Capacidade | Detalhe |
|---|---|
| Troca de chaves | Handshake DTLS sobre o par de candidatos ICE nomeado (RFC 5764 DTLS-SRTP), derivando o material de chaveamento SRTP. |
| Papel DTLS | Na sinalização manual, o papel vem de a=setup (ofertante passivo, respondente ativo); IsDTLSClient o reporta assim que resolvido. |
| Perfis de proteção SRTP | SRTP_AES128_CM_SHA1_80, SRTP_AES128_CM_SHA1_32, SRTP_AEAD_AES_128_GCM, SRTP_AEAD_AES_256_GCM, negociados durante o handshake DTLS. |
| Estado criptográfico por SSRC | Um contexto criptográfico (contador de rollover, janela de replay) por SSRC, como exige a seção 3.2.3 da RFC 3711, mesmo quando o BUNDLE coloca todas as m-lines em um único transporte DTLS-SRTP. |
| Escopo | Cobre a mídia RTP/RTCP e a associação SCTP que carrega os canais de dados — a conexão inteira, não apenas uma m-line. |
| Backend | Implementação de SRTP baseada em OpenSSL. |
Um estimador baseado em atraso, no estilo do Google Congestion Control, acompanha o enlace e controla a taxa de bits alvo do codificador de vídeo.
| Capacidade | Membro | Notas |
|---|---|---|
| Estimador baseado em atraso | TsgcBWE_Estimator | Agrupa pacotes em rajadas de envio de 5 ms, executa um filtro de tendência sobre o atraso entre grupos, e classifica o enlace como normal, overuse ou underuse. |
| Controle de taxa | Controlador AIMD | Overuse reduz para 85% da taxa reconhecida, underuse mantém, normal aumenta (multiplicativo quando longe do último teto conhecido, aditivo perto dele). |
| Teto de perdas | Acompanhamento da taxa de perda | Acima de 10% de perda o teto cai; abaixo de 2% ele se recupera 8% por segundo até MaxBitrate. |
| Feedback em nível de transporte | TWCC (RTCP) | BuildRTCP_TWCC / ParseRTCP_TWCC geram feedback de controle de congestionamento em nível de transporte, com REMB como teto de reserva para pares que só suportam ele. |
| Como ativar | RTCOptions.Media.CongestionControl | Só tem efeito quando a descrição remota também negocia a extensão de cabeçalho / feedback correspondente. |
| Recuperação de perdas | RTCOptions.Media.RTX | Retransmissão do stream de vídeo conforme RFC 4588 mediante RTCP NACK. |
| Correção de erros adiante | RTCOptions.Media.FEC | Proteção RED / ULPFEC no stream de vídeo de saída. |
| Pacing | RTCOptions.Media.Pacing | Espaça os pacotes de vídeo de saída na taxa de bits estimada, em vez de enviá-los em rajada. |
| Recuperação de keyframe | RTCP PLI | RequestKeyFrame na faixa receptora solicita ao emissor um novo keyframe após perda. |