Class Radio

java.lang.Object
de.umass.lastfm.Radio

public class Radio extends Object
Provides access to the Last.fm radio streaming service.
Note that you have to be a subscriber (or have a special API key) to use this API. Official documentation can be found here http://www.last.fm/api/radio
Author:
Janni Kovacs
  • Method Details

    • getType

      public String getType()
    • getStationName

      public String getStationName()
    • getStationUrl

      public String getStationUrl()
    • supportsDiscovery

      public boolean supportsDiscovery()
    • playlistExpiresIn

      public int playlistExpiresIn()
      Returns the playlist expiration value for the last playlist fetchet, or -1 if no playlist has been fetched yet.
      Returns:
      playlist expiration in seconds
    • tune

      public static Radio tune(Radio.RadioStation station, Session session)
      Tune in to a Last.fm radio station.
      Parameters:
      station - An instance of Radio.RadioStation
      session - A Session instance
      Returns:
      a Radio instance
    • tune

      public static Radio tune(Radio.RadioStation station, Locale locale, Session session)
      Tune in to a Last.fm radio station.
      Parameters:
      station - An instance of Radio.RadioStation
      locale - The language you want the radio's name in
      session - A Session instance
      Returns:
      a Radio instance
    • tune

      public static Radio tune(String station, Locale locale, Session session)
      Tune in to a Last.fm radio station.
      Parameters:
      station - A lastfm radio URL
      locale - The language you want the radio's name in
      session - A Session instance
      Returns:
      a Radio instance
    • getPlaylist

      public Playlist getPlaylist()
      Fetches a new radio playlist.
      Returns:
      a new Playlist
    • getPlaylist

      public Playlist getPlaylist(boolean discovery, boolean rtp)
      Fetches a new radio playlist.
      Parameters:
      discovery - Whether to request last.fm content with discovery mode switched on
      rtp - Whether the user is scrobbling or not during this radio session (helps content generation)
      Returns:
      a new Playlist