RTCRtpReceiver: свойство jitterBufferTarget

Свойство jitterBufferTarget интерфейса RTCRtpReceiver — это DOMHighResTimeStamp, указывающее предпочтительную длительность, в миллисекундах, на которую буфер джиттера должен удерживать медиа перед её воспроизведением.

Приложение может использовать его для влияния на баланс между задержкой воспроизведения и риском исчерпания аудио- или видеокадров из-за джиттера сети.

A DOMHighResTimeStamp указывающий текущую целевую длительность удержания буфера джиттера в миллисекундах.

Значение может быть установлено в положительное значение, не превышающее 4000 миллисекунд.

RangeError

Выбрасывается, если целевое значение установлено в отрицательное значение или значение, превышающее 4000 миллисекунд.

Значение атрибута влияет на количество буферизации, выполняемой браузером, что, в свою очередь, влияет на повторные передачи и восстановление потерянных пакетов.

Обратите внимание, что атрибут «влияет» на целевое значение буфера джиттера браузера, но не устанавливает его напрямую. Фактическое целевое значение буфера джиттера браузера будет изменяться между максимальными и минимальными допустимыми значениями, которые отражают целевой диапазон, который браузер может предоставить в зависимости от сетевых условий и ограничений памяти, и может изменяться в любое время. Значение, возвращаемое jitterBufferTarget, не зависит от фактического целевого значения браузера.

Среднюю задержку буфера джиттера можно рассчитать, разделив RTCInboundRtpStreamStats.jitterBufferDelay на RTCInboundRtpStreamStats.jitterBufferEmittedCount. Чтобы наблюдать эффекты изменения целевого значения буфера джиттера, вы можете отслеживать изменение значения этого среднего значения со временем.

Если RTCRtpReceiver аудио и видео дорожки синхронизированы, то большее из двух значений jitterBufferTarget должно использоваться для обоих приемников.