WebRTC 統計 API の識別子

ssrc、 型 unsigned long

synchronization source（SSRC）識別子は、[RFC3550] に従う unsigned integer 値であり、この stats object が記述している RTP パケットの stream を識別するために使用される。

outbound および inbound local について、SSRC はそれぞれそれらの endpoint によって 送信および受信された RTP stream の stats を記述する。 remote inbound および remote outbound について、SSRC はリモート endpoint によって受信され、 リモート endpoint に送信された RTP stream の stats を記述する。

kind、 型 DOMString

"audio" または "video" のいずれかである。 これは、関連する MediaStreamTrack の kind 属性と一致しなければMUSTならない。

transportId 、型 DOMString

これは、この RTP stream に関連付けられた RTCTransportStats を生成するために 検査されたオブジェクトに関連付けられる一意な識別子である。

codecId、 型 DOMString

これは、この RTP stream に関連付けられた RTCCodecStats を生成するために検査されたオブジェクトに関連付けられる一意な識別子である。

payloadType、型 unsigned long

RTP encoding または decoding で使用される payload type。

transportId 、型 DOMString

この codec が使用されている transport の一意な識別子であり、 対応する RTCTransportStats オブジェクトを検索するために使用できる。

mimeType、 型 DOMString

IANA media types registry [IANA-MEDIA-TYPES] で定義される codec MIME media type/subtype。 例: video/VP8。

clockRate、型 unsigned long

メディアサンプリングレートを表す。

channels、型 unsigned long

存在する場合、チャンネル数（mono=1、stereo=2）を示す。

sdpFmtpLine 、型 DOMString

対応する codec に対応する SDP の a=fmtp 行からの "format specific parameters" フィールド。 もしそれが exist する場合、 [RFC8829]（第 5.8 節）で 定義されるとおりである。

packetsReceived、型 unsigned long long

この SSRC について受信された RTP パケットの総数。 これには再送が含まれる。 受信 endpoint では、これは [RFC3550] 第 6.4.1 節で定義されるように計算される。送信 endpoint では、packetsReceived は、RTCP Receiver Report で報告される Extended Highest Sequence Number Received から Cumulative Number of Packets Lost を差し引き、さらに この SSRC に送信された RTCP Sender Report における initial Extended Sequence Number を差し引き、1 を加えることで推定される。 これは [RFC3550] の Appendix A.3 で説明されていることを、sender 側に合わせて反映するためである。 RTCP Receiver Report が まだ受信されていない場合、0 を返す。

packetsReceivedWithEct1、型 unsigned long long

この SSRC について受信された、 "ECT(1)" marking 付き RTP パケットの総数。

packetsReceivedWithCe、型 unsigned long long

この SSRC について受信された、 "CE" marking 付き RTP パケットの総数。

packetsReportedAsLost、型 unsigned long long

[RFC8888] 第 3.1 節の report が、ゼロの R bit を伴って送信された RTP パケットの総数。 "ccfb" feedback mechanism のサポートがネゴシエートされている場合にのみ exist する。

packetsReportedAsLostButRecovered、型 unsigned long long

[RFC8888] 第 3.1 節の report が、ゼロの R bit を伴って送信されたが、 同じパケットに対する後続の report では R bit が 1 に設定されていた RTP パケットの総数。 "ccfb" feedback mechanism のサポートがネゴシエートされている場合にのみ exist する。

packetsLost、型 long long

この SSRC について失われた RTP パケットの総数。 [RFC3550] 第 6.4.1 節で定義されるように計算される。 これは推定方法のため、送信された数より多くのパケットが受信された場合には 負になる可能性があることに注意。

jitter、型 double

この SSRC について秒単位で測定される Packet Jitter。 [RFC3550] の第 6.4.1 節で定義されるように計算される。

trackIdentifier、型 DOMString

MediaStreamTrack の id 属性の値。

mid、型 DOMString

この stream を所有する RTCRtpTransceiver が null ではない mid 値を持つ場合、これはその値である。そうでない場合、このメンバーは 存在してはMUST NOTならない。

remoteId、型 DOMString

remoteId は、 同じ SSRC についてリモートの RTCRemoteOutboundRtpStreamStats オブジェクトを検索するために使用される。

framesDecoded

audio については exist してはMUST NOTならない。 これは、この RTP stream について正しくデコードされた フレームの総数、すなわちフレームがドロップされなければ表示されるはずのフレームを表す。

keyFramesDecoded、型 unsigned long

audio については exist してはMUST NOTならない。 この RTP media stream について正常にデコードされた、 VP8 [RFC6386] の key frame や H.264 [RFC6184] の IDR-frame などの key frame の総数を表す。これは framesDecoded のサブセットである。 framesDecoded - keyFramesDecoded により、 デコードされた delta frame の数が得られる。

framesRendered

audio については exist してはMUST NOTならない。 レンダリングされたフレームの総数を表す。 フレームがレンダリングされた直後に増加する。

framesDropped、型 unsigned long

audio については exist してはMUST NOTならない。 この receiver の track について、デコード前にドロップされた、または フレームが表示期限に間に合わなかったためにドロップされたフレームの総数。 測定は receiver が作成された時点で開始され、[RFC7004] Appendix A (g) で定義される累積メトリックである。

frameWidth、型 unsigned long

audio については exist してはMUST NOTならない。 最後にデコードされたフレームの幅を表す。最初の フレームがデコードされる前、このメンバーは exist してはMUST NOTならない。

frameHeight、型 unsigned long

audio については exist してはMUST NOTならない。 最後にデコードされたフレームの高さを表す。最初の フレームがデコードされる前、このメンバーは exist してはMUST NOTならない。

framesPerSecond、型 double

audio については exist してはMUST NOTならない。 直近 1 秒間にデコードされたフレーム数。

qpSum、型 unsigned long long

audio については exist してはMUST NOTならない。 この receiver によってデコードされたフレームの QP 値の合計。 フレーム数は framesDecoded にある。

QP 値の定義は codec に依存する。VP8 では、QP 値は frame header 内で syntax element y_ac_qi として運ばれる値であり、 [RFC6386] 第 19.2 節で定義される。 その範囲は 0..127 である。

QP 値は、使用された quantizer 値の指標にすぎないことに注意。 多くの形式には、フレーム内で quantizer 値を変化させる方法がある。

totalDecodeTime、型 double

audio については exist してはMUST NOTならない。 この stream の framesDecoded フレームのデコードに費やされた秒数の総数。 平均デコード時間は、この値を framesDecoded で 割ることで計算できる。1 フレームをデコードするのにかかる時間は、 decoder にフレームを供給してから、そのフレームについて decoder がデコード済み データを返すまでに経過した時間である。

totalInterFrameDelay、型 double

audio については exist してはMUST NOTならない。 連続してレンダリングされたフレーム間の interframe delay の秒単位の合計であり、 フレームがレンダリングされた直後に記録される。interframe delay variance は totalInterFrameDelay、 totalSquaredInterFrameDelay、 および framesRendered から、次の式に従って計算できる: (totalSquaredInterFrameDelay - totalInterFrameDelay^2/ framesRendered)/framesRendered.

totalSquaredInterFrameDelay、型 double

audio については exist してはMUST NOTならない。 連続してレンダリングされたフレーム間の二乗された interframe delay の秒単位の合計であり、 フレームがレンダリングされた直後に記録される。interframe delay variance の計算方法の詳細については、 totalInterFrameDelay を参照。

