The Gong Project User Guide

For Version 4.2.0C

Revision: 27 February 2009

This user guide is also available as a zip file.


Table of Contents


1 Introduction

1.1 What is Gong?

Gong is a tool that supports Internet-based text and audio communication. It allows groups of people such as students and teachers to participate in discussion groups using their computers. Participants can leave text and voice messages on voice boards. They can listen to and reply to other text and voice messages left by other people. A group of people can join a real-time text/ voice chat which can be recorded on voice boards. In addition, there are some powerful features such as support for multiple languages, styled text editing, voice editing, voice speed up/slow down, selective word/phrase playback and support for multilingual interface.

The Gong system is based on a client-server architecture. That means any user has to use software on their computer to connect to a server in order to participate in discussion groups. The administrator of the system can manage the Gong server through any web browser.

1.2 Features

The following table shows the major features in the Gong system.

Feature Brief Description
Streamed Playback Voice messages in the Gong system are streamed (played while being downloaded) from the server. Streaming reduces the waiting time when a voice recording is being played back.
Support for Multiple Languages The Gong system supports the display of multiple languages using what is called the Unicode system.
Styled Text Editing The Gong system is a tool for audio and text communication. You can format the text component of a message using various styles such as bold text and text alignments.
Voice Editing The voice component is recorded by a microphone. The Gong system has a simple audio editor so that the voice recording can be modified after it has been recorded.
Selective Word/Phrase Playback Given an English voice recording and its script, the Gong system allows a user to play a single word or phrase inside the recording just by clicking on the words. This is useful for English learning.
Voice Speed Up/Slow Down In addition to the normal voice playback of a message, the Gong system allows users to change the speed of the playback. A message can be played faster or slower without changing the pitch.
Voice Analysis Gong can be used as a tool for language learning. The system can analyze any voice recording to produce a spectrogram or waveform of the recording.
Chinese Mandarin Pinyin Romanization System The Pinyin romanization system is one form of Mandarin. It is often used to teach the pronunciation of the language. The Gong system supports the storage and display of this representation.
Chinese Cantonese Yale Romanization System The Cantonese Yale romanization system is a form of representation of Cantonese, one of the major dialects of Chinese. The Gong system is specialized to support this romanization system for Cantonese learners.
Real-time Text/Voice Chat Two or more than two persons can participate in a text/voice chat on the Gong system. The chat is configurable. For example, you can choose whether or not to use text chat and/or audio chat, and whether or not to record the chat.
Personal Messaging You can send instant text messages to any other persons who are also logged on the Gong system. These messages act as a quick communication tool apart from using the voice messages and voice chat.
Compact Version - MiniGong MiniGong is the compact version of the Gong system. Its compact size (480 x 115) means that it can be put in a webpage easily. To the user it acts like a software CD player, but all the sound is accessed through the web, and more recordings can be added.
Multilingual Interface The user interface of the Gong system can be displayed in different languages. At the moment, five sets of languages are available for selection: American English, British English, Japanese, Traditional Chinese and Simplified Chinese.
Gong Integration Parameters The Gong system has basic support for integration into other Learning Management Systems (LMS) through its parameters. Configuration of color, language, login details can be automatically controlled by the LMS.
Gong Applet Scripting Interface Using the Gong applet scripting interface any components on a Web page can manipulate a Gong applet within the same page. For example a Flash program can have the functionalities of the Gong system with a behind the scene Gong engine.

1.3 Application vs Applet

The Gong system can be executed as:

To use the applet version of the system, the installation of the Java™ 2 runtime environment is required. The latest Java™ 2 runtime environment can be downloaded from http://java.sun.com/getjava.

If the application version is used, you are not required to install Java™ explicitly because it is embedded in the software.

1.4 System Requirements

The following two tables summarize the hardware and software requirements of the Gong system.

Hardware Requirement
Platform Any system that supports Java™ 2 Runtime Environment
(PC is needed for generating word indexing information for selective word/phrase playback)
Free Harddisk Space 100Mb or more
RAM 128Mb or more
Sound System Sound system with speakers and microphone
Internet Connectivity 56k modem connection or faster (broadband recommended)

Software Requirement
Operating System Windows® 95/98/ME/NT/2000/XP, Unix based OS, Macintosh
(Microsoft Windows® is needed for selective word/phrase playback)
Java™ Version Gong Application - No Java™ installation is required (Java™ is embedded)
Gong Applet - Java™ 2 Runtime Environment 1.4.2 or above
Supported Browser Admin Module - Internet Explorer 5.5 or above
Gong Applet - Internet Explorer 5 or above, Netscape 4.7 or above

2 Getting Started! (Under construction)

Sorry this section is under construction.

3 Interface Description

3.1 System Login

The system login interface is typically the first screen you would see when you start up the Gong system. Here you either log on the system with registered information (username and password) or log on as a guest user.

System Login
  1. Welcome message
    This message typically shows the welcoming message from the system.
  2. Username textfield
    You input your username into this field if you want to log on the Gong system with your registered information.
  3. Password textfield
    You input your password into this field if you want to log on the Gong system with your registered information.
  4. 'Ok' button
    You confirm your username/password input by pressing the button and log on the Gong system.
  5. 'Cancel' button
    You cancel the login procedure by pressing the button.
  6. 'Guest' button
    You press this button if you want to log on the Gong system as a guest user. Depending on the system configuration you may not be allowed to log on the system as a guest user and therefore this button is hidden from the interface.

Related user instructions:

3.2 Board Selection

The board selection interface is where you can select the discussion board you would like to read.

Board Selection
  1. Available board list
    The list shows the boards that you can select from. It contains only the boards that you can access and therefore different people would have different list.
  2. 'Move Up' button
    You can move the board selection to the one above the current selected board in the list.
  3. 'Move Down' button
    You can move the board selection to the one under the current selected board in the list.
  4. Board name
    This shows the board name of the board you have selected on the list.
  5. Board description
    This shows the description of the board you have selected on the list.
  6. Remarks of 'What you can do in this board'
    This describes your role in the board you have selected. For example it tells you whether you can create board messages or not.
  7. 'Ok' button
    You confirm your board selection by pressing the button.
  8. 'Cancel' button
    You cancel the board selection procedure by pressing the button.

Related user instructions:

3.3 Discussion Board

The discussion board is the place people leave their voice messages. You can read, listen to and reply to any messages on the board.

Gong Discussion Board
  1. Username textfield
    This shows the username of the current logged on user.
  2. 'Details' button
    You can see and modify your details and settings in the user details window by pressing the button.
  3. Board name textfield
    This shows the board name of the current selected discussion board.
  4. Gong client version
    This shows the version of the Gong client.
  5. 'System Information' button
    You can bring up the system information window by pressing the button.
  6. Online user list
    This is the list of users who currently log on the system and are in the same discussion board as you are. You can bring up the popup menu of the user if you right-click on a username. You may not have the user list on a discussion board depending on the settings of the board.
  7. 'Start Chat' button
    You can start a chat session by pressing the button.
  8. 'Compose' button
    You can create a new message by pressing the button. You may not be able to create new messages depending on the permission.
  9. 'Find' button
    You can search the subject and content of board messages by pressing the button.
  10. 'Help' button
    You can reach the help page of the Gong system (possibly the user guide you are reading now) by pressing the button.
  11. 'Expand' button
    You can expand all message nodes in the message tree by pressing the button.
  12. 'Collapse' button
    You can shrink the message tree to one level by pressing the button.
  13. 'Change' button
    You can change to another discussion board by pressing the button.
  14. 'Quit' button
    You can close and quit the system by pressing the button. You will not see the button if you are using the Java applet version of Gong.
  15. Message tree
    The tree contains all messages in the discussion board displayed in a hierarchical way.
  16. 'Play' button
    You can play back the voice recording by pressing the button.
  17. 'Pause' button
    You can pause the voice playback by pressing the button.
  18. 'Stop' button
    You can stop the playback by pressing the button.
  19. 'Reply' button
    You can reply to the selected message by pressing the button. You may not be able to reply messages depending on the permission.
  20. 'Edit' button
    You can edit the selected message by pressing the button. You may not be able to edit messages depending on the permission.
  21. 'Delete' button
    You can delete the selected message and any of its replies by pressing the button. You may not be able to delete messages depending on the permission.
  22. 'Analyze' button
    You can analysis the selected message by pressing the button.
  23. Current time of the voice recording
    This shows the current time of the voice playback.
  24. Total duration of the voice recording
    This shows the total length of the voice recording.
  25. 'Words per min' slider
    You can change the playback speed by moving the slider to the left (slower) or to the right (faster). If word indexing is performed on the message a number will be shown on the slider. This number indicates the speed in terms of words per minute of the playback speed.
  26. 'Normal Speed' button
    You can center the slider (i.e. normal speed) by pressing the button.
  27. Timeline
    You can change the playback time by clicking on the timeline. It also shows the current playback time in percentage of the total length of the voice recording.
  28. Indexing indicator
    This symbol indicates the message contains word indexing information. You can then selectively playback the voice recording based on the content (transcript).
  29. Volume control
    You can change the volume of the voice playback using the control.
  30. Message content
    This shows the text content of the message. You can bring up the context menu for the text content if you right-click on the area.

Related user instructions:

3.3.1 User List Menu

The user list menu pops up when you right-click on any name in the user list of the discussion board.

