4.1.18. setConfiguration

4.1.18. setConfiguration

Die setConfiguration-Methode ermöglicht es, die globale Konfiguration der PeerConnection, die ursprünglich durch Konstruktorparameter festgelegt wurde, während der Sitzung zu ändern. Die Auswirkungen des Aufrufs dieser Methode hängen davon ab, wann sie aufgerufen wird, und sie werden sich unterscheiden, je nachdem, welche spezifischen Parameter geändert werden:

• Alle Änderungen an den zu verwendenden STUN/TURN-Servern wirken sich auf die nächste Sammelphase aus. Wenn eine ICE-Sammelphase bereits begonnen hat oder abgeschlossen ist, wird das in Abschnitt 3.5.1 erwähnte 'needs-ice-restart'-Bit gesetzt. Dies führt dazu, dass der nächste Aufruf von createOffer neue ICE-Anmeldeinformationen generiert, um einen ICE-Neustart zu erzwingen und eine neue Sammelphase zu starten, in der die neuen Server verwendet werden. Wenn der ICE-Kandidatenpool eine von null verschiedene Größe hat und noch keine lokale Beschreibung angewendet wurde, werden alle vorhandenen Kandidaten verworfen und neue Kandidaten von den neuen Servern gesammelt.

• Jede Änderung an der ICE-Kandidatenrichtlinie wirkt sich auf die nächste Sammelphase aus. Wenn eine ICE-Sammelphase bereits begonnen hat oder abgeschlossen ist, wird das 'needs-ice-restart'-Bit gesetzt. In jedem Fall haben Änderungen an der Richtlinie keine Auswirkungen auf den Kandidatenpool, da gepoolte Kandidaten der Anwendung erst zur Verfügung gestellt werden, wenn eine Sammelphase stattfindet, und daher kann jede erforderliche Filterung noch an allen gepoolten Kandidaten durchgeführt werden.

• Die ICE-Kandidatenpoolgröße DARF NICHT geändert werden, nachdem eine lokale Beschreibung angewendet wurde. Wenn noch keine lokale Beschreibung angewendet wurde, werden alle Änderungen an der ICE-Kandidatenpoolgröße sofort wirksam; wenn erhöht, werden zusätzliche Kandidaten vorab gesammelt; wenn verringert, werden die nun überflüssigen Kandidaten verworfen.

• Die Bundle- und RTCP-Multiplexing-Richtlinien DÜRFEN NICHT nach der Konstruktion der PeerConnection geändert werden.

Der Aufruf dieser Methode kann zu einer Änderung des Zustands des ICE-Agenten führen.