ViaJcart - User Manual - Chapter 8

User Manual

Chapter 8 - ViaJCart™ Audio Setup

Introduction:

You can use Real Audio and MIDI Music with ViaJCart™ 2. This will greatly enhance the shopping experience. To do this you have to use HTML Frames. One frame will contain the shopping cart applet itself and the second frame will be used to play audio files. Review our Demo to see how this works.

You can record sound files advertising your products in .wav format and convert them to Real Audio format by using one of the popular audio software like CoolEdit. You can specify different audio file for each product. The MIDI files can provide relaxing background music, which is randomly selected from a list of MIDI files.

HTML Frames and Audio:

To take advantage of Audio with ViaJCart you must use HTML frames. One frame will contain the Shopping cart applet itself and the second frame will be used by ViaJCart to play audio files.

See Example Below:
This is a main ViaJCart page. It contains two frames. The first frame points to page jscfrm.htm, which is a page that contains ViaJCart applet. The second frame points to JSCAudio.htm and has a name of JSCAudio.
This frame will be used by ViaJCart to play audio files.

<head>
<title>ViaJCart Audio Example</title>
</head>
<frameset BORDER="0" FRAMEBORDER="0" FRAMESPACING="0" cols="100%,*">
<noframes>
<body>
</body>
</noframes>
<frame SRC="jscfrm.htm">
<noframes>
</noframes>
<frame SRC="JSCAudio.htm" name="JSCAudio" MARGINWIDTH="0" NORESIZE scrolling="no">
</frameset>
</html>

Note: If you plan to use Real Audio sounds specify:
<frameset BORDER="0" FRAMEBORDER="0" FRAMESPACING="0" cols="99%,*">

How to Set Up Real Audio:

You need to have two files to make it work correctly. First, you need to create a Real Audio file. You can use software provided by Real Audio or third party like CoolEdit to record or convert from .wav to a Real Audio file with .ra extension. The plug-in meta file that points to .ra must have a .rpm extension. The HTML page points to .rpm file. Place these files into "Aud" directory. Here is an example:

audio.ra
=========
This file contains binary audio data.

audio.rpm
==========
This a regular text file and contains the following:
http://www.yourdomain.com/path/to/audio.ra

audio.htm
==========
Contains embed statement:
<HTML>
<EMBED src="audio.rpm" autostart="true" width=0 height=0 border=0>
</HTML>

Place name of this page into Catalog file in the Audio Field. Read Chapter 4 for more details. Make sure you enable RealAudio=Yes in the JSC.ini file.

How to Set Up MIDI Music:

The setup for MID background music is similar to Real Audio setup. You need to have an HTML page that points to a midi file in the Aud directory.

<HTML>
<BODY>
<SCRIPT>
if (navigator.appName.substring(0,9) == "Microsoft")
window.document.write('<bgsound src="YourTestFile.mid">') ;
else window.document.write('<embed src="YourTestFile.mid" hidden="true" autostart="true">') ;
</SCRIPT>
</BODY>
</HTML>

Place name of this page into Catalog file in the Audio Field. Read Chapter 4 for more details. Put both .mid file and .htm file into Aud directory. Next, list time and HTML pages in the JSC.ini file on the Music parameter.

Music=90:page1.htm;120:page2.htm;100:page3.htm etc…

The format is Music=time:page_name;time:page_name; …… up to 100 pages can be listed. The ViaJCart will randomly select on of the pages and play it in the background HTML Frame.

How to disable Audio:

If you do not want to use Music or Real Audio set value to "No" (Not "*") for both parameters in the JSC.ini file:

Music=No
RealAudio=No

next

Chapter 1 - Installation
Chapter 2 - JSC.ini control file
Chapter 3 - Menu file creation
Chapter 4 - Catalog files
Chapter 5 - Checking out process
Chapter 6 - Order; Encryption/Decryption process
Chapter 7 - ViaJcart Customization with JSCStrings.ini
Chapter 8 - Audio Setup
Chapter 9 - Real-Time Credit Card Processing
Chapter 10 - Troubleshooting
Chapter 11 - Upgrade From 1.x to 2.x