AzuraCast/src/Radio/AutoDJ/Scheduler.php

452 lines
14 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Radio\AutoDJ;
use App\Doctrine\ReloadableEntityManagerInterface;
use App\Entity;
use App\Entity\Repository\StationPlaylistMediaRepository;
use App\Entity\Repository\StationQueueRepository;
use Carbon\CarbonImmutable;
use Carbon\CarbonInterface;
use Doctrine\Common\Collections\Collection;
use Monolog\Logger;
use Monolog\LogRecord;
class Scheduler
{
public function __construct(
protected Logger $logger,
protected StationPlaylistMediaRepository $spmRepo,
protected StationQueueRepository $queueRepo,
protected ReloadableEntityManagerInterface $em,
) {
}
public function shouldPlaylistPlayNow(
Entity\StationPlaylist $playlist,
CarbonInterface $now = null,
array $recentPlaylistHistory = []
): bool {
$this->logger->pushProcessor(
function (LogRecord $record) use ($playlist) {
$record->extra['playlist'] = [
'id' => $playlist->getId(),
'name' => $playlist->getName(),
];
return $record;
}
);
if (null === $now) {
$now = CarbonImmutable::now($playlist->getStation()->getTimezoneObject());
}
if (!$this->isPlaylistScheduledToPlayNow($playlist, $now)) {
$this->logger->debug('Playlist is not scheduled to play now.');
$this->logger->popProcessor();
return false;
}
$shouldPlay = true;
switch ($playlist->getTypeEnum()) {
case Entity\Enums\PlaylistTypes::OncePerHour:
$shouldPlay = $this->shouldPlaylistPlayNowPerHour($playlist, $now);
$this->logger->debug(
sprintf(
'Once-per-hour playlist %s been played yet this hour.',
$shouldPlay ? 'HAS NOT' : 'HAS'
)
);
break;
case Entity\Enums\PlaylistTypes::OncePerXSongs:
$playPerSongs = $playlist->getPlayPerSongs();
$shouldPlay = !$this->wasPlaylistPlayedRecently($playlist, $recentPlaylistHistory, $playPerSongs);
$this->logger->debug(
sprintf(
'Once-per-X-songs playlist %s been played within the last %d song(s).',
$shouldPlay ? 'HAS NOT' : 'HAS',
$playPerSongs
)
);
break;
case Entity\Enums\PlaylistTypes::OncePerXMinutes:
$playPerMinutes = $playlist->getPlayPerMinutes();
$shouldPlay = !$this->wasPlaylistPlayedInLastXMinutes($playlist, $now, $playPerMinutes);
$this->logger->debug(
sprintf(
'Once-per-X-minutes playlist %s been played within the last %d minute(s).',
$shouldPlay ? 'HAS NOT' : 'HAS',
$playPerMinutes
)
);
break;
case Entity\Enums\PlaylistTypes::Advanced:
$this->logger->debug('Playlist is "Advanced" type and is not managed by the AutoDJ.');
$shouldPlay = false;
break;
case Entity\Enums\PlaylistTypes::Standard:
break;
}
$this->logger->popProcessor();
return $shouldPlay;
}
public function isPlaylistScheduledToPlayNow(
Entity\StationPlaylist $playlist,
CarbonInterface $now
): bool {
$scheduleItems = $playlist->getScheduleItems();
if (0 === $scheduleItems->count()) {
$this->logger->debug('Playlist has no schedule items; skipping schedule time check.');
return true;
}
$scheduleItem = $this->getActiveScheduleFromCollection($scheduleItems, $now);
return null !== $scheduleItem;
}
protected function shouldPlaylistPlayNowPerHour(
Entity\StationPlaylist $playlist,
CarbonInterface $now
): bool {
$current_minute = $now->minute;
$target_minute = $playlist->getPlayPerHourMinute();
if ($current_minute < $target_minute) {
$target_time = $now->subHour()->minute($target_minute);
} else {
$target_time = $now->minute($target_minute);
}
$playlist_diff = $target_time->diffInMinutes($now, false);
if ($playlist_diff < 0 || $playlist_diff > 15) {
return false;
}
return !$this->wasPlaylistPlayedInLastXMinutes($playlist, $now, 30);
}
protected function wasPlaylistPlayedInLastXMinutes(
Entity\StationPlaylist $playlist,
CarbonInterface $now,
int $minutes
): bool {
$playedAt = $playlist->getPlayedAt();
if (0 === $playedAt) {
return false;
}
$threshold = $now->subMinutes($minutes)->getTimestamp();
return ($playedAt > $threshold);
}
protected function wasPlaylistPlayedRecently(
Entity\StationPlaylist $playlist,
array $recentPlaylistHistory = [],
int $length = 15
): bool {
if (empty($recentPlaylistHistory)) {
return false;
}
$playlistId = $playlist->getIdRequired();
// Only consider playlists that are this playlist or are non-jingles.
$relevantSongHistory = array_slice(
array_filter(
$recentPlaylistHistory,
static function ($row) use ($playlistId) {
return $playlistId === $row['playlist_id']
? true
: $row['is_visible'];
}
),
0,
$length
);
foreach ($relevantSongHistory as $sh_row) {
if ($playlistId === (int)$sh_row['playlist_id']) {
return true;
}
}
return false;
}
/**
* Get the duration of scheduled play time in seconds (used for remote URLs of indeterminate length).
*
* @param Entity\StationPlaylist $playlist
*/
public function getPlaylistScheduleDuration(Entity\StationPlaylist $playlist): int
{
$now = CarbonImmutable::now($playlist->getStation()->getTimezoneObject());
$scheduleItem = $this->getActiveScheduleFromCollection(
$playlist->getScheduleItems(),
$now
);
if ($scheduleItem instanceof Entity\StationSchedule) {
return $scheduleItem->getDuration();
}
return 0;
}
public function canStreamerStreamNow(
Entity\StationStreamer $streamer,
CarbonInterface $now = null
): bool {
if (!$streamer->enforceSchedule()) {
return true;
}
if (null === $now) {
$now = CarbonImmutable::now($streamer->getStation()->getTimezoneObject());
}
$scheduleItem = $this->getActiveScheduleFromCollection(
$streamer->getScheduleItems(),
$now
);
return null !== $scheduleItem;
}
/**
* @param Collection<int, Entity\StationSchedule> $scheduleItems
* @param CarbonInterface $now
* @return Entity\StationSchedule|null
*/
protected function getActiveScheduleFromCollection(
Collection $scheduleItems,
CarbonInterface $now
): ?Entity\StationSchedule {
if ($scheduleItems->count() > 0) {
foreach ($scheduleItems as $scheduleItem) {
$scheduleName = (string)$scheduleItem;
if ($this->shouldSchedulePlayNow($scheduleItem, $now)) {
$this->logger->debug(
sprintf(
'%s - Should Play Now',
$scheduleName
)
);
return $scheduleItem;
}
$this->logger->debug(
sprintf(
'%s - Not Eligible to Play Now',
$scheduleName
)
);
}
}
return null;
}
public function shouldSchedulePlayNow(
Entity\StationSchedule $schedule,
CarbonInterface $now
): bool {
$startTime = Entity\StationSchedule::getDateTime($schedule->getStartTime(), $now);
$endTime = Entity\StationSchedule::getDateTime($schedule->getEndTime(), $now);
$this->logger->debug('Checking to see whether schedule should play now.', [
'startTime' => $startTime,
'endTime' => $endTime,
]);
if (!$this->shouldSchedulePlayOnCurrentDate($schedule, $now)) {
$this->logger->debug('Schedule is not scheduled to play today.');
return false;
}
$comparePeriods = [];
if ($startTime->equalTo($endTime)) {
// Create intervals for "play once" type dates.
$comparePeriods[] = [$startTime, $endTime->addMinutes(15)];
$comparePeriods[] = [$startTime->subDay(), $endTime->subDay()->addMinutes(15)];
$comparePeriods[] = [$startTime->addDay(), $endTime->addDay()->addMinutes(15)];
} elseif ($startTime->greaterThan($endTime)) {
// Create intervals for overnight playlists (one from yesterday to today, one from today to tomorrow).
$comparePeriods[] = [$startTime->subDay(), $endTime];
$comparePeriods[] = [$startTime, $endTime->addDay()];
} else {
$comparePeriods[] = [$startTime, $endTime];
}
foreach ($comparePeriods as [$start, $end]) {
if ($this->shouldPlayInSchedulePeriod($schedule, $start, $end, $now)) {
return true;
}
}
return false;
}
protected function shouldPlayInSchedulePeriod(
Entity\StationSchedule $schedule,
CarbonInterface $start,
CarbonInterface $end,
CarbonInterface $now
): bool {
if (!$now->between($start, $end)) {
return false;
}
// Check day-of-week limitations.
$dayToCheck = $start->dayOfWeekIso;
if (!$this->isScheduleScheduledToPlayToday($schedule, $dayToCheck)) {
return false;
}
// Check playlist special handling rules.
$playlist = $schedule->getPlaylist();
if (null === $playlist) {
return true;
}
// Handle "Play Single Track" advanced setting.
if (
$playlist->backendPlaySingleTrack()
&& $playlist->getPlayedAt() >= $start->getTimestamp()
) {
return false;
}
// Handle "Loop Once" schedule specification.
if (
$schedule->getLoopOnce()
&& !$this->shouldPlaylistLoopNow($schedule, $now, $start, $end)
) {
return false;
}
return true;
}
protected function shouldPlaylistLoopNow(
Entity\StationSchedule $schedule,
CarbonInterface $now,
CarbonInterface $startTime,
CarbonInterface $endTime
): bool {
$this->logger->debug('Checking if playlist should loop now.');
$playlist = $schedule->getPlaylist();
if (null === $playlist) {
$this->logger->error('Attempting to check playlist loop status on a non-playlist-based schedule item.');
return false;
}
$playlistPlayedAt = CarbonImmutable::createFromTimestamp(
$playlist->getPlayedAt(),
$now->getTimezone()
);
$isQueueEmpty = $this->spmRepo->isQueueEmpty($playlist);
$hasCuedPlaylistMedia = $this->queueRepo->hasCuedPlaylistMedia($playlist);
if (!$playlistPlayedAt->between($startTime, $endTime)) {
$this->logger->debug('Playlist was not played yet.');
$isQueueFilled = $this->spmRepo->isQueueCompletelyFilled($playlist);
if ((!$isQueueFilled || $isQueueEmpty) && !$hasCuedPlaylistMedia) {
$now = $startTime->subSecond();
$this->logger->debug('Resetting playlist queue with now override', [$now]);
$this->spmRepo->resetQueue($playlist, $now);
$isQueueEmpty = false;
}
} elseif ($isQueueEmpty && !$hasCuedPlaylistMedia) {
$this->logger->debug('Resetting playlist queue.');
$this->spmRepo->resetQueue($playlist);
$isQueueEmpty = false;
}
$playlist = $this->em->refetch($playlist);
$playlistQueueResetAt = CarbonImmutable::createFromTimestamp(
$playlist->getQueueResetAt(),
$now->getTimezone()
);
if (!$isQueueEmpty && !$playlistQueueResetAt->between($startTime, $endTime)) {
$this->logger->debug('Playlist should loop.');
return true;
}
$this->logger->debug('Playlist should NOT loop.');
return false;
}
public function shouldSchedulePlayOnCurrentDate(
Entity\StationSchedule $schedule,
CarbonInterface $now
): bool {
$startDate = $schedule->getStartDate();
$endDate = $schedule->getEndDate();
if (!empty($startDate)) {
$startDate = CarbonImmutable::createFromFormat('Y-m-d', $startDate, $now->getTimezone());
if (false !== $startDate) {
$startDate = $startDate->setTime(0, 0);
if ($now->lt($startDate)) {
return false;
}
}
}
if (!empty($endDate)) {
$endDate = CarbonImmutable::createFromFormat('Y-m-d', $endDate, $now->getTimezone());
if (false !== $endDate) {
$endDate = $endDate->setTime(23, 59, 59);
if ($now->gt($endDate)) {
return false;
}
}
}
return true;
}
/**
* Given an ISO-8601 date, return if the playlist can be played on that day.
*
* @param Entity\StationSchedule $schedule
* @param int $dayToCheck ISO-8601 date (1 for Monday, 7 for Sunday)
*/
public function isScheduleScheduledToPlayToday(
Entity\StationSchedule $schedule,
int $dayToCheck
): bool {
$playOnceDays = $schedule->getDays();
return empty($playOnceDays)
|| in_array($dayToCheck, $playOnceDays, true);
}
}