Kurento 之 WebRTC 统计 - HelloWorld开发者社区

介绍

WebRTC流（音频，视频或数据）可能丢失，并且经历不同数量的网络延迟。为了评估WebRTC应用程序的性能，可能需要能够监视底层网络和媒体管道的WebRTC功能。

为此，Kurento为服务器端（Kurento Media Server，KMS）提供了WebRTC统计数据收集。此功能的实现遵循W3C WebRTC的统计API中提供的指南。因此，KMS中收集的统计数据可以分为两组：

inboundrtp：KMS接收流的统计信息。
outboundrtp：KMS发送流的统计信息。

API 描述

通常，WebRTC统计信息收集功能由KMS提供，并通过不同的Kurento客户端实现（Java，JavaScript客户端提供开箱即用）来使用。要读取这些统计信息，首先应该使用Media Pipeline对象的setLatencyStats方法启用它们。使用Kurento Java客户端，操作如下：

String kmsWsUri = "ws://localhost:8888/kurento";
KurentoClient kurentoClient = KurentoClient.create(kmsWsUri);
MediaPipeline mediaPipeline = kurentoClient.createMediaPipeline();
mediaPipeline.setLatencyStats(true);

// ...

使用 JavaScript 客户端:

var kmsWsUri = "ws://localhost:8888/kurento";
kurentoClient(kmsWsUri, function(error, kurentoClient) {
   kurentoClient.create("MediaPipeline", function(error, mediaPipeline) {
      mediaPipeline.setLatencyStats(true, function(error){

         // ...

      });
   });
});

一旦启用WebRTC统计，第二步是使用媒体元素的getStats方法读取统计值，例如，读取Java中的WebRtcEndpoint对象的统计信息：

WebRtcEndpoint webRtcEndpoint = new WebRtcEndpoint.Builder(mediaPipeline).build();
MediaType mediaType = ... // it can be MediaType.VIDEO, MediaType.AUDIO, or MediaType.DATA
Map<String, Stats> statsMap = webRtcEndpoint.getStats(mediaType);

// ...

JavaScript操作：

mediaPipeline.create("WebRtcEndpoint", function(error, webRtcEndpoint) {
   var mediaType = ... // it can be 'VIDEO', 'AUDIO', or 'DATA'
   webRtcEndpoint.getStats(mediaType, function(error, statsMap) {

      // ...

   });
});

请注意，WebRTC统计信息将作为map读取。因此，此集合的每个条目都有一个键和一个值，其中键是特定统计量，在读取时具有给定值。考虑到这些值参考实时属性，因此这些值随时间变化，这取决于多个因素（例如网络性能，KMS负载等）。统计的完整描述在KMD接口描述中定义。最相关的统计数据如下：