READMEJAVA.TXT

How to Install a Java Sample for Microsoft Agent 
------------------------------------------------


*** Perform the following steps once for all samples ***

1. Install the Microsoft Agent core control. To run samples which produce
speech output, install the TruVoice text-to-speech engine. To run samples
which take speech input, install the Microsoft Command and Control speech
engine.

2. Download the character animation files for the three standard
characters: Genie.acs, Merlin.acs and Robby.acs. Create a directory
/Program Files/Microsoft Agent/Characters/ and put the three character
files in it. (You may select a different location for these files, but
then you will need to replace the path string within each sample to
refer to the new location.)


*** Perform the following steps once for all Java samples ***

1. Import the Agent Server COM class to Java. Start up Microsoft Visual J++.
Run the Java Type Library Wizard from the Tools menu. Scroll through the
list of items and find the entry for "Microsoft Agent Server 1.5".
Place a check mark in the box next to this entry, then click OK.


*** Perform the following steps for each Java sample ***

1. Download the sample. Create a local directory for the sample. (E.g.
/Program Files/DevStudio/MyProjects/AgentSample/) Unzip the samples files
and put them into the directory you created.

2. Start up Microsoft Visual J++. From the File menu, select Open Workspace.
Navigate to the folder you created in step 1. Select the workspace file (it
has a .dsw file extension) for this sample. Click Open.

3. From the Build menu, select Execute. When prompted that files need to be
built, Click Yes. When prompted for a Class File Name, enter the name of
the sample. For instance, if you downloaded the HelloJ sample, enter
"HelloJ". Note that the name is case sensitive.