pauseCount、型 unsigned long

audio については exist してはMUST NOTならない。 この receiver が経験した video pause の総数を数える。 最後にレンダリングされたフレームから経過した時間が 5 秒を超える場合、 video は一時停止していると見なされる。pauseCount は、そのような一時停止の後にフレームがレンダリングされたときに増加する。

totalPausesDuration、型 double

audio については exist してはMUST NOTならない。 pause の総継続時間（pause の定義については pauseCount を参照）を 秒単位で表す。この値はフレームがレンダリングされたときに更新される。

freezeCount、型 unsigned long

audio については exist してはMUST NOTならない。 この receiver が経験した video freeze の総数を数える。 frame duration、すなわち連続してレンダリングされた 2 つのフレーム間の時間間隔が、 Max(3 * avg_frame_duration_ms, avg_frame_duration_ms + 150) 以上である場合、 freeze である。ここで avg_frame_duration_ms は、最後にレンダリングされた 30 フレームの duration の線形平均である。

totalFreezesDuration、型 double

audio については exist してはMUST NOTならない。 frozen と見なされるレンダリング済みフレームの総継続時間（freeze の定義については freezeCount を参照）を 秒単位で表す。この値は フレームがレンダリングされたときに更新される。

lastPacketReceivedTimestamp、型 DOMHighResTimeStamp

この SSRC について最後のパケットが受信された時刻のタイムスタンプを表す。 これは、ローカル endpoint によって統計が生成された時刻を表す timestamp とは異なる。

headerBytesReceived、型 unsigned long long

この SSRC について受信された RTP header および padding byte の総数。 これには再送が含まれる。 これは IP や UDP などの transport layer header のサイズを含まない。 headerBytesReceived + bytesReceived は、 transport 上で payload として受信された byte 数と等しい。

packetsDiscarded、型 unsigned long long

late または early-arrival により jitter buffer によって破棄された RTP パケットの累積数。 すなわち、これらのパケットは再生されない。packet duplication により破棄された RTP パケットは、 このメトリックでは報告されない [XRBLOCK-STATS]。 [RFC7002] 第 3.2 節および Appendix A.a で定義されるように計算される。

fecBytesReceived、型 unsigned long long

この SSRC について受信された RTP FEC byte の総数であり、 payload byte のみを含む。 これは bytesReceived のサブセットである。 別の ssrc を使用する FEC mechanism がネゴシエートされた場合、FEC パケットは 別個の SSRC 上で送信されるが、それでもここで計上される。

fecPacketsReceived、型 unsigned long long

この SSRC について受信された RTP FEC パケットの総数。別の ssrc を使用する FEC mechanism がネゴシエートされた場合、FEC パケットは 別個の SSRC 上で送信されるが、それでもここで計上される。 このカウンターは、media packet と同一帯域で FEC パケットを受信する場合にも 増加することがある （例: Opus の場合）。

fecPacketsDiscarded、型 unsigned long long

この SSRC について受信された RTP FEC パケットの総数のうち、 error correction payload がアプリケーションによって破棄されたもの。 これは、1. FEC パケットによって保護されたすべての source packet が受信済みまたは 別個の FEC パケットによってすでに回復済みである場合、または 2. FEC パケットが遅れて到着した、 すなわち recovery window の外であり、失われた RTP パケットがすでに playout 中にスキップされている場合に発生する可能性がある。 これは fecPacketsReceived のサブセットである。

bytesReceived、型 unsigned long long

この SSRC について受信された byte の総数。 これには再送が含まれる。 [RFC3550] 第 6.4.1 節で定義されるように計算される。

firCount、型 unsigned long

audio については exist してはMUST NOTならない。 この receiver によって送信された Full Intra Request (FIR) パケットの総数を数える。 これは [RFC5104] 第 4.3.1 節で定義される。 [RFC2032] で示され、 [RFC4587] によって 非推奨とされた RTCP FIR は数えない。

pliCount、型 unsigned long

audio については exist してはMUST NOTならない。 この receiver によって送信された Picture Loss Indication (PLI) パケットの総数を数える。これは [RFC4585] 第 6.3.1 節で定義される。

totalProcessingDelay、型 double

これは、各 audio sample または video frame について、 最初の RTP パケットが受信された時刻（reception timestamp）から、対応する sample または frame が デコードされた時刻（decoded timestamp）までにかかった時間の秒単位の合計である。 この時点で、audio sample または video frame は MediaStreamTrack による playout の準備ができている。 通常ここで playout の準備ができているとは、audio sample または video frame が decoder によって完全にデコードされた後を意味する。

関連する複雑さを考慮し、arrival time または reception timestamp は 可能な限り network layer に近いところで測定され、decoded timestamp は 完全な sample または frame がデコードされ次第測定される。

audio の場合、複数の sample が同じ RTP パケットで受信されるため、すべての sample は 同じ reception timestamp と異なる decoded timestamp を共有する。 video の場合、frame は複数の RTP パケットにわたって受信される。この場合、 frame を含む最も早い timestamp が reception timestamp として数えられ、 decoded timestamp は完全な frame がデコードされた時点に対応する。

このメトリックは、デコードされないフレーム、 すなわち framesDropped については増加しない。 平均 processing delay は、totalProcessingDelay を、video については framesDecoded （または audio については provisional stats spec の totalSamplesDecoded）で 割ることで計算できる。

nackCount、型 unsigned long

この receiver によって送信された Negative ACKnowledgement (NACK) パケットの総数を数える。 これは [RFC4585] 第 6.2.1 節で定義される。

estimatedPlayoutTimestamp、型 DOMHighResTimeStamp

これは、この receiver の track の推定 playout time である。playout time は、 既知の timestamp（RTP timestamp を NTP timestamp に対応付ける RTCP SR パケットから得られる）を持つ、 最後に再生可能な audio sample または video frame の NTP timestamp であり、 再生可能になってから経過した時間で外挿される。これは sender の NTP clock time における track の "current time" であり、 現在再生中の audio がなくても存在できる。

これは、同じ source からの 2 つの track について、audio と video がどれだけ同期していないかを 推定するのに有用である。audioInboundRtpStats.estimatedPlayoutTimestamp - videoInboundRtpStats.estimatedPlayoutTimestamp.

jitterBufferDelay、型 double

jitter buffer の目的は、（video の場合）RTP パケットを frame に再結合し、 滑らかな playout を行うことである。ここで説明するモデルは、sample または frame が まだ圧縮されており、まだデコードされていないことを前提とする。 これは、各 audio sample または video frame について、 最初のパケットが jitter buffer に受信された時刻（ingest timestamp）から jitter buffer を出る時刻（emit timestamp）までにかかる時間の秒単位の合計である。 audio の場合、複数の sample が同じ RTP パケットに属するため、それらは同じ ingest timestamp を持つが、異なる jitter buffer emit timestamp を持つ。 video の場合、frame は複数の RTP パケットにわたって受信されることがあるため、 ingest timestamp は jitter buffer に入ったその frame の最も早いパケットであり、 emit timestamp は frame 全体が jitter buffer を出る時刻である。 このメトリックは、sample または frame が buffer 内での時間を完了して外に出たときに増加する（そして jitterBufferEmittedCount を増加させる）。 平均 jitter buffer delay は、jitterBufferDelay を jitterBufferEmittedCount で割ることで計算できる。

