The Radio activity allows you to play streaming audio from internet radio stations in your application.
It's similar to the Audio activity, with additional support for SHOUTcast and Icecast streaming audio.
To add a Radio activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select SHOUTcast Radio from the list.
The name for this activity. This will appear on the dashboard, toolbar, and navigation drawer. It can be whatever you want. For example: "National Public Radio"
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.
A relative index that controls the order of the activities in your application. The position affects where your activity is displayed on the dashboard and navigation drawer. You can use any value you want; all that matters is how the value compares to the position indexes of other activities.
For more information on this setting please read: How to change the order of the icons on the dashboard.
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.
The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.
The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.
The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.
The type of radio URL you're connecting to. Choose from the following three options:
- Playlist - an .m3u, .pls, or .asx file containing links to individual audio tracks
- SHOUTcast Playlist - an .m3u, .pls, or .asx file containing links to SHOUTcast/Icecast server streams
- SHOUTcast Stream - a direct link to a SHOUTcast/Icecast server stream
Choosing Playlist or SHOUTcast Playlist will make the app treat the URL as a playlist file. It will attempt to download the file at that URL and parse it in order to expand it into individual tracks.
Choosing SHOUTcast Playlist or SHOUTcast Stream will make the app treat the URL as a SHOUTcast or Icecast server. It will connect to the server every 30 to 60 seconds in order to retrieve metadata about the radio channel and the current song. If successful, this information will be shown above the media controls at the bottom of the screen:
Note: not all SHOUTcast servers provide this information. If your channel doesn't transmit the song titles, you may want to switch to the Playlist setting so your app doesn't use any bandwidth attempting to retrieve the metadata.
The URL of your playlist or SHOUTcast stream. Make sure you choose the appropriate Radio Type for the file this URL points to.
For example, http://yp.shoutcast.com/sbin/tunein-station.pls?id=21585 is the URL to a SHOUTcast playlist file.
This checkbox controls whether or not the share icon/menu item will be shown on the activity's toolbar and context menu.
Automatically start playing the first track after opening this activity.
The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity.