RTCVideoSourceStats

Словарь RTCVideoSourceStats API WebRTC предоставляет статистическую информацию о видеодорожке (MediaStreamTrack), которая подключена к одному или нескольким отправителям (RTCRtpSender).

Эти данные можно получить, проитерировав RTCStatsReport, возвращаемый RTCRtpSender.getStats() или RTCPeerConnection.getStats(), пока не будет найден отчёт с type media-source и kind video.

frames Необязательно

Положительное число, которое указывает общее количество кадров, исходящих от этого источника видео.

framesPerSecond Необязательно

Положительное число, представляющее количество кадров, исходящих от этого источника видео в течение последней секунды. Это свойство не определено для этого объекта статистики в течение первой секунды его существования.

height Необязательно

Число, представляющее высоту последнего кадра, исходящего от этого источника, в пикселях. Это свойство не определено для этого объекта статистики до получения первого кадра.

width Необязательно

Число, представляющее ширину последнего кадра, исходящего от этого источника, в пикселях. Это свойство не определено для этого объекта статистики до получения первого кадра.

Следующие свойства присутствуют как в RTCVideoSourceStats , так и в RTCAudioSourceStats:

trackIdentifier

Строка, содержащая значение id связанного MediaStreamTrack с источником видео.

kind

Строка, указывающая, представляет ли этот объект статистику для источника видео или источника мультимедиа. Для RTCVideoSourceStats это всегда будет video.

Следующие свойства являются общими для всех объектов статистики.

id

Строка, которая однозначно идентифицирует объект, отслеживаемый для получения этого набора статистики.

timestamp

DOMHighResTimeStamp объект, указывающий время, в которое была взята выборка для этого объекта статистики.

type

Строка со значением "media-source", указывающая, что объект является экземпляром RTCAudioSourceStats или RTCVideoSourceStats.

Интерфейс предоставляет статистику о видеоисточнике мультимедиа, подключенном к одному или нескольким отправителям. Информация включает идентификатор связанного MediaStreamTrack, а также высоту и ширину последнего кадра, отправленного из источника, количество отправленных кадров и частоту кадров.

Этот пример показывает, как можно проитерировать объект статистики, возвращённый из RTCRtpSender.getStats() , чтобы получить статистику конкретно для видеоисточника мультимедиа.

// where sender is an RTCRtpSender
const stats = await sender.getStats();
let videoSourceStats = null;

stats.forEach((report) => {
  if (report.type === "media-source" && report.kind==="video") {
    videoSourceStats = report;
    break;
  }
});

// videoSourceStats will be null if the report did not include video source stats
const frames = videoSourceStats?.frames;
const fps = videoSourceStats?.framesPerSecond;
const width = videoSourceStats?.width;
const height = videoSourceStats?.height;