jitterBufferTargetDelay、型 double

この値は、jitter buffer から sample が emit されるたびに、 target jitter buffer delay だけ増加する。追加される target は、 その sample が jitter buffer から emit された時点の、 秒単位の target delay である。平均 target delay を得るには、 jitterBufferEmittedCount で割る。

jitterBufferEmittedCount、型 unsigned long long

jitter buffer から出た audio sample または video frame の総数 （jitterBufferDelay を増加させる）。

jitterBufferMinimumDelay、型 double

jitter buffer delay がより高い値へ増加する理由はさまざまであり、たとえば AV synchronization を達成するため、または jitterBufferTarget が RTCRtpReceiver に設定されたためである。これらの mechanism の 1 つを使用する場合、 達成できたはずの最小 jitter buffer delay を追跡しておくことが有用な場合があり、 それにより WebRTC client は追加されている delay の量を追跡できる。

このメトリックは jitterBufferTargetDelay と同じように機能するが、 jitter buffer target delay を増加させる外部 mechanism、たとえば jitterBufferTarget（上記リンクを参照）、 AV sync、またはその他の mechanism の影響を受けない。このメトリックは jitter や packet loss などの network characteristics のみに基づき、 外部要因が影響しなければ得られる最小 jitter buffer delay と見なすことができる。 このメトリックは、jitterBufferEmittedCount が更新されるたびに更新される。

totalSamplesReceived、型 unsigned long long

video については MUST NOT exist である。この RTP stream 上で 受信された sample の総数。これには concealedSamples が含まれる。

concealedSamples、型 unsigned long long

video については MUST NOT exist である。concealed sample である sample の総数。concealed sample とは、 再生される前に、ローカルで生成された合成 sample に置き換えられた sample である。 conceal されなければならない sample の例としては、失われた packet からの sample （packetsLost で報告される）や、 再生には遅すぎて到着した packet からの sample （packetsDiscarded で報告される）がある。

silentConcealedSamples、型 unsigned long long

video については MUST NOT exist である。挿入された concealed sample のうち、"silent" であるものの総数。 silent sample を再生すると、無音または comfort noise になる。これは concealedSamples のサブセットである。

concealmentEvents、型 unsigned long long

video については MUST NOT exist である。 concealment event の数。このカウンターは、 concealed sample が non-concealed sample の後に合成されるたびに増加する。つまり、 複数の連続した concealed sample は concealedSamples count を複数回増加させるが、単一の concealment event である。

insertedSamplesForDeceleration、型 unsigned long long

video については MUST NOT exist である。playout が 遅くされた場合、このカウンターは、 受信された sample の数と再生された sample の数との差分だけ増加する。 sample を挿入することによって playout が遅くされる場合、これは挿入された sample の数になる。

removedSamplesForAcceleration、型 unsigned long long

video については MUST NOT exist である。playout が 速くされた場合、このカウンターは、 受信された sample の数と再生された sample の数との差分だけ増加する。 sample を削除することによって speedup が達成される場合、これは削除された sample の数になる。

audioLevel、型 double

video については MUST NOT exist である。受信 track の audio level を表す。ローカルに添付された track の audio level については、代わりに RTCAudioSourceStats を参照。

値は 0..1（linear）の範囲であり、1.0 は 0 dBov、0 は silence、0.5 は 0 dBov からの sound pressure level のおよそ 6 dBSPL の変化を表す。

audioLevel は、totalAudioEnergy の下で説明されるアルゴリズムを使用して、ある小さな interval にわたって平均される。 使用される interval は implementation-defined である。

totalAudioEnergy、型 double

video については MUST NOT exist である。受信 track の audio energy を表す。ローカルに添付された track の audio energy については、代わりに RTCAudioSourceStats を参照。

この値は次のように計算されなければMUSTならない: 受信された（したがって audio sample が totalSamplesReceived によって数えられる）各 sample について、 sample の値を最高強度の encode 可能値で割り、二乗し、その後 sample の duration（秒）を掛けたものを加算する。言い換えると、 duration * Math.pow(energy/maxEnergy, 2) である。

これは、[RFC6464] で定義される audioLevel と 同じ単位を使用する root mean square（RMS）値を得るために使用できる。 これは式 Math.sqrt(totalAudioEnergy/totalSamplesDuration) を使用して それらの単位に変換できる。この計算は、任意の望ましい時間間隔にわたる 平均 audio level を計算するために、2 つの異なる getStats() 呼び出しの値の差分を使用して実行することもできる。言い換えると、 Math.sqrt((energy2 - energy1)/(duration2 - duration1)) とする。

たとえば、10ms の audio packet が 0.5（1.0 のうち）の RMS で生成された場合、 これは totalAudioEnergy に 0.5 * 0.5 * 0.01 = 0.0025 を加えるべきである。 RMS が 0.1 の別の 10ms packet が 受信された場合、これは同様に totalAudioEnergy に 0.0001 を加えるべきである。 すると、 Math.sqrt(totalAudioEnergy/totalSamplesDuration) は Math.sqrt(0.0026/0.02) = 0.36 となり、これは連続した 20ms の audio segment に対して RMS 計算を行うことで得られる値と同じである。

複数の audio channel が使用される場合、 sample の audio energy は任意の channel の最高 energyを指す。

totalSamplesDuration、型 double

video については MUST NOT exist である。受信 track の audio duration を表す。ローカルに添付された track の audio duration については、代わりに RTCAudioSourceStats を参照。

受信された（したがって totalSamplesReceived によって数えられる）すべての sample の合計 duration を秒単位で表す。 totalAudioEnergy とともに使用して、異なる interval にわたる平均 audio level を計算できる。

framesReceived、型 unsigned long

audio については MUST NOT exist である。この RTP stream 上で受信された完全な frame の総数を表す。 このメトリックは、完全な frame が受信されたときに増加する。

decoderImplementation、型 DOMString

exist してはならない。ただし、exposing hardware is allowed である場合を除く。

audio については MUST NOT exist である。使用されている decoder implementation を識別する。 これは相互運用性の問題を診断するのに有用である。

playoutId 、型 DOMString

video については MUST NOT exist である。 audio playout が発生している場合、これは対応する RTCAudioPlayoutStats を検索するために使用される。

powerEfficientDecoder、型 boolean

exist してはならない。ただし、exposing hardware is allowed である場合を除く。

audio については MUST NOT exist である。 現在使用されている decoder が、user agent によって power efficient と見なされるかどうか。 これは構成が hardware acceleration につながるかどうかを反映すべきSHOULDであるが、 user agent は、その構成が power efficient と見なされるかどうかを判断する際に、 他の情報を考慮してもMAYよい。

framesAssembledFromMultiplePackets、型 unsigned long

audio については MUST NOT exist である。 これは、この RTP stream について正しくデコードされた、複数の RTP packet から構成される frame の総数を表す。そのような frame については、 totalAssemblyTime が増加する。平均 frame assembly time は、 totalAssemblyTime を framesAssembledFromMultiplePackets で 割ることで計算できる。

totalAssemblyTime、型 double

audio については MUST NOT exist である。 各 video frame について、最初の RTP packet が受信された時刻 （reception timestamp）から、その frame の最後の RTP packet が受信された時刻までに かかる時間の秒単位の合計である。複数の RTP packet から構成される frame についてのみ増加する。

