CatStation/Content.Client/Instruments/UI/InstrumentBoundUserInterface.cs

using Content.Client.Interactable;
using Content.Shared.ActionBlocker;
using Content.Shared.Instruments;
using Content.Shared.Instruments.UI;
using Robust.Client.Audio.Midi;
using Robust.Client.UserInterface;
using Robust.Shared.Audio.Midi;
using Robust.Shared.Containers;
using Robust.Shared.Utility;

namespace Content.Client.Instruments.UI;

public sealed partial class InstrumentBoundUserInterface : BoundUserInterface
{
    private const int MaxSearchDepth = 16;
    private const string SawmillCategory = "instrumentui";

    [Dependency] private IMidiManager _midiManager = default!;
    [Dependency] private ILocalizationManager _loc = default!;
    [Dependency] private ILogManager _logManager = default!;
    [Dependency] private InstrumentSystem _instruments = default!;
    [Dependency] private ActionBlockerSystem _actionBlockerSystem = default!;
    [Dependency] private InteractionSystem _interactionSystem = default!;
    [Dependency] private SharedContainerSystem _sharedContainerSystem = default!;
    private readonly ISawmill _sawmill = default!;

    private readonly FileMidiSource _fileSource = new();
    private readonly BandMidiSource _bandSource = new();
    private readonly InputMidiSource _inputSource = new();

    private readonly ChannelsControl _channelsControl = new();
    private readonly MidiCollectionUtilsControl _midiCollectionUtilsControl = new();
    private readonly MinVolumeControl _minVolumeControl = new();

    private InstrumentMenu? _instrumentMenu;
    private string _percussionLabel = "";

    public InstrumentBoundUserInterface(EntityUid owner, Enum uiKey) : base(owner, uiKey)
    {
        _sawmill = _logManager.GetSawmill(SawmillCategory);
    }

    protected override void Open()
    {
        base.Open();

        _percussionLabel = _loc.GetString("instruments-component-channels-percussion-channel-name");

        var instrument = EntMan.GetComponent<InstrumentComponent>(Owner);

        instrument.OnMidiPlaybackEnded += OnMidiPlaybackEnded;

        _instruments.OnChannelsUpdated += OnChannelsUpdated;

        _fileSource.StartPlayingRequest += OnStartPlayingRequest;
        _fileSource.StopPlayingRequest += OnStopPlayingRequest;
        _fileSource.LoopingToggled += OnLoopToggledRequest;
        _fileSource.TrackPositionChangeRequest += OnTrackPositionChangeRequest;
        _fileSource.Instrument = (Owner, instrument);

        _bandSource.RefreshBandRequest += OnRefreshBandsRequest;
        _bandSource.JoinBandRequest += OnSetBandMasterRequest;

        _inputSource.OpenInputRequest += OnOpenInputRequest;
        _inputSource.CloseInputRequest += OnCloseInputRequest;

        _channelsControl.ChannelsUpdateRequest += OnChannelsUpdateRequest;
        _channelsControl.SwitchFilteredChannel += OnSwitchFilteredChannel;

        _minVolumeControl.MinVolumeChanged += OnMinVolumeChanged;
        _minVolumeControl.MinVolume = instrument.MinVolume;

        _instrumentMenu = this.CreateWindow<InstrumentMenu>();

        if (EntMan.TryGetComponent<MetaDataComponent>(Owner, out var metaData))
            _instrumentMenu.Title = metaData.EntityName;

        _instrumentMenu.SetMidiAvailability(_midiManager.IsAvailable);
        _instrumentMenu.SetInstrument((Owner, instrument));

        // Initialize sources and switch to the (probably) most used one.
        // Add additional concrete InstrumentMidiSourceBase types here.
        _instrumentMenu.SetupSources(_fileSource, _bandSource, _inputSource);
        _instrumentMenu.SwitchMode(_fileSource);

        // Initialize controls used to configure various system parameters.
        // Append any additional configuration controls here.
        _instrumentMenu.AddConfigurationControl(
            _loc.GetString("instruments-component-menu-channels-label"),
            _channelsControl);
        _instrumentMenu.AddConfigurationControl(
            _loc.GetString("instruments-component-midi-file-collection-label"),
            _midiCollectionUtilsControl);
        _instrumentMenu.AddConfigurationControl(
            _loc.GetString("instruments-component-menu-midi-min-volume-slider-label"),
            _minVolumeControl);
    }

