Audio Activity

The Audio Player Activity allows you to play audio files within the application.

Adding an Audio Player Activity

To add an Audio Player 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 Audio Player from the list.

Settings

Activity Name

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: "Rocking Guitar Solos"

Description

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.

Position

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

Icon

This is where you can select the icon that will be used to represent this activity on the dashboard.

Details

Player Mode

The Audio Player activity supports two different player modes: Music Player, and Sound Board.

  • Music Player

    The Music Player mode is intended for presenting your audio as an album of songs or playlist. It is a more appropriate interface when you're presenting longer tracks where the ability to pause and seek is useful.

    • media controls are visible (the Play/Pause button, seek bar, etc.)
    • when one track finishes, the next track automatically begins playing by default
    • the currently playing track will continue to play when you exit the activity

    Here is an example of an Audio Player activity in Music Player mode:

    screenshot-audio_no_device.png

  • Sound Board

    The Sound Board mode presents your audio as a list of sounds. It is a more appropriate interface when you're presenting short sounds where pausing and seeking are not important.

    • no media controls
    • when one track finishes, playback ends by default
    • the currently playing track is stopped when you exit the activity

    Here is an example of an Audio Player activity in Sound Board mode:

    swedish-chef-soundboard.png

Enable 'Set as Ringtone' menu options

This checkbox controls whether the following three items will appear in the context menu when someone long-presses on an audio track in the list:

  • Set as ringtone
  • Set as notification sound
  • Set as default alarm sound

Setting a ringtone involves copying the audio file to external storage on the user's device. (Audio tracks that are hosted on a remote web server will be downloaded to the user's device.)

Note: because users have full access to any files within external storage, enabling this setting effectively gives the user access to your audio files.

Colors

Track Titles

The color that will be used for the titles in the track list.

Track Descriptions

The color that will be used for the descriptions in the track list.

Background Image

This is where you can select an optional background image that will be displayed behind the list of audio tracks. Click the 'Browse' button to select an image file.

Effect

You can have Andromo apply an effect to your background image, for example to make the text easier to read.

  • None

    Does not apply any effect to your image (your image remains unchanged).

  • Frosted

    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.

  • Midnight

    Converts your image to greyscale and reduces its intensity, resulting in a cool dark background that works well with the standard text colors.

Audio Playlist

The Audio Playlist section only appears once the Audio Player activity has been saved.

The list of audio tracks in the activity will appear here. You may add new audio tracks to the list by clicking the Add Audio Track button.

Activity URL

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.

Save Changes

Once you're finished entering the above information, click on the 'Save Changes' button to create your Audio Player activity, and begin the process of adding audio tracks.

Adding Audio Tracks

Once you've created your Audio Player activity, the next step is to start adding audio tracks.

See Audio Tracks for information about the audio track settings.

Supported Formats

See Supported Audio Formats.

Streaming Audio

See Streaming Audio.

File Sizes

See Audio File Sizes.

Recent Discussions

23 Oct, 2014 03:18 AM
22 Oct, 2014 06:20 PM
22 Oct, 2014 02:38 PM
22 Oct, 2014 01:21 PM
22 Oct, 2014 12:38 PM