Adds parameterized invariant tests (Schedule_clock_padded_offline_multimode) exercising schedule-level clock pad + offline advance across a 2-day window (two midnight crossings) through Flood, Duration, and Multiple — previously only PlayoutModeSchedulerOne had any coverage. Fixture uses sub-15-min content so each padded item occupies one :15 slot and Duration's fill-the-block contract tiles exactly (no off-boundary packing). Part 2 (precision): replaces the day-boundary anchor-clamp magnitude heuristic (overrun <= one pad interval on a padded schedule) with a precise signal — the last scheduler now reports the exact offline-pad target it advanced CurrentTime to (transient PlayoutSchedulerResult.ClockPadOfflineTarget, never persisted), and the clamp exempts only when CurrentTime equals that target exactly. A non-offline overrun (Duration/Flood/Multiple ending short of its natural end, a hard-stop, a tail advance) changes CurrentTime away from the target and still clamps, so persisted NextStart no longer shifts by up to an interval. No persisted-schema/migration change. Output byte-identical for all existing goldens. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
223 lines
9.0 KiB
C#
223 lines
9.0 KiB
C#
using ErsatzTV.Core.Domain;
|
|
using ErsatzTV.Core.Domain.Filler;
|
|
using ErsatzTV.Core.Extensions;
|
|
using ErsatzTV.Core.Interfaces.Scheduling;
|
|
using LanguageExt.UnsafeValueAccess;
|
|
using Microsoft.Extensions.Logging;
|
|
|
|
namespace ErsatzTV.Core.Scheduling;
|
|
|
|
public class PlayoutModeSchedulerFlood(ILogger logger) : PlayoutModeSchedulerBase<ProgramScheduleItemFlood>(logger)
|
|
{
|
|
public override PlayoutSchedulerResult Schedule(
|
|
PlayoutBuilderState playoutBuilderState,
|
|
Dictionary<CollectionKey, IMediaCollectionEnumerator> collectionEnumerators,
|
|
ProgramScheduleItemFlood scheduleItem,
|
|
ProgramScheduleItem nextScheduleItem,
|
|
DateTimeOffset hardStop,
|
|
Random random,
|
|
CancellationToken cancellationToken)
|
|
{
|
|
var warnings = new PlayoutBuildWarnings();
|
|
var playoutItems = new List<PlayoutItem>();
|
|
|
|
PlayoutBuilderState nextState = playoutBuilderState;
|
|
var willFinishInTime = true;
|
|
DateTimeOffset? clockPadOfflineTarget = null;
|
|
|
|
IMediaCollectionEnumerator contentEnumerator =
|
|
collectionEnumerators[CollectionKey.ForScheduleItem(scheduleItem)];
|
|
|
|
ProgramScheduleItem peekScheduleItem = nextScheduleItem;
|
|
|
|
var scheduledNone = false;
|
|
|
|
while (contentEnumerator.Current.IsSome && nextState.CurrentTime < hardStop && willFinishInTime)
|
|
{
|
|
MediaItem mediaItem = contentEnumerator.Current.ValueUnsafe();
|
|
|
|
// find when we should start this item, based on the current time
|
|
DateTimeOffset itemStartTime = GetStartTimeAfter(nextState, scheduleItem, Option<ILogger>.Some(Logger));
|
|
if (itemStartTime >= hardStop)
|
|
{
|
|
scheduledNone = playoutItems.Count == 0;
|
|
nextState = nextState with { CurrentTime = hardStop };
|
|
break;
|
|
}
|
|
|
|
TimeSpan itemDuration = mediaItem.GetDurationForPlayout();
|
|
|
|
// never block scheduling when there is only one schedule item (with fixed start and flood)
|
|
DateTimeOffset peekScheduleItemStart =
|
|
scheduleItem.Id != peekScheduleItem.Id && peekScheduleItem.StartType == StartType.Fixed
|
|
? GetStartTimeAfter(nextState with { InFlood = true }, peekScheduleItem, Option<ILogger>.None, true)
|
|
: DateTimeOffset.MaxValue;
|
|
|
|
if (itemDuration == TimeSpan.Zero && mediaItem is RemoteStream)
|
|
{
|
|
itemDuration = itemStartTime != peekScheduleItemStart && peekScheduleItemStart < hardStop
|
|
? peekScheduleItemStart - itemStartTime
|
|
: hardStop - itemStartTime;
|
|
}
|
|
|
|
List<MediaChapter> itemChapters = ChaptersForMediaItem(mediaItem);
|
|
|
|
var playoutItem = new PlayoutItem
|
|
{
|
|
PlayoutId = playoutBuilderState.PlayoutId,
|
|
MediaItemId = mediaItem.Id,
|
|
Start = itemStartTime.UtcDateTime,
|
|
Finish = itemStartTime.UtcDateTime + itemDuration,
|
|
InPoint = TimeSpan.Zero,
|
|
OutPoint = itemDuration,
|
|
GuideGroup = nextState.NextGuideGroup,
|
|
FillerKind = scheduleItem.GuideMode == GuideMode.Filler ||
|
|
contentEnumerator.CurrentIncludeInProgramGuide == false
|
|
? FillerKind.GuideMode
|
|
: FillerKind.None,
|
|
CustomTitle = scheduleItem.CustomTitle,
|
|
PreferredAudioLanguageCode = scheduleItem.PreferredAudioLanguageCode,
|
|
PreferredAudioTitle = scheduleItem.PreferredAudioTitle,
|
|
PreferredSubtitleLanguageCode = scheduleItem.PreferredSubtitleLanguageCode,
|
|
SubtitleMode = scheduleItem.SubtitleMode,
|
|
PlayoutItemWatermarks = [],
|
|
PlayoutItemGraphicsElements = [],
|
|
SchedulingContext = GetSchedulingContext(scheduleItem, null, contentEnumerator)
|
|
};
|
|
|
|
foreach (ProgramScheduleItemWatermark programScheduleItemWatermark in scheduleItem
|
|
.ProgramScheduleItemWatermarks ?? [])
|
|
{
|
|
playoutItem.PlayoutItemWatermarks.Add(
|
|
new PlayoutItemWatermark
|
|
{
|
|
PlayoutItem = playoutItem,
|
|
WatermarkId = programScheduleItemWatermark.WatermarkId
|
|
});
|
|
}
|
|
|
|
foreach (ProgramScheduleItemGraphicsElement programScheduleItemGraphicsElement in scheduleItem
|
|
.ProgramScheduleItemGraphicsElements ?? [])
|
|
{
|
|
playoutItem.PlayoutItemGraphicsElements.Add(
|
|
new PlayoutItemGraphicsElement
|
|
{
|
|
PlayoutItem = playoutItem,
|
|
GraphicsElementId = programScheduleItemGraphicsElement.GraphicsElementId
|
|
});
|
|
}
|
|
|
|
var enumeratorStates = new Dictionary<CollectionKey, CollectionEnumeratorState>();
|
|
foreach ((CollectionKey key, IMediaCollectionEnumerator enumerator) in collectionEnumerators)
|
|
{
|
|
enumeratorStates.Add(key, enumerator.State.Clone());
|
|
}
|
|
|
|
(List<PlayoutItem> maybePlayoutItems, DateTimeOffset? clockPadTarget) = AddFiller(
|
|
nextState,
|
|
collectionEnumerators,
|
|
scheduleItem,
|
|
playoutItem,
|
|
itemChapters,
|
|
warnings,
|
|
cancellationToken);
|
|
|
|
DateTimeOffset itemEndTimeWithFiller = maybePlayoutItems.Max(pi => pi.FinishOffset);
|
|
DateTimeOffset? itemClockPadOfflineTarget = null;
|
|
if (clockPadTarget is { } floodPadTarget && floodPadTarget > itemEndTimeWithFiller)
|
|
{
|
|
itemEndTimeWithFiller = floodPadTarget;
|
|
itemClockPadOfflineTarget = floodPadTarget;
|
|
}
|
|
|
|
// if the next schedule item is supposed to start during this item,
|
|
// don't schedule this item and just move on
|
|
willFinishInTime = peekScheduleItemStart < itemStartTime ||
|
|
peekScheduleItemStart >= itemEndTimeWithFiller;
|
|
|
|
if (willFinishInTime)
|
|
{
|
|
playoutItems.AddRange(maybePlayoutItems);
|
|
clockPadOfflineTarget = itemClockPadOfflineTarget;
|
|
// LogScheduledItem(scheduleItem, mediaItem, itemStartTime);
|
|
|
|
nextState = nextState with
|
|
{
|
|
CurrentTime = itemEndTimeWithFiller,
|
|
InFlood = true,
|
|
|
|
// only bump guide group if we don't have a custom title
|
|
NextGuideGroup = string.IsNullOrWhiteSpace(scheduleItem.CustomTitle)
|
|
? nextState.IncrementGuideGroup
|
|
: nextState.NextGuideGroup
|
|
};
|
|
|
|
contentEnumerator.MoveNext(itemStartTime);
|
|
}
|
|
else
|
|
{
|
|
// reset enumerators
|
|
foreach ((CollectionKey key, IMediaCollectionEnumerator enumerator) in collectionEnumerators)
|
|
{
|
|
enumerator.ResetState(enumeratorStates[key]);
|
|
}
|
|
}
|
|
}
|
|
|
|
// _logger.LogDebug(
|
|
// "Advancing to next schedule item after playout mode {PlayoutMode}",
|
|
// "Flood");
|
|
|
|
nextState = nextState with
|
|
{
|
|
InFlood = playoutItems.Count != 0 && nextState.CurrentTime >= hardStop,
|
|
|
|
// only decrement guide group if it was bumped
|
|
NextGuideGroup = playoutItems.Select(pi => pi.GuideGroup).Distinct().Count() != 1
|
|
? nextState.DecrementGuideGroup
|
|
: nextState.NextGuideGroup
|
|
};
|
|
|
|
// only advance to the next schedule item if we aren't still in a flood
|
|
if (!nextState.InFlood && !scheduledNone)
|
|
{
|
|
nextState.ScheduleItemsEnumerator.MoveNext();
|
|
}
|
|
|
|
ProgramScheduleItem peekItem = nextScheduleItem;
|
|
DateTimeOffset peekItemStart = GetFillerStartTimeAfter(nextState, peekItem, hardStop);
|
|
|
|
if (scheduleItem.TailFiller != null)
|
|
{
|
|
(nextState, playoutItems) = AddTailFiller(
|
|
nextState,
|
|
collectionEnumerators,
|
|
scheduleItem,
|
|
playoutItems,
|
|
peekItemStart,
|
|
warnings,
|
|
cancellationToken);
|
|
}
|
|
|
|
if (scheduleItem.FallbackFiller != null)
|
|
{
|
|
(nextState, playoutItems) = AddFallbackFiller(
|
|
nextState,
|
|
collectionEnumerators,
|
|
scheduleItem,
|
|
playoutItems,
|
|
peekItemStart,
|
|
cancellationToken);
|
|
}
|
|
|
|
nextState = nextState with { NextGuideGroup = nextState.IncrementGuideGroup };
|
|
|
|
return new PlayoutSchedulerResult(nextState, playoutItems, warnings)
|
|
{
|
|
ClockPadOfflineTarget = clockPadOfflineTarget
|
|
};
|
|
}
|
|
|
|
protected override string SchedulingContextName => "Flood";
|
|
}
|