4.1.18. setConfiguration
4.1.18. setConfiguration
Il metodo setConfiguration consente di modificare la configurazione globale della PeerConnection, che è stata inizialmente impostata dai parametri del costruttore, durante la sessione. Gli effetti della chiamata di questo metodo dipendono da quando viene invocato e differiranno a seconda dei parametri specifici che vengono modificati:
-
Qualsiasi modifica ai server STUN/TURN da utilizzare influisce sulla fase di raccolta successiva. Se una fase di raccolta ICE è già iniziata o completata, il bit 'needs-ice-restart' menzionato nella Sezione 3.5.1 verrà impostato. Ciò farà sì che la prossima chiamata a createOffer generi nuove credenziali ICE, allo scopo di forzare un riavvio ICE e avviare una nuova fase di raccolta, in cui verranno utilizzati i nuovi server. Se il pool di candidati ICE ha una dimensione diversa da zero e una descrizione locale non è ancora stata applicata, tutti i candidati esistenti verranno scartati e verranno raccolti nuovi candidati dai nuovi server.
-
Qualsiasi modifica alla politica dei candidati ICE influisce sulla fase di raccolta successiva. Se una fase di raccolta ICE è già iniziata o completata, il bit 'needs-ice-restart' verrà impostato. In ogni caso, le modifiche alla politica non hanno effetto sul pool di candidati, perché i candidati in pool non vengono resi disponibili all'applicazione fino a quando non si verifica una fase di raccolta, e quindi qualsiasi filtraggio necessario può ancora essere effettuato su qualsiasi candidato in pool.
-
La dimensione del pool di candidati ICE NON DEVE essere modificata dopo aver applicato una descrizione locale. Se una descrizione locale non è ancora stata applicata, qualsiasi modifica alla dimensione del pool di candidati ICE ha effetto immediatamente; se aumentata, vengono pre-raccolti candidati aggiuntivi; se diminuita, i candidati ora superflui vengono scartati.
-
Le politiche di bundle e di multiplexing RTCP NON DEVONO essere modificate dopo la costruzione della PeerConnection.
La chiamata di questo metodo può comportare un cambiamento nello stato dell'agente ICE.