i
Javaª Media Framework
API Guide
November 19,1999
JMF 2.0 FCS
JMF API Guideii
iii
1998-99 Sun Microsystems, Inc.
2550 Garcia Avenue, Mountain View, California 94043-1100 U.S.A.
All rights reserved.
The images of the video camera, video tape, VCR, television, and speakers
on page 12 copyright www.arttoday.com.
RESTRICTED RIGHTS LEGEND
: Use, duplication, or disclosure by the
U.S. Government is subject to restrictions of FAR 52.227-14(g)(2)(6/87)
and FAR 52.227-19(6/87), or DFAR 252.227-7015(b)(6/95) and DFAR
227.7202-1(a).
The release described in this document may be protected by one or more
U.S. patents, foreign patents, or pending applications.
Sun, the Sun logo, Sun Microsystems, JDK, Java, and the Java Coffee Cup
logo are trademarks or registered trademarks of Sun Microsystems, Inc. in
the United States and other countries.
THIS PUBLICATION IS PROVIDED ÒAS ISÓ WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.
THIS PUBLICATION COULD INCLUDE TECHNICAL INACCURACIES
OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY
ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE
INCORPORATED IN NEW EDITIONS OF THE PUBLICATION. SUN
MICROSYSTEMS, INC. MAY MAKE IMPROVEMENTS AND/OR
CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S)
DESCRIBED IN THIS PUBLICATION AT ANY TIME.
JMF API Guideiv
v
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
About JMF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Design Goals for the JMF API . . . . . . . . . . . . . . . . . . . . . . . xiv
About the JMF RTP APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Design Goals for the JMF RTP APIs. . . . . . . . . . . . . . . xvi
Partners in the Development of the JMF API . . . . . . . . . .xvii
Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii
About this Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii
Guide to Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii
Change History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx
Part 1: Javaª Media Framework . . . . . . . . . . . . . . . . . . . . . . . .1
Working with Time-Based Media . . . . . . . . . . . . . . . . . . . . . . .3
Streaming Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Content Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Media Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Common Media Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Media Presentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Presentation Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Latency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Presentation Quality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7