本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

C SDK 的用戶端指標

使用 Amazon Kinesis Video Streams with WebRTC 建置的應用程式由各種移動組件組成，包括聯網、訊號、候選者交換、對等連線和資料交換。C 中的 Kinesis Video Streams with WebRTC 支援各種用戶端指標，可讓您監控和追蹤應用程式中這些元件的效能和用量。支援的指標分為兩個主要類別：專門為 Kinesis Video Streams 的訊號和聯網實作定義的自訂指標，以及衍生自 W3C 標準的媒體和資料相關通訊協定特定指標。請注意，目前 C 中的 Kinesis Video Streams with WebRTC 僅支援一部分的 W3C 標準指標。 WebRTC

訊號指標

訊號指標可用來了解訊號用戶端在應用程式執行時的行為。您可以使用 STATUS signalingClientGetMetrics (SIGNALING_CLIENT_HANDLE, PSignalingClientMetrics) API 來取得這些訊號指標。以下是使用模式範例：

SIGNALING_CLIENT_HANDLE signalingClientHandle;
SignalingClientMetrics signalingClientMetrics;
STATUS retStatus = signalingClientGetMetrics(signalingClientHandle, &signalingClientMetrics);
printf("Signaling client connection duration: %" PRIu64 " ms",
       (signalingClientMetrics.signalingClientStats.connectionDuration / HUNDREDS_OF_NANOS_IN_A_MILLISECOND));

您可以在 Stats.h signalingClientStats中找到 的定義。

目前支援下列訊號指標：

C SDK 支援的 W3C 標準指標

使用 W3CWebRTC 標準指標的子集。這些分為下列類別：

您可以使用 STATUS rtcPeerConnectionGetMetrics (PRtcPeerConnection, PRtcRtpTransceiver, PRtcStats) API 來收集與 ICE、RTP 和資料通道相關的指標。以下是使用範例：

RtcStats rtcStats;
rtcStats.requestedTypeOfStats = RTC_STATS_TYPE_LOCAL_CANDIDATE;
STATUS retStatus = rtcPeerConnectionGetMetrics (pRtcPeerConnection, NULL, &rtcStats);
printf(“Local Candidate address: %s\n”, rtcStats.rtcStatsObject.localIceCandidateStats.address);

以下是另一個顯示使用模式以取得收發器相關統計資料的範例：

RtcStats rtcStats;
PRtcRtpTransceiver pVideoRtcRtpTransceiver;
rtcStats.requestedTypeOfStats = RTC_STATS_TYPE_OUTBOUND_RTP;
STATUS retStatus = rtcPeerConnectionGetMetrics (pRtcPeerConnection, pVideoRtcRtpTransceiver, &rtcStats);
printf(“Number of packets discarded on send: %s\n”, rtcStats.rtcStatsObject.outboundRtpStreamStats.packetsDiscardedOnSend);

在上述範例中，如果 rtcPeerConnectionGetMetrics() 的第二個引數是 NULL，則會傳回清單中第一個收發器的資料。

rtcStatsObject 的定義可在 Stats.h 中找到。RtcStats 的定義可在 Include.h 中找到。

您可以在 WebRTC C SDK 儲存庫的範例目錄中，以及 Kinesis Video Streams 示範儲存庫中找到 APIs 的範例用量和不同的指標。

使用 W3CC 標準指標。 WebRTC

聯網

ICE 伺服器指標：

ICE 候選統計資料：僅包含所選候選項目 （本機和遠端） 的相關資訊。

ICE 候選配對統計資料：僅包含所選候選配對的相關資訊。

媒體

傳出 RTP 統計資料

遠端傳入 RTP 統計資料：

傳入 RTP 統計資料：

資料管道

資料管道指標：