H.1 LiveAudio

The LiveAudio plug-in plays audio files in most common formats, including AIFF, AU, MIDI, and WAV. It is bundled with Navigator 3.0 on Windows and Macintosh platforms. Its LiveConnect API consists of the following 14 methods:

end_time(seconds)

Specify the time at which the audio clip should stop playing. Calling this method overrides the STARTTIME attribute.

fade_from_to(from, to)

Fade the sound from the volume from to the volume to. Both volumes should be volume percentages expressed as integers between 0 and 100.

fade_to(volume)

Fade the sound to the specified volume. This argument specifies volume as a percentage of maximum volume and should be expressed as an integer between 0 and 100.

GetVolume()

Returns the current volume of the sound, as an integer between 0 and 100. This number represents a percentage of maximum volume.

IsPaused()

Returns true if the sound is paused; false otherwise.

IsPlaying()

Returns true if the sound is playing; false otherwise.

IsReady()

Returns true if the sound has completed loading and the plug-in is ready to play it.

pause()

Pause sound playing, without restarting at the beginning.

play(loop, url)

Play the sound specified by url. If loop is true, then the sound should be played over and over again continuously. If loop is false, then it should be played only once. Otherwise, if loop is an integer, it specifies the number of times that the sound should be played. This loop argument corresponds closely to the HTML LOOP attribute.

setvol(volume)

Sets the volume of the sound to volume. This argument represents the volume as a percentage of the maximum volume and should be expressed as an integer between 0 and 100.

start_at_beginning()

This method overrides the start_time() method or the STARTTIME HTML attribute and forces the sound to be played from the beginning.

stop()

Stop playing the sound.

StopAll()

Stop playing the sound and all other sounds controlled by the LiveAudio plug-in.

stop_at_end()

Calling this method overrides the end_time() method and the ENDTIME HTML attribute and forces the sound to be played all the way to the end.