関連する複雑さを考慮し、arrival time または reception timestamp は 可能な限り network layer に近いところで測定される。このメトリックは、 デコードされない frame、すなわち framesDropped や、その他の理由でデコードに失敗した frame （もしあれば）については増加しない。複数の RTP packet から構成される frame についてのみ増加する。

retransmittedPacketsReceived、型 unsigned long long

この SSRC について受信された再送 packet の総数。 これは packetsReceived の サブセットである。RTX がネゴシエートされていない場合、 再送 packet は識別できず、このメンバーは MUST NOT exist である。

retransmittedBytesReceived、型 unsigned long long

この SSRC について受信された 再送 byte の総数であり、payload byte のみを含む。 これは bytesReceived のサブセットである。 RTX がネゴシエートされていない場合、再送 packet は識別できず、 このメンバーは MUST NOT exist である。

rtxSsrc 、型 unsigned long

別個の RTP stream 上での再送について RTX がネゴシエートされている場合、 これはこの stream の ssrc と関連付けられた RTX stream の SSRC である。 RTX がネゴシエートされていない場合、この値は MUST NOT present である。

fecSsrc 、型 unsigned long

別個の RTP stream を使用する FEC mechanism がネゴシエートされている場合、これはこの stream の ssrc と関連付けられた FEC stream の SSRC である。 FEC がネゴシエートされていない、または同じ RTP stream を使用する場合、この値は MUST NOT present である。

totalCorruptionProbability、型 double

audio については MUST NOT exist である。この SSRC について 行われたすべての corruption probability measurement の累積合計を表す。この属性がいつ SHOULD present であるかについては、 corruptionMeasurements を参照。

totalCorruptionProbability に加算される各 measurement は [0.0, 1.0] の範囲でなければMUSTならない。 ここで値 0.0 は、システムが処理済み frame に corruption が存在しない、または無視できる程度であると 推定したことを示す。同様に値 1.0 は、処理済み frame に corruption がほぼ確実に 見えることを示す。その中間の値は、何らかの corruption が見える可能性が高いが、 たとえば magnitude が低い、または frame の小さな部分にのみ存在する可能性があることを示す。

注

corruption likelihood の値は推定であり、保証ではない。推定が 0.0 であっても、たとえば frame の非常に小さな領域だけが影響を受けている場合には corruption が存在する可能性がある（すなわち false negative である）。同様に、推定が 1.0 であっても、 たとえば frame average よりはるかに高い QP を持つ macroblock がある場合には corruption が存在しない可能性がある（すなわち false positive である）。 PSNR measurement などに edge case があるのと同様に、これらのメトリックは per-frame basis で絶対的な真実として使用するよりも、主として 統計分析の基礎として使用されるべきである。

totalSquaredCorruptionProbability、型 double

audio については MUST NOT exist である。この SSRC について 行われたすべての corruption probability measurement の二乗の累積合計を表す。この属性がいつ SHOULD present であるかについては、 corruptionMeasurements を参照。

corruptionMeasurements、型 unsigned long long

audio については MUST NOT exist である。user agent が corruption probability measurement を行うことができる場合、このカウンターはそのような measurement ごとに増加し、 totalCorruptionProbability および totalSquaredCorruptionProbability は、それぞれこの measurement および measurement の二乗で集計される。 corruption-detection header extension が RTP packet に存在する場合、corruption probability measurement は MUST present である。

注

http://www.webrtc.org/experiments/rtp-hdrext/corruption-detection に記載されている corruption-detection header extension は実験的なものである。 IETF 標準が確立されると、identifier および format は変更される可能性がある。

localId、型 DOMString

localId は、同じ SSRC についてローカルの RTCOutboundRtpStreamStats オブジェクトを検索するために使用される。

roundTripTime 、型 double

RTCP Receiver Report (RR) 内の RTCP timestamp に基づく、この SSRC についての推定 round trip time であり、 秒単位で測定される。[RFC3550] 第 6.4.1 節で定義されるように計算される。 0 以外の DLSR 値を持つ RTCP Receiver Report が 受信されるまでは、MUST NOT exist である。

totalRoundTripTime、型 double

セッションの開始以降に行われたすべての round trip time 測定値の秒単位の 累積合計を表す。個々の round trip time は RTCP Receiver Report (RR) [RFC3550] 内の RTCP timestamp に基づいて計算されるため、 0 以外の DLSR 値が必要である。平均 round trip time は、 totalRoundTripTime を roundTripTimeMeasurements で割ることで計算できる。

fractionLost 、型 double

この SSRC について報告された fraction packet loss。 [RFC3550] 第 6.4.1 節および Appendix A.3 で定義されるように計算される。

roundTripTimeMeasurements、型 unsigned long long

この SSRC について受信された、有効な round trip time を含む RTCP RR block の総数を表す。 0 以外の DLSR 値を持つ RTCP Receiver Report が 受信されていないため roundTripTime を計算できない場合、このカウンターは増加しない。

packetsWithBleachedEct1Marking、 型 unsigned long long

[RFC3168] 第 3 節に従って ECT(1) marking 付きで送信されたが、 [RFC8888] report によって、その packet が "not-ECT" の marking で受信されたという情報が与えられた packet の数。

packetsSent、型 unsigned long long

この SSRC について送信された RTP packet の総数。 これには再送が含まれる。 [RFC3550] 第 6.4.1 節で定義されるように計算される。

bytesSent、型 unsigned long long

この SSRC について送信された byte の総数。 これには再送が含まれる。 [RFC3550] 第 6.4.1 節で定義されるように計算される。

mid、型 DOMString

この stream を所有する RTCRtpTransceiver が null ではない mid 値を持つ場合、 これはその値であり、そうでない場合、このメンバーは exist してはMUST NOTならない。

mediaSourceId、型 DOMString

この stream の sender に現在添付されている track を表す stats object、 RTCMediaSourceStats の識別子。

remoteId、 型 DOMString

remoteId は、 同じ SSRC についてリモートの RTCRemoteInboundRtpStreamStats オブジェクトを検索するために使用される。

rid、型 DOMString

audio については exist してはMUST NOTならない。 この rid がこの RTP stream に設定されている場合にのみ exist する。 rid が設定されている場合、この値は RID RTP header extension がネゴシエートされているかどうかにかかわらず存在する。

encodingIndex、型 unsigned long

audio については exist してはMUST NOTならない。 これは、RTP sender の encodings のリスト内で、この RTP stream を表す encoding の index である。

headerBytesSent、型 unsigned long long

この SSRC について送信された RTP header および padding byte の総数。これは IP や UDP などの transport layer header のサイズを 含まない。 headerBytesSent + bytesSent は、transport 上で payload として送信された byte 数に等しい。

retransmittedPacketsSent、型 unsigned long long

この SSRC について再送された packet の総数。これは packetsSent のサブセットである。 RTX がネゴシエートされていない場合、再送 packet はこの ssrc 上で送信される。RTX がネゴシエートされた場合、 再送 packet は別個の SSRC 上で送信されるが、それでもここで計上される。

retransmittedBytesSent、型 unsigned long long

この SSRC について再送された byte の総数であり、payload byte のみを 含む。これは bytesSent のサブセットである。 RTX がネゴシエートされていない場合、再送 byte はこの ssrc 上で送信される。 RTX がネゴシエートされた場合、再送 byte は別個の SSRC 上で送信されるが、 それでもここで計上される。

