Java Media Framework

安装JMF

下载完JMF安装程序后，双击安装程序的图标。

大部分安装程序都会有个选项，安装本地库到系统目录中；例如，Windows版本安装程序会有一个选项“Move DLLs to Windows/System directory.”。最好将此选项选中，因为它能确保这些操作系统的库文件能正确的安装

在安装的过程中，你还需要选择项目来更新系统的CLASSPATH和PATH变量。如果这些选项被关闭，那么在你编译和运行本指南的例程序的时候就需要在classpath中引入JMF的jar文件。

---

浏览

在本节中，我们将进行创建一个简单的音频播放器的第一个练习。本例将介绍Manager类和Player接口，中两个都是建立大多数基于JMF应用的重要部分。

本例的功能目标是在字符界面下播放本地的音频文件。我们将学习此源代码，并了解每一行所做的任务。完成本节后，你将会有一个基于JMF的可播放包括MP3, WAV, AU等多种音频文件的演示程序。

在本练习后的源代码分类种可查询文件SimpleAudioPlayer.java。

引入必要的类

SimpleAudioPlayer类中包括了一些调用，在其前几行中需要引入所有必要的类：

import javax.media.*;
import java.io.File;
import java.io.IOException;
import java.net.URL;
import java.net.MalformedURLException;

The javax.media包是由JMF定义的多个包之一。javax.media是一个核心包，包括了定义Manager类和Player接口等。本节中，我们主要学习Manager类和Player接口，其余的javax.media类放在后面的章节中。

除了引入javax.media声明外，以上的代码片断引入了一些创建媒体播放器的输入的声明。

Player接口

在下面的代码片断中，创建一个公共类SimpleAudioPlayer并举例定义一个Player变量：