User List Menu
  1. User description
    This describes what the user is currently doing on the system.
  2. 'Send a personal message' option
    You can send a personal message to this user if you select the option.
  3. 'Read message box' option
    You can read the messages from this user if you select the option.
  4. 'Join his/her chat session' option
    You can join the chat session hosted by this user if you select the option.
  5. 'See his/her details' option
    You can see the user's details if you select the option.

Related user instructions:

3.3.2 Message Text Menu

The message text menu pops up when you right-click on the text area of a message. It mainly controls how the Chinese Mandarin Pinyin and Chinese Cantonese Yale are displayed.

Message Text Menu
  1. 'Display tones with lines' option
    You can change the display of tones with black lines above the corresponding vowel in Pinyin words and Yale words.
  2. 'Display tones with diacritics' option
    You can change the display of tones with diacritic marks above the corresponding vowel in Pinyin words and Yale words.
  3. 'Display tones with numbers' option
    You can change the display of tones with tone number at the end of Pinyin words and Yale words.
  4. 'Show romanization with highlights' checkbox
    You can highlight the Pinyin words and Yale words in the text area if you tick the checkbox.

3.3.3 Text Search

You can search for a text string in any message on a discussin board. The text search can be performed repeatly until all messages on the board is searched.

Text Search
  1. Search text textfield
    You input the text you would like to search for in the field.
  2. 'Match case' option
    You can perform a case-sensitive search if you select the option.
  3. 'Find whole words only' option
    You can perform a whole word match if you select the option. For example if you search for 'back', the word 'back' would be included in the result but not the word 'backward'.
  4. 'Regular expression' option
    You can search the discussion board using regular expression.
  5. 'Subject' option
    The text search includes the subject of the messages if you select the option.
  6. 'Content' option
    The text search includes the content of the messages if you select the option.
  7. 'Author' option
    The text search includes the author of the messages if you select the option.
  8. 'Find' button
    You can start the text search by pressing the button.
  9. 'Cancel' button
    You can cancel the search by pressing the button.

Related user instructions:

3.4 Message Composition

You can create or edit a message in the message composition interface. It can be brought up from the discussion board by either composing, editing or replying a message.

Message Composition
  1. 'Play' button
    You can play back the voice recording by pressing the button.
  2. 'Record' button
    You can make a new voice recording by pressing the button. If there is already a recording you will replace the current one with the new one.
  3. 'Pause' button
    You can pause the voice playback by pressing the button.
  4. 'Stop' button
    You can stop the playback or recording by pressing the button.
  5. 'Edit' button
    You can bring up the voice editor for editing the voice data by pressing the button.
  6. 'Index' button
    You can generate word indexing information using the current voice recording and text content of the message by pressing the button.
  7. 'Post' button
    You can post the current voice message by pressing the button.
  8. 'Abort' button
    You can abort the composition by pressing the button.
  9. Current time of the voice recording
    This shows the current time of the voice playback or the current recorded time.
  10. Total/ maximum duration of the voice recording
    This shows the total length of the voice recording or the maximum recordable length of new voice recording.
  11. Timeline
    You can change the playback time by clicking on the timeline. It also shows the current playback time in percentage of the total length of the voice recording.
  12. Volume control
    You can change the volume of the voice playback using the control.
  13. Audio level display
    This shows the microphone level during your voice recording. If this stays in a very low level during recording it means you need to adjust the input volume of your device.
  14. Name textfield
    You input your name in this field if you are a guest user. Otherwise your username is automatically shown in the field.
  15. Subject textfield
    You input the subject of the current voice message and it will be shown on the discussion board if the message is posted.
  16. Subject color
    You can change the color of your subject which appears on the discussion board. Depending on the configuration and your role you may not be able to change the color.
  17. Styled text formatting toolbar
    This toolbar contains the styled text formatting controls such as the style buttons and the hyperlink location field.
  18. Chinese Cantonese Yale interface checkbox
    You can show/hide the Chinese Cantonese Yale input interface using the checkbox. You may not be able to use the interface depending on the system configuration.
  19. Chinese Mandarin Pinyin interface checkbox
    You can show/hide the Chinese Mandarin Pinyin input interface using the checkbox. You may not be able to use the interface depending on the system configuration.
  20. Message content
    You input the message text content into this area.

Related user instructions:

3.4.1 Styled Text Format

The styled text formatting toolbar allows you to apply various text formatting to the text content of a message. In addition you can create hyperlinks in text as well.

Styled Text Format
  1. 'Bold' button
    You can make bold font or clear bold font by pressing the button. Alternatively you can use the keyboard shortcut 'Ctrl+B'.
  2. 'Italic' button
    You can make italic font or clear italic font for the selected text by pressing the button. Alternatively you can use the keyboard shortcut 'Ctrl+I'.
  3. 'Underline' button
    You can make underline font or clear underline font for the selected text by pressing the button. Alternatively you can use the keyboard shortcut 'Ctrl+U'.
  4. 'Left Justified' button
    You can justified the selected text to the left for the selected text by pressing the button.
  5. 'Centered' button
    You can center the selected text by pressing the button.
  6. 'Right Justified' button
    You can justified the selected text to the right by pressing the button.
  7. 'Normal Font' button
    You can make the font back to normal size for the selected text by pressing the button.
  8. 'Big Font' button
    You can make the font bigger for the selected text by pressing the button.
  9. 'Small Font' button
    You can make the font smaller for the selected text by pressing the button.
  10. 'Undo' button
    You can undo the last editing by pressing the button. Alternatively you can use the keyboard shortcut 'Ctrl+Z'.
  11. 'Redo' button
    You can redo any previously undone editing by pressing the button. Alternatively you can use the keyboard shortcut 'Ctrl+Y'.
  12. 'Hyperlink' button
    You can create/remove a hyperlink on the selected text by pressing the button.
  13. Location textfield
    You input the hyperlink location in the field when you want to create a hyperlink or you input blank when you want to remove a hyperlink.

Related user instructions:

3.4.2 Chinese Cantonese Yale Input

The Chinese Cantonese Yale interface allows you to create Cantonese Yale words in the text area.

Chinese Cantonese Yale Interface
  1. 'Clear' button
    You can clear any Yale tone for the selected text by pressing the button.
  2. 'High Falling' button
    You can make a high falling tone on the selected Yale syllable by pressing the button. Alternatively you can use the keyboard shortcut 'Alt+0'.
  3. 'High Level' button
    You can make a high level tone on the selected Yale syllable by pressing the button. Alternatively you can use the keyboard shortcut 'Alt+1'.
  4. 'High Rising' button
    You can make a high rising tone on the selected Yale syllable by pressing the button. Alternatively you can use the keyboard shortcut 'Alt+2'.
  5. 'Middle Level' button
    You can make a middle level tone on the selected Yale syllable by pressing the button. Alternatively you can use the keyboard shortcut 'Alt+3'.
  6. 'Low Falling' button
    You can make a low falling tone on the selected Yale syllable by pressing the button. Alternatively you can use the keyboard shortcut 'Alt+4'.
  7. 'Low Rising' button
    You can make a low rising tone on the selected Yale syllable by pressing the button. Alternatively you can use the keyboard shortcut 'Alt+5'.
  8. 'Low Level' button
    You can make a low level tone on the selected Yale syllable by pressing the button. Alternatively you can use the keyboard shortcut 'Alt+6'.
  9. 'Display Mode' selection box
    You can select different display modes for the Yale syllables in the text area. There are three choices:
    • Tones with Lines - shows the Yale tones with black lines above the corresponding vowel
    • Tones with Diacritics - shows the Yale tones with diacritic mark above the corresponding vowel
    • Tones with Numbers - shows the Yale tones with their tonal number at the end of the Yale syllable

Related user instructions:

3.4.3 Chinese Mandarin Pinyin Input

The Chinese Mandarin Pinyin interface allows you to create Mandarin Pinyin words in the text area.

Chinese Mandarin Pinyin Interface
  1. 'Clear' button
    You can clear any Pinyin tone for the selected text by pressing the button.
  2. 'Flat' button
    You can make a flat tone on the selected Pinyin syllable by pressing the button. Alternatively you can use the keyboard shortcut 'Alt+1'.
  3. 'Rising' button
    You can make a rising tone on the selected Pinyin syllable by pressing the button. Alternatively you can use the keyboard shortcut 'Alt+2'.
  4. 'Falling then Rising' button
    You can make a falling then rising tone on the selected Pinyin syllable by pressing the button. Alternatively you can use the keyboard shortcut 'Alt+3'.
  5. 'Falling' button
    You can make a falling tone on the selected Pinyin syllable by pressing the button. Alternatively you can use the keyboard shortcut 'Alt+4'.
  6. 'Neutral' button
    You can make a neutral tone on the selected Pinyin syllable by pressing the button. Alternatively you can use the keyboard shortcut 'Alt+5'.
  7. 'ü' button
    You can insert the ü vowel by pressing the button.
  8. 'Display Mode' selection box
    You can select different display modes for the Pinyin syllables in the text area. There are three choices:
    • Tones with Lines - shows the Pinyin tones with black lines above the corresponding vowel
    • Tones with Diacritics - shows the Pinyin tones with diacritic mark above the corresponding vowel
    • Tones with Numbers - shows the Pinyin tones with their tonal number at the end of the Pinyin syllable

Related user instructions:

3.4.4 Voice Editor

The voice editor is for users to make modifications to the voice data of a message. You can access the editor through the message composition interface.