rtxSsrc 、型 unsigned long

別個の RTP stream 上での再送について RTX がネゴシエートされている場合、これはこの stream の ssrc と関連付けられた RTX stream の SSRC である。 RTX がネゴシエートされていない場合、この値は exist してはMUST NOTならない。

targetBitrate、型 double

現在の encoder target を bit per second で反映する。 target は encoder の設定を反映する瞬時値であるが、 結果として送信される payload byte per second は、再送を除き、 target と密接に相関すべきSHOULDである。 bytesSent および retransmittedBytesSent も参照。 targetBitrate は、Transport Independent Application Specific (TIAS) bitrate [RFC3890] と同じ方法で定義される。

totalEncodedBytesTarget、型 unsigned long long

audio については exist してはMUST NOTならない。 この値は、frame が encode されるたびに target frame size（byte 単位）だけ増加する。 実際の frame size はこの数値より大きい場合も小さい場合もある。 この値は framesEncoded が増加するたびに増加する。

frameWidth、型 unsigned long

audio については exist してはMUST NOTならない。 最後に encode された frame の幅を表す。encode された frame の解像度は、 media source より低い場合がある（RTCVideoSourceStats.width を参照）。 最初の frame が encode される前、このメンバーは exist してはMUST NOTならない。

frameHeight、型 unsigned long

audio については exist してはMUST NOTならない。 最後に encode された frame の高さを表す。encode された frame の解像度は、 media source より低い場合がある（RTCVideoSourceStats.height を参照）。 最初の frame が encode される前、このメンバーは exist してはMUST NOTならない。

framesPerSecond、型 double

audio については exist してはMUST NOTならない。 直近 1 秒間に encode された frame 数。これは media source の frame rate （RTCVideoSourceStats.framesPerSecond を参照）より低い場合がある。

framesSent、型 unsigned long

audio については exist してはMUST NOTならない。 この RTP stream 上で送信された frame の総数を表す。

hugeFramesSent、型 unsigned long

audio については exist してはMUST NOTならない。 この RTP stream によって送信された huge frame の総数を表す。 huge frame とは、定義上、encoded size が frame の平均サイズの少なくとも 2.5 倍である frame である。frame の平均サイズは、 frame が encode された時点での target bitrate per second を target FPS で割ったものとして定義される。 これらは通常、picture 内に多くの変化があるため encode が複雑な frame である。 これは、たとえば stream された presentation における slide change を推定するために使用できる。

2.5 という乗数は、WebRTC standalone implementation を使用したサンプル presentation の encoded frame size の分析から選ばれた。2.5 は十分に大きい 乗数でありながら、それでもすべての slide change event を huge frame として識別させた。ただし、1.4% の false positive slide change detection を生じさせたが、 これは妥当と見なされる。

framesEncoded、型 unsigned long

audio については exist してはMUST NOTならない。 これは、この RTP media stream について正常に encode された frame の総数を表す。

keyFramesEncoded、型 unsigned long

audio については exist してはMUST NOTならない。 これは、この RTP media stream について正常に encode された、 VP8 [RFC6386] の key frame や H.264 [RFC6184] の IDR-frame などの key frame の総数を表す。これは framesEncoded のサブセットである。 framesEncoded - keyFramesEncoded により、 encode された delta frame の数が得られる。

qpSum、型 unsigned long long

audio については exist してはMUST NOTならない。 この sender によって encode された frame の QP 値の合計。 frame 数は framesEncoded にある。

QP 値の定義は codec に依存する。VP8 では、QP 値は frame header 内で syntax element y_ac_qi として運ばれる値であり、 [RFC6386] 第 19.2 節で定義される。 その範囲は 0..127 である。

QP 値は、使用された quantizer 値の指標にすぎないことに注意。 多くの形式には、frame 内で quantizer 値を変化させる方法がある。

psnrSum、型 record<DOMString, double>

exist してはならない。ただし、exposing hardware is allowed である場合を除く。

audio については exist してはMUST NOTならない。 この sender によって encode された frame の PSNR 値の累積合計。 record には "y"、"u"、"v" コンポーネントの値が含まれる。 measurement の数は psnrMeasurements にある。

PSNR は [ISO-29170-1:2017] で定義される。

注

PSNR metrics は per-frame basis で絶対的な真実を表すものではなく、 統計分析を意図している。

psnrMeasurements、型 unsigned long long

exist してはならない。ただし、exposing hardware is allowed である場合を除く。

audio については exist してはMUST NOTならない。 PSNR が測定された回数。psnrSum のコンポーネントは この measurement とともに集計される。

PSNR は [ISO-29170-1:2017] で定義される。 PSNR measurement の頻度は implementation-defined である。

注

User agent は、各 encoder implementation について固定頻度で PSNR を測定し、目立った性能上のペナルティを引き起こさない限り 可能な限り高頻度で測定することが推奨される。

totalEncodeTime、型 double

audio については exist してはMUST NOTならない。 この stream の framesEncoded frame の encode に費やされた秒数の総数。 平均 encode time は、この値を framesEncoded で割ることで 計算できる。 1 frame を encode するのにかかる時間は、 encoder に frame を供給してから、encoder がその frame について encoded data を返すまでに経過した時間である。これは、結果として得られる data を packetize するために追加でかかる可能性のある時間を含まない。

totalPacketSendDelay、型 double

packet が network に送信される前にローカルで buffer された秒数の総数。 時間は、packet が RTP packetizer から emit されてから、 OS network socket に渡されるまでで測定される。この measurement は、totalPacketSendDelay に、 packetsSent が 増加したときに加算される。

qualityLimitationReason、型 RTCQualityLimitationReason

audio については exist してはMUST NOTならない。 resolution および/または framerate を制限している現在の理由、または 制限されていない場合は "none"。

実装は最も制限している要因を報告する。複数の要因が存在する可能性があるため、 実装が最も制限している要因を判断できない場合、理由は次の優先順位で 報告されなければMUSTならない: "bandwidth", "cpu", "other"。

注

CPU と bandwidth resource の消費は 相互依存しており推定が困難であるため、 「最も制限している要因」が何かを判断するのは難しい。ここで推奨される優先順位は、 "bandwidth" が一般により変動しやすく、そのため "cpu" よりも 可能性が高く有用な signal であるという heuristic に基づいている。

qualityLimitationDurations、型 record<DOMString, double>

audio については exist してはMUST NOTならない。 この stream が各 quality limitation state に費やした総時間（秒単位）の record。record には、"none" を含むすべての RTCQualityLimitationReason 型に対する mapping が含まれる。

すべての entry の合計から qualityLimitationDurations["none"] を差し引くと、stream が制限されていた総時間が得られる。

qualityLimitationResolutionChanges、型 unsigned long

audio については exist してはMUST NOTならない。 quality limited であるために resolution が変化した回数 （qualityLimitationReason が "none" 以外の値を持つ）を表す。 counter は初期値が 0 で、resolution が上がるか下がると増加する。たとえば、 720p track が一定時間 480p として送信され、その後 720p に回復した場合、 qualityLimitationResolutionChanges は値 2 を持つ。

nackCount、型 unsigned long

[RFC4585] 第 6.2.1 節で定義される、この sender によって受信された Negative ACKnowledgement (NACK) packet の総数を数える。

firCount、型 unsigned long

