#nullable disable #pragma warning disable CS1591 using System; using System.Collections.Generic; using System.Globalization; using System.Linq; using System.Text.Json.Serialization; using Jellyfin.Data.Enums; using MediaBrowser.Controller.Providers; using MediaBrowser.Model.Entities; using MediaBrowser.Model.IO; using MediaBrowser.Model.Providers; using Microsoft.Extensions.Logging; namespace MediaBrowser.Controller.Entities.TV { /// /// Class Episode. /// public class Episode : Video, IHasTrailers, IHasLookupInfo, IHasSeries { /// [JsonIgnore] public IReadOnlyList LocalTrailers => GetExtras() .Where(extra => extra.ExtraType == Model.Entities.ExtraType.Trailer) .ToArray(); /// /// Gets or sets the season in which it aired. /// /// The aired season. public int? AirsBeforeSeasonNumber { get; set; } public int? AirsAfterSeasonNumber { get; set; } public int? AirsBeforeEpisodeNumber { get; set; } /// /// Gets or sets the ending episode number for double episodes. /// /// The index number. public int? IndexNumberEnd { get; set; } [JsonIgnore] protected override bool SupportsOwnedItems => IsStacked || MediaSourceCount > 1; [JsonIgnore] public override bool SupportsInheritedParentImages => true; [JsonIgnore] public override bool SupportsPeople => true; [JsonIgnore] public int? AiredSeasonNumber => AirsAfterSeasonNumber ?? AirsBeforeSeasonNumber ?? ParentIndexNumber; [JsonIgnore] public override Folder LatestItemsIndexContainer => Series; [JsonIgnore] public override Guid DisplayParentId => SeasonId; [JsonIgnore] protected override bool EnableDefaultVideoUserDataKeys => false; /// /// Gets the Episode's Series Instance. /// /// The series. [JsonIgnore] public Series Series { get { var seriesId = SeriesId; if (seriesId.Equals(default)) { seriesId = FindSeriesId(); } return seriesId.Equals(default) ? null : (LibraryManager.GetItemById(seriesId) as Series); } } [JsonIgnore] public Season Season { get { var seasonId = SeasonId; if (seasonId.Equals(default)) { seasonId = FindSeasonId(); } return seasonId.Equals(default) ? null : (LibraryManager.GetItemById(seasonId) as Season); } } [JsonIgnore] public bool IsInSeasonFolder => FindParent() != null; [JsonIgnore] public string SeriesPresentationUniqueKey { get; set; } [JsonIgnore] public string SeriesName { get; set; } [JsonIgnore] public string SeasonName { get; set; } [JsonIgnore] public override bool SupportsRemoteImageDownloading { get { if (IsMissingEpisode) { return false; } return true; } } [JsonIgnore] public bool IsMissingEpisode => LocationType == LocationType.Virtual; [JsonIgnore] public Guid SeasonId { get; set; } [JsonIgnore] public Guid SeriesId { get; set; } public string FindSeriesSortName() { var series = Series; return series == null ? SeriesName : series.SortName; } public override double GetDefaultPrimaryImageAspectRatio() { // hack for tv plugins if (SourceType == SourceType.Channel) { return 0; } return 16.0 / 9; } public override List GetUserDataKeys() { var list = base.GetUserDataKeys(); var series = Series; if (series != null && ParentIndexNumber.HasValue && IndexNumber.HasValue) { var seriesUserDataKeys = series.GetUserDataKeys(); var take = seriesUserDataKeys.Count; if (seriesUserDataKeys.Count > 1) { take--; } var newList = seriesUserDataKeys.GetRange(0, take); var suffix = ParentIndexNumber.Value.ToString("000", CultureInfo.InvariantCulture) + IndexNumber.Value.ToString("000", CultureInfo.InvariantCulture); for (int i = 0; i < take; i++) { newList[i] = newList[i] + suffix; } newList.AddRange(list); list = newList; } return list; } public string FindSeriesPresentationUniqueKey() { var series = Series; return series == null ? null : series.PresentationUniqueKey; } public string FindSeasonName() { var season = Season; if (season == null) { if (ParentIndexNumber.HasValue) { return "Season " + ParentIndexNumber.Value.ToString(CultureInfo.InvariantCulture); } return "Season Unknown"; } return season.Name; } public string FindSeriesName() { var series = Series; return series == null ? SeriesName : series.Name; } public Guid FindSeasonId() { var season = FindParent(); // Episodes directly in series folder if (season == null) { var series = Series; if (series != null && ParentIndexNumber.HasValue) { var findNumber = ParentIndexNumber.Value; season = series.Children .OfType() .FirstOrDefault(i => i.IndexNumber.HasValue && i.IndexNumber.Value == findNumber); } } return season == null ? Guid.Empty : season.Id; } /// /// Creates the name of the sort. /// /// System.String. protected override string CreateSortName() { return (ParentIndexNumber != null ? ParentIndexNumber.Value.ToString("000 - ", CultureInfo.InvariantCulture) : string.Empty) + (IndexNumber != null ? IndexNumber.Value.ToString("0000 - ", CultureInfo.InvariantCulture) : string.Empty) + Name; } /// /// Determines whether [contains episode number] [the specified number]. /// /// The number. /// true if [contains episode number] [the specified number]; otherwise, false. public bool ContainsEpisodeNumber(int number) { if (IndexNumber.HasValue) { if (IndexNumberEnd.HasValue) { return number >= IndexNumber.Value && number <= IndexNumberEnd.Value; } return IndexNumber.Value == number; } return false; } public Guid FindSeriesId() { var series = FindParent(); return series == null ? Guid.Empty : series.Id; } public override IEnumerable GetAncestorIds() { var list = base.GetAncestorIds().ToList(); var seasonId = SeasonId; if (!seasonId.Equals(default) && !list.Contains(seasonId)) { list.Add(seasonId); } return list; } public override IEnumerable GetDeletePaths() { return new[] { new FileSystemMetadata { FullName = Path, IsDirectory = IsFolder } }.Concat(GetLocalMetadataFilesToDelete()); } public override UnratedItem GetBlockUnratedType() { return UnratedItem.Series; } public EpisodeInfo GetLookupInfo() { var id = GetItemLookupInfo(); var series = Series; if (series != null) { id.SeriesProviderIds = series.ProviderIds; id.SeriesDisplayOrder = series.DisplayOrder; } id.IsMissingEpisode = IsMissingEpisode; id.IndexNumberEnd = IndexNumberEnd; return id; } public override bool BeforeMetadataRefresh(bool replaceAllMetadata) { var hasChanges = base.BeforeMetadataRefresh(replaceAllMetadata); if (!IsLocked) { if (SourceType == SourceType.Library) { try { if (LibraryManager.FillMissingEpisodeNumbersFromPath(this, replaceAllMetadata)) { hasChanges = true; } } catch (Exception ex) { Logger.LogError(ex, "Error in FillMissingEpisodeNumbersFromPath. Episode: {Episode}", Path ?? Name ?? Id.ToString()); } } } return hasChanges; } public override List GetRelatedUrls() { var list = base.GetRelatedUrls(); var imdbId = this.GetProviderId(MetadataProvider.Imdb); if (!string.IsNullOrEmpty(imdbId)) { list.Add(new ExternalUrl { Name = "Trakt", Url = string.Format(CultureInfo.InvariantCulture, "https://trakt.tv/episodes/{0}", imdbId) }); } return list; } } }