Package se.michaelthelin.spotify.model_objects.specification

Class Track

java.lang.Object
se.michaelthelin.spotify.model_objects.AbstractModelObject
se.michaelthelin.spotify.model_objects.specification.Track
All Implemented Interfaces:
Serializable, IModelObject, IPlaylistItem, IArtistTrackModelObject, ISearchModelObject
public class Track extends AbstractModelObject implements IArtistTrackModelObject, ISearchModelObject, IPlaylistItem
Retrieve information about Track objects by building instances from this class.
See Also:

  • Method Details

    • getAlbum

      public AlbumSimplified getAlbum()
      Get the album on which the track appears.
      Returns:
      The album on which the track appears. The (simplified) album object includes a link in href to full information about the album.

    • getArtists

      public ArtistSimplified[] getArtists()
      Get the artists who performed the track.
      Returns:
      The artists who performed the track. Each artist object includes a link in href to more detailed information about the artist.

    • getAvailableMarkets

      public com.neovisionaries.i18n.CountryCode[] getAvailableMarkets()
      Get the country codes of all countries, in which the track is available.
      Returns:
      A list of the countries in which the track can be played, identified by their ISO 3166-1 alpha-2 code.

    • getDiscNumber

      public Integer getDiscNumber()
      Get the disc number of the track in its album.
      Returns:
      The disc number (usually 1 unless the album consists of more than one disc).

    • getDurationMs

      public Integer getDurationMs()
      Get the duration of the track in milliseconds.
      Specified by:
      getDurationMs in interface IPlaylistItem
      Returns:
      The track length in milliseconds.

    • getIsExplicit

      public Boolean getIsExplicit()
      Check whether the track is explicit or not.
      Returns:
      Whether or not the track has explicit lyrics (true = yes it does; false = no it does not OR unknown).

    • getExternalIds

      public ExternalId getExternalIds()
      Get the external IDs of the track.
      Example: isrc -> "International Standard Recording Code".
      Returns:
      Known external IDs for the track.

    • getExternalUrls

      public ExternalUrl getExternalUrls()
      Get the external URLs of the track.
      Example: Spotify-URL.
      Specified by:
      getExternalUrls in interface IPlaylistItem
      Returns:
      Known external URLs for this track.

    • getHref

      public String getHref()
      Get the full Spotify Web API endpoint URL of the track.
      Specified by:
      getHref in interface IPlaylistItem
      Returns:
      A link to the Web API endpoint providing full details of the track.

    • getId

      public String getId()
      Get the Spotify ID of the track.
      Specified by:
      getId in interface IPlaylistItem
      Returns:
      The Spotify ID for the track.

    • getIsPlayable

      public Boolean getIsPlayable()
      Check whether the track is playable in the market, which may has been specified somewhere before requesting it. Part of the response when Track Relinking is applied.
      Returns:
      If true, the track is playable in the given market. Otherwise false.

    • getLinkedFrom

      public TrackLink getLinkedFrom()
      Get the track link object of the track if Track Relinking was applied and the requested track has been replaced with a different track. The track in the linked_from object contains information about the originally requested track.
      Returns:
      The track in the linked_from object contains information about the originally requested track.

    • getRestrictions

      public Restrictions getRestrictions()
      Get the restrictions of the track. Part of the response when Track Relinking is applied, the original track is not available in the given market, and Spotify did not have any tracks to relink it with. The track response will still contain metadata for the original track, and a restrictions object containing the reason why the track is not available.
      Example: "restrictions" : {"reason" : "market"}
      Returns:
      The track response will still contain metadata for the original track, and a restrictions object containing the reason why the track is not available.

    • getName

      public String getName()
      Get the name of the track.
      Specified by:
      getName in interface IPlaylistItem
      Returns:
      Track name.

    • getPopularity

      public Integer getPopularity()
      Get the popularity of the track. The value will be between 0 and 100, with 100 being the most popular.

      The popularity of a track is a value between 0 and 100, with 100 being the most popular. The popularity is calculated by algorithm and is based, in the most part, on the total number of plays the track has had and how recent those plays are.

      Generally speaking, songs that are being played a lot now will have a higher popularity than songs that were played a lot in the past. Duplicate tracks (e.g. the same track from a single and an album) are rated independently. Artist and album popularity is derived mathematically from track popularity. Note that the popularity value may lag actual popularity by a few days: the value is not updated in real time.

      Returns:
      The popularity of the track. The value will be between 0 and 100, with 100 being the most popular.

    • getPreviewUrl

      public String getPreviewUrl()
      Get a link to a 30 second preview (MP3 format) of the track. null if not available.
      Returns:
      A link to a 30 second preview (MP3 format) of the track. null if not available.

    • getTrackNumber

      public Integer getTrackNumber()
      Get the track number of the track. If an album has several discs, the track number is the number on the specified disc.
      Returns:
      The number of the track.

    • getType

      public ModelObjectType getType()
      Get the model object type, which should be a "track" in this case.
      Specified by:
      getType in interface IPlaylistItem
      Returns:
      The object type: "track".

    • getUri

      public String getUri()
      Get the Spotify track URI.
      Specified by:
      getUri in interface IPlaylistItem
      Returns:
      The Spotify URI for the track.

    • toString

      public String toString()
      Description copied from class: AbstractModelObject
      Returns a String representation of this model object in the style:

      ModelObject(attr1=value1, attr2=value2, ...)

      Specified by:
      toString in class AbstractModelObject

    • builder

      public Track.Builder builder()
      Description copied from interface: IModelObject
      Create a builder for building an instance of a model object.
      The type of the builder and its methods depend on its corresponding implementation.
      Specified by:
      builder in interface IModelObject
      Returns:
      A builder object.

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object