Sun Java Solaris Communities My SDN Account Join SDN
 
JMF 2.1.1 Setup

Windows

 

Setting Up JMF 2.1.1


This page describes how to set up and run JMF for Windows. JMF for Windows is an optimized implementation of JMF that contains class files and native libraries for running JMF players.

Setting Up JMF

  1. Check the hardware and software requirements.
  2. Run the installation program to extract JMF to a directory, such as C:\Program Files\JMF2.1.1. We'll refer to the directory as %JMFDIR%.
  3. Verify that your CLASSPATH and PATH have been configured properly. During installation, InstallShield should automatically set up your CLASSPATH and PATH.
  4. set CLASSPATH=%JMFDIR%\lib\jmf.jar;%JMFDIR%\lib\sound.jar;.;%CLASSPATH%
    Your PATH should be set to include the JMF library files, if you had specified that they not be installed in the Windows\System directory:
    set PATH=%JMFDIR%\lib;%PATH%
You can use the JMF Diagnostics applet to verify that JMF is set up properly on your system.

Configuring JMF

JMF consists of a collection of media handlers, plugins and capture devices. They are configurable and extensible.  To configure JMF, use the JMFRegistry application.  See the JMF Registry User's Guide for details.

Running JMF

You can run the samples using the JDK Applet Viewer, browsers (HotJava, Netscape Communicator, or Internet Explorer) and the JMStudio standalone applications.

Running the RTP Applets and Applications

You can only play unicast and broadcast streams using RTPPlayerApplet. To play a multicast stream or to transmit, you need to use the application JMStudio. See the RTP release notes for more information.

Running JMF with Netscape Communicator

JMF can be used with Netscape Communicator 4.06 or later.

If Netscape Communicator is already installed on your system when you install JMF, the JMF installation program (with your permission) sets up JMF to work with Netscape Communicator. If the installation program fails to detect Netscape Communicator during installation, there are two ways to get JMF to work with Communicator:

  • You can uninstall JMF 2.1.1 (from the Add/Remove Programs option in the Windows Control Panel) and then install both Netscape Communicator 4.06+ and JMF 2.1.1, in that order. (This is the easier option.)

  •  
  • Install Netscape Communicator and then copy the JMF shared libraries and classes to the Netscape directory.

  • From the %WINDIR%\System32 directory or %JMFDIR%\lib directory:
     

    • Copy jm*.dll and jsound.dll to C:\Program Files\Netscape\Communicator\Program\Java\Bin


    Note:These instructions assume that Netscape Communicator was installed in C:\Program Files\Netscape. If that's not true, substitute the appropriate directories.

If a particular type of file doesn't work with Netscape, first check if the MIME type for this type of file is set correctly. By default, Netscape doesn't provide the settings for MIDI (audio/midi), RMF (audio/rmf), and GSM (audio/x-gsm) files. In Communicator, you can add and modify the MIME types from the Edit->Preferences menu, in Navigator/Applications category.

Note: JMF requires access to several resources outside the normal Java sandbox. When Communicator brings up dialogs asking you to grant privileges to JMF applets, you should grant them. To avoid the repeated display of security dialogs, you might want to enable "Remember this decision" in the security dialog.

Running JMF with Internet Explorer and the Microsoft VM

JMF will run on the latest Microsoft VM (5.0.0.3177 or greater) with JNI support. Internet Explorer 4.01 or greater is recommended. JMF also runs on Internet Explorer 3.02 if Java Plug-in is used.

Running JMF with HotJava 1.1

HotJava 1.1 seems to ignore the CLASSPATH variable. If you want to use it with JMF, you'll need to explicitly tell HotJava to use your CLASSPATH. You can do that by invoking:
hotjava -classpath %CLASSPATH%Also take a look at the runme.bat in the directory where you installed JMF.