api.Events - Better Yandex Music

Методы

api.Events.on(event, handler)
api.Events.off(event, handler)

События

Событие	Аргумент handler	Когда
`play`	—	Трек начал играть
`pause`	—	Пауза
`ended`	—	Трек закончился
`trackChange`	`track: Track \| null`	Сменился трек
`speedChange`	`speed: number`	Скорость изменилась
`volumeChange`	`volume: number` (0–1)	Громкость изменилась
`seeked`	`position: number` (сек)	Перемотка

Тип Track: { title, artist, album, artwork }

api.Events.on не снимается автоматически при stop(). Снимай вручную через api.Events.off.

Как работает trackChange

BYM полингует navigator.mediaSession.metadata раз в 500мс. При смене title + artist — эмиттит trackChange. Задержка до 500мс — норма.

Пример

BYM.register({ id: 'event-demo' }, (api) => {
  function onTrack(track) {
    api.Logger.log('Трек:', track?.title ?? 'нет трека');
  }
  function onVolume(vol) {
    api.Logger.log('Громкость:', Math.round(vol * 100) + '%');
  }

  return {
    start() {
      api.Events.on('trackChange',  onTrack);
      api.Events.on('volumeChange', onVolume);
    },
    stop() {
      api.Events.off('trackChange',  onTrack);
      api.Events.off('volumeChange', onVolume);
    },
  };
});