Added Player.EventsListener#onPlaybackEnded (#297)

Author: devgianlu

api/README.md

@@ -44,6 +44,7 @@ You can subscribe for players events by creating a WebSocket connection to `/eve
 The currently available events are:
 - `contextChanged` The Spotify context URI changed
 - `trackChanged` The Spotify track URI changed
+- `playbackEnded` Playback has ended
 - `playbackPaused` Playback has been paused
 - `playbackResumed` Playback has been resumed
 - `volumeChanged` Playback volume changed

api/src/main/java/xyz/gianlu/librespot/api/handlers/EventsHandler.java

@@ -50,6 +50,13 @@ public void onTrackChanged(@NotNull PlayableId id, @Nullable TrackOrEpisode meta
         dispatch(obj);
     }
 
+    @Override
+    public void onPlaybackEnded() {
+        JsonObject obj = new JsonObject();
+        obj.addProperty("event", "playbackEnded");
+        dispatch(obj);
+    }
+
     @Override
     public void onPlaybackPaused(long trackTime) {
         JsonObject obj = new JsonObject();

player/src/main/java/xyz/gianlu/librespot/player/Player.java

@@ -654,6 +654,7 @@ public void trackChanged(@NotNull String playbackId, @Nullable TrackOrEpisode me
     @Override
     public void trackPlayed(@NotNull String playbackId, @NotNull PlaybackMetrics.Reason endReason, @NotNull PlayerMetrics playerMetrics, int when) {
         endMetrics(playbackId, endReason, playerMetrics, when);
+        events.playbackEnded();
     }
 
     @Override
@@ -833,6 +834,8 @@ public interface EventsListener {
 
         void onTrackChanged(@NotNull PlayableId id, @Nullable TrackOrEpisode metadata);
 
+        void onPlaybackEnded();
+
         void onPlaybackPaused(long trackTime);
 
         void onPlaybackResumed(long trackTime);
@@ -1031,6 +1034,11 @@ private void sendVolume(int value) {
             metadataPipe.safeSend(MetadataPipe.TYPE_SSNC, MetadataPipe.CODE_PVOL, volData);
         }
 
+        void playbackEnded() {
+            for (EventsListener l : new ArrayList<>(listeners))
+                executorService.execute(l::onPlaybackEnded);
+        }
+
         void playbackPaused() {
             long trackTime = state.getPosition();
             for (EventsListener l : new ArrayList<>(listeners))