RTCPeerConnection

Overview

The TsgcRTCPeerConnection is a client component that allows you to connect peers using P2P through UDP.

At a glance

Features

• Native Delphi implementation with full ANSI/Unicode support.

Technical specification

Main properties

The principal published / public properties used to configure and drive the component. Consult the online help for the full list.

Main methods

The principal public methods exposed by the component.

Public events

The component exposes the following published events; consult the online help for full event-handler signatures.

Quick Start

Drop the component on a form, configure the properties below and activate it. The snippet that follows shows the typical Send Data configuration sourced from the online help.

Delphi (VCL / FireMonkey)

oRTCPeerConnection := TsgcRTCPeerConnection.Create(nil);
...
oRTCPeerConnection.WriteData('Hello from sgcWebSockets!!!');

C++ Builder

TsgcRTCPeerConnection *oRTCPeerConnection = new TsgcRTCPeerConnection();
...
oRTCPeerConnection->WriteData("Hello from sgcWebSockets!!!");

.NET (C#)

TsgcRTCPeerConnection oRTCPeerConnection = new TsgcRTCPeerConnection();
...
oRTCPeerConnection.WriteData("Hello from sgcWebSockets!!!");

Common scenarios

The following scenarios are lifted verbatim from the online help. Each shows the configuration and method calls needed to drive the component through a specific real-world flow.

1 · RTCPeerConnection | WebSocket Server

The TsgcRTCPeerConnection client requires a WebSocket Server for signaling. The client makes use of the WebSocket protocol to exchange the SDP of the peers and the candidates (IPs and ports), which will allow peers to communicate.

oServer := TsgcWebSocketServer.Create(nil);
oProtocol := TsgcWSPServer_RTCPeerConnection.Create(nil);
oProtocol.Server := oServer;
oServer.Port := 8080;
oServer.Active := True;

TsgcWebSocketServer *oServer = new TsgcWebSocketServer();
TsgcWSPServer_RTCPeerConnection *oProtocol = new TsgcWSPServer_RTCPeerConnection();
oProtocol->Server = oServer;
oServer->Port = 8080;
oServer->Active = true;

TsgcWebSocketServer oServer = new TsgcWebSocketServer();
TsgcWSPServer_RTCPeerConnection oProtocol = new TsgcWSPServer_RTCPeerConnection();
oProtocol.Server = oServer;
oServer.Port = 8080;
oServer.Active = true;

2 · Receive Data

Every time the TsgcRTCPeerConnection receives any data from the other peer, the event OnRTCMessage will be called.

procedure OnRTCMessage(Sender: TObject; const aBytes: TBytes);
begin
  ShowMessage(TEncoding.UTF8.GetString(aBytes));
end;

void OnRTCMessage(TObject *Sender, const TBytes aBytes)
{
  ShowMessage(TEncoding->UTF8->GetString(aBytes));
}

void OnRTCMessage(TObject Sender, byte[] aBytes)
{
  MessageBox.Show(System.Text.Encoding.Default.GetString(aBytes));
}

Sources used to build this document

Every external claim links back to a primary source. The online-help references decode the canonical deep-link the company maintains for this component.