    protected override void ReceiveMessage(BoundUserInterfaceMessage message)
    {
        if (message is not InstrumentBandResponseBuiMessage bandRx)
            return;

        var entities = new List<(EntityUid, string)>();
        foreach (var netEnt in bandRx.Nearby)
        {
            entities.Add((EntMan.GetEntity(netEnt.Item1), netEnt.Item2));
        }

        _bandSource.Populate(entities);
    }

    protected override void Dispose(bool disposing)
    {
        base.Dispose(disposing);
        if (!disposing)
            return;

        _fileSource.StartPlayingRequest -= OnStartPlayingRequest;
        _fileSource.StopPlayingRequest -= OnStopPlayingRequest;
        _fileSource.LoopingToggled -= OnLoopToggledRequest;
        _fileSource.TrackPositionChangeRequest -= OnTrackPositionChangeRequest;

        _bandSource.RefreshBandRequest -= OnRefreshBandsRequest;
        _bandSource.JoinBandRequest -= OnSetBandMasterRequest;

        _inputSource.OpenInputRequest -= OnOpenInputRequest;
        _inputSource.CloseInputRequest -= OnCloseInputRequest;

        if (!EntMan.TryGetComponent(Owner, out InstrumentComponent? instrument))
            return;

        _fileSource.Instrument = (Owner, instrument);
        instrument.OnMidiPlaybackEnded -= OnMidiPlaybackEnded;
    }

    private void OnSwitchFilteredChannel(int channelIndex, bool state)
    {
        _instruments.SetFilteredChannel(Owner, channelIndex, !state);
    }

    private void OnChannelsUpdateRequest()
    {
        UpdateChannels();
    }

    private void OnChannelsUpdated()
    {
        UpdateChannels();
    }

    private void OnMinVolumeChanged(int volume)
    {
        _instruments.SetMinVolume(Owner, volume);
    }

    private void OnMidiPlaybackEnded()
    {
        _fileSource.SelectNextTrack();
    }

    private void OnSetBandMasterRequest(EntityUid ent)
    {
        if (!PlayCheck())
            return;

        _instruments.SetMaster(Owner, ent);
    }

    private void OnRefreshBandsRequest()
    {
        SendMessage(new InstrumentBandRequestBuiMessage());
    }

    private void OnLoopToggledRequest(bool toggled)
    {
        if (EntMan.TryGetComponent(Owner, out InstrumentComponent? instrumentComp))
        {
            instrumentComp.LoopMidi = toggled;
        }

        _instruments.UpdateRenderer(Owner);
    }

    private void OnTrackPositionChangeRequest(int value)
    {
        _instruments.SetPlayerTick(Owner, value);
    }

    private void OnOpenInputRequest()
    {
        if (!PlayCheck())
            return;

        if (!EntMan.TryGetComponent<InstrumentComponent>(Owner, out var instrument))
            return;

        _instruments.OpenInput(Owner, instrument);
    }

    private void OnCloseInputRequest()
    {
        if (!EntMan.TryGetComponent<InstrumentComponent>(Owner, out var instrument))
            return;

        _instruments.CloseInput(Owner, false, instrument);
    }

    private void OnStopPlayingRequest()
    {
        if (!EntMan.TryGetComponent<InstrumentComponent>(Owner, out var instrument))
            return;

        _instruments.CloseMidi(Owner, false, instrument);
    }