audio については exist してはMUST NOTならない。 [RFC5104] 第 4.3.1 節で定義される、この sender によって受信された Full Intra Request (FIR) packet の総数を 数える。[RFC2032] で示され、 [RFC4587] によって 非推奨とされた RTCP FIR は数えない。

pliCount、型 unsigned long

audio については exist してはMUST NOTならない。 [RFC4585] 第 6.3.1 節で定義される、この sender によって受信された Picture Loss Indication (PLI) packet の総数を数える

encoderImplementation、型 DOMString

exist してはならない。ただし、exposing hardware is allowed である場合を除く。

audio については exist してはMUST NOTならない。 使用されている encoder implementation を識別する。 これは相互運用性の問題を診断するのに有用である。

powerEfficientEncoder、型 boolean

exist してはならない。ただし、exposing hardware is allowed である場合を除く。

audio については exist してはMUST NOTならない。 現在使用されている encoder が user agent によって power efficient と見なされるかどうか。 これは構成が hardware acceleration につながるかどうかを反映すべきSHOULDであるが、 user agent は、その構成が power efficient と見なされるかどうかを判断する際に、 他の情報を考慮してもMAYよい。

active、 型 boolean

この RTP stream が送信されるよう 構成されているか、または無効化されているかを示す。 active な stream であっても、たとえば network conditions によって制限されている場合には 送信していないことがある点に注意。

scalabilityMode、型 DOMString

audio については exist してはMUST NOTならない。 scalability mode がこの RTP stream に現在構成されている場合にのみ exist する。

packetsSentWithEct1、型 unsigned long long

[RFC3168] 第 5 節で定義され、[RFC9331] で説明される L4S protocol によって使用される ECT(1) marking 付きで、 この SSRC について送信された RTP packet の総数。

localId、型 DOMString

localId は、同じ SSRC についてローカルの RTCInboundRtpStreamStats オブジェクトを検索するために使用される。

remoteTimestamp、型 DOMHighResTimeStamp

型 DOMHighResTimeStamp [HIGHRES-TIME] の remoteTimestamp は、これらの統計がリモート endpoint によって送信された remote timestamp を表す。これは、統計がローカル endpoint によって生成または受信された時刻を 表す timestamp とは異なる。 remoteTimestamp は、存在する場合、 リモート endpoint の clock を反映する RTCP Sender Report (SR) block 内の NTP timestamp から導出される。その clock はローカル clock と同期していない可能性がある。

reportsSent、型 unsigned long long

この SSRC について送信された RTCP Sender Report (SR) block の総数を表す。

roundTripTime 、型 double

[RFC3611] で定義される DLRR report block を含む最新の RTCP Sender Report (SR) に基づく、この SSRC についての推定 round trip time。 round trip time の計算は [RFC3611] 第 4.5 節で定義される。最新の SR が DLRR report block を含まない場合、 DLRR report block 内の last RR timestamp が zero の場合、または DLRR report block 内の delay since last RR 値が zero の場合は、 exist してはMUST NOTならない。

totalRoundTripTime、型 double

セッションの開始以降に行われたすべての round trip time measurement の秒単位の 累積合計を表す。個々の round trip time は、 RTCP Sender Report (SR) [RFC3611] 内の DLRR report block に基づいて計算される。 roundTripTime を計算できない場合、この counter は増加しない。 平均 round trip time は、totalRoundTripTime を roundTripTimeMeasurements で割ることで計算できる。

roundTripTimeMeasurements、型 unsigned long long

[RFC3611] に従って有効な round trip time を導出できる DLRR report block を含む、 この SSRC について受信された RTCP Sender Report (SR) block の総数を表す。 roundTripTime を計算できない場合、この counter は増加しない。

trackIdentifier、型 DOMString

MediaStreamTrack の id 属性の値。

kind、 型 DOMString

MediaStreamTrack の kind 属性の値。 これは "audio" または "video" である。 "audio" の場合、この stats object は RTCAudioSourceStats 型である。 "video" の場合、この stats object は RTCVideoSourceStats 型である。

audioLevel、 型 double

media source の audio level を表す。リモート由来の track の audio level については、 代わりに RTCInboundRtpStreamStats を参照。

値は 0..1（linear）の範囲であり、1.0 は 0 dBov、0 は silence、0.5 は 0 dBov からの sound pressure level のおよそ 6 dBSPL の変化を表す。

audioLevel は、 totalAudioEnergy で説明されるアルゴリズムを使用して、ある小さな interval にわたって平均される。 使用される interval は implementation-defined である。

totalAudioEnergy、型 double

media source の audio energy を表す。リモート由来の track の audio energy については、 代わりに RTCInboundRtpStreamStats を参照。

この値は次のように計算されなければMUSTならない: この stats object の生存期間中に media source によって生成された各 audio sample について、sample の値を encode 可能な最高強度の値で割り、二乗し、その後 sample の duration（秒）を掛けたものを加算する。言い換えると、duration * Math.pow(energy/maxEnergy, 2) である。

これは、[RFC6464] で定義される audioLevel と同じ単位を使用する root mean square（RMS）値を得るために使用できる。 これは式 Math.sqrt(totalAudioEnergy/totalSamplesDuration) を使用して それらの単位に変換できる。この計算は、任意の望ましい時間間隔にわたる 平均 audio level を計算するために、2 つの異なる getStats() 呼び出しの値の差分を使用して実行することもできる。言い換えると、 Math.sqrt((energy2 - energy1)/(duration2 - duration1)) とする。

たとえば、10ms の audio packet が 0.5（1.0 のうち）の RMS で生成された場合、 これは totalAudioEnergy に 0.5 * 0.5 * 0.01 = 0.0025 を加えるべきである。 RMS が 0.1 の別の 10ms packet が 受信された場合、これは同様に totalAudioEnergy に 0.0001 を加えるべきである。 すると、 Math.sqrt(totalAudioEnergy/totalSamplesDuration) は Math.sqrt(0.0026/0.02) = 0.36 となり、これは連続した 20ms の audio segment に対して RMS 計算を行うことで得られる値と同じである。

複数の audio channel が使用される場合、 sample の audio energy は任意の channel の最高 energyを指す。

totalSamplesDuration、型 double

media source の audio duration を表す。リモート由来の track の audio duration については、 代わりに RTCInboundRtpStreamStats を参照。

この stats object の生存期間中に、この source によって生成されたすべての sample の総 duration を秒単位で表す。 totalAudioEnergy とともに使用して、異なる interval にわたる平均 audio level を計算できる。

echoReturnLoss 、型 double

MediaStreamTrack が echo cancellation が適用される microphone から供給されている場合にのみ exist する。 [ECHO] (2012) 第 3.14 節で定義されるように、decibel 単位で計算される。

複数の audio channel が使用される場合、 どの sample についても最も低い audio energyの channel が考慮される。

echoReturnLossEnhancement、型 double

MediaStreamTrack が echo cancellation が適用される microphone から供給されている場合にのみ exist する。 [ECHO] (2012) 第 3.15 節で定義されるように、decibel 単位で計算される。

複数の audio channel が使用される場合、どの sample についても 最も低い audio energyの channel が考慮される。

width 、型 unsigned long

この source に由来する最後の frame の幅（pixel 単位）。 frame が生成される前、このメンバーは MUST NOT exist である。

height 、型 unsigned long

この source に由来する最後の frame の高さ（pixel 単位）。 frame が生成される前、このメンバーは MUST NOT exist である。

