TsgcRTCPeerConnection — the one component behind sgcWebRTC: ICE/TURN connectivity, manual SDP offer/answer signaling (RFC 8829 JSEP), DTLS-SRTP encrypted transport, SCTP data channels (RFC 8831/8832) and RTP audio/video tracks, in Delphi and C++ Builder.
Set RTCOptions, hook the SDP and ICE events, then either drive the offer/answer exchange yourself or open a data channel and let CreateOffer do it. Built on the same ICE/DTLS transport as the base component in sgcWebSockets Enterprise.
TsgcRTCPeerConnection
sgcP2P (re-exports sgcP2P_RTCPeerConnection)
RFC 8445, 8489, 8656, 8827, 5764, 8831, 8832, 3550, 3711, 8829
Delphi, C++ Builder
Attach a track with AddTrack, hook the SDP events, then call CreateOffer. Send aSDP to the remote peer over your own signaling channel and feed its answer back through SetRemoteDescription.
uses
sgcP2P;
var
oRTC: TsgcRTCPeerConnection;
oTrack: TsgcRTCTrack;
begin
oRTC := TsgcRTCPeerConnection.Create(nil);
oRTC.RTCOptions.ICEServers.AddURL('stun:stun.l.google.com:19302');
oRTC.OnLocalDescription := OnLocalDescriptionHandler;
oRTC.OnICECandidate := OnICECandidateHandler;
oRTC.OnConnectionStateChange := OnConnectionStateChangeHandler;
oRTC.OnTrack := OnTrackHandler;
oTrack := oRTC.AddTrack(rtctkVideo, cctVideoH264);
oTrack.OnEncodedFrame := OnEncodedFrameHandler; // remote frames, once negotiated
oRTC.CreateOffer; // gathers ICE candidates, builds the SDP offer, fires OnLocalDescription
end;
procedure TForm1.OnLocalDescriptionHandler(Sender: TObject;
const aType, aSDP: string);
begin
// send { type: aType, sdp: aSDP } to the remote peer
end;
// once the remote answer arrives over your signaling channel:
oRTC.SetRemoteDescription('answer', vRemoteSDP);
// and for every remote ICE candidate it sends:
oRTC.AddIceCandidate(vCandidate, vSdpMid, vSdpMLineIndex);// includes: sgcP2P.hpp
TsgcRTCPeerConnection *oRTC = new TsgcRTCPeerConnection(NULL);
oRTC->RTCOptions->ICEServers->AddURL("stun:stun.l.google.com:19302");
oRTC->OnLocalDescription = OnLocalDescriptionHandler;
oRTC->OnICECandidate = OnICECandidateHandler;
oRTC->OnConnectionStateChange = OnConnectionStateChangeHandler;
oRTC->OnTrack = OnTrackHandler;
TsgcRTCTrack *oTrack = oRTC->AddTrack(rtctkVideo, cctVideoH264);
oTrack->OnEncodedFrame = OnEncodedFrameHandler; // remote frames, once negotiated
oRTC->CreateOffer(); // gathers ICE candidates, builds the SDP offer, fires OnLocalDescription
void __fastcall TForm1::OnLocalDescriptionHandler(TObject *Sender,
const String aType, const String aSDP)
{
// send { type: aType, sdp: aSDP } to the remote peer
}
// once the remote answer arrives over your signaling channel:
oRTC->SetRemoteDescription("answer", vRemoteSDP);
// and for every remote ICE candidate it sends:
oRTC->AddIceCandidate(vCandidate, vSdpMid, vSdpMLineIndex);The members you reach for most often. See the feature matrix for the full breakdown by capability.
RTCOptions holds ICE, ICEServers, DTLS / DTLSOptions, Media (congestion control, FEC, pacing, RTX) and the legacy WebSocket signaling settings.
CreateOffer, CreateAnswer, SetLocalDescription, SetRemoteDescription, AddIceCandidate, RestartIce, Close.
ConnectionState, SignalingState, LocalDescription, RemoteDescription, Renegotiating, NegotiationNeeded, Polite, TrickleICE.
CreateDataChannel, DataChannelCount, DataChannels[i], OnDataChannel.
AddTrack, RemoveTrack, TrackCount, Tracks[i], OnTrack.
OnLocalDescription, OnICECandidate, OnConnectionStateChange, OnNegotiationNeeded, OnError, plus the legacy OnRTCConnect / OnRTCCandidatePairNominated / OnRTCException family.
| Online HelpFull API reference and usage guide for TsgcRTCPeerConnection. | Open | |
| Full Feature MatrixAudio, video, data channels, screen share, SRTP and bandwidth estimation. | Open | |
| Download Free TrialRun the peer connection against a browser or another native peer. | Open | |
| PricingSingle, Team and Site licenses with full source code. | Open |