TsgcTURNServerMethods › AddBinding

AddBinding Method

Aggiunge un endpoint di ascolto aggiuntivo (IP/porta) al server TURN senza interrompere i binding già attivi.

Sintassi

function AddBinding(const aIPAddress: string; aPort: Integer) : TIdSocketHandle;

Parametri

NomeTipoDescrizione
aIPAddressconst stringIndirizzo IPv4/IPv6 locale a cui fare il bind. Utilizzare una stringa vuota, 0.0.0.0 o :: per ascoltare su ogni interfaccia.
aPortIntegerPorta UDP locale (da 1 a 65535) su cui il server TURN accetta le richieste dei client. Utilizzare 3478 per corrispondere alla porta TURN riservata IANA.

Valore restituito

Il TIdSocketHandle appena creato, oppure quello esistente quando è già presente una voce per lo stesso IP/porta. L'handle è di proprietà della collezione Bindings interna e non deve essere liberato dal chiamante. (TIdSocketHandle)

Note

AddBinding aggiunge un endpoint di ascolto al server mentre Active è True, senza interrompere alcun binding già in uso. Utilizzarlo per esporre il servizio TURN su più interfacce (ad esempio IPv4 e IPv6 sullo stesso host) o per accettare client su una porta alternativa. Ogni endpoint aggiuntivo riceve il set completo di metodi TURN (ALLOCATE, REFRESH, CREATE-PERMISSION, CHANNEL-BIND, indicazioni Send/Data e ChannelData) più le normali STUN Binding Request. Quando l'IP/porta fornito è già in ascolto, viene restituito l'handle esistente e non viene aperto alcun socket aggiuntivo. Le porte relay assegnate alle singole Allocation non sono influenzate da questa chiamata — vengono estratte dall'intervallo MinPort–MaxPort di TURNOptions.Allocation.

Esempio

oTURN.AddBinding('0.0.0.0', 3478);
oTURN.AddBinding('::', 3478);
oTURN.Active := True;

Torna ai Metodi