4.1.18. setConfiguration

4.1.18. setConfiguration

La méthode setConfiguration permet de modifier la configuration globale de la PeerConnection, qui a été initialement définie par les paramètres du constructeur, pendant la session. Les effets de l'appel de cette méthode dépendent du moment où elle est invoquée, et ils différeront en fonction des paramètres spécifiques qui sont modifiés:

• Toute modification des serveurs STUN/TURN à utiliser affecte la phase de collecte suivante. Si une phase de collecte ICE a déjà commencé ou s'est terminée, le bit 'needs-ice-restart' mentionné dans la Section 3.5.1 sera défini. Cela entraînera le prochain appel à createOffer à générer de nouvelles informations d'identification ICE, dans le but de forcer un redémarrage ICE et de lancer une nouvelle phase de collecte, dans laquelle les nouveaux serveurs seront utilisés. Si le pool de candidats ICE a une taille non nulle et qu'une description locale n'a pas encore été appliquée, tous les candidats existants seront supprimés et de nouveaux candidats seront collectés à partir des nouveaux serveurs.

• Toute modification de la politique de candidats ICE affecte la phase de collecte suivante. Si une phase de collecte ICE a déjà commencé ou s'est terminée, le bit 'needs-ice-restart' sera défini. Dans tous les cas, les modifications de la politique n'ont aucun effet sur le pool de candidats, car les candidats mis en pool ne sont pas mis à disposition de l'application avant qu'une phase de collecte ne se produise, et donc tout filtrage nécessaire peut encore être effectué sur les candidats mis en pool.

• La taille du pool de candidats ICE NE DOIT PAS être modifiée après l'application d'une description locale. Si une description locale n'a pas encore été appliquée, toute modification de la taille du pool de candidats ICE prend effet immédiatement; si elle est augmentée, des candidats supplémentaires sont pré-collectés; si elle est diminuée, les candidats désormais superflus sont supprimés.

• Les politiques de bundle et de multiplexage RTCP NE DOIVENT PAS être modifiées après la construction de la PeerConnection.

L'appel de cette méthode peut entraîner une modification de l'état de l'agent ICE.