Class Radio


  • public class Radio
    extends java.lang.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 Detail

      • getType

        public java.lang.String getType()
      • getStationName

        public java.lang.String getStationName()
      • getStationUrl

        public java.lang.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,
                                 java.util.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​(java.lang.String station,
                                 java.util.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