Voice Editor
  1. 'Play' button
    You can play back the selected voice data or from the current time if no voice data is selected by pressing the button.
  2. 'Record' button
    You can insert a new recording at the current time if no voice data is selected or replace the current selected voice data with a new recording by pressing the button.
  3. 'Stop' button
    You can stop the playback or recording by pressing the button.
  4. 'Delete' button
    You can delete the selected voice data by pressing the button.
  5. 'Trim' button
    You can trim the selected voice data (deleting start and end of the data which are not selected) by pressing the button.
  6. 'Undo' button
    You can undo the last editing by pressing the button.
  7. 'Redo' button
    You can redo the previously undone editing by pressing the button.
  8. 'Finish' button
    You can finish the voice editing and optionally save the data by pressing the button.
  9. 'Zoom In' button
    You can zoom in the voice data by pressing the button.
  10. 'Zoom Out' button
    You can zoom out the voice data by pressing the button.
  11. 'Fit All' button
    You can fit the whole voice recording inside the voice data area by pressing the button.
  12. 'Fit Selection' button
    You can fit the selected voice data inside the voice data area by pressing the button.
  13. 'Select All' button
    You can select all of the voice data by pressing the button.
  14. Timeline
    This shows the time scale of the current voice data.
  15. Voice data
    This is the area which shows the voice data. You can
    • de-select the current selected voice data by clicking on the area;
    • select a portion of the data by clicking and dragging in the area;
    • select all of the voice data by double-clicking on the area.
  16. Current time
    This shows the current time of the playback or the current recorded time.
  17. Total duration of voice data
    This shows the total length of the voice data or the maximum recordable length of a new voice recording.
  18. Start time of the selected data
    This shows the start time of the selected region.
  19. End time of the selected data
    This shows the end time of the selected region.
  20. Total duration of the selected data
    This shows the duration of the selected region.
  21. Audio level display
    This shows the microphone level during your voice recording. If this stays in a very low level during recording it means you need to adjust the input volume of your device.

Related user instructions:

3.5 Voice Analysis

The voice analysis allows you to analyze the voice data by looking at its spectrogram or waveform. In addition the data is analyzed so that word indexing information can be produced if the message is an English message. You can bring up the analysis of a message from the discussion board.

Voice Analysis
  1. 'Play' button
    You can play back the voice recording by pressing the button.
  2. 'Stop' button
    You can stop the playback by pressing the button.
  3. 'Index' button
    You can tell the system to analyze the voice data in order to produce the word indexes.
  4. 'Clear' button
    You can clear the word indexes by pressing the button.
  5. 'Close' button
    You can close the analysis window and optionally save the word indexing information.
  6. Analysis model selection box
    You can select different models to perform the analysis for advanced users. In addition you can create a new model by using different combinations of model files.
  7. 'Show all models' checkbox
    You can select this box so that the word indexes of all models are shown on the voice data area.
  8. 'Zoom In' button
    You can zoom in the voice data by pressing the button.
  9. 'Zoom Out' button
    You can zoom out the voice data by pressing the button.
  10. 'Fit All' button
    You can fit the whole voice recording inside the voice data area by pressing the button.
  11. 'Fit Word' button
    You can fit the voice data using an appropriate scale for each word inside the voice data area by pressing the button.
  12. 'Spectrogram' option
    You can show the spectrogram of the voice data by selecting the option.
  13. Spectrogram size selection box
    You can change bin size of the spectrogram to give you different resolutions of the spectrogram.
  14. 'Waveform' option
    You can show the waveform of the voice data by selecting the option.
  15. Word indexing/timeline
    This shows the word indexes and their corresponding time in the voice data. The current word is shown in white while the rest are shown in gray.
  16. Voice data
    This displays the voice data in spectrogram or waveform depending on the selected option.
  17. Window splitter
    You can change the display area of the top half and bottom half of the window. By default the top half (voice data) is hidden.
  18. 'Words per min' slider
    You can change the playback speed by moving the slider to the left (slower) or to the right (faster). The number shown on the slider indicates the speed in terms of words per minute of the playback speed.
  19. 'Normal Speed' button
    You can center the slider (i.e. normal speed) by pressing the button.
  20. Message content
    This shows the text content of the message. You are not allowed to modify the content here.

Related user instructions:

3.5.1 New Data Model

This interface allows you to create a new model for performing voice analysis. A model is a combination of different files prepared in the recogniser directory.

Create New Model
  1. Name textfield
    You assign the name of your model in the field.
  2. Model file selection box
    You can select from a list of model files in the box.
  3. Dictionary selection box
    You can select from a list of dictionary files in the box.
  4. HMM list selection box
    You can select from a list of HMM listing files in the box.
  5. 'Ok' button
    You can confirm to create the new model by pressing the button.
  6. 'Cancel' button
    You can abort the creation of the model by pressing the button.

3.6 Personal Messaging

3.6.1 Sending Personal Message

The send message interface is where you send a personal text message to other users on the board. You can send a message using the user list on the discussion board.

Send Personal Message
  1. Recipient list
    This shows the recipients (one or more) you have selected when you choose to send this message.
  2. Message content textfield
    You input the text content of the personal message in the field.
  3. Message color
    You can select the color of your message.
  4. 'Send' button
    You confirm to send the personal message by pressing the button.
  5. 'Cancel' button
    You can abort the sending procedure by pressing the button.

Related user instructions:

3.6.2 Reading Personal Message

The read message interface contains the personal messages to and from another user. It is similar to the inbox and outbox of an email system. You can read messages from a user by using the user list on the discussion board.

Read Personal Message
  1. Sender name
    This shows the sender (or recipient) of the personal messages below.
  2. Personal messages
    This contains the personal messages sent from and to the user. The messages with regular font are sent from the user while the ones with italic font and brackets are sent to the user by you.
  3. 'Show your messages' checkbox
    You can select this checkbox in order to show the messages you have sent to the user as well as the messages he/she has sent to you. If you uncheck this box only messages sent from the user will be shown.
  4. 'Reply' button
    You can send a personal message to the sender by pressing the button.
  5. 'Clear' button
    You can clear all messages from memory by pressing the button. All messages will be lost because they are not stored anywhere in the system
  6. 'Close' button
    You can close this window by pressing the button.

Related user instructions:

3.7 Text/Voice Chat

3.7.1 Chat Initialization

The chat initialization takes place after you try to start a new chat session from the discussion board. In here you can configure the chat and select who you would like to chat with.

Chat Initialization
  1. Available user list
    This shows the current users who log on the same board as you do. You can select any of them to be invited to the chat session.
  2. 'Text Profile' option
    You can change the chat configurations to the predefined 'Text' profile by selecting this option.
  3. 'Voice Profile' option
    You can change the chat configurations to the predefined 'Voice' profile by selecting this option.
  4. 'Full Voice Profile' option
    You can change the chat configurations to the predefined 'Full Voice' profile by selecting this option.
  5. 'Broadcast Profile' option
    You can change the chat configurations to the predefined 'Broadcast' profile by selecting this option.
  6. Profile description
    This describes the settings of the profile you have selected above.
  7. 'Show Options' button
    You can choose to display the detailed chat options instead of the profile description.
  8. 'Private' option
    You can make your chat session a private session (only invited users can join the chat) by selecting the option.
  9. 'Public' option
    You can make your chat session a public session (anybody can join the chat) by selecting the option.
  10. Invitation instruction
    As a host you can invite other people to join the chat. This is the instructions on how to do it during you are chatting with others.
  11. 'Start' button
    You can start the chat session with the selected configurations by pressing the button.
  12. 'Cancel' button
    You can abort the initialization by pressing the button.

Related user instructions:

3.7.1.1 Chat Options

This is the detailed chat options that can be shown during chat initialization or before joining a chat session.

Chat Options
  1. 'Host Text Output' option
    The host can output text content if you select the option.
  2. 'Others Text Output' option
    Chat participants (excluding the host) can output text content if you select the option.
  3. 'Record Text' option
    The text conversation will be recorded if you select the option.
  4. 'Host Voice Output' option
    The host can output voice if you select the option.
  5. 'Others Voice Output' option
    Chat participants (excluding the host) can output voice if you select the option.
  6. 'Record Voice' option
    The voice conversation will be recorded if you select the option.
  7. 'Store Separate Speech' option
    The voice conversation will be recorded as a single stream as well as separate streams for each participants if you select the option. For example if you have two persons A and B chatting in the system, the system will save a stream with both person A's voice and person B's voice, a separate stream with person A's voice only and another one with person B's voice only.

3.7.2 Chat Description

The chat description shows up when you want to join a chat session from the discussion board.

Chat Description
  1. Current user list
    This shows the current users who have joined the chat.
  2. Chat description
    This describes the configurations of the chat session.
  3. 'Show Options' button
    You can choose to display the detailed chat options instead of the chat description.
  4. 'Join' button
    You can join the chat session by pressing the button.
  5. 'Cancel' button
    You can abort the operation by pressing the button.

Related user instructions:

3.7.3 Chat Session

The chat session interface is where you chat with other people in the system. Depending on the chat configurations you can use text and/or voice to chat with others. If you are the host you can also invite people to join the session.

