Plugin API V4

Changelog.md

@@ -7,7 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+* Support Plugin V4 API which allows selecting a playlist entry by index.
+  **Note:** The CD Player volume will use the new `mstarPlayerVolumeChanged` instead of `mstarTrackVolumeChanged` like in previous API versions.
+
+### Fixes
+
 * The dialogs to edit or remove files of a track work again.
+* Actually call `mstarPlayerVolumeChanged` for plugins.
 
 ## [1.3.0] - 2026-02-07
 

Source/CDPlayer.cpp

@@ -249,6 +249,10 @@ void CDPlayer::previousEntry()
 {
     m_tracksTable.previous();
 }
+void CDPlayer::selectEntry(int playlist_index)
+{
+    m_tracksTable.selectRow(playlist_index);
+}
 void CDPlayer::paint(juce::Graphics& g)
 {
     g.fillAll(m_color);
@@ -296,7 +300,7 @@ void CDPlayer::setGain(float gain)
 {
     m_gain = gain;
     updateGain();
-    m_pluginLoader.trackVolumeChanged(getName().toRawUTF8(), "", m_gain);
+    m_pluginLoader.cdPlayerVolumeChanged(getName().toRawUTF8(), gain);
     std::for_each(m_listeners.begin(),
         m_listeners.end(),
         std::bind(&MixerControlableChangeListener::gainChanged, std::placeholders::_1, gain));

Source/CDPlayer.h

@@ -40,6 +40,7 @@ class CDPlayer
     void stop() override;
     void nextEntry(bool onlyIfEntrySaysSo = false) override;
     void previousEntry() override;
+    void selectEntry(int playlist_index) override;
 
     // XML serialization
 public:

Source/Player.cpp

@@ -99,6 +99,7 @@ void Player::setType(PlayerType type)
 void Player::setGain(float gain)
 {
     m_tracksContainer.setGain(gain);
+    m_pluginLoader.playerVolumeChanged(getName().toRawUTF8(), gain);
     std::for_each(m_listeners.begin(),
         m_listeners.end(),
         std::bind(&MixerControlableChangeListener::gainChanged, std::placeholders::_1, gain));
@@ -419,6 +420,11 @@ void Player::previousEntry()
     m_pluginLoader.previousEntrySelected(getName().toRawUTF8());
 }
 
+void Player::selectEntry(int playlist_index)
+{
+    m_playlistPlayer.selectPlaylistEntry(playlist_index);
+}
+
 void Player::playlistEntryChanged(const std::vector<TrackConfig>& trackConfigs, bool play, int index)
 {
     currentPlaylistEntry = index;

Source/Player.h

@@ -41,6 +41,7 @@ class Player
     void stop() override;
     void nextEntry(bool onlyIfEntrySaysSo = false) override;
     void previousEntry() override;
+    void selectEntry(int playlist_index) override;
     void playlistEntryChanged(const std::vector<TrackConfig>& trackConfigs, bool play, int index);
     void gainChangedCallback(const char* track_name, float gain);
 

Source/PlayerComponent.h

@@ -14,4 +14,5 @@ class PlayerComponent
     virtual void stop() = 0;
     virtual void nextEntry(bool onlyIfEntrySaysSo = false) = 0;
     virtual void previousEntry() = 0;
+    virtual void selectEntry(int playlist_index) = 0;
 };

Source/PlaylistPlayerWindow.cpp

@@ -319,3 +319,8 @@ void PlaylistPlayerWindow::previousPlaylistEntry()
 {
     m_tableListBox.previous();
 }
+
+void PlaylistPlayerWindow::selectPlaylistEntry(int playlist_index)
+{
+    m_tableListBox.selectRow(playlist_index);
+}

Source/PlaylistPlayerWindow.h

@@ -44,6 +44,8 @@ class PlaylistPlayerWindow
 
     void previousPlaylistEntry();
 
+    void selectPlaylistEntry(int playlist_index);
+
     int getResizerBarPosition() const;
 
     void setResizerBarPosition(int position);

Source/PluginInterfaceV4.h

@@ -0,0 +1,48 @@
+#pragma once
+
+namespace PluginInterface::V4
+{
+using ListPlayersCallbackFunction = void (*)(const char* player_name, void* userData);
+using ListPlayersFunction = void (*)(ListPlayersCallbackFunction callback, void* userData);
+using PlayFunction = void (*)(const char* player_name);
+using StopFunction = void (*)(const char* player_name);
+using NextEntryFunction = void (*)(const char* player_name);
+using PreviousEntryFunction = void (*)(const char* player_name);
+using SelectEntryFunction = void (*)(const char* player_name, int playlist_index);
+using ListTracksCallbackFunction = void (*)(const char* track_name, void* userData);
+using ListTracksFunction = void (*)(const char* player_name, ListTracksCallbackFunction callback, void* userData);
+using SetPlayerVolumeFunction = void (*)(const char* player_name, float volume);
+using SetTrackVolumeFunction = void (*)(const char* player_name, const char* track_name, float volume);
+
+struct Init
+{
+    ListPlayersFunction listPlayers;
+    PlayFunction play;
+    StopFunction stop;
+    NextEntryFunction next;
+    PreviousEntryFunction previous;
+    SelectEntryFunction select;
+    ListTracksFunction listTracks;
+    SetTrackVolumeFunction setTrackVolume;
+    SetPlayerVolumeFunction setPlayerVolume;
+};
+
+using InitFunction = void (*)(const Init&);
+using PlayingStateChangedFunction = void (*)(const char* playerName, bool isPlaying);
+using NextEntrySelectedFunction = void (*)(const char* playerName);
+using PreviousEntrySelectedFunction = void (*)(const char* playerName);
+using PlaylistEntrySelectedFunction
+    = void (*)(const char* playerName, int playlist_index, const char* playlistEntryName, double duration);
+using PlaylistEntryDurationChangedFunction = void (*)(const char* playerName, int playlist_index, double duration);
+using PlaylistEntryNameChangedFunction
+    = void (*)(const char* playerName, int playlist_index, const char* playlistEntryName);
+using TrackVolumeChangedFunction = void (*)(const char* playerName, const char* track_name, double volume);
+using PlayerVolumeChangedFunction = void (*)(const char* playerName, double volume);
+using PositionChangedFunction = void (*)(const char* playerName, double position);
+using ConfigureFunction = void (*)();
+using ShutdownFunction = void (*)();
+
+using LoadConfigurationFunction = void (*)(const char* configurationText);
+using GetConfigurationFunction = char* (*)();
+using FreeConfigurationTextFunction = void (*)(const char* configurationText);
+}