mirror of
https://github.com/navidrome/navidrome.git
synced 2026-08-31 07:30:32 +00:00
* feat(req): add Float64Or helper for parsing float query params * feat(scrobbler): extend NowPlayingInfo with state/position/rate fields * feat(scrobbler): implement ReportPlayback with state machine and auto-scrobble * feat(responses): add state/positionMs/playbackRate to NowPlayingEntry * feat(subsonic): add reportPlayback endpoint handler * feat(subsonic): include state/positionMs/playbackRate in getNowPlaying response * feat(subsonic): register playbackReport OpenSubsonic extension * test(e2e): add reportPlayback endpoint e2e tests * refactor(scrobbler): simplify ReportPlayback — extract helpers, remove duplication - Add state constants and exported ValidStates map - Extract remainingTTL() helper (was duplicated 3x) - Merge playing/paused switch cases into single branch - Use Get instead of GetWithParticipants for non-stopped states - Guard NowPlayingCount broadcast with count-change detection - Use cache entry for NowPlaying dispatch instead of extra DB query - Remove redundant Position field from NowPlayingInfo * refactor(scrobbler): skip DB query in playing/paused when playMap has entry * fix(play_tracker): handle errors when adding/updating NowPlayingInfo in cache Signed-off-by: Deluan <deluan@navidrome.org> * refactor(play_tracker): replace sort with slices.SortFunc for NowPlayingInfo Signed-off-by: Deluan <deluan@navidrome.org> * fix(play_tracker): check all ReportPlayback errors in tests Replace _ = with explicit error assertions to avoid masking failures in intermediate calls. Signed-off-by: Deluan <deluan@navidrome.org> * test(e2e): use real PlayTracker and assert getNowPlaying after reportPlayback Replace noopPlayTracker with a real PlayTracker backed by the E2E database. E2E tests now verify the full round-trip: reportPlayback creates/updates/removes entries visible via getNowPlaying, including state, positionMs, and playbackRate fields. Export NewPlayTracker constructor for use outside the scrobbler package. * fix(play_tracker): account for playback rate in TTL and detect track switches The remainingTTL function now divides remaining time by the playback rate, so cache entries expire correctly at non-1x speeds (e.g., 2x playback halves the TTL). Zero/negative rates default to 1.0. The playing/paused case now checks if the cached MediaFile ID matches the reported mediaId, falling back to a DB fetch when the client switches tracks without sending stopped/starting. Adds parameterized tests for remainingTTL covering rate variations and edge cases. * fix(subsonic): validate positionMs and playbackRate in reportPlayback Reject negative positionMs values and invalid playbackRate values (NaN, Inf, zero, negative) at the API boundary before they reach TTL and position estimation math. Returns clear error messages for each case. * feat(play_tracker): add ClientId and ClientName to ReportPlayback parameters Signed-off-by: Deluan <deluan@navidrome.org> * refactor(play_tracker): replace NowPlaying method with ReportPlayback calls Signed-off-by: Deluan <deluan@navidrome.org> * refactor(play_tracker_test): remove redundant TTL behavior tests and clean up mockPluginLoader Signed-off-by: Deluan <deluan@navidrome.org> --------- Signed-off-by: Deluan <deluan@navidrome.org>
291 lines
7.2 KiB
Go
291 lines
7.2 KiB
Go
package subsonic
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"math"
|
|
"net/http"
|
|
"time"
|
|
|
|
"github.com/navidrome/navidrome/core/scrobbler"
|
|
"github.com/navidrome/navidrome/log"
|
|
"github.com/navidrome/navidrome/model"
|
|
"github.com/navidrome/navidrome/model/request"
|
|
"github.com/navidrome/navidrome/server/events"
|
|
"github.com/navidrome/navidrome/server/subsonic/responses"
|
|
"github.com/navidrome/navidrome/utils/req"
|
|
)
|
|
|
|
func (api *Router) SetRating(r *http.Request) (*responses.Subsonic, error) {
|
|
p := req.Params(r)
|
|
id, err := p.String("id")
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
rating, err := p.Int("rating")
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
log.Debug(r, "Setting rating", "rating", rating, "id", id)
|
|
err = api.setRating(r.Context(), id, rating)
|
|
if err != nil {
|
|
log.Error(r, err)
|
|
return nil, err
|
|
}
|
|
|
|
return newResponse(), nil
|
|
}
|
|
|
|
func (api *Router) setRating(ctx context.Context, id string, rating int) error {
|
|
var repo model.AnnotatedRepository
|
|
var resource string
|
|
|
|
entity, err := model.GetEntityByID(ctx, api.ds, id)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
switch entity.(type) {
|
|
case *model.Artist:
|
|
repo = api.ds.Artist(ctx)
|
|
resource = "artist"
|
|
case *model.Album:
|
|
repo = api.ds.Album(ctx)
|
|
resource = "album"
|
|
default:
|
|
repo = api.ds.MediaFile(ctx)
|
|
resource = "song"
|
|
}
|
|
err = repo.SetRating(rating, id)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
event := &events.RefreshResource{}
|
|
api.broker.SendMessage(ctx, event.With(resource, id))
|
|
return nil
|
|
}
|
|
|
|
func (api *Router) Star(r *http.Request) (*responses.Subsonic, error) {
|
|
p := req.Params(r)
|
|
ids, _ := p.Strings("id")
|
|
albumIds, _ := p.Strings("albumId")
|
|
artistIds, _ := p.Strings("artistId")
|
|
if len(ids)+len(albumIds)+len(artistIds) == 0 {
|
|
return nil, newError(responses.ErrorMissingParameter, "Required id parameter is missing")
|
|
}
|
|
ids = append(ids, albumIds...)
|
|
ids = append(ids, artistIds...)
|
|
|
|
err := api.setStar(r.Context(), true, ids...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return newResponse(), nil
|
|
}
|
|
|
|
func (api *Router) Unstar(r *http.Request) (*responses.Subsonic, error) {
|
|
p := req.Params(r)
|
|
ids, _ := p.Strings("id")
|
|
albumIds, _ := p.Strings("albumId")
|
|
artistIds, _ := p.Strings("artistId")
|
|
if len(ids)+len(albumIds)+len(artistIds) == 0 {
|
|
return nil, newError(responses.ErrorMissingParameter, "Required id parameter is missing")
|
|
}
|
|
ids = append(ids, albumIds...)
|
|
ids = append(ids, artistIds...)
|
|
|
|
err := api.setStar(r.Context(), false, ids...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return newResponse(), nil
|
|
}
|
|
|
|
func (api *Router) setStar(ctx context.Context, star bool, ids ...string) error {
|
|
if len(ids) == 0 {
|
|
return nil
|
|
}
|
|
log.Debug(ctx, "Changing starred", "ids", ids, "starred", star)
|
|
if len(ids) == 0 {
|
|
log.Warn(ctx, "Cannot star/unstar an empty list of ids")
|
|
return nil
|
|
}
|
|
event := &events.RefreshResource{}
|
|
err := api.ds.WithTxImmediate(func(tx model.DataStore) error {
|
|
for _, id := range ids {
|
|
exist, err := tx.Album(ctx).Exists(id)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
if exist {
|
|
err = tx.Album(ctx).SetStar(star, id)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
event = event.With("album", id)
|
|
continue
|
|
}
|
|
exist, err = tx.Artist(ctx).Exists(id)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
if exist {
|
|
err = tx.Artist(ctx).SetStar(star, id)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
event = event.With("artist", id)
|
|
continue
|
|
}
|
|
err = tx.MediaFile(ctx).SetStar(star, id)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
event = event.With("song", id)
|
|
}
|
|
api.broker.SendMessage(ctx, event)
|
|
return nil
|
|
})
|
|
if err != nil {
|
|
log.Error(ctx, err)
|
|
return err
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (api *Router) Scrobble(r *http.Request) (*responses.Subsonic, error) {
|
|
p := req.Params(r)
|
|
ids, err := p.Strings("id")
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
times, _ := p.Times("time")
|
|
if len(times) > 0 && len(times) != len(ids) {
|
|
return nil, newError(responses.ErrorGeneric, "Wrong number of timestamps: %d, should be %d", len(times), len(ids))
|
|
}
|
|
submission := p.BoolOr("submission", true)
|
|
position := p.IntOr("position", 0)
|
|
ctx := r.Context()
|
|
|
|
if submission {
|
|
err := api.scrobblerSubmit(ctx, ids, times)
|
|
if err != nil {
|
|
log.Error(ctx, "Error registering scrobbles", "ids", ids, "times", times, err)
|
|
}
|
|
} else {
|
|
err := api.scrobblerNowPlaying(ctx, ids[0], position)
|
|
if err != nil {
|
|
log.Error(ctx, "Error setting NowPlaying", "id", ids[0], err)
|
|
}
|
|
}
|
|
|
|
return newResponse(), nil
|
|
}
|
|
|
|
func (api *Router) scrobblerSubmit(ctx context.Context, ids []string, times []time.Time) error {
|
|
var submissions []scrobbler.Submission
|
|
log.Debug(ctx, "Scrobbling tracks", "ids", ids, "times", times)
|
|
for i, id := range ids {
|
|
var t time.Time
|
|
if len(times) > 0 {
|
|
t = times[i]
|
|
} else {
|
|
t = time.Now()
|
|
}
|
|
submissions = append(submissions, scrobbler.Submission{TrackID: id, Timestamp: t})
|
|
}
|
|
|
|
return api.scrobbler.Submit(ctx, submissions)
|
|
}
|
|
|
|
func (api *Router) scrobblerNowPlaying(ctx context.Context, trackId string, position int) error {
|
|
mf, err := api.ds.MediaFile(ctx).Get(trackId)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
if mf == nil {
|
|
return fmt.Errorf(`ID "%s" not found`, trackId)
|
|
}
|
|
|
|
player, _ := request.PlayerFrom(ctx)
|
|
username, _ := request.UsernameFrom(ctx)
|
|
client, _ := request.ClientFrom(ctx)
|
|
clientId, ok := request.ClientUniqueIdFrom(ctx)
|
|
if !ok {
|
|
clientId = player.ID
|
|
}
|
|
|
|
log.Info(ctx, "Now Playing", "title", mf.Title, "artist", mf.Artist, "user", username, "player", player.Name, "position", position)
|
|
return api.scrobbler.ReportPlayback(ctx, scrobbler.ReportPlaybackParams{
|
|
MediaId: trackId,
|
|
PositionMs: int64(position) * 1000,
|
|
State: scrobbler.StatePlaying,
|
|
PlaybackRate: 1.0,
|
|
ClientId: clientId,
|
|
ClientName: client,
|
|
})
|
|
}
|
|
|
|
func (api *Router) ReportPlayback(r *http.Request) (*responses.Subsonic, error) {
|
|
p := req.Params(r)
|
|
mediaId, err := p.String("mediaId")
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
mediaType, err := p.String("mediaType")
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
positionMs, err := p.Int64("positionMs")
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
if positionMs < 0 {
|
|
return nil, newError(responses.ErrorGeneric, "positionMs must be non-negative")
|
|
}
|
|
state, err := p.String("state")
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
if !scrobbler.ValidStates[state] {
|
|
return nil, newError(responses.ErrorGeneric, "Invalid state: %s", state)
|
|
}
|
|
|
|
playbackRate := p.Float64Or("playbackRate", 1.0)
|
|
if math.IsNaN(playbackRate) || math.IsInf(playbackRate, 0) || playbackRate <= 0 {
|
|
return nil, newError(responses.ErrorGeneric, "playbackRate must be a finite positive number")
|
|
}
|
|
ignoreScrobble := p.BoolOr("ignoreScrobble", false)
|
|
|
|
ctx := r.Context()
|
|
if mediaType != "song" {
|
|
log.Warn(ctx, "reportPlayback received unsupported mediaType", "mediaType", mediaType, "mediaId", mediaId)
|
|
}
|
|
|
|
player, _ := request.PlayerFrom(ctx)
|
|
client, _ := request.ClientFrom(ctx)
|
|
clientId, ok := request.ClientUniqueIdFrom(ctx)
|
|
if !ok {
|
|
clientId = player.ID
|
|
}
|
|
|
|
err = api.scrobbler.ReportPlayback(ctx, scrobbler.ReportPlaybackParams{
|
|
MediaId: mediaId,
|
|
PositionMs: positionMs,
|
|
State: state,
|
|
PlaybackRate: playbackRate,
|
|
IgnoreScrobble: ignoreScrobble,
|
|
ClientId: clientId,
|
|
ClientName: client,
|
|
})
|
|
if err != nil {
|
|
log.Error(ctx, "Error in ReportPlayback", "mediaId", mediaId, "state", state, err)
|
|
return nil, err
|
|
}
|
|
|
|
return newResponse(), nil
|
|
}
|