Chat Session
  1. 'Invite' button
    You can invite other people to join the chat by pressing the button if you are the host.
  2. 'Record' button
    You can start recording the voice conversation by pressing the button if you are the host. You will not be able to do this if the chat session is not configured to do so.
  3. 'Stop' button
    You can stop the recording by pressing the button if you are the host.
  4. 'Post' button
    You can post and close the chat conversation by pressing the button if you are the host. You will not be able to do this if the chat session is not configured to do so.
  5. 'Abort' button
    You can close the chat conversation by pressing the button if you are the host. Otherwise you can only quit the chat without affecting other participants.
  6. Volume control
    You can change the volume of the voice conversation using the control.
  7. Audio level display
    This shows the microphone level during your voice output. If this stays in a very low level during the chat it means you need to adjust the input volume of your device.
  8. Current time
    This shows the time you have joined the chat.
  9. Recording status
    This shows the status of the voice recording of the conversation. By default, the conversation is not recorded. You may not be able to see the status depending on the chat configurations.
  10. Subject textfield
    You input the subject of the chat session in the field.
  11. Current user list
    This shows the current users who have joined the chat.
  12. Text conversation
    This is the text conversation of the chat session.
  13. Message textfield
    You input your text message in the field. The message will be sent to the chat conversation once you hit the 'Enter' key.
  14. Message color seleciton box
    You can select the color of your text message.

Related user instructions:

3.8 User Details and Settings

If you are not a guest user you can open the user details window from the discussion board. In the window you can change your details and preferences in the system.

3.8.1 Personal Details

The 'Personal Details' tab in the user details interface allows you to amend your personal information and password.

Personal Details
  1. 'Personal Settings' tab
    You can switch to the 'Personal Settings' tab by pressing here.
  2. Username textfield
    This shows your username when you log on the system.
  3. Name textfield
    You input your name into this field if you want to change it.
  4. Id textfield
    This shows your id assigned to you by the system.
  5. Email textfield
    You input your email into this field if you want to change it.
  6. Current password textfield
    You input your current password into this field if you want to change the password.
  7. New password textfield
    You input a new password into this field if you want to change your current one.
  8. Password confirmation textfield
    You input the new password into this field again to confirm the password change.
  9. 'Ok' button
    You can confirm the changes to your details and settings by pressing the button.
  10. 'Cancel' button
    You can abort the any changes by pressing the button.

Related user instructions:

3.8.2 Personal Settings

The 'Personal Settings' tab in the user details interface allows you to change your preferred settings.

Personal Settings
  1. 'Personal Details' tab
    You can switch to the 'Personal Details' tab by pressing here.
  2. Subject color selection box
    You can change your default subject color when you compose a new message on the discussion board in the future.
  3. 'Sound Notification' option
    You can choose to have sound notification or not. There is sound notification when there is new board message or personal message.
  4. System language selection box
    You can change the language display of the whole interface by changing this box. If you change it to 'Default' the language change will take effect next time you start the Gong system. Otherwise if you change to any other language the change will take effect immediately.
  5. 'Ok' button
    You can confirm the changes to your details and settings by pressing the button.
  6. 'Cancel' button
    You can abort the any changes by pressing the button.

Related user instructions:

3.9 System Information

The system information window can be brought up in the discussion board. It contains various tabs which provide different information to the Gong system you are currently running.

3.9.1 System

The 'System' tab in the system information window shows you the information related to the system you are using. You can bring up the system information window from the discussion board.

System
  1. 'Log' tab
    You can switch to the 'Log' tab by pressing here.
  2. 'Statistics' tab
    You can switch to the 'Statistics' tab by pressing here.
  3. 'About' tab
    You can switch to the 'About' tab by pressing here.
  4. 'People' tab
    You can switch to the 'People' tab by pressing here.
  5. Gong client version
    This shows the version of Gong client system you are currently using.
  6. Gong server version
    This shows the version of the Gong server you are currently connecting to.
  7. System architecture
    This shows the system you are currently using.
  8. Operating system
    This shows the operating system you are currently using.
  9. Operating system version
    This shows the version of operating system you are currently using.
  10. Java version
    This shows the version of Java you are currently using.
  11. 'Close' button
    You can close the system information window by pressing the button.

3.9.2 Logs

The 'Log' tab in the system information window allows you to download various logs from the server. These logs include the event log, error log and system information log. You can bring up the system information window from the discussion board.

Logs
  1. 'System' tab
    You can switch to the 'System' tab by pressing here.
  2. 'Statistics' tab
    You can switch to the 'Statistics' tab by pressing here.
  3. 'About' tab
    You can switch to the 'About' tab by pressing here.
  4. 'People' tab
    You can switch to the 'People' tab by pressing here.
  5. Log date textfield
    You input the log date into the field.
  6. 'Event Log' option
    You can select to download the event log from the server.
  7. 'Error Log' option
    You can select to download the error log from the server.
  8. 'System Info Log' option
    You can select to download the system information log from the server.
  9. 'Show' button
    You can show the selected log in the log window by pressing the button.
  10. 'Close' button
    You can close the system information window by pressing the button.

Related user instructions:

3.9.2.1 Log Window

The log window is used to show the log downloaded from the server. You can get one of the logs from the system information window.

Log Window
  1. Log date
    This shows the date of the log file currently showing.
  2. Log content
    This is the log content downloaded from the server.
  3. 'Ok' button
    You can close the log window by pressing the button.
  4. 'Copy' button
    You can copy the log content into the system clipboard by pressing the button.

3.9.3 Statistics

The 'Statistics' tab in the system information window allows you to generate two types of statistics. The board statistics are generated from the information on the discussion board you are looking at. The server statistics are generated from the event logs in the server. You can bring up the system information window from the discussion board.

Statistics
  1. 'System' tab
    You can switch to the 'System' tab by pressing here.
  2. 'Log' tab
    You can switch to the 'Log' tab by pressing here.
  3. 'About' tab
    You can switch to the 'About' tab by pressing here.
  4. 'People' tab
    You can switch to the 'People' tab by pressing here.
  5. Start time textfield
    You input the start time for the generation of the statistics.
  6. End time textfield
    You input the end time (optional) for the generation of the statistics.
  7. 'Board Stat' button
    You can generate the board statistics by pressing the button.
  8. 'Server Stat' button
    You can generate the server statistics in the statistics window by pressing the button.
  9. 'Close' button
    You can close the system information window in the statistics window by pressing the button.

Related user instructions:

3.9.3.1 Statistics Window

The statistics window is used to show the statistics of the discussion board or the server. You can choose to get one of these two from the system information window. The following screen display is an example of board statistics. Server statistics would have a screen display of minor differences mainly on the statistics categories.

Statistics Window
  1. Date range
    This shows the date range of the statistics generation.
  2. Statistics
    This is the generated statistics divided into different categories.
  3. Statistics description
    This shows the description of separate item selected above.
  4. 'Ok' button
    You can close the statistics window by pressing the button.
  5. 'Copy' button
    You can copy the statistics into the system clipboard by pressing the button.
  6. 'Save' button
    You can save the statistics into a file by pressing the button.

3.10 MiniGong Board

The MiniGong board is a mini version of the Gong discussion board. You can do most of the operations as in a normal Gong board but there are certain things that you would not be able to perform.

MiniGong Board
  1. 'Play' button
    You can play back the voice recording by pressing the button.
  2. 'Record' button
    You can make a new voice recording by pressing the button. If you have already made one recording without posting you will replace the current one with the new one.
  3. 'Pause' button
    You can pause the voice playback by pressing the button.
  4. 'Stop' button
    You can stop the playback or recording by pressing the button.
  5. 'Previous' button
    You can switch to the previous message on the board by pressing the button.
  6. 'Next' button
    You can switch to the next message on the board by pressing the button.
  7. 'Post' button
    You can post the current voice message by pressing the button.
  8. Board name
    This shows the current discussion board you are in.
  9. Message subject
    This shows the current subject you are listening to.
  10. 'Message List' button
    You can bring up the message list window by pressing the button.
  11. 'About' button
    You can see the information on MiniGong by pressing the button.
  12. 'Message Speed' slider
    You can change the playback speed by moving the slider to the left (slower) or to the right (faster).
  13. 'Normal Speed' button
    You can center the slider (i.e. normal speed) by pressing the button.
  14. Timeline
    You can change the playback time by clicking on the timeline. It also shows the current playback time in percentage of the total length of the voice recording.

Related user instructions:

3.10.1 Message List

The message list shows the available messages you can select from the board for the MiniGong.

Message List
  1. Message list
    You can select the message you would like to listen to from the list.
  2. 'Ok' button
    You can confirm the message selection by pressing the button.
  3. 'Cancel' button
    You can abort the selection by pressing the button.

Related user instructions:

4 User Instructions

4.1 Logging on the System

4.1.1 Logging on as Registered User

If you are a registered user in the Gong system you can log on the system using your registered username and password.

Instructions:

1Run the Gong application or applet.
2Input your Gong username and password in the corresponding textfields. The image shows an example using 'gibson' as the username with a six characters password.
3Click on the 'Ok' button to log on the system.

Related user interfaces:

4.1.2 Logging on as Guest User

If you are not a registered user in the Gong system you can log on to it as a guest user. However, depending on the configurations, there may be cases where guest users are not permitted in the system. The obvious way to know this is to look for the 'Guest' button in the system login interface.

Instructions:

1Run the Gong application or applet.
2Click on the 'Guest' button to log on as a guest user.

Related user interfaces:

4.2 Selecting a Discussion Board

After logging on the system you can go into the boards listed in the board selection interface. You should pay attention to your permission by looking at the remarks field of the selected board. There are three types of remarks:

If the remarks field does not contain anything that means you have full access rights in that particular discussion board.

Instructions:

1Log on the Gong system to reach the board selection interface.
2Select a board in the list using arrow keys, the 'Move Up' button or the 'Move Down' button.
3Check that you have selected the right board by looking at the description and remarks.
4Click on the 'Ok' button to select and go into the discussion board.

Related user interfaces:

4.3 Browsing Messages (Under construction)

Sorry this section is under construction.

