// Copyright (c) ppy Pty Ltd . Licensed under the MIT Licence. // See the LICENCE file in the repository root for full licence text. using System; using System.Collections.Generic; using System.IO; using System.Linq; using System.Threading.Tasks; using JetBrains.Annotations; using osu.Framework.Allocation; using osu.Framework.Audio; using osu.Framework.Audio.Track; using osu.Framework.Bindables; using osu.Framework.Graphics; using osu.Framework.Graphics.Containers; using osu.Framework.IO.Stores; using osu.Framework.Platform; using osu.Framework.Testing; using osu.Framework.Timing; using osu.Game.Beatmaps; using osu.Game.Database; using osu.Game.Online.API; using osu.Game.Online.API.Requests.Responses; using osu.Game.Overlays; using osu.Game.Rulesets; using osu.Game.Rulesets.Mods; using osu.Game.Rulesets.Objects; using osu.Game.Rulesets.UI; using osu.Game.Screens; using osu.Game.Storyboards; using osu.Game.Tests.Beatmaps; namespace osu.Game.Tests.Visual { [ExcludeFromDynamicCompile] public abstract class OsuTestScene : TestScene { protected Bindable Beatmap { get; private set; } protected Bindable Ruleset; protected Bindable> SelectedMods; protected new OsuScreenDependencies Dependencies { get; private set; } private DrawableRulesetDependencies rulesetDependencies; private Lazy localStorage; protected Storage LocalStorage => localStorage.Value; private Lazy contextFactory; protected IResourceStore Resources; protected IAPIProvider API { get { if (UseOnlineAPI) throw new InvalidOperationException($"Using the {nameof(OsuTestScene)} dummy API is not supported when {nameof(UseOnlineAPI)} is true"); return dummyAPI; } } private DummyAPIAccess dummyAPI; protected DatabaseContextFactory ContextFactory => contextFactory.Value; /// /// Whether this test scene requires real-world API access. /// If true, this will bypass the local and use the provided one. /// protected virtual bool UseOnlineAPI => false; /// /// When running headless, there is an opportunity to use the host storage rather than creating a second isolated one. /// This is because the host is recycled per TestScene execution in headless at an nunit level. /// private Storage isolatedHostStorage; protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent) { if (!UseFreshStoragePerRun) isolatedHostStorage = (parent.Get() as HeadlessGameHost)?.Storage; Resources = parent.Get().Resources; contextFactory = new Lazy(() => { var factory = new DatabaseContextFactory(LocalStorage); // only reset the database if not using the host storage. // if we reset the host storage, it will delete global key bindings. if (isolatedHostStorage == null) factory.ResetDatabase(); using (var usage = factory.Get()) usage.Migrate(); return factory; }); RecycleLocalStorage(false); var baseDependencies = base.CreateChildDependencies(parent); var providedRuleset = CreateRuleset(); if (providedRuleset != null) baseDependencies = rulesetDependencies = new DrawableRulesetDependencies(providedRuleset, baseDependencies); Dependencies = new OsuScreenDependencies(false, baseDependencies); Beatmap = Dependencies.Beatmap; Beatmap.SetDefault(); Ruleset = Dependencies.Ruleset; Ruleset.SetDefault(); SelectedMods = Dependencies.Mods; SelectedMods.SetDefault(); if (!UseOnlineAPI) { dummyAPI = new DummyAPIAccess(); Dependencies.CacheAs(dummyAPI); base.Content.Add(dummyAPI); } return Dependencies; } protected override Container Content => content ?? base.Content; private readonly Container content; protected OsuTestScene() { base.Content.Add(content = new DrawSizePreservingFillContainer()); } protected virtual bool UseFreshStoragePerRun => false; public virtual void RecycleLocalStorage(bool isDisposing) { if (localStorage?.IsValueCreated == true) { try { localStorage.Value.DeleteDirectory("."); } catch { // we don't really care if this fails; it will just leave folders lying around from test runs. } } localStorage = new Lazy(() => isolatedHostStorage ?? new TemporaryNativeStorage($"{GetType().Name}-{Guid.NewGuid()}")); } [Resolved] protected AudioManager Audio { get; private set; } [Resolved] protected MusicController MusicController { get; private set; } /// /// Creates the ruleset to be used for this test scene. /// /// /// When testing against ruleset-specific components, this method must be overriden to their corresponding ruleset. /// [CanBeNull] protected virtual Ruleset CreateRuleset() => null; protected virtual IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(ruleset); protected APIBeatmapSet CreateAPIBeatmapSet(RulesetInfo ruleset) { var beatmap = CreateBeatmap(ruleset).BeatmapInfo; return new APIBeatmapSet { Covers = beatmap.BeatmapSet.Covers, OnlineID = beatmap.BeatmapSet.OnlineID, Status = beatmap.BeatmapSet.Status, Preview = beatmap.BeatmapSet.Preview, HasFavourited = beatmap.BeatmapSet.HasFavourited, PlayCount = beatmap.BeatmapSet.PlayCount, FavouriteCount = beatmap.BeatmapSet.FavouriteCount, BPM = beatmap.BeatmapSet.BPM, HasExplicitContent = beatmap.BeatmapSet.HasExplicitContent, HasVideo = beatmap.BeatmapSet.HasVideo, HasStoryboard = beatmap.BeatmapSet.HasStoryboard, Submitted = beatmap.BeatmapSet.Submitted, Ranked = beatmap.BeatmapSet.Ranked, LastUpdated = beatmap.BeatmapSet.LastUpdated, TrackId = beatmap.BeatmapSet.TrackId, Title = beatmap.BeatmapSet.Metadata.Title, TitleUnicode = beatmap.BeatmapSet.Metadata.TitleUnicode, Artist = beatmap.BeatmapSet.Metadata.Artist, ArtistUnicode = beatmap.BeatmapSet.Metadata.ArtistUnicode, Author = beatmap.BeatmapSet.Metadata.Author, AuthorID = beatmap.BeatmapSet.Metadata.AuthorID, AuthorString = beatmap.BeatmapSet.Metadata.AuthorString, Availability = beatmap.BeatmapSet.Availability, Genre = beatmap.BeatmapSet.Genre, Language = beatmap.BeatmapSet.Language, Source = beatmap.BeatmapSet.Metadata.Source, Tags = beatmap.BeatmapSet.Metadata.Tags, Beatmaps = new[] { new APIBeatmap { OnlineID = beatmap.OnlineID, OnlineBeatmapSetID = beatmap.BeatmapSet.OnlineID, Status = beatmap.Status, Checksum = beatmap.MD5Hash, AuthorID = beatmap.Metadata.AuthorID, RulesetID = beatmap.RulesetID, StarRating = beatmap.StarDifficulty, DifficultyName = beatmap.Version, } } }; } protected WorkingBeatmap CreateWorkingBeatmap(RulesetInfo ruleset) => CreateWorkingBeatmap(CreateBeatmap(ruleset)); protected virtual WorkingBeatmap CreateWorkingBeatmap(IBeatmap beatmap, Storyboard storyboard = null) => new ClockBackedTestWorkingBeatmap(beatmap, storyboard, Clock, Audio); [BackgroundDependencyLoader] private void load(RulesetStore rulesets) { Ruleset.Value = CreateRuleset()?.RulesetInfo ?? rulesets.AvailableRulesets.First(); } protected override void Dispose(bool isDisposing) { base.Dispose(isDisposing); rulesetDependencies?.Dispose(); if (MusicController?.TrackLoaded == true) MusicController.Stop(); if (contextFactory?.IsValueCreated == true) contextFactory.Value.ResetDatabase(); RecycleLocalStorage(true); } protected override ITestSceneTestRunner CreateRunner() => new OsuTestSceneTestRunner(); public class ClockBackedTestWorkingBeatmap : TestWorkingBeatmap { private readonly Track track; private readonly TrackVirtualStore store; /// /// Create an instance which creates a for the provided ruleset when requested. /// /// The target ruleset. /// A clock which should be used instead of a stopwatch for virtual time progression. /// Audio manager. Required if a reference clock isn't provided. public ClockBackedTestWorkingBeatmap(RulesetInfo ruleset, IFrameBasedClock referenceClock, AudioManager audio) : this(new TestBeatmap(ruleset), null, referenceClock, audio) { } /// /// Create an instance which provides the when requested. /// /// The beatmap /// The storyboard. /// An optional clock which should be used instead of a stopwatch for virtual time progression. /// Audio manager. Required if a reference clock isn't provided. public ClockBackedTestWorkingBeatmap(IBeatmap beatmap, Storyboard storyboard, IFrameBasedClock referenceClock, AudioManager audio) : base(beatmap, storyboard, audio) { double trackLength = 60000; if (beatmap.HitObjects.Count > 0) // add buffer after last hitobject to allow for final replay frames etc. trackLength = Math.Max(trackLength, beatmap.HitObjects.Max(h => h.GetEndTime()) + 2000); if (referenceClock != null) { store = new TrackVirtualStore(referenceClock); audio.AddItem(store); track = store.GetVirtual(trackLength); } else track = audio?.Tracks.GetVirtual(trackLength); } ~ClockBackedTestWorkingBeatmap() { // Remove the track store from the audio manager store?.Dispose(); } protected override Track GetBeatmapTrack() => track; public class TrackVirtualStore : AudioCollectionManager, ITrackStore { private readonly IFrameBasedClock referenceClock; public TrackVirtualStore(IFrameBasedClock referenceClock) { this.referenceClock = referenceClock; } public Track Get(string name) => throw new NotImplementedException(); public Task GetAsync(string name) => throw new NotImplementedException(); public Stream GetStream(string name) => throw new NotImplementedException(); public IEnumerable GetAvailableResources() => throw new NotImplementedException(); public Track GetVirtual(double length = double.PositiveInfinity) { var track = new TrackVirtualManual(referenceClock) { Length = length }; AddItem(track); return track; } } /// /// A virtual track which tracks a reference clock. /// public class TrackVirtualManual : Track { private readonly IFrameBasedClock referenceClock; private bool running; public TrackVirtualManual(IFrameBasedClock referenceClock) { this.referenceClock = referenceClock; Length = double.PositiveInfinity; } public override bool Seek(double seek) { accumulated = Math.Clamp(seek, 0, Length); lastReferenceTime = null; return accumulated == seek; } public override void Start() { running = true; } public override void Reset() { Seek(0); base.Reset(); } public override void Stop() { if (running) { running = false; lastReferenceTime = null; } } public override bool IsRunning => running; private double? lastReferenceTime; private double accumulated; public override double CurrentTime => Math.Min(accumulated, Length); protected override void UpdateState() { base.UpdateState(); if (running) { double refTime = referenceClock.CurrentTime; double? lastRefTime = lastReferenceTime; if (lastRefTime != null) accumulated += (refTime - lastRefTime.Value) * Rate; lastReferenceTime = refTime; } if (CurrentTime >= Length) { Stop(); // `RaiseCompleted` is not called here to prevent transitioning to the next song. } } } } public class OsuTestSceneTestRunner : OsuGameBase, ITestSceneTestRunner { private TestSceneTestRunner.TestRunner runner; protected override void LoadAsyncComplete() { // this has to be run here rather than LoadComplete because // TestScene.cs is checking the IsLoaded state (on another thread) and expects // the runner to be loaded at that point. Add(runner = new TestSceneTestRunner.TestRunner()); } protected override void InitialiseFonts() { // skip fonts load as it's not required for testing purposes. } public void RunTestBlocking(TestScene test) => runner.RunTestBlocking(test); } } }