jellyfin-server/MediaBrowser.Controller/LiveTv/ILiveTvManager.cs

398 lines
17 KiB
C#
Raw Normal View History

2016-03-02 18:42:39 +00:00
using System;
2015-04-12 18:58:21 +00:00
using MediaBrowser.Controller.Dto;
2014-10-15 04:11:40 +00:00
using MediaBrowser.Controller.Entities;
2014-06-07 19:46:24 +00:00
using MediaBrowser.Model.Dto;
2015-08-21 19:25:35 +00:00
using MediaBrowser.Model.Entities;
2013-12-15 01:17:57 +00:00
using MediaBrowser.Model.LiveTv;
2013-11-25 20:39:23 +00:00
using MediaBrowser.Model.Querying;
using System.Collections.Generic;
using System.Threading;
2013-11-26 21:36:11 +00:00
using System.Threading.Tasks;
2016-06-08 06:21:13 +00:00
using MediaBrowser.Model.Events;
2016-10-05 07:15:29 +00:00
using MediaBrowser.Controller.Library;
namespace MediaBrowser.Controller.LiveTv
{
/// <summary>
/// Manages all live tv services installed on the server
/// </summary>
public interface ILiveTvManager
{
/// <summary>
/// Gets the services.
/// </summary>
/// <value>The services.</value>
IReadOnlyList<ILiveTvService> Services { get; }
2013-12-17 20:02:12 +00:00
/// <summary>
/// Gets the new timer defaults asynchronous.
/// </summary>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task{TimerInfo}.</returns>
2013-12-18 05:44:46 +00:00
Task<SeriesTimerInfoDto> GetNewTimerDefaults(CancellationToken cancellationToken);
/// <summary>
/// Gets the new timer defaults.
/// </summary>
/// <param name="programId">The program identifier.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task{SeriesTimerInfoDto}.</returns>
Task<SeriesTimerInfoDto> GetNewTimerDefaults(string programId, CancellationToken cancellationToken);
2016-09-25 18:39:13 +00:00
/// <summary>
/// Deletes the recording.
/// </summary>
/// <param name="id">The identifier.</param>
/// <returns>Task.</returns>
Task DeleteRecording(string id);
2016-02-12 04:54:00 +00:00
/// <summary>
/// Deletes the recording.
/// </summary>
/// <param name="recording">The recording.</param>
/// <returns>Task.</returns>
2016-03-19 21:34:43 +00:00
Task DeleteRecording(BaseItem recording);
2016-09-25 18:39:13 +00:00
/// <summary>
/// Cancels the timer.
/// </summary>
/// <param name="id">The identifier.</param>
/// <returns>Task.</returns>
Task CancelTimer(string id);
2013-12-04 20:55:42 +00:00
2013-12-15 14:19:24 +00:00
/// <summary>
/// Cancels the series timer.
/// </summary>
/// <param name="id">The identifier.</param>
/// <returns>Task.</returns>
Task CancelSeriesTimer(string id);
2015-07-23 13:23:22 +00:00
/// <summary>
/// Adds the parts.
/// </summary>
/// <param name="services">The services.</param>
2015-07-23 13:23:22 +00:00
/// <param name="tunerHosts">The tuner hosts.</param>
/// <param name="listingProviders">The listing providers.</param>
void AddParts(IEnumerable<ILiveTvService> services, IEnumerable<ITunerHost> tunerHosts, IEnumerable<IListingsProvider> listingProviders);
/// <summary>
/// Gets the recording.
/// </summary>
/// <param name="id">The identifier.</param>
2015-04-12 18:58:21 +00:00
/// <param name="options">The options.</param>
/// <param name="cancellationToken">The cancellation token.</param>
2015-04-12 18:58:21 +00:00
/// <param name="user">The user.</param>
/// <returns>Task{RecordingInfoDto}.</returns>
2015-05-31 18:22:51 +00:00
Task<BaseItemDto> GetRecording(string id, DtoOptions options, CancellationToken cancellationToken, User user = null);
2016-09-25 18:39:13 +00:00
/// <summary>
/// Gets the timer.
/// </summary>
/// <param name="id">The identifier.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task{TimerInfoDto}.</returns>
Task<TimerInfoDto> GetTimer(string id, CancellationToken cancellationToken);
2013-12-15 01:17:57 +00:00
/// <summary>
/// Gets the series timer.
/// </summary>
/// <param name="id">The identifier.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task{TimerInfoDto}.</returns>
Task<SeriesTimerInfoDto> GetSeriesTimer(string id, CancellationToken cancellationToken);
2015-04-12 18:58:21 +00:00
2013-11-24 20:51:45 +00:00
/// <summary>
2013-11-26 02:53:48 +00:00
/// Gets the recordings.
2013-11-24 20:51:45 +00:00
/// </summary>
2013-11-26 21:36:11 +00:00
/// <param name="query">The query.</param>
2015-04-12 18:58:21 +00:00
/// <param name="options">The options.</param>
2013-11-26 21:36:11 +00:00
/// <param name="cancellationToken">The cancellation token.</param>
2013-11-26 02:53:48 +00:00
/// <returns>QueryResult{RecordingInfoDto}.</returns>
2015-05-31 18:22:51 +00:00
Task<QueryResult<BaseItemDto>> GetRecordings(RecordingQuery query, DtoOptions options, CancellationToken cancellationToken);
Task<QueryResult<BaseItemDto>> GetRecordingSeries(RecordingQuery query, DtoOptions options, CancellationToken cancellationToken);
2013-11-24 20:51:45 +00:00
2013-11-27 19:04:19 +00:00
/// <summary>
/// Gets the timers.
/// </summary>
/// <param name="query">The query.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task{QueryResult{TimerInfoDto}}.</returns>
Task<QueryResult<TimerInfoDto>> GetTimers(TimerQuery query, CancellationToken cancellationToken);
2013-12-04 20:55:42 +00:00
2013-11-24 20:51:45 +00:00
/// <summary>
2013-12-15 01:17:57 +00:00
/// Gets the series timers.
2013-11-24 20:51:45 +00:00
/// </summary>
2013-12-15 01:17:57 +00:00
/// <param name="query">The query.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task{QueryResult{SeriesTimerInfoDto}}.</returns>
Task<QueryResult<SeriesTimerInfoDto>> GetSeriesTimers(SeriesTimerQuery query, CancellationToken cancellationToken);
2016-09-25 18:39:13 +00:00
2013-11-26 02:53:48 +00:00
/// <summary>
/// Gets the channel.
/// </summary>
/// <param name="id">The identifier.</param>
/// <returns>Channel.</returns>
2013-12-19 21:51:32 +00:00
LiveTvChannel GetInternalChannel(string id);
2016-09-25 18:39:13 +00:00
2013-12-19 21:51:32 +00:00
/// <summary>
/// Gets the recording.
/// </summary>
/// <param name="id">The identifier.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>LiveTvRecording.</returns>
2016-03-19 21:34:43 +00:00
Task<BaseItem> GetInternalRecording(string id, CancellationToken cancellationToken);
2013-12-22 18:58:51 +00:00
/// <summary>
/// Gets the recording stream.
/// </summary>
/// <param name="id">The identifier.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task{Stream}.</returns>
2015-03-20 05:40:51 +00:00
Task<MediaSourceInfo> GetRecordingStream(string id, CancellationToken cancellationToken);
2013-12-29 18:53:56 +00:00
/// <summary>
/// Gets the channel stream.
/// </summary>
/// <param name="id">The identifier.</param>
2015-05-16 02:36:47 +00:00
/// <param name="mediaSourceId">The media source identifier.</param>
2013-12-29 18:53:56 +00:00
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task{StreamResponseInfo}.</returns>
2016-10-05 07:15:29 +00:00
Task<Tuple<MediaSourceInfo, IDirectStreamProvider>> GetChannelStream(string id, string mediaSourceId, CancellationToken cancellationToken);
2016-09-25 18:39:13 +00:00
2013-12-17 20:02:12 +00:00
/// <summary>
/// Gets the program.
/// </summary>
/// <param name="id">The identifier.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <param name="user">The user.</param>
/// <returns>Task{ProgramInfoDto}.</returns>
2015-05-31 19:12:58 +00:00
Task<BaseItemDto> GetProgram(string id, CancellationToken cancellationToken, User user = null);
2015-08-02 17:02:23 +00:00
2013-11-25 16:15:31 +00:00
/// <summary>
/// Gets the programs.
/// </summary>
/// <param name="query">The query.</param>
2015-08-02 17:02:23 +00:00
/// <param name="options">The options.</param>
2013-11-26 21:36:11 +00:00
/// <param name="cancellationToken">The cancellation token.</param>
2013-11-25 16:15:31 +00:00
/// <returns>IEnumerable{ProgramInfo}.</returns>
2015-08-02 17:02:23 +00:00
Task<QueryResult<BaseItemDto>> GetPrograms(ProgramQuery query, DtoOptions options, CancellationToken cancellationToken);
2013-12-15 01:17:57 +00:00
/// <summary>
/// Updates the timer.
/// </summary>
/// <param name="timer">The timer.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task.</returns>
Task UpdateTimer(TimerInfoDto timer, CancellationToken cancellationToken);
/// <summary>
/// Updates the timer.
/// </summary>
/// <param name="timer">The timer.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task.</returns>
Task UpdateSeriesTimer(SeriesTimerInfoDto timer, CancellationToken cancellationToken);
2013-12-17 20:02:12 +00:00
/// <summary>
/// Creates the timer.
/// </summary>
/// <param name="timer">The timer.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task.</returns>
Task CreateTimer(TimerInfoDto timer, CancellationToken cancellationToken);
/// <summary>
/// Creates the series timer.
/// </summary>
/// <param name="timer">The timer.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task.</returns>
Task CreateSeriesTimer(SeriesTimerInfoDto timer, CancellationToken cancellationToken);
2013-12-28 21:37:01 +00:00
/// <summary>
/// Gets the recording groups.
/// </summary>
/// <param name="query">The query.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task{QueryResult{RecordingGroupDto}}.</returns>
2015-05-31 18:22:51 +00:00
Task<QueryResult<BaseItemDto>> GetRecordingGroups(RecordingGroupQuery query, CancellationToken cancellationToken);
2014-01-05 06:50:48 +00:00
/// <summary>
/// Closes the live stream.
/// </summary>
/// <param name="id">The identifier.</param>
/// <returns>Task.</returns>
2016-09-29 12:55:49 +00:00
Task CloseLiveStream(string id);
/// <summary>
/// Gets the guide information.
/// </summary>
/// <returns>GuideInfo.</returns>
GuideInfo GetGuideInfo();
2014-01-12 15:58:47 +00:00
/// <summary>
/// Gets the recommended programs.
/// </summary>
/// <param name="query">The query.</param>
2015-08-02 17:02:23 +00:00
/// <param name="options">The options.</param>
2014-01-12 15:58:47 +00:00
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task{QueryResult{ProgramInfoDto}}.</returns>
2015-08-02 17:02:23 +00:00
Task<QueryResult<BaseItemDto>> GetRecommendedPrograms(RecommendedProgramQuery query, DtoOptions options, CancellationToken cancellationToken);
2014-01-23 22:15:15 +00:00
/// <summary>
/// Gets the recommended programs internal.
/// </summary>
/// <returns>Task&lt;QueryResult&lt;LiveTvProgram&gt;&gt;.</returns>
2016-10-08 05:57:38 +00:00
Task<QueryResult<LiveTvProgram>> GetRecommendedProgramsInternal(RecommendedProgramQuery query, DtoOptions options, CancellationToken cancellationToken);
2014-01-23 22:15:15 +00:00
/// <summary>
/// Gets the live tv information.
/// </summary>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task{LiveTvInfo}.</returns>
Task<LiveTvInfo> GetLiveTvInfo(CancellationToken cancellationToken);
/// <summary>
/// Resets the tuner.
/// </summary>
/// <param name="id">The identifier.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task.</returns>
Task ResetTuner(string id, CancellationToken cancellationToken);
2014-06-07 19:46:24 +00:00
/// <summary>
/// Gets the live tv folder.
/// </summary>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>BaseItemDto.</returns>
2015-08-14 19:14:54 +00:00
Task<Folder> GetInternalLiveTvFolder(CancellationToken cancellationToken);
2014-06-07 19:46:24 +00:00
/// <summary>
/// Gets the live tv folder.
/// </summary>
/// <param name="userId">The user identifier.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>BaseItemDto.</returns>
Task<BaseItemDto> GetLiveTvFolder(string userId, CancellationToken cancellationToken);
2014-06-10 17:36:06 +00:00
/// <summary>
/// Gets the enabled users.
/// </summary>
/// <returns>IEnumerable{User}.</returns>
IEnumerable<User> GetEnabledUsers();
2014-08-14 13:24:30 +00:00
/// <summary>
/// Gets the internal channels.
/// </summary>
/// <param name="query">The query.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task&lt;QueryResult&lt;LiveTvChannel&gt;&gt;.</returns>
Task<QueryResult<LiveTvChannel>> GetInternalChannels(LiveTvChannelQuery query,
CancellationToken cancellationToken);
/// <summary>
/// Gets the internal recordings.
/// </summary>
/// <param name="query">The query.</param>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task&lt;QueryResult&lt;BaseItem&gt;&gt;.</returns>
Task<QueryResult<BaseItem>> GetInternalRecordings(RecordingQuery query, CancellationToken cancellationToken);
2015-03-29 04:56:39 +00:00
/// <summary>
/// Gets the recording media sources.
/// </summary>
2016-10-09 07:18:43 +00:00
Task<IEnumerable<MediaSourceInfo>> GetRecordingMediaSources(IHasMediaSources item, CancellationToken cancellationToken);
2015-03-29 04:56:39 +00:00
/// <summary>
/// Gets the channel media sources.
/// </summary>
2016-10-09 07:18:43 +00:00
Task<IEnumerable<MediaSourceInfo>> GetChannelMediaSources(IHasMediaSources item, CancellationToken cancellationToken);
2015-05-31 18:22:51 +00:00
/// <summary>
/// Adds the information to recording dto.
/// </summary>
/// <param name="item">The item.</param>
/// <param name="dto">The dto.</param>
/// <param name="user">The user.</param>
void AddInfoToRecordingDto(BaseItem item, BaseItemDto dto, User user = null);
2015-05-31 19:12:58 +00:00
/// <summary>
/// Adds the information to program dto.
/// </summary>
2016-03-02 18:42:39 +00:00
/// <param name="programs">The programs.</param>
2016-02-12 18:29:28 +00:00
/// <param name="fields">The fields.</param>
2015-05-31 19:12:58 +00:00
/// <param name="user">The user.</param>
2016-03-02 18:42:39 +00:00
/// <returns>Task.</returns>
2016-09-25 18:39:13 +00:00
Task AddInfoToProgramDto(List<Tuple<BaseItem, BaseItemDto>> programs, List<ItemFields> fields, User user = null);
2015-07-23 13:23:22 +00:00
/// <summary>
/// Saves the tuner host.
/// </summary>
2016-08-26 19:29:28 +00:00
Task<TunerHostInfo> SaveTunerHost(TunerHostInfo info, bool dataSourceChanged = true);
2015-07-23 13:23:22 +00:00
/// <summary>
/// Saves the listing provider.
/// </summary>
/// <param name="info">The information.</param>
2015-07-25 17:21:10 +00:00
/// <param name="validateLogin">if set to <c>true</c> [validate login].</param>
/// <param name="validateListings">if set to <c>true</c> [validate listings].</param>
2015-07-23 13:23:22 +00:00
/// <returns>Task.</returns>
2015-07-25 17:21:10 +00:00
Task<ListingsProviderInfo> SaveListingProvider(ListingsProviderInfo info, bool validateLogin, bool validateListings);
void DeleteListingsProvider(string id);
Task<TunerChannelMapping> SetChannelMapping(string providerId, string tunerChannelNumber, string providerChannelNumber);
TunerChannelMapping GetTunerChannelMapping(ChannelInfo channel, List<NameValuePair> mappings, List<ChannelInfo> providerChannels);
2015-07-23 13:23:22 +00:00
/// <summary>
/// Gets the lineups.
/// </summary>
2015-08-10 19:09:10 +00:00
/// <param name="providerType">Type of the provider.</param>
2015-07-23 13:23:22 +00:00
/// <param name="providerId">The provider identifier.</param>
2015-07-23 17:58:20 +00:00
/// <param name="country">The country.</param>
2015-07-23 13:23:22 +00:00
/// <param name="location">The location.</param>
/// <returns>Task&lt;List&lt;NameIdPair&gt;&gt;.</returns>
2015-08-10 19:09:10 +00:00
Task<List<NameIdPair>> GetLineups(string providerType, string providerId, string country, string location);
2015-08-21 19:25:35 +00:00
/// <summary>
/// Gets the registration information.
/// </summary>
/// <param name="feature">The feature.</param>
/// <returns>Task&lt;MBRegistrationRecord&gt;.</returns>
2016-09-06 05:02:05 +00:00
Task<MBRegistrationRecord> GetRegistrationInfo(string feature);
/// <summary>
/// Adds the channel information.
/// </summary>
2016-03-22 06:49:36 +00:00
/// <param name="items">The items.</param>
/// <param name="options">The options.</param>
/// <param name="user">The user.</param>
2016-03-22 06:49:36 +00:00
void AddChannelInfo(List<Tuple<BaseItemDto, LiveTvChannel>> items, DtoOptions options, User user);
/// <summary>
/// Called when [recording file deleted].
/// </summary>
/// <param name="recording">The recording.</param>
/// <returns>Task.</returns>
2016-03-19 21:34:43 +00:00
Task OnRecordingFileDeleted(BaseItem recording);
2016-03-17 18:19:39 +00:00
/// <summary>
/// Gets the sat ini mappings.
/// </summary>
/// <returns>List&lt;NameValuePair&gt;.</returns>
List<NameValuePair> GetSatIniMappings();
2016-03-31 19:32:26 +00:00
Task<List<ChannelInfo>> GetSatChannelScanResult(TunerHostInfo info, CancellationToken cancellationToken);
2016-06-08 05:24:25 +00:00
2016-06-09 16:13:25 +00:00
Task<List<ChannelInfo>> GetChannelsForListingsProvider(string id, CancellationToken cancellationToken);
Task<List<ChannelInfo>> GetChannelsFromListingsProviderData(string id, CancellationToken cancellationToken);
2016-06-08 06:21:13 +00:00
2016-09-25 18:39:13 +00:00
List<IListingsProvider> ListingProviders { get; }
2016-06-10 16:45:04 +00:00
2016-06-08 06:21:13 +00:00
event EventHandler<GenericEventArgs<TimerEventInfo>> SeriesTimerCancelled;
event EventHandler<GenericEventArgs<TimerEventInfo>> TimerCancelled;
event EventHandler<GenericEventArgs<TimerEventInfo>> TimerCreated;
event EventHandler<GenericEventArgs<TimerEventInfo>> SeriesTimerCreated;
}
}