4.4 Controlling Text/Voice Message (Under construction)

4.4.1 Controlling Text Component

Sorry this section is under construction.

4.4.2 Controlling Voice Component

Sorry this section is under construction.

4.5 Creating Message

In order to participate in discussion boards you need to be able to put messages on the board. Generally a message in Gong consists of two major components. One is the text component and another is the voice component. You can create a message with just the text component, the voice component or both.

The following instructions describe the general procedure on how to post a message on a board. Other detailed instructions in message composition are also included in the next few sections.

Instructions:

1Click on the 'Compose' button in the discussion board to bring up the message composition interface.
2Click on the 'Record' button to start the recording of your voice message.
3Pay attention to the audio level during recording. If the level is very low you may need to adjust the input volume of your audio device.
4Click on the 'Stop' button to stop the recording.
5Click on the 'Play' button to check the content of the voice recording. You can always make a new one if you want to. Alternatively you can use the voice editor to modify the voice data of your recording.
6Input the text content of your message in the text area. You can apply various text formatting using the styled text format toolbar.
7Input your name in the name textfield if you are a guest user. You do not need to enter it if you have logged on the system using a registered username.
8Input the subject of the message in the subject textfield.
9Click on the 'Post' button to post the message to the board.
The new message is posted at the top of the discussion board.

Related user interfaces:

4.5.1 Creating Hyperlink

Hyperlinks can be created on any text in a message during message composition.

Instructions:

1Select the text where you would like to add the hyperlink to.
2Input the address of the link in the location textfield.
3Click on the 'Hyperlink' button to create the link.
The hyperlink is added to the selected text.

Related user interfaces:

4.5.2 Removing Hyperlink

Hyperlinks can be removed with a similar procedure as in creating the hyperlink.

Instructions:

1Select the text where you would like to remove the hyperlink.
2Clear the location textfield with an empty address.
3Click on the 'Hyperlink' button to remove the link.
The hyperlink is removed.

Related user interfaces:

4.5.3 Chinese Cantonese Yale Input

You can input Chinese Cantonese Yale romanization using the Chinese Cantonese Yale interface in message composition. The Yale romanization is a combination of a Yale syllable and a tone. The system allows the input of the tone in relative ease.

Instructions:

1Tick the 'Cantonese Yale Interface' checkbox to activate the Chinese Cantonese Yale input.
2Input the Yale syllable.
3 Assign the tone to the syllable by one of the following methods:
3aHighlight the syllable and click on one of the tone buttons.
3b

Put the cursor at the end of the syllable and press the shortcut key of the tone.

* You should be able to enter Yale words fairly quickly using the shortcut keys because there is no need to highlight the word explicitly.

The tone is added on top of the Yale syllable. The example uses tone 5 which is the low rising tone.

Related user interfaces:

4.5.4 Chinese Mandarin Pinyin Input

You can input Chinese Mandarin Pinyin romanization using the Chinese Mandarin Pinyin interface in message composition. The Pinyin romanization is a combination of a Pinyin syllable and a tone. The system allows the input of the tone in relative ease.

Instructions:

1Tick the 'Mandarin Pinyin Interface' checkbox to activate the Chinese Mandarin Pinyin input.
2Input the Pinyin syllable.
3 Assign the tone to the syllable by one of the following methods:
3aHighlight the syllable and click on one of the tone buttons.
3b

Put the cursor at the end of the syllable and press the shortcut key of the tone.

* You should be able to enter Pinyin words fairly quickly using the shortcut keys because there is no need to highlight the word explicitly.

The tone is added on top of the Pinyin syllable. The example uses tone 3 which is the falling-then-rising tone.

Related user interfaces:

4.5.5 Editing Voice Data

You can edit your voice recording from the message composition interface when you are composing a new message, replying a message or editing a message. In the voice editor, you can perform one of the following three different operations:

Instructions:

1Click on the 'Edit' button in the message composition interface to bring up the voice editor.
2Apply any of the operations: delete, trim or insert/replace.
3Click on the 'Finish' button to save the modifications and close the editor.

Related user interfaces:

4.5.5.1 Deleting Voice Data

You can delete any selected voice data using the voice editor. You can even delete the entire voice recording in a voice message.

Instructions:

1Select the voice data you would like to remove from the voice recording by clicking-and-dragging on the data area.
2Click on the 'Delete' button to delete the selected voice data.
The selected voice data is deleted from the recording.

Related user interfaces:

4.5.5.2 Trimming Voice Data

You can delete any voice data that is not selected but keep the selected voice data using the voice editor. The operation is called trimming.

Instructions:

1Select the voice data you would like to keep in the voice recording by clicking-and-dragging on the data area.
2Click on the 'Trim' button to delete anything that is not selected.
The selected voice data is kept in the recording but others are deleted.

Related user interfaces:

4.5.5.3 Inserting/Replacing Voice Data

You can create new voice recording into the current one using the voice editor. There are two different situations where you can put in new voice data. The first situation is when you have not selected any voice data. The second one is when you do have part of the data selected. In the former case, when you create new voice recording it will be inserted in the current location. For the latter, the new voice recording will replace the one you have selected. You can even replace the entire recording if you select all of the voice data.

Instructions:

1i) If you would like to insert new voice data:
  • Click on the data area to pick the insertion point.
ii) If you would like to replace current data:
  • Click-and-drag the voice data to be replaced.
2Click on the 'Record' button to start making your new recording.
3Pay attention to the audio level during recording. If the level is very low you may need to adjust the input volume of your audio device.
4Click on the 'Stop' button to finish the recording.

i) New voice data is inserted at the insertion point.

ii) New voice data has replaced the selected voice data.

* Notice the length of the recording in the second case is shortened.

Related user interfaces:

4.6 Replying Message

You can reply to any message posted in a discussion board. Creating a reply is like creating a new message except that the message subject and the message text content are given for the reply.

Instructions:

1Select the message you would like to reply to in the message tree.
2Click on the 'Reply' button to bring up the message composition interface.
3Write and post the message similar to what you need to do when you create a message.
A reply is added to the selected message.

Related user interfaces:

4.7 Editing Message

Depending on the permissions you may be able to edit the content of a message in a discussion board. After the editing, the editor's name would also be listed on the message tree together with the original author of the message.

Instructions:

1Select the message you would like to edit in the message tree.
2Click on the 'Edit' button to bring up the message composition interface.
3Modify and post the message similar to what you need to do when you create a message.
In the example the subject of the selected message is modified.

Related user interfaces:

4.8 Deleting Message

Depending on the permissions you may be able to delete messages in a discussion board. You should be careful with this operation because once a message is deleted it would be impossible to recover it.

Instructions:

1Select the message you would like to delete in the message tree. If there are replies in the message those replies will also be deleted.
2Click on the 'Delete' button to delete the message and its replies.
The selected message and its replies are deleted.

Related user interfaces:

4.9 Searching Message

You can search for text string in all messages including authors, subjects and their text content on a discussion board. The search can be case-sensitive or case-insensitive and it can be done repeatedly through the entire board. You can also perform a search using regular expression.

Instructions:

1Click on the 'Find' button on the discussion board.
2Input the text you would like to search for.
3Click on the 'Find' button in the search window to start the search.
The searched text (the search string is 'nasa' in the example) is highlighted if result is found. You can perform the search again to find the next match.

Related user interfaces:

4.10 Analysing Message with Indexing

You can create word indexing information on an English voice message using voice analysis in the Gong system. The analysis tool allows you to match the voice and text if the voice is the spoken equivalent of the text and vice versa. The indexing information can be saved in the message and once the message is analyzed everybody on the discussion board would be able to use the information as well.

Instructions:

1

Create your voice message.

The message should contain a voice recording and a transcript which match each other. For example if you speak 'How are you' over the microphone you should input 'How are you' in the text area. You can add punctuations in the text and caps are not important. That means for example 'how are you!' and 'How are you?' would work fine as well.

2Select the message you have just created on the discussion board.
3Click on the 'Analyze' button to bring up the voice analysis window. Once the window comes up the message would be analyzed immediately.
4

Click on the 'Play' button to check the indexing of the message.

* If the word indexing does not work well at the start of the message it is usually because there is a long silence at the start of the voice which affects the result of the analysis. In this case you can close the analysis window, edit the message using the voice editor and remove the silence at the start and the end of the voice recording.

5Double-click on any of the words to check the indexing of a particular word.
6Click on the 'Close' button to close and save the word indexing information of the message.
The word indexing indicator should appear on the right-hand side of the timeline control.

Related user interfaces:

4.11 Personal Messaging

4.11.1 Sending Personal Message

You can send simple text message to other users logged on the same discussion board. These messages are not stored anywhere in the system and therefore they will be discarded once you quit the system.

Instructions:

1

Click on the user (the recipient of the personal message) on the user list of the discussion board to bring up the user list menu. 'gibson' will be clicked in this example.

* You can send to multiple users by pressing the control key while selecting the users and then right-click on the user list to bring up the menu.

2Select 'Send a personal message' on the user list menu to bring up the send message interface.
3Input the text message you would like to send to the recipient(s).
4Click on the 'Send' button to send the message.

Related user interfaces:

4.11.2 Reading Personal Message

When you receive a personal message from other users you will hear a 'ding' sound as an acknowledgement. You can then use the read message interface to read the messages from and to the user.

Instructions:

1Click on the user on the user list of the discussion board to bring up the user list menu. 'gibson' will be clicked in this example.
2

Select 'Read message box' on the user list menu to bring up the read message interface.