frames 、型 unsigned long

この source に由来する frame の総数。

framesPerSecond、型 double

この source に由来する frame の数であり、直近 1 秒間に測定される。 この object の生存期間の最初の 1 秒間、このメンバーは MUST NOT exist である。

kind、 型 DOMString

audio playout の場合、これは "audio" という値を持つ。これは、playout されている MediaStreamTrack(s) の kind 属性を反映する。

synthesizedSamplesDuration、型 double

playout path が device playout に間に合うように audio sample を生成できない場合、 sample が代わりに playout されるよう合成される。 synthesizedSamplesDuration は秒単位で測定され、 この playout path によって audio sample が合成されるたびに増加する。 この metric は totalSamplesDuration とともに使用して、playout された media のうち合成されたものの割合を 計算できる。

Synthesization は通常、pipeline が十分に機能していない場合にのみ発生する。 RTCInboundRtpStreamStats によって合成された sample はここでは数えられず、 RTCInboundRtpStreamStats.concealedSamples で数えられる。

synthesizedSamplesEvents、型 unsigned long

synthesized samples event の数。この counter は、 non-synthesized sample の後に sample が合成されるたびに増加する。 つまり、複数の連続した synthesized sample は synthesizedSamplesDuration を複数回増加させるが、単一の synthesization samples event である。

totalSamplesDuration、型 double

playout されたすべての audio sample の総 duration（秒単位）。 synthesized sample と non-synthesized sample の両方を含む。

totalPlayoutDelay、型 double

audio sample が playout device によって pull されるとき、 この counter は、その audio sample についての playout path の推定 delay だけ増加する。 playout delay には、emit されてから device 上で実際に playout される時刻までの delay が含まれる。この metric は totalSamplesCount とともに使用して、sample あたりの平均 playout delay を 計算できる。

totalSamplesCount、型 unsigned long long

audio sample が playout device によって pull されるとき、 この counter は playout のために emit された sample 数だけ増加する。

dataChannelsOpened、型 unsigned long

生存期間中に "open" state に入った一意な RTCDataChannel の数を表す。

dataChannelsClosed、型 unsigned long

生存期間中に "open" state を離れた一意な RTCDataChannel の数を表す （いずれかの端によって閉じられた、または基礎となる transport が閉じられたため）。 "connecting" から "closing" または "closed" へ遷移し、決して "open" にならなかった RTCDataChannel は、 この数に含まれない。

任意の時点における open data channel の総数は、 dataChannelsOpened - dataChannelsClosed として計算できる。この数は常に正である。

label、 型 DOMString

RTCDataChannel object の label 値。

protocol、 型 DOMString

RTCDataChannel object の protocol 値。

dataChannelIdentifier、型 unsigned short

RTCDataChannel object の id 属性。

state、型 RTCDataChannelState

RTCDataChannel object の readyState 値。

messagesSent、型 unsigned long

送信された API "message" event の総数を表す。

bytesSent、型 unsigned long long

この RTCDataChannel 上で送信された payload byte の総数を表す。

messagesReceived、型 unsigned long

受信された API "message" event の総数を表す。

bytesReceived、型 unsigned long long

この RTCDataChannel 上で受信された payload byte の総数を表す。

packetsSent、型 unsigned long long

この transport 上で送信された packet の総数を表す。

packetsReceived、型 unsigned long long

この transport 上で受信された packet の総数を表す。

bytesSent、型 unsigned long long

この RTCIceTransport 上で送信された payload byte の総数を表す。すなわち、header、padding、 または ICE connectivity check を含まない。

bytesReceived、型 unsigned long long

この RTCIceTransport 上で受信された payload byte の総数を表す。すなわち、header、padding、 または ICE connectivity check を含まない。

iceRole、 型 RTCIceRole

下位の RTCDtlsTransport.iceTransport の role 属性の現在の値に設定される。

iceLocalUsernameFragment、型 DOMString

この RTCIceTransport について、message validation procedure [RFC5245] で使用される local username fragment の現在の値に設定される。 setLocalDescription() および ICE restart 時に更新されることがある。

dtlsState、型 RTCDtlsTransportState

下位の RTCDtlsTransport の state 属性の現在の値に設定される。

iceState、型 RTCIceTransportState

下位の RTCIceTransport の state 属性の現在の値に設定される。

selectedCandidatePairId、型 DOMString

これは、この transport に関連付けられた RTCIceCandidatePairStats を生成するために検査された object に関連付けられる一意な識別子である。

localCertificateId、型 DOMString

DTLS がネゴシエートされる component について、local certificate を与える。

remoteCertificateId、型 DOMString

DTLS がネゴシエートされる component について、remote certificate を与える。

tlsVersion 、型 DOMString

DTLS がネゴシエートされる component について、合意された TLS version。 DTLS negotiation が完了した後にのみ exist する。

値は、存在する場合は ServerHello.supported_versions から、 そうでない場合は ServerHello.version から来る。これは、その version の 2 byte を表す 4 桁の大文字の hexadecimal digit として表される。

dtlsCipher 、型 DOMString

IANA cipher suite registry [IANA-TLS-CIPHERS] の "Description" column で定義される、DTLS transport に使用される cipher suite の説明名。

dtlsRole 、型 RTCDtlsRole

DTLS role に応じて "client" または "server"。 DTLS negotiation が開始される前は "unknown"。

srtpCipher 、型 DOMString

IANA DTLS-SRTP protection profile registry [IANA-DTLS-SRTP] の "Profile" column で 定義され、[RFC5764] で さらに説明される、SRTP transport に使用される protection profile の説明名。

selectedCandidatePairChanges、型 unsigned long

この transport の selected candidate pair が変更された回数。 selected candidate pair を持たない状態から持つ状態になる、またはその逆の場合も、 この counter は増加する。初期値は 0 であり、最初の candidate pair が選択されると 1 になる。

ccfbMessagesSent、型 unsigned long

この transport 上で送信された、[RFC8888] section 3.1 で説明される CongestionControl Feedback Packet 型の Transport-Layer Feedback Message の数。

ccfbMessagesReceived、型 unsigned long

この transport 上で受信された、[RFC8888] section 3.1 で説明される CongestionControl Feedback Packet 型の Transport-Layer Feedback Message の数。

transportId 、型 DOMString

これは、この candidate に関連付けられた RTCTransportStats を生成するために 検査された object に関連付けられる一意な識別子である。

address、 型 DOMString

これは candidate の address であり、IPv4 address、IPv6 address、および fully qualified domain name（FQDN）を許容する。詳細は [RFC5245] section 15.1 を参照。

user agent は、対応する RTCPeerConnection 上で web application が構成した remote candidate address のみが expose されるようにすべきである。 これは、peer reflexive remote candidate について特に重要である。既定では、 user agent は任意の remote candidate の RTCIceCandidateStats dictionary において、address member を null のままにしておかなければMUSTならない。 RTCPeerConnection instance が、web application による addIceCandidate() の使用を通じて address を知ると、 user agent は、新しく知った address に一致する、対応する RTCPeerConnection の任意の remote RTCIceCandidateStats dictionary において 'address' member 値を expose できる。

port、型 long

これは candidate の port number である。

protocol、 型 DOMString

transport の有効な値は "udp" および "tcp" のいずれかである。 [RFC5245] section 15.1 で定義される "transport" に基づく。

