JMF中文版API DOC版

根据给定文件的信息，我们可以总结出以下几个重要的知识点： ### JMF (Java Media Framework) 概述 JMF（Java Media Framework）是Sun Microsystems为Java平台提供的一套多媒体框架，它支持多种媒体格式的处理，包括音频、视频以及混合媒体等。JMF的主要目标是为开发者提供一个统一的接口来开发多媒体应用程序，而无需关心底层硬件和具体的媒体格式。 ### JMF 中文版 API 文档的重要性 对于很多中文开发者来说，官方提供的文档通常是英文的，这可能会导致理解上的障碍。因此，JMF 中文版 API 文档对于希望学习和使用 JMF 的开发者来说非常有用。这些文档能够帮助开发者更好地理解和掌握 JMF 的功能和用法，特别是对于那些对英文文档感到困难的开发者。 ### JMF 事件处理机制 #### ActiveReceiveStreamEvent `ActiveReceiveStreamEvent` 类用于通知 `SessionListener` 关于 RTP/RTCP 协议的数据包到达的情况。当数据包开始停止并到达时会触发此类事件。如果涉及的是一个活跃的发送者，则会改变 `ReceiveStream` 的状态；如果是被动接收者，则 `ReceiveStream` 可能无效。 #### ActiveSendStreamEvent `ActiveSendStreamEvent` 类用于通知 `RTPSendStreamListener` 关于 RTP/RTCP 协议的数据包到达的情况。当数据包开始停止并到达时会触发此类事件。 #### ApplicationEvent `ApplicationEvent` 类继承自 `ReceiveStreamEvent`，用于通知监听器已经接收到 RTP/RTCP 协议的“体”数据包。 #### AudioDeviceUnavailableEvent `AudioDeviceUnavailableEvent` 类继承自 `ControllerEvent`，用于表明控制器无法获取音频设备。 ### JMF 格式处理 #### AudioFormat 类 `AudioFormat` 类是用于描述音频数据格式的一个类。它包含了一些基本属性，如采样率、每个样本的位数、声道数等。以下是 `AudioFormat` 类的一些重要方法和构造函数： - **构造函数**： - `AudioFormat(String encoding)`：使用指定的编码类型构造 `AudioFormat` 对象。 - `AudioFormat(String encoding, double sampleRate, int sampleSizeInBits, int channels)`：使用指定的属性构造 `AudioFormat` 对象。 - `AudioFormat(String encoding, double sampleRate, int sampleSizeInBits, int channels, int endian, int signed, int frameSizeInBits, double frameRate, Class dataType)`：使用指定的属性构造 `AudioFormat` 对象。 - **方法**： - `Object clone()`：创建一个当前 `AudioFormat` 对象的克隆。 - `long computeDuration(long length)`：基于提供的数据长度计算持续时间。 - `void copy(Format f)`：将指定格式的属性复制到当前 `AudioFormat` 对象。 - `boolean equals(Object format)`：比较指定格式与当前 `AudioFormat` 是否相等。 - `int getChannels()`：获取声道数。 - `int getEndian()`：获取表明样本字节顺序是大端还是小端的整数。 - `double getFrameRate()`：获取帧率。 - `int getFrameSizeInBits()`：获取帧大小。 - `double getSampleRate()`：获取采样率。 - `int getSampleSizeInBits()`：获取样本大小。 - `int getSigned()`：获取一个布尔值，表明样本是否是以有符号格式存储。 - `Format intersects(Format format)`：找到两个格式对象之间的共同属性。 - `boolean matches(Format format)`：检查指定格式是否与当前 `AudioFormat` 相匹配。 - `String toString()`：获取当前 `AudioFormat` 的属性字符串表示形式。 ### 异常处理 #### BadHeaderException 类 `BadHeaderException` 类继承自 `MediaException`，用于表示处理媒体头时发生的异常。此类异常通常发生在解析媒体文件头部信息的过程中出现问题时。 通过以上总结可以看出，JMF 提供了丰富的多媒体处理功能，包括事件处理、音频格式的定义以及异常处理等方面的支持。这对于开发者来说是非常有用的工具集合，可以帮助他们更轻松地开发多媒体应用。