* You will have the read message option only when you have received any message from the user.

Related user interfaces:

4.12 Creating Text/Voice Chat

Depending on the permission of a discussion board you can chat with other people who log on the same board as you do. Through the chat initialization window you can configure a chat session so that you can chat with other people. You can set up a chat session easily because the Gong system provides four predefined profiles for you to select from:

In addition to the profile you can also select the privacy of the chat session. You can have a private session so that only the people you have invited can join the chat. Or you can have a public one which means everybody on the board can join your session. When you finish with the chat session you can post it on the board similar to what you did with a voice message.

Instructions:

1

Click on the 'Start Chat' button under the user list to bring up the chat initialization window.

* You can start a chat only if you can see the user list on the discussion board.

2Select any users on the user list to invite them to your chat session. In the example three people are selected for the invitation.
3Select the appropriate mode for the session.
4Select the privacy option of the session.
5Click on the 'Start' button to start the chat.
The chat session window is created after starting.

Related user interfaces:

4.12.1 Text Chat

In a chat session with text chat capability you can chat with other people by sending quick text message. The text content of the chat session also gives other information such as who has joined the chat or whether recording is being started or stopped.

Instructions:

1Select the message color in the color selection box.
2Input the text message in the message textfield and press 'Enter'.
The text is created in the text area of the session.

Related user interfaces:

4.12.2 Voice Chat with Recording

During a chat the host can choose to start/stop recording if the chat session is recordable. The recording can be started and stopped any number of times to increase the flexibility of the chat. At the start a recordable chat session is in its stop state.

Instructions:

1Click on the 'Record' button to start recording the session.
2Click on the 'Stop' button to stop the recording. You can start and stop as many number of times as you like.

Related user interfaces:

4.12.3 Inviting People

The host of a chat session can invite other people to join the chat session any time during the chat. For a private session only people who are invited would be able to join a session.

Instructions:

1Click on the 'Invite' button to show the available user list.
2Select the user(s) you would like to invite and click the 'Ok' button.

Related user interfaces:

4.12.4 Posting Text/Voice Chat

The host of a chat session can invite other people to join the chat session any time during the chat. For a private session only people who are invited would be able to join a session.

Instructions:

1Input the subject of the session in the subject textfield.
2Click on the 'Post' button to post the session on the board.
The session is posted at the top of the discussion board.

Related user interfaces:

4.13 Joining Text/Voice Chat

You can join a chat session in a discussion board if it is a public board or you are invited to join the board. If you are invited you will be asked by the system whether you would like to join or not. Otherwise you would have to select the chat session on the user list and join it explicitly.

Instructions:

1Click on the user who is hosting a chat session on the user list to bring up the user list menu.
2

Select 'Join his/her chat session' to bring up the chat session description.

* You can join a chat session if it is public only.

3Click on the 'Join' button to join the chat.

Related user interfaces:

4.14 Changing User Details and Settings

4.14.1 Changing the User Password

You can change your password in the Gong system at any time in the user details window.

Instructions:

1Open the user details window.
2Input your current password in the current password textfield.
3Input your new password in the new password textfield and the confirmation textfield.
4Click on the 'Ok' button to confirm the change.

Related user interfaces:

4.14.2 Changing the Interface Language

The Gong system provides different sets of language for the display of the interface. You can change the language using the user details window.

Instructions:

1Switch to the 'Personal Settings' tab after opening the user details window.
2Select the language in the language selection box. If you select 'Default' as the language you will only see the changes after restarting the discussion board. Otherwise the language will change immediately after you save and close the window.
3Click on the 'Ok' button to save the settings.
The language of the entire interface is changed. In this example the language selected is 'Traditional Chinese'.

Related user interfaces:

4.15 Showing Logs

There are three types of logs created in the Gong server. They are the event log, the error log and the system information log. You can download any of these logs for a particular date through the system information window.

Instructions:

1Switch to the 'Log' tab after opening the system information window.
2Input the date in the log date textfield to specify the date you would like to see.
3Select the log type you would like to download.
4Click on the 'Show' button to download the log.

Related user interfaces:

4.15.1 Event Log

The event log is created whenever the server has received these requests (values in brackets are the event code):

Each of the above requests would generate a line of log data at the end of the event log file in the following format.

[Event Code];[IP Address];[Username];[Date/Time];[Board];[Message Id];[Length]

4.15.2 Error Log

The error log is the collection of error messages when the server has an internal error. Each line of the error log file contains an error generated by the server. It takes the following format.

[IP Address];[Username];[Date/Time];[Board];[Location];[Reason]

4.15.3 System Information Log

The system information log collects the information of client machines so that any potential client problems can be analyzed accordingly. Each line in the system information log contains five values which are in the following format:

[Gong Client Version];[OS Architecture];[OS Name];[OS Version];[Java Version]

4.16 Generating Statistics

You can generate useful statistics for discussion boards discussion boards or server event logs. The statistics are divided into categories different in the statistics window for the ease of viewing.

Instructions:

1Switch to the 'Statistics' tab after opening the system information window.
2Input the date range in the textfields. If you would like to generate board statistics you may optionally leave one or both of the dates empty.
3Click on the 'Board Stat' button or 'Server Stat' button depending on which one you would like to generate.

Related user interfaces:

4.16.1 Board Statistics

Board statistics are generated using board data such as the number of messages and the total size of voice messages. Although you can only generate a set of statistics for each discussion board every user who has posted a message in the board would also have his/her own set of data. The statistics generated are categorized and visualized as the following hierarchical structure:

4.16.2 Server Statistics

Server statistics are generated from the event log resided in the server. The event log contains important information such as the number of times a particular user has logged on the system and the duration of voice messages a user has posted. The statistics downloaded from the server are categorized and visualized as the following hierarchical structure:

4.17 Using MiniGong

4.17.1 Browsing Messages

Using MiniGong is like using a CD player where you can easily play from message to message using the 'Previous' button and the 'Next' button. Alternatively you can play a specific message in the discussion board by selecting it from the list of messages. The restriction in MiniGong is that the list of messages will be shown in the top level only. In other words, all replies to any messages in the board will not be shown in MiniGong.

Instructions:

1Click on the 'Message List' button to bring up the message list window.
2Select a message on the message list.
3Click on the 'Ok' button to switch to the selected message. The voice message will be played immediately once you return to the MiniGong interface.

Related user interfaces:

4.17.2 Making New Message

You can always make new voice message using MiniGong. Depending on the permissions you can also post the voice message to the discussion board. The only difference, if compared to posting using the message composition interface, is that you cannot create any text component for messages created using MiniGong.

Instructions:

1Click on the 'Record' button to start the recording of your voice message.
2Click on the 'Stop' button to stop the recording.
3Click on the 'Play' button to check the content of the voice recording. You can always make a new one if you want to.
4Click on the 'Post' button to post the recording and you will be asked for the subject of the message.
5Input the subject in the textfield and click on the 'Ok' button to save the voice message.

Related user interfaces:

5 System Configurations

5.1 Gong Client Parameters

Client parameters control various aspects of the Gong client such as server connection and program appearance. If the Gong client is executed as an application program the parameters are provided in an INI file called 'gong.ini'. Otherwise if the Gong client is a Java applet™ the parameters are set as applet parameters.

The Gong client usually comes with an appropriate set of parameters. Therefore, you are not required to alter the values unless you understand what the parameters are used for.

The following table summaries the parameters for the Gong client and their descriptions.

Name Description
Server.Hostname The Gong server address.
Either the server's hostname or IP address can be used here.
Server.Port The Gong server connection port number.
The range is 0 to 65535. The default port number is port 8000.
Login.WelcomeMessage The welcome message to be shown at the log on window.
The parameter value can have one line only but can be expressed as two lines by separating the lines with a '\n' character. The default message is 'Welcome to the Gong system!\nPlease login:'.
Login.ShowGuestButton Whether to show the guest button on the log on window.
The value is either 'true' or 'false'. The default value is 'true'.
Message.ShowYaleInterface Whether to show the Cantonese Yale user interface on the message composition window.
The value is either 'true' or 'false'. The default value is 'false'.
Message.ShowPinyinInterface Whether to show the Pinyin user interface on the message composition window.
The value is either 'true' or 'false'. The default value is 'false'.
System.Color The system color to be used by basic controls.
The color is expressed in hexidecimal representation of the red, green and blue components. For example, red is 'ff0000' and light yellow is 'ffff80'. The default color in RGB values is (195, 225, 245), i.e. 'c3e1f5'.
System.SecondaryColor The system secondary color to be used by other controls.
The color is expressed in hexidecimal representation of the red, green and blue components. For example, red is 'ff0000' and light yellow is 'ffff80'. The default color in RGB values is (195, 225, 245), i.e. 'c3e1f5'.
System.BackgroundColor The system background color of windows.
The color is expressed in hexidecimal representation of the red, green and blue components. For example, red is 'ff0000' and light yellow is 'ffff80'. The default color in RGB values is (195, 225, 245), i.e. 'c3e1f5'.
System.ControlFont The system font of the controls.
Should be careful with the font choice because not all font can be used to display multilingual data. The default font is 'SansSerif'.
System.UserFont The system font of the user input data.
Should be careful with the font choice because not all font can be used to display multilingual data. The default font is 'SansSerif'.
System.Language The system language.
It selects the language to be used throughout the user interface. The value is expressed as the locale string. The currently available values are:
  • en - American English
  • en_UK - British English
  • ja - Japanese
  • zh - Traditional Chinese
  • zh_CN - Simplified Chinese
