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. The name will appear on the dashboard and as the activity's title on the action bar. It can be whatever you want. For example: "National Public Radio"
A few words describing this activity. This text may be displayed on the dashboard as a subtitle when it's Show Subtitle Text setting is enabled.
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 in the action bar drop down. 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 any navigation drop-downs. 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.
This is where you can select the icon that will be used to represent this activity on the dashboard. Click the 'Browse' button to select and image file.
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.
Automatically start playing the first track after opening this activity.
The color that will be used for the titles in the track list.
The color that will be used for the descriptions in the track list.
This is where you can select a background image that will be displayed behind the list of audio tracks (optional). Click the 'Browse' button to select and image file.
You can have Andromo apply an effect to your background image, for example to make the text easier to read.
Does not apply any effect to your image (your image remains unchanged).
Overlays a translucent layer over your image, giving it a subtle "frosted" look that helps improve the contrast of text without changing the colors in your original background image too much.
Converts your image to greyscale and reduces its intensity, resulting in a cool dark background that works well with the standard text colors.
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.