RTCIceCandidate.type

在此页

句法
范例
规范
浏览器兼容性
另请参阅
相关话题

RTCIceCandidate interface's read-only type specifies the type of candidate the object represents.

type field's value is set when the RTCIceCandidate() constructor is used. You can't specify the value of type in the options object, but the address is automatically extracted from the candidate a-line, if it's formatted properly, being taken from its cand-type 字段。

句法

var type = RTCIceCandidate.type;

值

A DOMString whose value is one of those defined by the RTCIceCandidateType enumerated type.

These candidate types are listed in order of priority; the higher in the list they are, the more efficient they are.

host: The candidate is a host candidate, whose IP address as specified in the RTCIceCandidate.ip property is in fact the true address of the remote peer.
srflx: The candidate is a server reflexive candidate; the ip indicates an intermediary address assigned by the STUN server to represent the candidate's peer anonymously.
prflx: The candidate is a peer reflexive candidate; the ip is an intermediary address assigned by the STUN server to represent the candidate's peer anonymously.
relay: The candidate is a relay candidate, obtained from a TURN server. The relay candidate's IP address is an address the TURN server uses to forward the media between the two peers.

若 type is null , that information was missing from the candidate 's a-line, which will cause RTCPeerConnection.addIceCandidate() to throw an OperationError 异常。

范例

In this example, the candidate's type is used to present a modified user interface for host candidates (those where the ip refers directly to the remote peer, rather than an intermediary).

if (candidate.type == "host") {
  showHostControls();
} else {
  hideHostControls();
}

规范

规范	状态	注释
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCIceCandidate.type' in that specification.	候选推荐	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`type`	Chrome 74	Edge ≤18	Firefox 不支持 No	IE 不支持 No	Opera 不支持 No	Safari ?	WebView Android 74	Chrome Android 74	Firefox Android 不支持 No	Opera Android 不支持 No	Safari iOS ?	Samsung Internet Android 11.0

在此页

句法

值

范例

规范

浏览器兼容性

图例

另请参阅

元数据

相关话题