sgcWebRTC'nin TsgcRTCPeerConnection'a eklediği her şey, yeteneğe göre gruplanmış. Sinyalleşme ve bağlanabilirlik, sgcWebSockets Enterprise'daki temel bileşenden gelir; bu paket bunun üzerine medya motorunun kilidini açar — ses, görüntü, ekran yakalama, veri kanalları, şifreleme ve bant genişliği tahmini. Her yetenek Delphi ve C++ Builder'da aynı şekilde çalışır ve her lisans tam kaynak koduyla gelir.
Enterprise temeli ve SDP
Opus / G.711
VP8 / H.264 / MJPEG
RFC 8831 / 8832
Yakalama ve gösterim
Şifreli medya
Tıkanıklık kontrolü
Temel bağlanabilirlik zaten sgcWebSockets içindedir. sgcWebRTC, aynı bileşen üzerinde SDP, veri kanalı ve medya yüzeyinin kilidini açar.
| Yetenek | Şununla gelir | Notlar |
|---|---|---|
STUN istemcisi (TsgcSTUNClient) | sgcWebSockets Standard | Sunucu-yansımalı aday keşfi, Enterprise altında da mevcuttur. |
TURN istemcisi ve sunucusu, ICE istemcisi (TsgcTURNClient, TsgcICEClient) | sgcWebSockets Enterprise | Aktarılan adaylar ve tam ICE aday toplama / adaylandırma. |
Temel TsgcRTCPeerConnection, eski WebSocket üzerinden aktarımlı sinyalleşme | sgcWebSockets Enterprise | GatherCandidates, WriteData ve OnRTCWebSocket… / OnRTCCandidatePairNominated / OnRTCConnect olayları, yerleşik RTCPeerConnection protokol sunucusu üzerinden ICE bağlanabilirliğini ve bir DTLS taşımasını yönetir; SDP, veri kanalları veya medya yoktur. |
| Manuel SDP teklif/yanıt sinyalleşmesi | sgcWebRTC | CreateOffer, CreateAnswer, SetLocalDescription, SetRemoteDescription, AddIceCandidate, RestartIce — bir tarayıcının beklediği JSEP (RFC 8829) durum makinesi. |
| Yeniden müzakere ve glare çözümü | sgcWebRTC | AddTrack / RemoveTrack sonrası yeniden teklifler, OnNegotiationNeeded, geri alma ve Polite üzerinden W3C perfect-negotiation kuralı. |
| Trickle ICE | sgcWebRTC | TrickleICE ve RTCOptions.TrickleICEAuto, tüm toplama zaman aşımını beklemek yerine adayları bulundukça akışa verir. |
| Bağlantı ve sinyalleşme durumu | sgcWebRTC | ConnectionState (W3C RTCPeerConnectionState alt kümesi) ve SignalingState (RTCSignalingState alt kümesi), ayrıca OnConnectionStateChange ve OnError. |
| SCTP veri kanalları, RTP ses/görüntü, SRTP şifreleme | sgcWebRTC | Aşağıdaki bölümlere bakın — üçü de Enterprise temeli üzerinde bu paketi gerektirir. |
Tek bir AddTrack çağrısı, eş bağlantısına bir ses izi ekler; PCM içeri girer, RTP dışarı çıkar; aynı yol, uzak iz için tersine çalışır.
| Yetenek | Üye | Notlar |
|---|---|---|
| Bir ses izi ekle | AddTrack(rtctkAudio, aCodec) | Bir TsgcRTCTrack döndürür; RemoveTrack gönderimi durdurur. |
| Opus codec'i | cctAudioOpus | Dinamik olarak yüklenen bir libopus bağlaması üzerinden 48 kHz / stereo. |
| G.711 codec'i | cctAudioPCMU / cctAudioPCMA | 8 kHz / mono μ-law ve A-law, her zaman kullanılabilir, harici kütüphane gerekmez. |
| Yakalanan sesi gönder | TsgcRTCTrack.SendPCM(aPCM, aSamplesPerChannel) | Kodlayıcının örnekleme hızında ve kanal sayısında 16 bit işaretli iç içe geçmiş (interleaved) PCM. |
| Çözülen sesi al | OnAudio(aPCM, aSampleRate, aChannels, aSamplesPerChannel) | RTP geldikçe ve çözüldükçe uzak izde tetiklenir. |
| Kodlayıcı / kod çözücü erişimi | AudioEncoder / AudioDecoder | Altta yatan TsgcAudioEncoderBase / TsgcAudioDecoderBase nesnesi, iz başına değiştirilebilir. |
| İz yaşam döngüsü | Enabled, Ended, OnEnded | Enabled := False, yeniden müzakere etmeden sesi kapatır; Ended, uzak taraf ya da bir yeniden teklif tarafından düşürülen bir izi yansıtır. |
| Mikrofon yakalama | TsgcMediaCaptureSource alt sınıfları | Platform başına yerel yakalama (Windows'ta waveIn, ayrıca Linux, Apple ve Android arka uçları) doğrudan SendPCM'i besler. |
Görüntü, ses ile aynı şekilde çalışır — kareler içeri girer, RTP dışarı çıkar — codec iz başına seçilir ve H.264 için altta platformun kendi donanım kodlayıcısı bulunur.
| Yetenek | Üye | Notlar |
|---|---|---|
| Bir görüntü izi ekle | AddTrack(rtctkVideo, aCodec) | Sesle aynı çağrı, bir görüntü TsgcCodecType'ıyla. |
| VP8 codec'i | cctVideoVP8 | libvpx bağlaması, dinamik olarak yüklenir, Windows ve Linux'ta kullanılabilir. |
| H.264 codec'i | cctVideoH264 | Platform başına yerel donanım kodlayıcısı: Media Foundation (Windows), VideoToolbox (iOS/macOS), MediaCodec (Android). Annex-B akışı, RFC 6184 yükleme, her anahtar karede bant içi taşınan SPS/PPS. |
| Motion JPEG codec'i | cctVideoJPEG | GDI+ tabanlı, Windows ve Delphi XE veya sonrası. |
| Ham bir kare gönder | TsgcRTCTrack.SendVideoFrame(aFrame, aForceKeyFrame) | Bir TsgcVideoFrame'i kodlar ve gönderir (I420/NV12/RGB/BGR ailesi). |
| Önceden kodlanmış bir kare gönder | SendEncodedFrame(aData, aIsKeyFrame) | Harici olarak kodlanmış bir kare için izin kendi kodlayıcısını atlar. |
| Çözülen / ham kareleri al | OnVideoFrame / OnEncodedFrame | Çözülen TsgcVideoFrame, ya da anahtar kare bayrağıyla ham kodlanmış bit akışı. |
| Bir anahtar kare iste | RequestKeyFrame | Uzak göndericiye bir RTCP PLI gönderir. |
| Kodlayıcı / kod çözücü erişimi | VideoEncoder / VideoDecoder | Altta yatan TsgcVideoEncoderBase / TsgcVideoDecoderBase nesnesi. |
| Kamera yakalama | TsgcMediaCaptureSource alt sınıfları | Platform başına yakalama arka uçları (Windows, Linux, Apple, Android) doğrudan SendVideoFrame'i besler. |
| Görüntüleme | TsgcMediaRenderer alt sınıfları | Çözülen uzak görüntü için platform başına gösterim arka uçları (Windows, Linux, Apple, Android). |
SCTP-over-DTLS üzerinden sıralı veya sırasız, tamamen güvenilir veya bir yeniden iletim sayısı ya da ömürle sınırlı.
| Yetenek | Üye | Notlar |
|---|---|---|
| Bir kanal aç | CreateDataChannel(aLabel, aOrdered, aMaxRetransmits, aMaxPacketLifeTime, aProtocol) | Bir TsgcRTCDataChannel döndürür; RTCOptions.DTLS'yi zorla açar. |
| Uzaktan açılan kanal | OnDataChannel(aChannel) | Eş bu bağlantı üzerinde bir kanal açtığında tetiklenir. |
| Metin / ikili gönder | Send(aText) / SendBytes(aBytes) | Kanal henüz açık değilse False döndürür. |
| Al | OnMessage(aText) / OnMessageBinary(aBytes) | SCTP'yi yöneten iş parçacığında tetiklenir. |
| Yaşam döngüsü olayları | OnOpen, OnClose, OnError(aError) | W3C RTCDataChannel yaşam döngüsüyle eşleşir. |
| Kanal durumu | State, HasId, Id | SCTP akış kimliği yalnızca DTLS rolü çözüldüğünde kesinleşir (RFC 8832 eşliği). |
| Akış kontrolü | BufferedAmount, MaxMessageSize | MaxMessageSize, eşin kendi a=max-message-size değerini izler ve aşırı boyutlu bir gönderimi yerel olarak reddeder. |
| Güvenilirlik iç gözlemi | Reliability, ReliabilityParam, Ordered, MaxRetransmits, MaxPacketLifeTime | Kanalın tam olarak neyi müzakere ettiğini geri okuyun. |
| Kapat | Close | RE-CONFIG tabanlı kapatma; State önce closing, ardından OnClose ile closed durumuna geçer. |
| Eş bağlantısı düzeyi | DataChannelCount, DataChannels[i] | Bağlantı üzerindeki her açık kanalı numaralandırın. |
Bağlantı üzerindeki her RTP, RTCP ve SCTP paketi, DTLS el sıkışmasından itibaren şifrelenir — düz metin modu yoktur.
| Yetenek | Ayrıntı |
|---|---|
| Anahtar değişimi | Aday gösterilen ICE aday çifti üzerinden DTLS el sıkışması (RFC 5764 DTLS-SRTP), SRTP anahtar malzemesini türetir. |
| DTLS rolü | Manuel sinyalleşmede rol a=setup'tan gelir (teklif eden pasif, yanıtlayan aktif); IsDTLSClient çözüldüğünde bunu bildirir. |
| SRTP koruma profilleri | SRTP_AES128_CM_SHA1_80, SRTP_AES128_CM_SHA1_32, SRTP_AEAD_AES_128_GCM, SRTP_AEAD_AES_256_GCM; DTLS el sıkışması sırasında müzakere edilir. |
| SSRC başına kripto durumu | RFC 3711 bölüm 3.2.3'ün gerektirdiği gibi, BUNDLE her m-satırını tek bir DTLS-SRTP taşımasına koysa bile SSRC başına bir kriptografik bağlam (rollover sayacı, tekrar penceresi). |
| Kapsam | RTP/RTCP medyasını ve veri kanallarını taşıyan SCTP ilişkilendirmesini kapsar — yalnızca bir m-satırı değil, bağlantının tamamı. |
| Arka uç | OpenSSL destekli SRTP uygulaması. |
Google Congestion Control tarzında gecikme tabanlı bir tahminleyici bağlantıyı izler ve görüntü kodlayıcısının hedef bit hızını yönlendirir.
| Yetenek | Üye | Notlar |
|---|---|---|
| Gecikme tabanlı tahminleyici | TsgcBWE_Estimator | Paketleri 5 ms'lik gönderim patlamaları halinde gruplar, grup arası gecikme üzerinde bir eğilim çizgisi filtresi çalıştırır ve bağlantıyı normal, aşırı kullanım veya az kullanım olarak sınıflandırır. |
| Hız kontrolü | AIMD denetleyicisi | Aşırı kullanım, onaylanan hızın %85'ine düşürür; az kullanım sabit tutar; normal artırır (son bilinen tavandan uzaktayken çarpımsal, yakınken toplamsal). |
| Kayıp tavanı | Kayıp oranı izleme | %10 üzeri kayıpta tavan düşer; %2 altında saniyede %8 MaxBitrate'e kadar toparlanır. |
| Taşıma genelinde geri bildirim | TWCC (RTCP) | BuildRTCP_TWCC / ParseRTCP_TWCC taşıma genelinde tıkanıklık kontrolü geri bildirimi; yalnızca REMB'i destekleyen eşler için yedek tavan olarak REMB ile. |
| Etkinleştirin | RTCOptions.Media.CongestionControl | Yalnızca uzak açıklama da eşleşen başlık uzantısını / geri bildirimi müzakere ettiğinde etkili olur. |
| Kayıp kurtarma | RTCOptions.Media.RTX | RTCP NACK üzerine görüntü akışının RFC 4588 yeniden iletimi. |
| İleri hata düzeltmesi | RTCOptions.Media.FEC | Giden görüntü akışında RED / ULPFEC koruması. |
| Hız ayarı (pacing) | RTCOptions.Media.Pacing | Giden görüntü paketlerini patlama yapmak yerine tahmini bit hızında ayarlar. |
| Anahtar kare kurtarma | RTCP PLI | Alan izdeki RequestKeyFrame, kayıptan sonra göndericiden yeni bir anahtar kare ister. |