public class SimpleAudioPlayer{
private Player audioPlayer = null;

术 语Player听起来由点熟悉，因为它是建立在我们公用的音频或者视频播放器的基础上的。事实上，这个接口的例子就像是当作它们的真实的副本。 Players揭示了一个实体上的媒体播放器（如立体音箱系统或者VCR）涉及到功能上的方法。例如，一个JMF媒体播放器可以开始和结束一个媒体流。在 本节种，我们将使用Player的开始和结束功能。

在一个文件上创建一个Player

使用JMF获得一个特定媒体文件的Player实例非常简单。Manager类在JMF中如同一个工厂制作许多的特殊接口类型，包括Player接口。因此，Manager类的责任就是创建Player实例，如下例：

public SimpleAudioPlayer(URL url) throws IOException, NoPlayerException, CannotRealizeException
{
audioPlayer = Manager.createRealizedPlayer(url);
}

public SimpleAudioPlayer(File file) throws IOException, NoPlayerException, CannotRealizeException
{
this(file.toURL());
}

如果你看完本节的代码，你可以注意到Manager类包含了创建一个Player实例的其他方法。我们会研究其中的一些，如在后面的章节中的DataSource或者MediaLocator的实例化。

Player的状态

JMF定义了大量的一个Player实例可能存在的不同状态。如下：

· Prefetched
· Prefetching
· Realized
· Realizing
· Started
· Unrealized

使用这些状态

因 为使用媒体常常是资源非常密集的，由JMF对象揭示的许多方法都是不闭塞的，允许一系列事件监听的状态改变的异步通知。例如，一个Player在它可以启 动之前，必须经过Prefetched和Realized状态。由于这些状态的改变都需要一些时间来完成，JMF媒体应用可以分配一个线程来初始化创建 Player实例，然后再继续其他的操作。当Player准备就绪的时候，它会通知应用程序其状态已经改变。

在 一个如同我们的这样简单的程序中，多功能性的类型并不是很重要。处于这个原因，Manager类也提供了一些创建Realized player的有用方法。调用一个createRealizedPlayer()方法来阻塞调用线程，直到player达到Realized状态。为了调 用一个无阻塞的创建player的方法，我们在Manager类中使用了一个createPlayer()方法。下面的一行代码中创建了一个我们需要在例 程序中使用的

Realized player：
audioPlayer = Manager.createRealizedPlayer(url);

启动和停止Player

设定一个Player实例的启动或是停止就如同调用Player的一个简单的认证方法，如下所示：

public void play()
{
audioPlayer.start();
}

public void stop()
{
audioPlayer.stop();
audioPlayer.close();
}

调用SimpleAudioPlayer类中的play()方法来实现调用Player实例的start()方法。调用此方法后，你能听到本地的喇叭的声音文件。同样的，stop()方法使player停止并且关闭掉Player对象。

对 于读取和或者播放本地媒体文件来说，关闭Player实例释放所有资源是一个有用的方法。因为这是一个简单的例子，关闭Player是终止一个会话可接受 的方法。但是在实际的应用中，你需要小心的确认在除掉Player之前必须要关闭掉。一但你已经关闭掉player，在再次播放一个媒体之前你必须要创建 一个新的Player实例（等待它的状态改变）。

建立一个SimpleAudioPlayer

最后，这个媒体播放应用程序要包含一个可以从命令提示行中输入命令而调用的main()方法。在此main()方法中，我们将调用创建SimpleAudioPlayer的方法：

File audioFile = new File(args[ 0 ]);
SimpleAudioPlayer player = new SimpleAudioPlayer(audioFile);

在播放音频文件之前的唯一的一些事情就是调用已经创建的音频player的方法play()，如下所示：

player.play();

要停止和清除掉音频player，在main()方法中也应该有如下调用：

player.stop();

编译和运行SimpleAudioPlayer

通过在命令提示行输入javac SimpleAudioPlayer.java来编译例程序。所创建的文件SimpleAudioPlayer.class在当前工作目录中。然后在命令提示行中键入如下命令来运行例程序：

java SimpleAudioPlayer audioFile

将audioFile替换成你本地机器上的音频文件。所有的相对文件名都试相对于当前的工作目录。你会看到一些当前正在播放文件的标志信息。要终止播放，按下回车键。

如果编译失败，确认JMF的jar文件已经正确的包含在CLASSPATH环境变量中。

---

播放视频

在 前一节中，我们学习了建立一个通过字符界面播放音频文件的应用程序。JMF中一个最重要的特点就是你不需要为了配置媒体播放器而去了解媒体文件的格式；一 切都内置了。举一个例子，再我们前面的例子中，需要使用MP3格式的时候，我们不需要让应用程序为一个MP3文件建立一个特殊的Player。

如同你将会再本节所见到的，对于视频文件的操作同样有效。JMF有所有媒体文件类型接口的详细资料。

处理视频媒体与音频最大的不同就是，我们必须建立一个能播放视频的显示屏幕。幸运的是，JMF能处理许多的这些资料。如同再上例一样我们会建立一个Player对象，并且使用很多的可视组件来直接从JMF对象中创建我们的可视的媒体浏览器。

本节中，我们将学习两个例程序。In this section, we'll walk through the second example application. 请再后面的练习的源代码分布中查阅MediaPlayerFrame.java。

关于例子

在 本节中，我们将创建一个能显示和运行本地音频和视频媒体的应用程序。作为练习的一部分，我们将研究JMF内置的一些GUI组件。熟悉AWT和Swing将 有助于你理解本例，但这并不是必须的。除非需要直接涉及到JMF的GUI组件，或者我们是不会详细介绍源代码的。你可以在源代码的注释中找到这里未涉及的 详细说明。

本例中我们使用的许多概念，类和方法都和第一个例子的类似。建立Player的基本操作大都一样。最大的不同就是我们需要对Player对象专研更深一点，特别当需要从Player获取媒体信息的时候。

如何开始

视频播放器例子被设计得如同音频播放例子一样通过命令行来运行，但是本例需要建立在GUI基础上。如同在上节一样，我们先通过媒体文件名调用应用。然后，应用程序显示一个带有可操作媒体组件的窗体。

在MediaPlayerFrame开始的一行中我们定义了类并扩展自，javax.swing.Jframe类。这就是使媒体播放器如同一个在桌面上的单独窗体的方法。任何客户机程序创建了本媒体播放对象后都可以通过调用Jframe类中定义的show()方法来显示。

下面是一个MediaPlayerFrame正在播放MPEG电影的屏幕截图：

获取GUI组件

Player界面有一些方法来获取已选择可视组件的涉及。在MediaPlayerFrame中，我们使用如下组件：

· player.getVisualComponent()是一个播放所有视频媒体的可视组件。
· player.getControlPanelComponent() 是一个操作时间轴的可视组件（包括开始，停止，回放），也包含了一些媒体流的有用信息。
· player.getGainControl().getControlComponent() 是操作音量（增加）的可视组件。getGainControl()方法返回一个GainControl实例，可用于改变节目的增加等级。

使用可视化组件

上面的界面方法都返回一个java.awt.Component类的实例。没个实例都视可加载到我们窗体上的可视组件。这些组件都与Player有直接的联系，所以在这些组件上的所有可视元素的处理都会产生Player播放媒体后相应的变化。
在我们将这些组件加入到我们的窗体的之前，必须要保证它们不为空。因为并不是所有的媒体播放器包括每一种可视组件，我们只需添加相关播放器类型的组件。比 如，一般来说一个音频播放器没有可视组件，所以getVisualComponent()就要返回空。你不会想在音频播放器窗体上添加可视组件的。

获得媒体的特殊控制

一 个Player实例也可以通过getControl()和getControls()方法来暴露其控制，getControls()返回一个控制对象集， 而getControl()返回一个控制。不同的播放器类型可选择为特殊的操作来暴露控制集去指定的媒体类型，或者用于获取该媒体的传输机制。如果你在写 一个只支持某些媒体类型的播放器，你需要依靠某些在Player实例中可用Control对象。

由 于我们的播放器是非常抽象的，被设计于播放多种不同媒体类型，我们简单的为用户暴露所有的Control对象。如果找到任何扩展的控制集，我们就可使用 getControlComponent()方法来增加相应的可视控件到标签面板上。通过这个办法，用户就可以观察播放器上的所有组件。以下代码片断将所 有的控制对象暴露给用户：

Control[] controls = player.getControls();
for (int i = 0; i < controls.length; i++)
{
if (controls[i].getControlComponent() != null)
{
tabPane.add(controls[i].getControlComponent());
}
}

为 了使一个真实的应用程序能用Control实例做一些有用的事（除了能显示可视组件之外），应用程序需要知道该Control的特殊类型，并分配它。此 后，应用程序就可使用这些control来控制媒体节目了。例如，如果你知道你经常使用的媒体暴露 javax.media.control.QualityControl类型的Control，你能使用QualityControl界面，之后在 QualityControl界面上通过调用各种方法来改变性质设定。

使用一个MediaLocator

在我们新的基于GUI的媒体播放器和我们的第一个简单播放器之间最大的不同就是，我们使用一个MediaLocator对象而不是URL来创建Player实例，如下所示：

public void setMediaLocator(MediaLocator locator) throws IOException, NoPlayerException, CannotRealizeException {
setPlayer(Manager.createRealizedPlayer(locator));
}

我 们将在稍后的章节中讨论这个变化的原因。目前，在网络上资源站点上，关于MediaLocator对象和URL的描述被认为是非常相似的。事实上，你可以 从一个URL创建一个MediaLocator，也可以从MediaLocator获取到URL。我们的新媒体播放器一个URL中创建一个 MediaLocator，并使用该MediaLocator通过文件创建了一个Player。

编译和运行MediaPlayerFrame

通过在命令提示行输入javac MediaPlayerFrame.java来编译例程序。在工作目录下将创建一个名为MediaPlayerFrame.class的文件。
在命令提示行中键入如下来运行例程序：

java MediaPlayerFrame mediaFile

你需要用你本机上的一个媒体文件来替换掉mediaFile（音频或者视频文件都可以）。所有的相对文件名都是相对于当前工作目录。你会看见一个显示控制媒体文件的GUI控制集的窗口。欲了解JMF支持的音频和视频文件列表，在23页的资源。

如果初始编译时失败，请确认JMF的jar文件已经包含在当前的CLASSPATH环境变量中。

MediaPlayerFrame在行动

在本节前你看见的一个视频播放器正在播放MPEG视频文件的屏幕截图。下面的屏幕截图显示了一个音频播放器正在播放一个MP3文件：
要更多的学习本练习中的例子，查看完成的MediaPlayerFrame源代码。

---

JMF体系结构

你 曾见过了使用JMF播放本地媒体文件是多么的容易，现在我们将后退一步，来看看一幅是如何通过JMF创建了如此成熟的基于媒体的应用程序的大的画面，是如 何通过JMF创建了如此成熟的基于媒体的应用程序。全面的了解JMF体系结构是没有意义的，本节将给你一个大体的概念，关于高级的JMF组件是如何组合起 来创建想得到的东西。

JMF的组件结构非常的灵活，它的组件一般可以分成三个部分：

· Input描述某种被用于在进程休息的时候作为一个输入的媒体。
· process执行某些输入上的活动。一个过程有一个明确的输入和输出。大量的过程可用, 能被用于一个输入或者一批输入。这些过程能被联系起来，一个过程的输出被用于另外一个过程的输入。在这种风格中，大量的过程可能被应用于一个输入。（这段 期间是可选择的——我们开始的两个例子没有包含真正的数据过程，只有一个来自文件的输入和一个通过Player的输出。）
· Output 描述了媒体的某些目的地。

从这些描述中，你可以想象到JMF组件体系结构听起来就好像在一个典型的立体声系统或者VCR之后。很容易设想到，使用JMF就如同打开电视或者在立体声音箱系统下调节声音的风格。例如，录制喜爱的电视节目的简单的动作能在这些组件的基础中：

· Input 是电视广播流，在同一个频道运输音频和视频。
· Process 是一个记录设备（就是，一个VCR或者许多的数字设备）转换模拟或者数字音频视频广播流成适合复制到磁带或其他媒体上的格式。
· Output 是记录已格式化轨迹（音频和视频）到某些类型的媒体上。

JMF资料处理模式

以下图片说明了JMF数据处理模块并对每个类型给出了例子：

使用此模式，很容易明白我们前面的两个例子，从文件中输入音频和视频并输出到本地计算机上。在后面的章节中，我们也会谈论一些通过传播和接收音频媒体的JMF网络功能。

处理模型例子

将JMF 的输入，处理和输出模式联系起来，我们能开始想象许多基于媒体的操作都可能通过JMF完成。一个例子，转换一种媒体类型为其他类型并将其输出存储到一个新 的文件。举一个例子，我们想要在不损坏原始文件的前提下转化一个WAV格式的音频文件为MP3格式。以下的过程模式插图，就是我们将开始执行转换的步骤：

本例的输入是一个WAV文件。它被一个媒体格式转换工具加工，并输出到一个新的文件。现在，让我们看看JMF API中的这个模式的每一步。我们使用输入，处理和输出模式作为概念上的路标。

JMF输入

再JMF 中，一般由一个MediaLocator对象来描述一个输入。如先前规定的，MediaLocator的外观和行为都非常象一个URL，这样它可以唯一确 定网络上的一个资源。事实上，使用一个URL来创建一个MediaLocator是完全可能的；我们在前面的两个例子中就是这样做的。

为 了我们的媒体转换例子，我们需要建立一个MediaLocator来描述最初的WAV文件。如同我们将在后面的章节中见到的，一个 MediaLocator也可以用于描述一个跨越网络中媒体流。在这个案例中，MediaLocator会描述传播的URL――很像一个被URL指定的在 Web上的资源，用于取代指定一个本地文件系统的文件来建立MediaLocator。

一个MediaLocator和一个URL之间的不同

要 成功的建立一个URL对象，需要适当的java.net.URLStreamHandler安装于系统中。这个流处理的用途是能够处理被URL描述的流类 型。一个MediaLocator对象并没有这个需要。例如，我们的下个应用程序将使用实时传输协议（RTP）在网络上传输音频。由于多数的系统都未为 RTP协议安装一个URLStreamHandler，所以创建一个URL对象会失败。在这个应用中，只有MediaLocator对象会成功。

要理解更多关于URL对象以及创建和注册一个URLStreamHandler的信息，查阅JDK帮助文档（查看23页资源）。

JMF处理机

当 我们使用JMF的时候，应用程序的处理机组件被Processor接口实例描述。你需要已有些熟悉Processor，它扩展至Player接口。由于 Processor继承直Player接口，它同样也从Player继承所有可用属性。另外，Processor增加了两个属性：Configuring 和Configured。这些扩展的属性（和与之关联的方法）用于Processor从输入流收集信息时的通信。

在我们的最后的例程序中，我们将建立一个Processor用于将MP3编码格式的音频转换成适合在网络上传播的格式。在稍后的板块中我们会讨论创建一个简单的Processor的步骤。

JMF输出

有 少许的方法用于描述JMF中处理模式的输出状态。最简单的（并且我们将在最后一个例子中使用的）是javax.media.DataSink接口。一个 DataSink读取媒体内容并且将其传送到一些目的地。本节中最开始的音频格式转换过程中，MP3（输出）文件将被DataSink描述。在我们最后一 个例子中，我们将使用一个DataSink在实际上完成网络中传播音频媒体的工作。一个DataSink是在Manager类中，由指定一个 DataSource（输入到DataSink）和一个MediaLocator（输出到DataSink）完成的。

一个DataSource实例描述可用于Players，Processors和DataSinks的输入数据。一个处理机的输出也被描述成一个DataSource对象。

这就是为什么处理器能彼此联系起来，在同一媒体数据中完成多种操作。这也是来自Processor的输出能作为输入被Player或者DataSink使用的原因（它可将媒体传递到输出目的地）。

一个DataSink的最后目的文件由一个MediaLocator对象说明。如同前面一样，MediaLocator描述一个网络资源；这就是媒体流将被传递的地方。

---

JMF和实时传输协议(RTP)

许 多的友善网络的特征直接建立在JMF中，这些使为客户端程序通过网络传输和接收媒体非常容易。当在一个网络上的一个用户想要接收任何种类的媒体流的时候， 它不需要在观看媒体前等待全部的广播下载到机器上；用户可以实时的观看广播。在流媒体中些提出了这个概念。通过流媒体，一个网络客户端能接收到其他机器上 广播的音频，甚至获取正在发生的实况视频广播。

在IETF RFC 1889中定义了实时传输协议（RTP）。发展在快速和可靠的状态下通过网络传输时间极其敏感的数据，RTP在JMF中用于提供给用户向其他网络节点中传输媒体流的方法。
在本节中，我们将学习我们的最后一个例程序。这里，你将学习到如何传输一个存储在一台机器上的MP3文件到另外的在同一个网络的机器上去。实际的MP3源 文件并不从主计算机上移除，它也不使复制到其他机器上去；事实上它将会转换成能使用RTP传输的文件格式并通过网络发送。一旦被一个客户端接收到，源文件 （现在是RTP信息包的形式）可以再次传输，这一次是在接收机器上可播放的一种格式。
在MediaTransmitter.java文件中源代码查看学习以下练习。

设置处理模式

我们可以在前面的章节中定义的处理模式的基础下来讨论我们的最终的例子。在传输机器上，处理模式看起来像这样：
事实上，MediaTransmitter对象源代码包括了以下三行：

private MediaLocator mediaLocator = null;
private DataSink dataSink = null;
private Processor mediaProcessor = null;

这三个实例变量可以直接映射到前面的处理模式图表，如下：

· mediaProcessor变量是我们的处理器；它将负责转换音频文件从MP3文件模式到一个适合通过RTP协议传输的格式。
· dataSink变量是我们的输出块。
· 当我们建立DataSink时我们需要指定一个MediaLocator，它是DataSink的目的文件。

当我们通过运行DataSink我们的处理过的媒体，它将传输到我们在MediaLocator中指定的地点。

RTP MediaLocator

在 前面的 两个练习中，我们通过从文件中获得的一个URL建立了MediaLocator实例。 在本练习中，我们必须建立一个MediaLocator来描述网络上媒体传播输出流；换句话说，我们必须创建一个能我们的音频传播的目的地的 MediaLocator。一个RTP MediaLocator符合如下规则，看起来就像一个典型的URL：

rtp: //address:port/content-type

让我们看看上面URL规范的每一段：

· address 是将传输的媒体的地址。以单播的模式传输（一个专用IP地址），地址将会是有意接收的机器的IP地址。以广播的模式传播（到子网中的所有机器），地址将会 是以255作为最后的一块的子网地址。举个例子，如果我再子网中可指定地址为192.168.1和想要传播到子网中的所有节点，我可以指定 192.168.1.255作为地址；这样允许子网中的每个节点监听广播媒体。
· port 必须是被传输者和接收者都允许的一个端口。
· content-type 是媒体流类型。在我们的案子中，这个将会是音频。
下面的一个简单的RTP传播MediaLocator例子会让所有在指定网络中的机器接收到媒体流：

rtp: //192.168.1.255:49150/audio

创建一个处理机

在setDataSource()方法中我们首先要做的就是创建一个Processor实例。
下面的Processor的职责是转换MP3音频媒体为一个RTP来表示：

public void setDataSource(DataSource ds)

评论

2 楼 Clayz 2008-05-01  

咳，我只是记录一下，以免自己忘记。我这有jmf安装文件，如果你要的话可以发给你。或者直接去sun上搜一下就有了啊。

1 楼 walkskyer 2008-04-26  

转载的话，应该把文章中提到的文件转过来啊！或者提供个转载的地址啊！！！唉！！