osu/osu.Game/Database/IModelDownloader.cs

52 lines
2.5 KiB
C#
Raw Normal View History

// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
// See the LICENCE file in the repository root for full licence text.
using System;
2020-05-19 07:44:22 +00:00
using osu.Game.Online.API;
using osu.Framework.Bindables;
namespace osu.Game.Database
{
/// <summary>
/// Represents a <see cref="IModelManager{TModel}"/> that can download new models from an external source.
/// </summary>
/// <typeparam name="TModel">The model type.</typeparam>
public interface IModelDownloader<TModel> : IModelManager<TModel>
where TModel : class
{
/// <summary>
2019-11-17 12:48:23 +00:00
/// Fired when a <typeparamref name="TModel"/> download begins.
/// This is NOT run on the update thread and should be scheduled.
/// </summary>
2020-05-19 07:44:22 +00:00
IBindable<WeakReference<ArchiveDownloadRequest<TModel>>> DownloadBegan { get; }
/// <summary>
2019-11-17 12:48:23 +00:00
/// Fired when a <typeparamref name="TModel"/> download is interrupted, either due to user cancellation or failure.
/// This is NOT run on the update thread and should be scheduled.
/// </summary>
2020-05-19 07:44:22 +00:00
IBindable<WeakReference<ArchiveDownloadRequest<TModel>>> DownloadFailed { get; }
2019-06-13 15:58:32 +00:00
/// <summary>
2019-11-17 12:48:23 +00:00
/// Checks whether a given <typeparamref name="TModel"/> is already available in the local store.
2019-06-13 15:58:32 +00:00
/// </summary>
2019-11-17 12:48:23 +00:00
/// <param name="model">The <typeparamref name="TModel"/> whose existence needs to be checked.</param>
/// <returns>Whether the <typeparamref name="TModel"/> exists.</returns>
bool IsAvailableLocally(TModel model);
/// <summary>
2019-11-17 12:48:23 +00:00
/// Begin a download for the requested <typeparamref name="TModel"/>.
/// </summary>
2019-11-17 12:48:23 +00:00
/// <param name="model">The <stypeparamref name="TModel"/> to be downloaded.</param>
2019-06-18 16:41:19 +00:00
/// <param name="minimiseDownloadSize">Whether this download should be optimised for slow connections. Generally means extras are not included in the download bundle..</param>
/// <returns>Whether the download was started.</returns>
bool Download(TModel model, bool minimiseDownloadSize);
/// <summary>
2019-11-17 12:48:23 +00:00
/// Gets an existing <typeparamref name="TModel"/> download request if it exists.
/// </summary>
2019-11-17 12:48:23 +00:00
/// <param name="model">The <typeparamref name="TModel"/> whose request is wanted.</param>
2019-06-12 04:30:23 +00:00
/// <returns>The <see cref="ArchiveDownloadRequest{TModel}"/> object if it exists, otherwise null.</returns>
ArchiveDownloadRequest<TModel> GetExistingDownload(TModel model);
}
}