События плеера
С помощью методов on и once SDK для JavaScript вы можете подписаться на события видеоплеера Cloud Video Player:
SourceChange
Переключение контента.
В объекте { source }
в обработчик поступает новая ссылка на контент.
Пример:
player.on('SourceChange', ({ source }) => {
console.log(source);
});
StatusChange
Изменение статуса воспроизведения.
В объекте { status }
в обработчик поступает новое значение статуса воспроизведения.
Пример:
player.on('StatusChange', ({ status }) => {
console.log(status);
});
ErrorChange
Появление или сброс ошибки.
В объекте { error }
в обработчик поступает ошибка.
Сброс ошибки происходит при переключении контента (если переключение возможно). В этом случае в обработчик поступает объект error
со значением undefined
.
Пример:
player.on('ErrorChange', ({ error }) => {
console.log(error);
});
CurrentTimeChange
Изменение позиции на шкале времени.
В объекте { currentTime }
в обработчик поступает новое значение текущего времени.
Пример:
player.on('CurrentTimeChange', ({ currentTime }) => {
console.log(currentTime);
});
DurationChange
Изменение длительности видео.
В объекте { duration }
в обработчик поступает новое значение длительности видео.
Событие может возникать:
- при смене контента;
- периодически для видео типа
EVENT
, так как длительность непрерывно растет; - при изменении типа видео с
LIVE
наVOD
.
Пример:
player.on('DurationChange', ({ duration }) => {
console.log(duration);
});
VideoTypeChange
Изменение типа видео.
В объекте { videoType }
в обработчик поступает новое значение типа видео.
Событие может возникать:
- при смене контента;
- при изменении типа видео с
LIVE
иEVENT
наVOD
.
Пример:
player.on('VideoTypeChange', ({ videoType }) => {
console.log(videoType);
});
MutedChange
Изменение статуса muted
(выключенного звука) видео.
В объекте { muted }
в обработчик поступает новое значение статуса muted.
Пример:
player.on('MutedChange', ({ muted }) => {
console.log(muted);
});
VolumeChange
Изменение уровня громкости звука в видео.
В объекте { volume }
в обработчик поступает новое значение уровня громкости.
Пример:
player.on('VolumeChange', ({ volume }) => {
console.log(volume);
});
UtcStartTimeChange
Изменение UTC-времени старта видео.
В объекте { utcStartTime }
в обработчик поступает новое значение UTC-времени.
Событие может возникать:
- при смене контента;
- при изменении типа видео с
LIVE
наVOD
.
Пример:
player.on('UtcStartTimeChange', ({ utcStartTime }) => {
console.log(utcStartTime);
});
SeekableRangeChange
Изменение области перемотки.
В объекте { seekableRange }
в обработчик поступает новое описание области перемотки.
Событие может возникать:
- при смене контента;
- периодически для видео типов
LIVE
иEVENT
, так как область перемотки в них непрерывно увеличивается.
Пример:
player.on('SeekableRangeChange', ({ seekableRange }) => {
console.log(seekableRange.start, seekableRange.end);
});
BufferedRangesChange
Изменение областей буферизации.
В объекте { bufferedRanges }
в обработчик поступает массив с новым описанием областей буферизации.
Пример:
player.on('BufferedRangesChange', ({ bufferedRanges }) => {
console.log(bufferedRanges);
});
См. также
- Interface: PlayerSdkEventHandlers в справочнике API