You may send custom parameters to the PlayerApplet using <param> tags inside the <applet> tag. All tags are optional unless marked "(required)".
PlayerApplet Parameter Reference
| Applet Tag |
Meaning |
Default Value |
autoPlay
(example) |
Start playin the recording automatically as soon as possible after it is loaded. The user will not have to hit the Play button. |
E6E3D0 but may change. |
background
(example) |
Hex RGB value for the background color, eg. "FFFF00" for yellow. |
E6E3D0 but may change. |
bevelSize
(example) |
Size in pixels for bevel around Applet. Use zero for no bevel. |
4 |
| debugLevel |
Controls how many debug messages are printed to the Java console. Value="0" for terse, "1" for informative, "2" for verbose. |
0 |
| useFileCache |
If set to "yes" then cache recordings and temporary files on the client hard drive. This requires the use of a signed JAR file such as "JavaSonicsListenUp.jar". It also requires the use of SUN Java or other Java that support signed Applets. Microsoft JVM not currently supported for this feature. |
"no" |
foreground
(example) |
Hex RGB value for the foreground color, eg. "0000FF" for blue. |
000000 |
| packButtons |
Move stop/pause/play buttons closer together so they are touching. |
no |
| sampleURL |
The URL of a sample to be played. Supported formats include:
- 8 or 16 bit AIFF file,
- 8 or 16 bit WAV file,
- IMA ADPCM WAV file,
- Speex file ending in ".spx".
See also the loadRecording() method for JavaScript. |
null |
skin
(example) |
The URL of a composite image that contains the transport buttons in multiple states. A skin is a single image with 4 rows and 4 columns. The skin can be any size but the width and height must be divisable by 4.
Row 1 = play button
Row 2 = stop button
Row 3 = record button
Row 4 = pause button
Column 1 = normal
Column 2 = disabled
Column 3 = mouseOver
Column 4 = mouseDown |
Uses default skin in JAR file.

|
| latencyInFrames |
Specify audio latency. Controls size of audio buffer and delay between program and audio being played or recorded. |
Depends on sample rate and operating system. |
| password |
Specify password to use when authenticating uploaded audio data. Use with "userName". Also see section on security. |
null |
| readyScript |
JavaScript that will be called when the Applet has loaded and finished initializing. You could, for example, call a JavaScript function that enabled Play and Record buttons in an HTML FORM. This would prevent clicking on those buttons and calling the Applet before it is ready. |
null |
| requestLevelChanges |
If set to "yes" then ask that JavaScript will be called periodically as the recording is recorded or played back. ListenUp will call the function:
LUPJS_LevelChanged( currentLevel )
The currentLevel will range from 0.0 to 1.0. It can be used to drive a VU Meter type display. |
no |
| requestStateChanges |
If set to "yes" then ask that JavaScript be called when the Applet changes state, for example when changing from "stopped" to "playing". ListenUp will call the function:
LUPJS_StateChanged( previousState, newState )
States are "stopped", "playing", recording", "paused", or "aborted". You could use this, for example, to enable or disable Play and Record buttons in an HTML FORM. |
no |
| requestTimeChanges |
If set to "yes" then ask that JavaScript will be called periodically as the recording is recorded or played back. The frequency of this call can be controlled using the "timeChangeInterval" parameter below. ListenUp will call the function:
LUPJS_TimeChanged( currentTime, maxTime )
When recording, maxTime is the maximum length of th recording in seconds set by maxRecordTime parameter. When playing, maxTime is the length of the recording. |
no |
| showLogo |
Turns on or off display of JavaSonics logo. (This required a special "nologo" license option before V1.83.) |
yes |
| showPauseButton |
If set to "no" then do not show the "Pause" button. You are welcome to provide an equivalent HTML button and use JavaScript to call pauseAudio(). |
yes |
| showPositionDisplay |
If set to "no" then do not show the position scroll bar. If "showWaveform" is set then this has no effect. |
yes |
| showTimeText |
If set to "no" then do not show the recording time display. |
yes |
| showVUMeter |
If set to "no" then do not show the VU Meter bar graph display. |
yes |
| showTransport |
Can be used to hide the transport controls (Start/Stop/Record/Pause). You must then provide equivalent HTML buttons and use JavaScript to call startAudio(), stopAudio(), record() and pause(). Note that currently only Windows supports calling Java from JavaScript. |
yes |
| showWaveform |
Use a waveform display instead of the scrollbar to indicate position. The waveform is a visual representation of the recorded message. |
no |
| timeChangeInterval |
Specify how often the recording time display will be updated, in milliseconds. |
50 |
| useTextButtons |
Use text buttons for the stop, play, pause and record buttons. This is mainly for visually impaired users who are using a screen reader that cannot decipher the iconic buttons. |
no |
| userName |
Specify userName to use when authenticating uploaded audio data. Use with "password". Also see section on security. |
null |