The default language is 'en'.
Info.Username The username to be used for logging on the system.
When this value is specified together with the password the system would skip the system logon process. In other words the user is automatically logged on the Gong system without the need to type in his/her username and password.
Info.Password The password to be used for logging on the system.
When this value is specified together with the username the system would skip the system logon process. In other words the user is automatically logged on the Gong system without the need to type in his/her username and password.
Info.Guest Whether to log on the system as a guest user.
This value can be true or false. When this value is true the user will log on the system automatically as a guest user.
Info.Board The selected board code in the system.
The code represents the board to be selected in the system. When this value is specified the board selection process will be skipped.
Info.Message The message id of a pre-selected message.
The id of the message is specified so that the system can select the right message when the user logs on the board.
Info.MessageSubject The message subject of a pre-selected message.
The keyword of the message subject is specified so that the system can select the right message when the user logs on the board.
Info.Encrypted Whether the sensitive information are encrypted.
This value can be true or false. When it is true this set of values (Info.Username, Info.Password, Info.Board) has to be encrypted with standard DES encryption algorithm.

5.1.1 Gong INI File

The Gong INI file is used to store the client parameters for the Gong application program. The parameters are listed in the file as a name-value pair in separate lines.

For example to specify the Gong server connection port as 8000 you can use a name-value pair of the 'Server.Port' parameter.

...
Server.Port=8000
...

Each parameter can only be put in one line unless a '\' is used to separate the lines. You can also write comments in the file using a '#' symbol in the beginning of a line.

5.1.2 Gong Applet Parameters

When Gong is executed as Java applet™ parameters are given as applet parameters. Applet parameters are listed as the HTML 'param' tags within the 'applet' element which are placed inside the HTML page containing the Gong applet.

For example to specify the Gong server connection port as 8000 you can put a 'param' tag using the 'Server.Port' parameter name.

<applet name='gong' archive='gong.jar' code='gong.GongApplet' ...>
  ...
  <param name='Server.Port' value='8000'>
  ...
</applet>

If there are more than one parameter you can put more than one 'param' tag inside the 'applet' element.

5.1.3 Encrypted Parameters (under construction)

Sorry this section is under construction.

5.1.3.1 JSP/Servlet Example

Sorry this section is under construction.

5.1.3.2 PHP Example

Sorry this section is under construction.

5.1.3.3 ASP Example

Sorry this section is under construction.

5.2 Gong Server Parameters

Server parameters control the Gong server execution. They are stored in an INI file called 'gongServer.ini'. These parameters are listed in the file as a name-value pair in separate lines. Only the server administrator would need to adjust the value of these parameters.

The following table shows the list of parameters that can be configured in the server.

Name Description
Server.Port The Gong server connection port number.
The range is 0 to 65535. The default port number is port 8000.
Server.ConnectionString The Gong server streaming connection string.
This value specifies the connection to use for chat sessions. The system will try in the order specified in the string for a valid connection so that streaming audio can be transmitted between the client and the server. The connection is expressed in tokens separated by semi-colons. Each token represents one available connection with this format:
<protocol: either udp or tcp>:<port number>
For example, a UDP connection on port 80 would be 'udp:80'. The default connection string is 'udp:6970; udp:7070; tcp:7070'.
Server.MaximumConnection The maximum number of users who can log on the server.
The default value is no limit, i.e. 0.
Server.MaximumConnectionError The error message returns to the client when the maximum number of users is reached.
The value can be separated into two lines using the '\n' character.
Server.ClientIdleLimit The user idle time to kick out a client connection.
If the user is idle for this specified amount of time, he/she may get kicked out of the server when the maximum user number is reached. The default value is no limit, i.e. 0.
Session.LocalConnectorLimit The limit of user connection without recording for a single chat session.
The default value is 20.
Session.LocalWriterLimit The limit of user connection with recording for a single chat session.
The default value is 5.
Session.GlobalConnectorLimit The limit of user connection without recording for chat sessions in the server.
The default value is 40.
Session.GlobalWriterLimit The limit of user connection with recording for chat sessions in the server.
The default value is 10.
Session.RecordingTimeLimit The maximum recording time of a chat session.
The value is in millisec. The default value is 600000, i.e. 10 mins.
Info.EncryptionKey The encryption key for the Gong client parameters.
The key is a string with a maximum length of 8 characters. If the length is less than 8 characters, padding zeros will be added at the end. The default value is 'Gong'.

5.3 Gong Applet Scripting Interface

A Gong applet scripting interface is provided by the Gong system in order to facilitate communications between the Gong applet and the HTML page containing the applet.

There are two functions provided in the interface:

Currently there are twenty one types of request which can be sent to a Gong applet. Each of the requests has its own parameter set. These parameters can be sent to the Gong applet as part of the XML string or in the 'param' argument when sent as plain text. Below is the list of requests that are available from the applet.

  1. Play Media
    Start the playback of the selected message in the Gong applet.
  2. Record Media
    Start a new recording in the Gong applet.
  3. Pause Media
    Temporarily stop an active playback of the media.
  4. Stop Media
    Stop an active playback or recording.
  5. Set Media Time
    Set the time of the media at any moment.
  6. Get Media Time
    Get the time of the media at any moment.
  7. Set Media Rate
    Set the playback rate of the media at any moment.
  8. Get Media Rate
    Get the playback rate of the media at any moment.
  9. Get Media Status
    Get the current status of the media in the applet.
  10. Move to Previous Message
    Move the selected message to the previous in the list of messages.
  11. Move to Next Message
    Move the selected message to the next in the list of messages.
  12. Select Message
    Select a message from the list of messages.
  13. Get Current Message Id
    Get the id of the currently selected message in the applet.
  14. Search Message
    Search for a message using a search text and a range of options.
  15. Get Message
    Get the XML representation of the currently selected message.
  16. Get Message Content
    Get the text content of the currently selected message in HTML or plain text.
  17. Post Message
    Post a new message to the applet using a subject and optionally a text content.
  18. Get Current Token
    Get the currently played token(word) in the active playback.
  19. Get Board Name
    Get the current board name.
  20. Get Board Data
    Get the current board data in XML representation.
  21. Get Version
    Get the version of the Gong applet.

The following tables describe the specification of these two functions.

String sendRequest(String xmlString)
Description
Make a request to the Gong applet.
Input
An XML representation of the request including the request name and its parameters in one of the following forms†:
  1. Play Media
    <PlayMediaRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MediaType>audio</MediaType>
      <StartTime>[Start time in milliseconds]</StartTime>
      <StopTime>[End time in milliseconds]</StopTime>
    </PlayMediaRequest>
  2. Record Media
    <RecordMediaRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MediaType>audio</MediaType>
      <Duration>[Permitted duration in milliseconds]</Duration>
    </RecordMediaRequest>
  3. Pause Media
    <PauseMediaRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MediaType>audio</MediaType>
    </PauseMediaRequest>
  4. Stop Media
    <StopMediaRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MediaType>audio</MediaType>
    </StopMediaRequest>
  5. Set Media Time
    <SetMediaTimeRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MediaType>audio</MediaType>
      <Time>The media time in milliseconds</Time>
    </SetMediaRateRequest>
  6. Get Media Time
    <GetMediaTimeRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MediaType>audio</MediaType>
    </GetMediaTimeRequest>
  7. Set Media Rate
    <SetMediaRateRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MediaType>audio</MediaType>
      <Rate>Playback rate within 0.5 (slow) and 1.5 (fast) where 1.0 is natural speed</Rate>
    </SetMediaRateRequest>
  8. Get Media Rate
    <GetMediaRateRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MediaType>audio</MediaType>
    </GetMediaRateRequest>
  9. Get Media Status
    <GetMediaStatusRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MediaType>audio</MediaType>
    </GetMediaStatusRequest>
  10. Move to Previous Message
    <MoveToPrevMessageRequest xmlns="http://www.cs.ust.hk/gong/gasi10"/>
  11. Move to Next Message
    <MoveToNextMessageRequest xmlns="http://www.cs.ust.hk/gong/gasi10"/>
  12. Select Message
    <SelectMessageRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MessageId>The id of the message to be selected</MessageId>
    </SelectMessageRequest>
  13. Get Current Message Id
    <GetCurrentMessageIdRequest xmlns="http://www.cs.ust.hk/gong/gasi10"/>
  14. Search Message
    <SearchMessageRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Text>The search text</Text>
      <Options>
        <CaseSensitive>Case-sensitive search, can be true or false</CaseSensitive>
        <WholeWords>Search for whole words only, can be true or false</WholeWords>
        <Regex>Use regular expression, can be true or false</Regex>
        <Targets>
          <Author>Search author, can be true or false</Author>
          <Subject>Search subject, can be true or false</Subject>
          <Content>Search text content, can be true or false</Content>
        </Targets>
      </Options>
    </SearchMessageRequest>
  15. Get Message
    <GetMessageRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MessageId>The id of the message</MessageId>
    </GetMessageRequest>
  16. Get Message Content
    <GetMessageContentRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MessageId>The id of the message</MessageId>
      <ContentType>The returned content type of either text/plain or text/html</ContentType>
    </GetMessageContentRequest>
  17. Post Message
    <PostMessageRequest xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Subject>The subject of the new message</Subject>
      <Content>[The text content of the new message]</Content>
    </PostMessageRequest>
  18. Get Current Token
    <GetCurrentTokenRequest xmlns="http://www.cs.ust.hk/gong/gasi10"/>
  19. Get Board Name
    <GetBoardNameRequest xmlns="http://www.cs.ust.hk/gong/gasi10"/>
  20. Get Board Data
    <GetBoardDataRequest xmlns="http://www.cs.ust.hk/gong/gasi10"/>
  21. Get Version
    <GetVersionRequest xmlns="http://www.cs.ust.hk/gong/gasi10"/>
