RTCIceCandidate：toJSON() 方法

RTCIceCandidate 方法 **toJSON()** 将其调用的 RTCIceCandidate 转换为 JSON。

然后可以通过在返回的对象上调用 stringify() 来获取对象的字符串化版本。

语法

js
toJSON()

参数

无。

返回值

一个 JSON 对象，具有以下属性，这些属性已设置为 RTCIceCandidate 对象中的相应值

candidate 可选

一个字符串，描述候选者的网络连接信息。更多信息可以在 RTCIceCandidate.candidate 中找到。

sdpMid 可选

一个字符串，包含与候选者关联的媒体流的标识标签，如果没有任何关联的媒体流，则为 null。更多信息可以在 RTCIceCandidate.sdpMid 中找到。

sdpMLineIndex 可选

一个数字属性，包含与候选者关联的 m 行的基于零的索引，位于媒体描述的 SDP 中，如果不存在此类关联，则为 null。更多信息可以在 RTCIceCandidate.sdpMLineIndex 中找到。

usernameFragment 可选

一个字符串，包含用户名片段（通常简称为“ufrag”或“ice-ufrag”）。此片段与 ICE 密码（“ice-pwd”）一起唯一地标识单个正在进行的 ICE 交互（包括与 STUN 服务器的任何通信）。更多信息可以在 RTCIceCandidate.usernameFragment 中找到。

注意：返回的 JSON 对象具有与可以可选地传递给 RTCIceCandidate() 构造函数以配置候选者的 candidateInfo 对象相同的形式/属性。

示例

此简单示例获取表示 RTCIceCandidate 的 JSON 字符串，该字符串位于变量 candidate 中。

js
let jsonString = candidate.toJSON().stringify();

规范

规范
WebRTC：浏览器中的实时通信
# dom-rtcicecandidate-tojson

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。