STUN Client
Descubra seu endpoint reflexivo atrás do NAT com um cliente STUN tipado (RFC 8489). Usado como etapa inicial para coleta de candidatos ICE e WebRTC.
Descubra seu endpoint reflexivo atrás do NAT com um cliente STUN tipado (RFC 8489). Usado como etapa inicial para coleta de candidatos ICE e WebRTC.
Cliente STUN — Binding requests, extração de XOR-MAPPED-ADDRESS, suporte a MESSAGE-INTEGRITY / FINGERPRINT, timer de retransmissão conforme RFC 8489.
TsgcSTUNClient
Windows, macOS, Linux, iOS, Android
Standard / Professional / Enterprise
Defina o host/port do servidor STUN, chame SendBindingRequest e leia MappedAddress / MappedPort em OnSTUNMappedAddress.
uses
sgcP2P;
var
STUN: TsgcSTUNClient;
begin
STUN := TsgcSTUNClient.Create(nil);
STUN.Host := 'stun.l.google.com';
STUN.Port := 19302;
STUN.OnSTUNMappedAddress := procedure(Sender: TObject;
const aMappedAddress, aMappedPort: string)
begin
Memo1.Lines.Add('public: ' + aMappedAddress + ':' + aMappedPort);
end;
STUN.SendBindingRequest;
end;
// uses: sgcP2P
TsgcSTUNClient *STUN = new TsgcSTUNClient(this);
STUN->Host = "stun.l.google.com";
STUN->Port = 19302;
STUN->SendBindingRequest();
Um cliente STUN tipado (RFC 8489) com as extensões message-integrity e fingerprint utilizadas pelo ICE.
SendBindingRequest envia a mensagem STUN 0x0001; a resposta aparece em OnSTUNMappedAddress com o atributo XOR-MAPPED-ADDRESS já parseado.
Defina Authentication.UserName / Password e o componente calcula o MESSAGE-INTEGRITY (HMAC-SHA1 / HMAC-SHA256). O realm e o nonce são extraídos da resposta de challenge 401.
STUN sobre UDP exige retransmissão na camada de aplicação. O componente implementa o back-off padrão (RTO / Rc / Rm) conforme RFC 8489 §6.2.1.
XOR-MAPPED-ADDRESS retorna em qualquer família — o componente decodifica ambas e armazena a forma textual canônica em MappedAddress.
Use múltiplas instâncias de TsgcSTUNClient contra vários servidores STUN para coletar candidatos ICE server-reflexive — um por interface local.
Usa TsgcUDPClient internamente; o binding de porta local é configurável para que STUN, ICE e o caminho de dados possam compartilhar um endpoint quando necessário.
Acesse a referência do componente, obtenha o projeto de demo pronto para executar e baixe o trial.
| Ajuda Online — TsgcSTUNClient Referência completa de propriedades, métodos e eventos deste componente. | Open | |
| Projeto de Demo — Demos\35.P2P\02.STUN Projeto de exemplo pronto para executar. Incluído no pacote sgcWebSockets — baixe o trial abaixo. | Open | |
| Documento Técnico (PDF) Recursos, quick start, exemplos de código para Delphi & C++ Builder e referências primárias — somente este componente. | Open | |
| Manual do Usuário (PDF) Manual abrangente cobrindo todos os componentes da biblioteca. | Open |