JMFRegistry User's Guide

Print-friendly Version

JMF 2.0 Documentation

This guide describes how to use JMFRegistry. JMFRegistry is a stand alone Java application that you can use to register new DataSources, MediaHandlers, PlugIns, and capture devices with JMF so that they can be used with your JMF 2.0 installation. JMFRegistry also enables you to rearrange the search orders and remove registered extensions.

Get the source for JMFRegistry.

To use a custom DataSource or MediaHandler with JMF, you must register the package prefix that identifies where the new class is located. (For example, COM.yourbiz.) You can do this with JMFRegistry through the PackageManager tab. Package prefixes for new protocols and MediaHandlers are set separately in the protocol package-prefix list and the content package-prefix list. You can also rearrange the order in which JMF searches installed protocol and media handlers, and remove registered package prefixes from the PackageManager tab.

For more information about how package prefixes are used to locate JMF extensions, see the "Extending JMF" chapter in the JMF API Guide.

To add a package prefix to either the ProtocolPrefix List or ContentPrefix List:

1. Open the PackageManager tab in the JMFRegistry Editor window.
    
2. Enter the new path in the ProtocolPrefixList text field.
    
3. Click the Add button.
    
4. To rearrange the search order, select the path you want to move and click the Move Up or Move Down button.
    
5. Click the Commit button to save your changes. Clicking the Restore button will revert to the last saved prefix list.

To remove a package prefix from either the ProtocolPrefix List or ContentPrefix List:

1. Open the PackageManager tab in the JMFRegistry Editor window.
    
2. Select the search path you want to remove.
    
3. Click the Remove button
    
4. Click the Commit button to save your changes. Clicking the Restore button will revert to the last saved prefix list.

To use a custom PlugIn with JMF, you must register it with the PlugInManager. You can do this with JMFRegistry through the PlugInManager tab. You can also view the input and/or output formats of a registered plug-in, rearrange the order in which JMF queries plug-ins, and remove registered plug-ins from the PlugInManager tab.

To register a new plug-in:

1. Open the PlugInManager tab in the JMF Registry Editor.
    
2. Select the tab for the type of plug-in you are adding. (Demultiplexer, Codec, Effect, Renderer, or Multiplexer.)
    
3. Enter the plug-in's fully qualified class name in the plug-in text field.
    
4. Click the Add button.
    
5. To rearrange the plug-in search order, select the plug-in you want to move and click the Move Up or Move Down button.
    
6. Click the Commit button to save your changes. Clicking the Restore button will revert to the last saved plug-in list.

To remove a plug-in:

1. Open the PlugInManager tab in the JMFRegistry Editor window.
    
2. Select the plug-in you want to remove.
    
3. Click the Remove button
    
4. Click the Commit button to save your changes. Clicking the Restore button will revert to the last saved plug-in list.

To use a particular capture device with JMF, you must register it with the CaptureDeviceManager. You can do this with JMFRegistry through the CaptureDeviceManager tab. You can also rearrange the order in which JMF queries capture devices, and remove registered devices from the CaptureDeviceManager tab.

To register a new capture device:

1. Open the CaptureDeviceManager tab in the JMF Registry Editor.
    
2. Enter the capture device in the capture devices text field.
    
3. Click the Add button.
    
4. To rearrange the capture device search order, select the device you want to move and click the Move Up or Move Down button.
    
5. Click the Commit button to save your changes. Clicking the Restore button will revert to the last saved capture device list.

1. Open the CaptureDeviceManager tab in the JMFRegistry Editor window.
    
2. Select the capture device you want to remove.
    
3. Click the Remove button
    
4. Click the Commit button to save your changes. Clicking the Restore button will revert to the last saved capture device list.

You can register file extension/MIME-type mappings with JMFRegistry through the MIME Types tab. A file extension can map to only one MIME type, but a MIME type can have several different file extensions mapped to it.

To add a mapping between a MIME type and a file extension:

1. Open the MIME Types tab in the JMF Registry Editor.
    
2. Select an existing MIME type or enter the name of a new MIME type in the MIME Type text field.
    
3. If you entered a new MIME type, click the MIME type Add button.
    
4. Enter the file extension you want to map to the selected MIME type in the Extension text field.
    
5. Click the Extension Add button.
    
6. Click the Commit button to save your changes.

To remove a file extension mapping for a MIME type:

1. Open the MIME Types tab in the JMF Registry Editor.
    
2. Select the MIME type whose mappings you want to edit.
    
3. Select the file extension that you want to remove.
    
4. Click the Extension Remove button.
    
5. Click the Commit button to save your changes.

To remove all of the mappings for a MIME type:

1. Select the MIME type you want to remove.
2. Click the MIME type Remove button.
3. To save your changes, click the Commit button.

Note: You can only remove MIME types and file extensions that you have added. You cannot change or remove the default mappings. For example, you cannot remove the extension mov or remap it to the MIME type video/xyz.

From the User Settings tab, you can specify file extensions that applets can read in addition to the registered mime types, control JMF Applet permissions, and control the location and size of the cache used when reading media from the network.

The Allow File Writing for Applets and Allow Capture for Applets check boxes let you control whether or not applets have permission to perform these operations.

The Allow Caching check box lets you control whether or not media content read from the network is cached to disk. If you enable media caching, you can also specify the directory where the media will be cached and how much disk space can be used for the cache.