Configuration of the NanoGong Applet Using Applet Parameters

If you are going to use NanoGong in Moodle, you can simply ignore this page. Just follow the installation instructions, for Moodle 1 here or for Moodle 2 here, and everything will be handled for you.

The NanoGong applet can be configured using several applet parameters. Some of these parameters are used to alter the appearance of the user interface, some others are used to adjust the quality of the recording and one is used to load a pre-recorded voice file for the NanoGong applet.

Below is the list of the parameters that can be configured:

  • ShowRecordButton

    An Example NanoGong Display
    The NanoGong Applet
    without the Record Button
    You can optionally hide the Record button from the NanoGong interface. The button can be hidden by setting this parameter to "false".

    The following is an example of the HTML code to hide the Record button:

    <applet archive="nanogong.jar" code="gong.NanoGong" width="150" height="40"> <param name="ShowRecordButton" value="false" /> </applet>
  • ShowSaveButton

    An Example NanoGong Display
    The NanoGong Applet
    without the Save Button
    You can also optionally hide the Save button from the NanoGong interface. By setting this parameter to "false" the button would be hidden from the applet.

    The following is an example of the HTML code to hide the Save button:

    <applet archive="nanogong.jar" code="gong.NanoGong" width="150" height="40"> <param name="ShowSaveButton" value="false" /> </applet>
  • ShowSpeedButton

    An Example NanoGong Display
    The NanoGong Applet
    without the Speed Buttons
    Similarly you can optionally hide the Speed buttons from the NanoGong interface. The speed up/slow down buttons are hidden if the parameter is set to "false".

    The following is an example of the HTML code to hide the speed buttons:

    <applet archive="nanogong.jar" code="gong.NanoGong" width="145" height="40"> <param name="ShowSpeedButton" value="false" /> </applet>
  • ShowAudioLevel

    An Example NanoGong Display
    The NanoGong Applet without
    the Audio Level Indicator
    The last user interface item that can be hidden is the audio level indicator. Again you can hide the item by setting the corresponding parameter to "false".

    The following is an example of the HTML code to hide the audio level indicator:

    <applet archive="nanogong.jar" code="gong.NanoGong" width="160" height="40"> <param name="ShowAudioLevel" value="false" /> </applet>
  • ShowTime

    An Example NanoGong Display
    The NanoGong Applet with
    the Time Display
    You can optionally show a time display in the NanoGong interface. By setting the parameter to "true" the time display would be shown in the applet when the mouse hovers over the timeline.

    The following is an example of the HTML code to show the time display:

    <applet archive="nanogong.jar" code="gong.NanoGong" width="180" height="40"> <param name="ShowTime" value="true" /> </applet>
  • Color

    An Example NanoGong Display
    The NanoGong Applet in
    a Different Color (Light Red)
    The color of the NanoGong applet can be changed using this parameter so that the applet can use a colour in your web page style. The color is specified in this form, #rrggbb, where rr, gg and bb are hexadecimal values in the range of 00 to FF.

    The following is an example of the HTML code to change the color to light red:

    <applet archive="nanogong.jar" code="gong.NanoGong" width="180" height="40"> <param name="Color" value="#FFF0F0" /> </applet>
  • SoundFileURL

    This parameter sets a pre-recorded sound file to be loaded in the NanoGong applet when it starts. That means the applet can be used as a playback component by providing an appropriate sound file. This parameter can be a relative location or absolute URL. For example, by using a relative URL you can load a file from a directory (or any sub-directory) where the applet is located.

    <applet archive="nanogong.jar" code="gong.NanoGong" width="180" height="40"> <param name="SoundFileURL" value="http://somewhere.com/mysoundfile.wav" /> </applet>
  • StartTime

    This parameter specifies the time of the pre-recorded sound file to start loading in the NanoGong applet. Together with the EndTime parameter, a section of the pre-recorded sound file, given by the SoundFileURL parameter, can be extracted and loaded into the NanoGong applet when it starts. The value of the start time is expressed in seconds.

    This parameter can be used together with the SoundFileURL parameter without specifying the end time. In this case, the end time is the end of the pre-recorded sound file.

    <applet archive="nanogong.jar" code="gong.NanoGong" width="180" height="40"> <param name="StartTime" value="10.5" /> </applet>
  • EndTime

    This parameter specifies the time of the pre-recorded sound file to stop loading in the NanoGong applet. Together with the StartTime parameter, a section of the pre-recorded sound file, given by the SoundFileURL parameter, can be extracted and loaded into the NanoGong applet when it starts. The value of the end time is expressed in seconds.

    This parameter can be used together with the SoundFileURL parameter without specifying the start time. In this case, the start time is the start of the pre-recorded sound file.

    <applet archive="nanogong.jar" code="gong.NanoGong" width="180" height="40"> <param name="EndTime" value="65" /> </applet>
  • AudioFormat

    This parameter controls the audio format used when a new recording is created using the applet. Two types of audio format, Speex and ImaADPCM, can be selected. Speex is a format with a very high compression ratio and therefore it uses less space/time when saving or transmitting the recording. ImaADPCM is not as highly compressed as Speex but it can be saved using the WAV file format, which means it can be played back using any of the common audio player programs.

    The following is an example of the HTML code to change the audio format to ImaADPCM:

    <applet archive="nanogong.jar" code="gong.NanoGong" width="180" height="40"> <param name="AudioFormat" value="ImaADPCM" /> </applet>
  • SamplingRate

    This parameter sets the sampling rate when a new recording is created using the applet. The sampling rate represents the number of audio data used for each second of sound. A larger sampling rate produces a recording with a better quality but uses more space. By default, the sampling rate has a value of 44100, which produces an excellent audio quality. Common values for sampling rate are (from poor quality to excellent quality) 8000, 11025, 16000, 22050, 32000 and 44100.

    The following is an example of the HTML code to change the sampling rate to 32000:

    <applet archive="nanogong.jar" code="gong.NanoGong" width="180" height="40"> <param name="SamplingRate" value="32000" /> </applet>
  • MaxDuration

    This parameter sets the maximum duration, in seconds, a recording could be recorded by the NanoGong applet. By default, the applet has a 5 minutes maximum duration for recording. The duration can be set to at most 20 minutes, i.e. 1200 seconds.

    The following is an example of the HTML code to change the maximum duration to 1 minute:

    <applet archive="nanogong.jar" code="gong.NanoGong" width="180" height="40"> <param name="MaxDuration" value="60" /> </applet>

Proceed to try out the NanoGong applet with various parameters »