osukey/osu.Game/Graphics/UserInterface/HoverClickSounds.cs

// 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;
using osu.Framework.Allocation;
using osu.Framework.Audio;
using osu.Framework.Audio.Sample;
using osu.Framework.Extensions;
using osu.Framework.Input.Events;
using osuTK.Input;

namespace osu.Game.Graphics.UserInterface
{
    /// <summary>
    /// Adds hover and click sounds to a drawable.
    /// Does not draw anything.
    /// </summary>
    public class HoverClickSounds : HoverSounds
    {
        private SampleChannel sampleClick;
        private readonly MouseButton[] buttons;

        /// <summary>
        /// Creates an instance that adds sounds on hover and on click for any of the buttons specified.
        /// </summary>
        /// <param name="sampleSet">Set of click samples to play.</param>
        /// <param name="buttons">
        /// Array of button codes which should trigger the click sound.
        /// If this optional parameter is omitted or set to <code>null</code>, the click sound will also be added on left click.
        /// </param>
        public HoverClickSounds(HoverSampleSet sampleSet = HoverSampleSet.Normal, MouseButton[] buttons = null)
            : base(sampleSet)
        {
            this.buttons = buttons ?? new[] { MouseButton.Left };
        }

        protected override bool OnMouseUp(MouseUpEvent e)
        {
            var index = Array.IndexOf(buttons, e.Button);
            bool shouldPlayEffect = index > -1 && index < buttons.Length;

            // examine the button pressed first for short-circuiting
            // in most usages it is more likely that another button was pressed than that the cursor left the drawable bounds
            if (shouldPlayEffect && Contains(e.ScreenSpaceMousePosition))
                sampleClick?.Play();
            return base.OnMouseUp(e);
        }

        [BackgroundDependencyLoader]
        private void load(AudioManager audio)
        {
            sampleClick = audio.Samples.Get($@"UI/generic-select{SampleSet.GetDescription()}");
        }
    }
}