candidateType、型 RTCIceCandidateType

この列挙型は [WEBRTC] で定義される。

priority、型 long

[RFC5245] section 15.1 で定義されるように計算される。

url、型 DOMString

型 "srflx" または型 "relay" の local candidate について、これは candidate が取得された ICE server の URL であり、 [WEBRTC] で定義される。

remote candidate について、この property は MUST NOT present である。

relayProtocol、型 RTCIceServerTransportProtocol

これは endpoint が TURN server と通信するために使用する protocol である。 これは local relay candidate に対してのみ存在し、[WEBRTC] で定義される。

remote candidate について、この property は MUST NOT present である。

foundation 、型 DOMString

[RFC5245] section 15.1 で定義される ICE foundation。

relatedAddress、型 DOMString

[RFC5245] section 15.1 で定義される ICE rel-addr。serverreflexive、 peerreflexive、および relay candidate についてのみ設定される。

relatedPort、 型 long

[RFC5245] section 15.1 で定義される ICE rel-addr。serverreflexive、 peerreflexive、および relay candidate についてのみ設定される。

usernameFragment、型 DOMString

[RFC5245] section 7.1.2.3 で定義される ICE username fragment。peerreflexive remote candidate については、ICE username fragment が以前に signaling されていない限り、 これは設定されない。

tcpType、型 RTCIceTcpCandidateType

RTCIceTcpCandidateType で定義され、 RTCIceCandidate で使用される ICE candidate TCP type。

transportId、型 DOMString

これは、この candidate pair に関連付けられた RTCTransportStats を生成するために 検査された object に関連付けられる一意な識別子である。

localCandidateId、型 DOMString

これは、この candidate pair に関連付けられた local candidate についての RTCIceCandidateStats を生成するために 検査された object に関連付けられる一意な識別子である。

remoteCandidateId、型 DOMString

これは、この candidate pair に関連付けられた remote candidate についての RTCIceCandidateStats を生成するために 検査された object に関連付けられる一意な識別子である。

state、型 RTCStatsIceCandidatePairState

pair 内の local candidate と remote candidate についての checklist の状態を表す。

nominated、 型 boolean

[RFC5245] Section 7.1.3.2.4 で説明される nominated flag の更新に関連する。

packetsSent、型 unsigned long long

この candidate pair 上で送信された packet の総数を表す。

packetsReceived、型 unsigned long long

この candidate pair 上で受信された packet の総数を表す。

bytesSent、型 unsigned long long

この candidate pair 上で送信された payload byte の総数を表す。すなわち、 header、padding、または ICE connectivity check は含まない。

bytesReceived、型 unsigned long long

この candidate pair 上で受信された payload byte の総数を表す。 すなわち、header、padding、または ICE connectivity check は含まない。

lastPacketSentTimestamp、型 DOMHighResTimeStamp

この特定の candidate pair 上で最後の packet が送信された timestamp を表す。 STUN packet は除外する。

lastPacketReceivedTimestamp、型 DOMHighResTimeStamp

この特定の candidate pair 上で最後の packet が受信された timestamp を表す。 STUN packet は除外する。

totalRoundTripTime、型 double

セッション開始以降のすべての round trip time measurement の秒単位の合計を表す。 STUN connectivity check [STUN-PATH-CHAR] response（responsesReceived）に基づき、consent を検証するために送信された request に対する response も含む [RFC7675]。 平均 round trip time は、 totalRoundTripTime を responsesReceived で割ることで 計算できる。

currentRoundTripTime、型 double

STUN connectivity check [STUN-PATH-CHAR] から計算される、 秒単位で測定された最新の round trip time を表し、 consent verification のために送信されたものも含む [RFC7675]。

availableOutgoingBitrate、型 double

これは、下位の congestion control によって、この candidate pair を使用するすべての送信方向の RTP stream についての available bitrate を組み合わせることにより計算される。bitrate measurement は、IP や TCP または UDP などのその他の transport layer のサイズを数えない。 これは [RFC3890] で定義される TIAS と同様であり、 すなわち bit per second で測定され、bitrate は 1 秒 window にわたって計算される。 使用中の candidate pair について、その推定値は通常、 lastPacketSentTimestamp で送信された packet の bitrate より低くないが、それより 高い場合がある。

下位の congestion control が、たとえば TWCC などの mechanism を使用して send-side bandwidth estimation を計算した場合、 または RTCP を介して receive-side estimation、たとえば REMB で説明されるものを受信した場合にのみ exist する。 bandwidth estimation のために考慮された packet の送信に一度も使用されたことがない candidate pair、または以前に使用されたことはあるが現在使用中ではない candidate pair については MUST NOT exist である。

availableIncomingBitrate、型 double

これは、下位の congestion control によって、この candidate pair を使用するすべての受信方向の RTP stream についての available bitrate を組み合わせることにより計算される。bitrate measurement は、IP や TCP または UDP などのその他の transport layer のサイズを数えない。 これは [RFC3890] で定義される TIAS と同様であり、 すなわち bit per second で測定され、bitrate は 1 秒 window にわたって計算される。 使用中の pair について、その推定値は通常、 lastPacketReceivedTimestamp で受信された packet の bitrate より低くないが、それより 高い場合がある。

receive-side bandwidth estimation、たとえば REMB が計算された場合にのみ exist する。 bandwidth estimation のために考慮された packet の受信に一度も使用されたことがない candidate pair、または以前に使用されたことはあるが現在使用中ではない candidate pair については MUST NOT exist である。

requestsReceived、型 unsigned long long

受信された connectivity check request（再送を含む）の総数を表す。 receiver は request が connectivity を確認するために送信されたものか、 consent を確認するために送信されたものかを判別できないため、すべての connectivity check request がここで数えられる。

requestsSent、型 unsigned long long

送信された connectivity check request（再送を含まない）の総数を表す。

responsesReceived、型 unsigned long long

受信された connectivity check response の総数を表す。

responsesSent、型 unsigned long long

送信された connectivity check response の総数を表す。connectivity check request と consent request を区別できないため、すべての response が数えられる。

consentRequestsSent、型 unsigned long long

送信された consent request の総数を表す。

packetsDiscardedOnSend、型 unsigned long

socket error により破棄された、この candidate pair についての packet の総数。 すなわち、packet を socket に渡す際に socket error が発生した場合である。 これは buffer がいっぱいである、利用可能な memory がないなど、 さまざまな理由で発生することがある。

bytesDiscardedOnSend、型 unsigned long long

socket error により破棄された、この candidate pair についての byte の総数。 すなわち、その byte を含む packet を socket に渡す際に socket error が発生した場合である。 これは buffer がいっぱいである、利用可能な memory がないなど、 さまざまな理由で発生することがある。[RFC3550] section 6.4.1 で定義されるように計算される。

fingerprint 、型 DOMString

certificate の fingerprint。[RFC4572] Section 5 で定義される fingerprint 値のみを使用する。

fingerprintAlgorithm、型 DOMString

certificate fingerprint を計算するために使用される hash function。たとえば "sha-256"。

base64Certificate、型 DOMString

certificate の DER-encoded base-64 表現。

issuerCertificateId、型 DOMString

issuerCertificateId は、certificate chain 内の次の certificate を含む stats object を参照する。 現在の certificate が chain の末尾にある場合（すなわち self-signed certificate の場合）、 これは設定されない。