README.TXT

----------------------------------------------------------- 
                      Java TAPI 3.0 Conferencing Sample 
                                 August 1997 
          ----------------------------------------------------------- 
                   (c) Copyright Microsoft Corporation, 1997 
 
 
-------------------- 
      CONTENTS 
-------------------- 
SUMMARY 
BEFORE YOU COMPILE/RUN THE SAMPLE 
HOW TO COMPILE THE SAMPLE 
HOW TO RUN THE SAMPLE 
USER'S GUIDE 
MISC INFO ABOUT THE SAMPLE 
 
 
SUMMARY 
======= 
 
The JT3Conf sample application/applet demonstrates the use of the Telephony API 
3.0 and Rendevous Controls to create, delete, and join conferences. 
 
Depending on installed hardware, the applet will allow you to communicate with 
others over a network connection using streaming audio and video. 
 
 
BEFORE YOU COMPILE/RUN THE SAMPLE 
================================= 
 
Before you can compile/run the sample you must perform the following steps: 
 
1. Configure the Telephoney API 3.0 
----------------------------------- 
TAPI 3.0 is installed by default in Windows NT 5.0.  To ensure that telephoney 
support is properly configured on your machine, go to the control panel and 
open the "Telephoney" control panel applet. 
 
2. Install the MS Virtual Machine for Java (build 4.79.2174 or greater) 
----------------------------------------------------------------------- 
To check which version of the VM you currently have, open Windows Explorer and 
go to the root directory of your Windows installation (e.g., C:\Winnt).  Find 
the file Jview.exe and right-click it with the mouse.  On the popup menu that 
appears click the "Properties" item.  When the properties dialog appears 
select the "Version" tab. 
 
If you must upgrade to a newer version of the VM, install the version that 
comes with the SDK for Java 2.0 (http://www.microsoft.com/java) since you will 
need the SDK for the following step. 
 
3. Generate Java/COM Integration Classes 
---------------------------------------- 
Java classes must be generated for TAPI 3.0 and the Rendevous Controls. 
To generate these classes you will need to have the SDK for Java 2.0 installed. 
Once you have installed the SDK, go to the \bin directory under the main SDK 
install directory (C:\SDK-Java.20 by default) and execute the following 
commands: 
 
JActiveX /javatlb /xh /X:m- C:\Winnt\system32\tapi3.dll 
Jvc C:\Winnt\java\trustlib\tapi3\*.java 
 
JActiveX /javatlb /xh /X:m- C:\Winnt\system32\rend.dll 
Jvc C:\Winnt\java\trustlib\rend\*.java 
 
WARNING! You must use Jvc version 1.02.3920 or greater to compile files 
 generated by JActiveX. 
 
This will generate the .class files needed to access TAPI 3.0 and the 
Rendevous Controls from Java in the C:\Winnt\java\trustlib\tapi3 and 
C:\Winnt\java\trustlib\rend directories. 
 
Note, you should replace "C:\Winnt" in the above paths with the path of your 
Windows installation.  For more information on how to generate Java/COM 
integration classes refer to the SDK for Java 2.0 documentation. 
 
 
HOW TO COMPILE THE SAMPLE 
========================= 
 
Once the above steps are complete you can compile JT3Conf by executing the 
makeall.bat file. 
 
 
HOW TO RUN THE SAMPLE 
===================== 
 
You may run the sample as an application by typing the following from the 
sample directory: 
 
Jview JT3Conf.class 
 
or 
 
JT3Conf.exe 
 
The sample is also an applet and may be executed by viewing JT3Conf.htm in 
Microsoft Internet Explorer. 
 
 
USER'S GUIDE 
============ 
 
When the app starts you will see a list of conferences (the list may be empty). 
The use of the program is straight forward.  To join a conference, just select 
it and click the Join button.  The other operations are similar. 
 
 
MISC INFO ABOUT THE SAMPLE 
========================== 
 
Platforms Supported 
------------------- 
The sample has been tested on Windows NT 5.0 using the Microsoft Virtual 
Machine for Java. 
 
Hardware Requirements 
--------------------- 
Hardware requirements for each type of media is listed below: 
Audio Capture  ... Sound card and microphone 
Audio Playback ... Sound card and speakers 
Video Capture  ... Video capture card and camera 
Video Playback ... N/A (just uses monitor)