在此页

• 句法
• 用法注意事项
• 范例
• 规范
• 浏览器兼容性
• 相关话题

RTCIceCandidate interface's read-only priority property specifies the candidate's priority according to the remote peer; the higher this value is, the better the remote peer considers the candidate to be.

As is the case with most of RTCIceCandidate 's properties, the value of priority is extracted from the candidate a-line string specified when creating the RTCIceCandidate . The a-line string is obtained either from the RTCIceCandidateInit property candidate or from an a-line string passed into RTCPeerConnection.addIceCandidate() 而不是 RTCIceCandidate .

句法

var priority = RTCIceCandidate.priority;
					

值

A long, unsigned integer value indicating the priority of the candidate according to the remote peer. The larger this value is, the more preferable the remote peer considers this candidate to be.

priority is initialized to null if it is not specified in the candidate , or if the candidate string can't be parsed propertly.

注意： 若 priority is null , passing the candidate to addIceCandidate() will fail, throwing an OperationError exception. This applies only if the candidate implements the priority 特性。

用法注意事项

Consider this SDP attribute line (a-line) which describes an ICE candidate:

a=candidate:4234997325 1 udp 2043278322 192.168.0.56 44323 typ host
					

The priority is the number after the protocol, so it's the fourth field in the candidate string. In this example, the priority is 2043278322.

范例

This candidate examines the priority of the candidate and, if it's greater than the priority of a previously-seen candidate, remembers the candidate for later use.

var bestCandidate = {
  candidate: "",
  sdpMid: null,
  sdpMLineIndex: null,
  priority: 0
};
function handleCandidate(candidateString) {
  var candidate = new RTCIceCandidate(candidateString);
  if (candidate.priority > bestCandidate.priority) {
    bestCandidate = candidate;
  }
}
					

规范

规范	状态	注释
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCIceCandidate.priority' 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
priority	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

图例

完整支持

完整支持

不支持

不支持

兼容性未知 ?

兼容性未知

元数据

• 最后修改： Mar 18, 2019

相关话题

1. WebRTC API
2. RTCIceCandidate
3. 构造函数

   1. RTCIceCandidate()
4. 特性

   1. address
   2. candidate
   3. component
   4. foundation
   5. port
   6. priority
   7. 协议
   8. relatedAddress
   9. relatedPort
   10. sdpMid
   11. sdpMLineIndex
   12. usernameFragment
5. 方法

   1. toJSON()
6. Related pages for WebRTC

   1. MediaDevices.getUserMedia()
   2. Navigator.mediaDevices
   3. RTCCertificate
   4. RTCDTMFSender
   5. RTCDTMFToneChangeEvent
   6. RTCDataChannel
   7. RTCDataChannelEvent
   8. RTCDtlsTransport
   9. RTCErrorEvent
   10. RTCIceTransport
   11. RTCPeerConnection
   12. RTCPeerConnectionIceErrorEvent
   13. RTCPeerConnectionIceEvent
   14. RTCRtpReceiver
   15. RTCRtpSender
   16. RTCRtpTransceiver
   17. RTCSctpTransport
   18. RTCSessionDescription
   19. RTCStatsEvent
   20. RTCStatsReport
   21. RTCTrackEvent