RTCIceTransport

A interface RTCIceTransport fornece informação a respeito da camada de transporte ICE na qual os dados estão sendo enviados e recebidos. Isso é particulamente útil se você precisa acessar as informações de estado da conexão.

Propriedades

A interface RTCIceTransport herda propriedades de sua interface pai, EventTarget. ele também oferta as seguintes propriedades:

component Somente leitura
O componente ICE que esta sendo usado pela transporte. O valor é uma das strings do RTCIceTransport tipo enumerável: "RTP" ou "RTSP".
gatheringState Somente leitura
O DOMString indica em qual estado de recolhimento o agente ICE esta atualmente. O valor é um dos incluidos no RTCIceGathererState tipo enumerável: "new", "gathering", ou "complete".
role Somente leitura
Retorna uma DOMString cujo valor é um membro do tipo enumerável RTCIceRole: "controlling" ou "controlled"; Isso indica se o agente ICE é aquele que toma a decisão final quanto ao par candidato a ser usado ou não.
state Somente leitura
O DOMString indica qual o atual estado do agente ICE. O valor do state pode ser usado para determinar se o agente ICE fez uma conecxão inicial usando uma par de candidatos viável ("connected"), fez a seleção final do par de candidatos ("completed"), ou em um estado de erro ("failed"), além de outros estados. Veja o tipo enumerável RTCIceTransportState para uma lista completa de estados.

Métodos

Também inclui métodos da interface pai EventTarget.

getLocalCandidates()
Retorna um array de objetos RTCIceCandidate, cada descrevendo um dos candidatos ICE que foram reunidos para o dispositivo local até o momento. Esses são os mesmos candidatos que já foram enviados para o peer remoto, enviando um evento icecandidate ao RTCPeerConnection para transmissão.
getLocalParameters()
Retorna o objeto RTCIceParameters descrevendo o parâmetro ICE estabelecido através de uma ligação ao método RTCPeerConnection.setLocalDescription(). Retorna null se os parâmetros ainda não foram recebidos.
getRemoteCandidates()
Retorna um array de objetos RTCIceCandidate, um para cada candidato do dispositivo remoto, que foram recebidos pelo local final da RTCPeerConnection e entrega ao ICE através da chamada addIceCandidate().
getRemoteParameters()
Retorna um objeto RTCIceParameters contendo os parâmetros ICE para o dispositivo remoto, como definido por uma chamada para RTCPeerConnection.setRemoteDescription(). Se setRemoteDescription() não foi chamada ainda, o retorno será null.
getSelectedCandidatePair()
Retorna um objeto RTCIceCandidatePair que identifica os dois candidatos — um para cada conexão — que foram selecionados até o momento. É possível que um par melhor sejá encontrado e selecionado posteriormente; Se você precisar acompanhar isso, veja o evento selectedcandidatepairchange. Se nenhum par de candidatos foi selecionado ainda o valor retornado será null.

Eventos

Escute esses eventos usando addEventListener() ou atribuindo um event listener para oneventname propriedade dessa interface.

gatheringstatechange
Enviado ao objeto RTCIceTransport para indicar que o valor da propriedade gatheringState foi alterado, indicando uma mudança no processo de negociação de candidatos ICE deste transporte.
Também esta disponível através da propriedade event handler ongatheringstatechange.
selectedcandidatepairchange
Enviado para o RTCIceTransport quando um novo, melhor par de candidatos foi selecionado para descrever a conectividade entre os dois peers. Isso pode ocorrer durante a negotiação ou a renegociação, incluindo depois de um ICE restart, que reusa os objetos RTCIceTransport existentes. O par de candidatos atuais pode ser obtido usando getSelectedCandidatePair().
Também esta disponível através da propriedade event handler onselectedcandidatepairchange.
statechange
Enviado par a instancia do RTCIceTransport quando o valor da propriedade state foi alterada, indicando que o processo de recolhimento ICE mudou de estado.
Também esta disponível através da propriedade event handler onstatechange.

Especificação

Especificação Status Comentário
WebRTC 1.0: Real-time Communication Between Browsers
The definition of 'RTCIceTransport' in that specification.
Candidata a Recomendação Definição initial.

Compatibilidade de Browser

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
RTCIceTransportChrome No support NoEdge Full support 15Firefox No support NoIE No support NoOpera No support NoSafari Full support 11WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS Full support 11Samsung Internet Android No support No
componentChrome No support NoEdge Full support 15Firefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
gatheringStateChrome No support NoEdge No support NoFirefox No support NoIE No support NoOpera No support NoSafari Full support 11WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS Full support 11Samsung Internet Android No support No
gatheringstatechange eventChrome No support NoEdge No support NoFirefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
ongatheringstatechangeChrome No support NoEdge No support NoFirefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
onselectedcandidatepairchangeChrome No support NoEdge No support NoFirefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
onstatechangeChrome No support NoEdge No support NoFirefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
roleChrome No support NoEdge Full support 15Firefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
selectedcandidatepairchange eventChrome No support NoEdge No support NoFirefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
stateChrome No support NoEdge Full support 15Firefox No support NoIE No support NoOpera No support NoSafari Full support 11WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS Full support 11Samsung Internet Android No support No
statechange eventChrome No support NoEdge No support NoFirefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
getLocalCandidatesChrome No support NoEdge No support NoFirefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
getLocalParametersChrome No support NoEdge No support NoFirefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
getRemoteCandidatesChrome No support NoEdge Full support 15Firefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
getRemoteParametersChrome No support NoEdge Full support 15Firefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
getSelectedCandidatePairChrome No support NoEdge Full support 15
Alternate Name
Full support 15
Alternate Name
Alternate Name Uses the non-standard name: getNominatedCandidatePair
Firefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No

Legend

Full support  
Full support
No support  
No support
Uses a non-standard name.
Uses a non-standard name.

Etiquetas do documento e colaboradores

Colaboradores desta página: hsulipe
Última atualização por: hsulipe,