    private void OnStartPlayingRequest(byte[] trackData)
    {
        try
        {
            if (!EntMan.TryGetComponent<InstrumentComponent>(Owner, out var instrument))
                return;

            // Close any song that is already playing.
            if (instrument.IsMidiOpen)
                _instruments.CloseMidi(Owner, false, instrument);

            if (!_fileSource.IsPlaying)
                return;

            if (!PlayCheck())
                return;

            if (!_instruments.OpenMidi(Owner, trackData, instrument))
                _fileSource.IsPlaying = false;
        }
        catch (Exception e)
        {
            _sawmill.Error($"Failed to play next midi track: {e.Message}");
            _fileSource.IsPlaying = false;
        }
    }

    private bool PlayCheck()
    {
        if (!EntMan.TryGetComponent(Owner, out InstrumentComponent? instrument))
            return false;

        var localEntity = PlayerManager.LocalEntity;

        // If we don't have a player or controlled entity, we return.
        if (localEntity == null)
            return false;

        // By default, allow an instrument to play itself and skip all other checks
        if (localEntity == Owner)
            return true;

        // If we're a handheld instrument, we might be in a container. Get it just in case.
        _sharedContainerSystem.TryGetContainingContainer((Owner, null, null), out var conMan);

        // If the instrument is handheld, and we're not holding it, we return.
        if (instrument.Handheld && (conMan == null || conMan.Owner != localEntity))
            return false;

        if (!_actionBlockerSystem.CanInteract(localEntity.Value, Owner))
            return false;

        if (!_interactionSystem.InRangeUnobstructed(localEntity.Value, Owner))
            return false;

        return true;
    }

    /// <summary>
    /// Walks up the tree of instrument masters to find the truest master of them all.
    /// </summary>
    private ActiveInstrumentComponent? ResolveActiveInstrument(InstrumentComponent comp)
    {
        var instrument = new Entity<InstrumentComponent>(Owner, comp);

        for (var i = 0; i < MaxSearchDepth; i++)
        {
            if (instrument.Comp.Master is not { } master)
                break;

            if (!EntMan.TryGetComponent<InstrumentComponent>(master, out var masterComp))
                break;

            instrument = new Entity<InstrumentComponent>(master, masterComp);
        }

        return EntMan.GetComponentOrNull<ActiveInstrumentComponent>(instrument.Owner);
    }

    private void UpdateChannels()
    {
        if (!EntMan.TryGetComponent<InstrumentComponent>(Owner, out var instrument))
            return;

        List<MidiChannelInfo> channelSettings = [];

        var activeInstrument = ResolveActiveInstrument(instrument);

        for (var i = 0; i < RobustMidiEvent.MaxChannels; i++)
        {
            bool channelFound = false;
            var trackName = "";
            var instrumentName = "";
            var programName = "";
            var state = !instrument?.FilteredChannels[i] ?? false;
            // Always show percussion channel if the instrument allows it, resolved or not.
            if (i == RobustMidiEvent.PercussionChannel && instrument!.AllowPercussion)
            {
                channelFound = true;
                programName = _percussionLabel;
            }
            else if (instrument!.IsInputOpen)
            {
                channelFound = true;
            }
            else if (i != RobustMidiEvent.PercussionChannel
                && activeInstrument != null
                && activeInstrument.Tracks.TryGetValue(i, out var resolvedMidiChannel)
                && resolvedMidiChannel != null)
            {
                channelFound = true;
                trackName = resolvedMidiChannel.TrackName ?? "";
                instrumentName = resolvedMidiChannel.InstrumentName ?? "";
                programName = resolvedMidiChannel.ProgramName ?? "";
            }

            if (channelFound)
                channelSettings.Add(new MidiChannelInfo(i, trackName, instrumentName, programName, state));
        }

        _channelsControl.SetChannels(channelSettings.ToArray());
    }
}

/// <summary>
/// Simple DTO for relaying MIDI channel information
/// </summary>
/// <param name="Id">MIDI channel ID</param>
/// <param name="TrackName">MIDI channel track name</param>
/// <param name="ProgramName">MIDI channel track name</param>
/// <param name="InstrumentName">MIDI channel track name</param>
/// <param name="FilterState">MIDI channel filter state</param>
public readonly record struct MidiChannelInfo(
    int Id,
    string TrackName,
    string InstrumentName,
    string ProgramName,
    bool FilterState);