README.TXT

----------------------------------------------------------- 
                      Java TAPI 3.0 Incomming 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 JT3Rec sample application/applet demonstrates the use of the Telephony API 
3.0 to receive incoming calls. 
 
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.  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 JT3Rec 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 JT3Rec.class 
 
or 
 
JT3Rec.exe 
 
The sample is also an applet and may be executed by viewing JT3Rec.htm in 
Microsoft Internet Explorer. 
 
 
USER'S GUIDE 
============ 
 
When the app starts available media types (e.g., Audio In, Audio Out, etc.) 
will be listed.  In order to receive incoming calls you must select mediatypes 
that you wish to receive and click the Listen button.  To stop listening for 
calls, just click the Stop button. 
 
When a call arrives the status box will prompt you to click Answer or Reject. 
Clicking Answer will attempt to connect you to the caller and clicking Reject 
will hurt the caller's feelings ;(. 
 
 
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)