README.TXT

----------------------------------------------------------- 
                      Java TAPI 3.0 Outgoing Call 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 JT3Call sample application/applet demonstrates the use of the Telephony API 
3.0 to make outgoing calls. 
 
Depending on installed hardware, the applet will allow you to communicate with 
others over a network connection using streaming audio and video.  One-to-one 
connections are supported, but you may also connect to network conferences in 
which you can communicate with multiple parties simultaneously. 
 
 
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 for TAPI 3.0 
----------------------------------------------------- 
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 
 
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 from Java in the 
C:\Winnt\java\trustlib\tapi3 directory. 
 
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 JT3Call 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 JT3Call.class 
 
or 
 
JT3Call.exe 
 
The sample is also an applet and may be executed by viewing JT3Call.htm in 
Microsoft Internet Explorer. 
 
 
USER'S GUIDE 
============ 
 
The first thing to note is the "Source Address" combo-box.  It displays 
addresses for different service providers installed on your machine.  If a 
connect operation does not work, it could be that you are trying to connect 
using the wrong source address (e.g., you must use a conferencing source 
address to join conferences). 
 
The "Destination Address" text field is where you enter the address you wish 
to connect to.  This can be an IP address, a machine name, etc. depending on 
the type of connection you are trying to establish. 
 
The "Static Terminals" listbox shows the available static terminals. 
 
Just below the static terminals listbox is the "Number of Video Wnds" text 
field.  Here, you enter the number of incoming video streams you want to 
see.  Video windows are dynamic terminals. 
 
By the way, terminals are end-points for connections.  There are two types 
of them: static and dynamic.  Static terminals are usually tied to hardware 
(e.g., speakers or microphones) and have a specific count.  Examples of 
dynamic terminals are video windows and files. 
 
 
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)