---
title: RTCIceCandidate
slug: Web/API/RTCIceCandidate
translation_of: Web/API/RTCIceCandidate
---
<p>{{APIRef("WebRTC")}}{{SeeCompatTable}}{{draft}}</p>

<p>Das <strong><code>RTCIceCandidate</code></strong> Interface der <a href="/en-US/docs/Web/API/WebRTC_API">WebRTC API</a> repräsentiert einen Kandidaten für einen Internet Connectivity Establishment (ICE) Server, welcher eine {{domxref("RTCPeerConnection")}} herstellt.</p>

<h2 id="Konstruktoren">Konstruktoren</h2>

<dl>
 <dt>{{domxref("RTCIceCandidate.RTCIceCandidate()","RTCIceCandidate()")}}</dt>
 <dd>Erstellt ein <code>RTCIceCandidate</code> Objekt.</dd>
</dl>

<h2 id="Properties">Properties</h2>

<dl>
 <dt>{{domxref("RTCIceCandidate.candidate")}} {{readonlyInline}}</dt>
 <dd>Ein {{domxref("DOMString")}}, der die Transportadresse für den Kadidaten repräsentiert, welche zur Konnektivitätsprüfung verwendet werden kann. Das Format der Adresse ist ein <code>candidate-attribute</code>, wie in {{RFC(5245)}} definiert. Dieser String ist leer (<code>""</code>), wenn der <code>RTCIceCandidate</code> einen "end of candidates" Indikator repräsentiert.</dd>
 <dt>{{domxref("RTCIceCandidate.foundation")}} {{readonlyInline}}</dt>
 <dd>Gibt einen eindeutigen Identifikator zurück, der es dem ICE erlaubt, Kandidaten, die in mehreren {{domxref("RTCIceTransport")}} Objekten vorhanden sind, in Beziehung zu setzen.</dd>
 <dt>{{domxref("RTCIceCandidate.ip")}} {{readonlyInline}}</dt>
 <dd>Gibt die IP-Adresse des Kandidaten zurück.</dd>
 <dt>{{domxref("RTCIceCandidate.port")}} {{readonlyInline}}</dt>
 <dd>Gibt den Port des Kandidaten zurück.</dd>
 <dt>{{domxref("RTCIceCandidate.priority")}} {{readonlyInline}}</dt>
 <dd>Gibt die zugewiesene Priorität des Kandidaten zurück.</dd>
 <dt>{{domxref("RTCIceCandidate.protocol")}} {{readonlyInline}}</dt>
 <dd>Gibt das vom Kandidaten verwendete Protokoll zurück, entweder TCP oder UDP.</dd>
 <dt>{{domxref("RTCIceCandidate.relatedAddress")}} {{readonlyInline}}</dt>
 <dd>Für einen Kandidaten, welcher von einem anderen abgeleitet ist, wie etwa ein Relay- oder Reflexivkandidat, ist <dfn><code>relatedAddress</code></dfn> die IP-Adresse des Kandidaten, von dem er abgeleitet ist. Für Hostkandidaten ist sie <code>null</code>.</dd>
 <dt>{{domxref("RTCIceCandidate.relatedPort")}} {{readonlyInline}}</dt>
 <dd>Für einen Kandidaten, welcher von einem anderen abgeleitet ist, wie etwa ein Relay- oder Reflexivkandidat, ist <dfn><code>relatedPort</code></dfn> der Port des Kandidaten, von dem er abgeleitet ist. Für Hostkandidaten ist er <code>null</code>.</dd>
 <dt>{{domxref("RTCIceCandidate.sdpMid")}} {{readonlyInline}}</dt>
 <dd>Enthält, wenn nicht <code>null</code>, den Identifikator der "media stream identification" (wei definiert in <cite><a href="https://tools.ietf.org/html/rfc5888">RFC 5888</a>) für die Medienkomponente, zu der dieser Kandidat zugeordnet ist.</cite></dd>
 <dt>{{domxref("RTCIceCandidate.sdpMLineIndex")}} {{readonlyInline}}</dt>
 <dd>Enthält, wenn nicht <code>null</code>, den Index (beginnend bei 0) der Medienbeschreibung (wie definiert in <a href="https://tools.ietf.org/html/rfc4566">RFC 4566</a>) im SDP, dem dieser Kandidat zugeordnet ist.</dd>
 <dt>{{domxref("RTCIceCandidate.tcpType")}} {{readonlyInline}}</dt>
 <dd>Wenn <code>protocol</code> den Wert <code>tcp</code> enthält, dann repräsentiert <code>tcpType</code> den Typ des TCP Kandidats. Ansonsten enthält <code>tcpType</code> den Wert <code>null</code>.</dd>
 <dt>{{domxref("RTCIceCandidate.type")}} {{readonlyInline}}</dt>
 <dd>Einer aus <code>host</code>, <code>srflx</code>, <code>prflx</code>, oder <code>relay</code>.</dd>
</dl>

<h2 id="Specifications">Specifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('WebRTC 1.0', '#rtcicecandidate-interface', 'RTCIceCandidate')}}</td>
   <td>{{Spec2('WebRTC 1.0')}}</td>
   <td>Initiale definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Browser compatibility</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Edge</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoDesktop(22)}}</td>
   <td> </td>
   <td> </td>
   <td> </td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Android Webview</th>
   <th>Edge</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Firefox OS</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
   <th>Chrome for Android</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td> </td>
   <td> </td>
   <td> </td>
   <td> </td>
   <td> </td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>