† Optional parameters are enclosed by square brackets.
Return
An XML response in one of the following formats:
  1. Play Media
    <PlayMediaResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <StartTime>Actual start time in milliseconds</StartTime>
      <StopTime>Actual end time in milliseconds</StopTime>
    </PlayMediaResponse>
  2. Record Media
    <RecordMediaResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Duration>Actual permitted duration in milliseconds</Duration>
    </RecordMediaResponse>
  3. Pause Media
    <PauseMediaResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Time>The current media time in milliseconds</Time>
    </PauseMediaResponse>
  4. Stop Media
    <StopMediaResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Duration>[Recorded duration in milliseconds if a recording is stopped]</Duration>
    </StopMediaResponse>
  5. Set Media Time
    <SetMediaTimeResponse xmlns="http://www.cs.ust.hk/gong/gasi10"/>
  6. Get Media Time
    <GetMediaTimeResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Time>The current media time in milliseconds</Time>
    </GetMediaTimeResponse>
  7. Set Media Rate
    <SetMediaRateResponse xmlns="http://www.cs.ust.hk/gong/gasi10"/>
  8. Get Media Rate
    <GetMediaRateResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Rate>The current playback rate</Rate>
    </GetMediaRateResponse>
  9. Get Media Status
    <GetMediaStatusResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Status>
        The status of the media which can be:
        playing or recording or paused or stopping or
        stopped or closing or closed
      </Status>
    </GetMediaStatusResponse>
  10. Move to Previous Message
    <MoveToPrevMessageResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MessageId>The id of the previous message</MessageId>
    </MoveToNextMessageResponse>
  11. Move to Next Message
    <MoveToNextMessageResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MessageId>The id of the next message</MessageId>
    </MoveToNextMessageResponse>
  12. Select Message
    <SelectMessageResponse xmlns="http://www.cs.ust.hk/gong/gasi10"/>
  13. Get Current Message Id
    <GetCurrentMessageIdResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MessageId>The id of the currently selected message</MessageId>
    </GetCurrentMessageIdResponse>
  14. Search Message
    <SearchMessageResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MessageId>The id of the message matching the search</MessageId>
    </SearchMessageResponse>
  15. Get Message
    <GetMessageResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Message>The message in XML representation</Message>
    </GetMessageResponse>
  16. Get Message Content
    <GetMessageContentResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Content>The text content of the message in the requested content type</Content>
    </GetMessageContentResponse>
  17. Post Message
    <PostMessageResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <MessageId>The id of the new message</MessageId>
    </PostMessageResponse>
  18. Get Current Token
    <GetCurrentTokenResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Token>The token in XML representation</Token>
    </GetCurrentTokenResponse>
  19. Get Board Name
    <GetBoardNameResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Name>The name of the current board</Name>
    </GetBoardNameResponse>
  20. Get Board Data
    <GetBoardDataResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Board>The data of the current board in XML representation</Board>
    </GetBoardDataResponse>
  21. Get Version
    <GetVersionResponse xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Version>The current version string</Version>
    </GetVersionResponse>
  22. Fault
    <Fault xmlns="http://www.cs.ust.hk/gong/gasi10">
      <Code>[Fault code]</Code>
      <Reason>[Fault reason]</Reason>
    </Fault>
Exception
An exception will be thrown if an error occurs.
 
String sendRequest(String name, String param)
Description
Make a request to the Gong applet.
Input
The request name and the set of parameters† associated with the request.
  1. Play Media
    name: "PlayMedia"
    param: "audio;[Start time in milliseconds];[End time in milliseconds]"
  2. Record Media
    name: "RecordMedia"
    param: "audio;[Permitted duration in milliseconds]"
  3. Pause Media
    name: "PauseMedia"
    param: "audio"
  4. Stop Media
    name: "StopMedia"
    param: "audio"
  5. Set Media Time
    name: "SetMediaTime"
    param: "audio;The media time in milliseconds"
  6. Get Media Time
    name: "GetMediaTime"
    param: "audio"
  7. Set Media Rate
    name: "SetMediaRate"
    param: "audio;Playback rate within 0.5 (slow) and 1.5 (fast) where 1.0 is natural speed"
  8. Get Media Rate
    name: "GetMediaRate"
    param: "audio"
  9. Get Media Status
    name: "GetMediaStatus"
    param: "audio"
  10. Move to Previous Message
    name: "MoveToPrevMessage"
    param: ""
  11. Move to Next Message
    name: "MoveToNextMessage"
    param: ""
  12. Select Message
    name: "SelectMessage"
    param: "The id of the message to be selected"
  13. Get Current Message Id
    name: "GetCurrentMessageId"
    param: ""
  14. Search Message
    name: "SearchMessage"
    param: "The search text;
            Case-sensitive search, can be true or false;
            Search for whole words only, can be true or false;
            Use regular expression, can be true or false;
            Search author, can be true or false;
            Search subject, can be true or false;
            Search text content, can be true or false"
  15. Get Message
    name: "GetMessage"
    param: "The id of the message"
  16. Get Message Content
    name: "GetMessageContent"
    param: "The id of the message;The returned content type of either text/plain or text/html"
  17. Post Message
    name: "PostMessage"
    param: "The subject of the new message;[The text content of the new message]"
  18. Get Current Token
    name: "GetCurrentToken"
    param: ""
  19. Get Board Name
    name: "GetBoardName"
    param: ""
  20. Get Board Data
    name: "GetBoardData"
    param: ""
  21. Get Version
    name: "GetVersion"
    param: ""
† Optional parameters are enclosed by square brackets.
Return
A response containing the values requested.
  1. Play Media
    "Actual start time in milliseconds;Actual end time in milliseconds"
  2. Record Media
    "Actual permitted duration in milliseconds"
  3. Pause Media
    "The current media time in milliseconds"
  4. Stop Media
    "[Recorded duration in milliseconds if a recording is stopped]"
  5. Set Media Time
    Nil
  6. Get Media Time
    "The current media time in milliseconds"
  7. Set Media Rate
    Nil
  8. Get Media Rate
    "The current playback rate"
  9. Get Media Status
    "The status of the media which can be:
     playing or recording or paused or stopping or stopped or closing or closed"
  10. Move to Previous Message
    "The id of the previous message"
  11. Move to Next Message
    "The id of the next message"
  12. Select Message
    Nil
  13. Get Current Message Id
    "The id of the currently selected message"
  14. Search Message
    "The id of the message matching the search"
  15. Get Message
    "The message in XML representation"
  16. Get Message Content
    "The text content of the message in the requested content type"
  17. Post Message
    "The id of the new message"
  18. Get Current Token
    "The token in XML representation"
  19. Get Board Name
    "The name of the current board"
  20. Get Board Data
    "The data of the current board in XML representation"
  21. Get Version
    "The current version string"
Exception
An exception will be thrown if an error occurs.

To illustrate the scripting interface the following sections use JavaScript and VBScript to create a simple two-buttons player with a Gong applet.

5.3.1 JavaScript Example

In the following example JavaScript is used to control the Gong applet with two HTML form buttons. The Gong applet resides on the HTML page but is hidden from the user.

<html>
<head>
    <title>JavaScript Example</title>
    <script type="text/javascript">
    <!--
    function doplay() {
        try {
            document.getElementById("gong").sendRequest("PlayMedia", "audio");
        }
        catch (e) {
            alert("Failed to play the message.");
        }
    }

    function dostop() {
        try {
            document.getElementById("gong").sendRequest("StopMedia", "audio");
        }
        catch (e) {
            alert("Failed to stop the message.");
        }
    }
    // -->
    </script>
</head>
<body>
    <h1>Simple Playback using Gong Applet</h1>
    <form>
        <input type="button" value="Play" onclick="doplay()" />
        <input type="button" value="Stop" onclick="dostop()" />
    </form>
    <applet id="gong" archive="gong.jar" code="gong.GongApplet" style="display:none" ...>
        ...
    </applet>
</body>
</html>

For a working example please go to the Gong website at http://www.cs.ust.hk/gong.

5.3.2 VBScript Example

In the following example VBScript is used to control the Gong applet with two HTML form buttons. The Gong applet resides on the HTML page but is hidden from the user.

<html>
<head>
    <title>VBScript Example</title>
    <script type="text/vbscript">
    <!--
    Sub Play_OnClick()
        On Error Resume Next
        document.gong.sendRequest "PlayMedia", "audio"
        If Err.Number <> 0 Then
            alert("Failed to play the message.");
            Exit Sub
        End If
    End Sub

    Sub Stop_OnClick()
        On Error Resume Next
        document.gong.sendRequest "StopMedia", "audio"
        If Err.Number <> 0 Then
            alert("Failed to stop the message.");
            Exit Sub
        End If
    End Sub
    // -->
    </script>
</head>
<body>
    <h1>Simple Playback using Gong Applet</h1>
    <form>
        <input type="button" value="Play" name="Play" />
        <input type="button" value="Stop" name="Stop" />
    </form>
    <applet name="gong" archive="gong.jar" code="gong.GongApplet" width="0" height="0" ...>
        ...
    </applet>
</body>
</html>

For a working example please go to the Gong website at http://www.cs.ust.hk/gong.