The SMIL player

General

The SMIL 2.0 player developed in the project

is integrated into the X-Smiles browser
can be be run as a standalone player
can be used as a library package

This page describes how to use the SMIL player in these three ways.

X-Smiles browser

The SMIL player is integrated into the X-Smiles browser. To install and run the browser, see the installation page.

The SMIL player in the browser can handle external links, embedded XForms elements and embedded XSL FO, SVG and SMIL files. These features are not available in the standalone player or library package.

SMIL standalone player

SMIL presentations can also be played using a standalone application. The standalone application can only play SMIL, it cannot play any embedded XForms elements, XSL FO or SVG files. Also, it cannot play SMIL embedded in a SMIL file or Ogg Vorbis audio. External links to other documents don't work.

The standalone application can be run from the X-Smiles package or from the SMIL package. Note that the classpath should include xerces.jar, xml-apis.jar, xsmiles.jar (smil.jar) and JMF. The player uses new Xerces2 to parse the XML files and JMF2.1.1 to play audio and video.

The command to run the player is

java -classpath smil.jar;xerces.jar;xml-apis.jar fi.hut.tml.xsmiles.mlfc.smil.viewer.swing.SMILViewer

To download the X-Smiles package, see the download page.
To download only the SMIL package, see the end of this page.

Library package

1. General

The SMIL player can also be used as a library package for other applications. It can be used either from the X-Smiles package or the SMIL package.

The library version of the player can only play SMIL, it cannot play any embedded XForms elements, XSL FO or SVG files. Also, it cannot play SMIL embedded in a SMIL file or Ogg Vorbis audio. External links to other documents don't work.

If the SMIL player is run from the SMIL package, the classpath should include smil.jar, xerces.jar, xml-apis.jar and JMF. Xerces2 is used to parse the XML files and JMF to play audio and video.

Also, simple HTML styling can be used, see the demo/smil/css/css.smil demo for example. To get this to work, ss_css2.jar should be included in the classpath (jar available in the X-Smiles release). It is a CSS2 parser developed by SteadyState.

2. Example

Here is a simple example, how to use the SMIL player. The classpath should include xerces.jar, xml-apis.jar and smil.jar. Also, for audio and video, JMF should be installed.

// Import the JSMILPlayer import fi.hut.tml.xsmiles.mlfc.smil.viewer.swing.JSMILPlayer; import javax.swing.JFrame; import java.awt.BorderLayout; public class SMILApp { /** * Main to play a SMIL presentation. */ public static void main(String[] args) { String filename = null; // Get the filename if (args.length > 0) { filename = args[0]; } else filename = "d:/source/xsmiles/demo/smil/ahma/ahma.smil"; System.out.println("SMILApp playing '"+filename); // Create the SMIL player JSMILPlayer smil = new JSMILPlayer(); // Initialize with the filename (could also be URL) if (smil.init(filename) == false) System.out.println("ERROR initializing "+filename); // Create a frame and add the SMIL component to it JFrame frame = new JFrame("Simple SMIL player"); frame.setSize(600,400); frame.getContentPane().add(smil, BorderLayout.CENTER); frame.show(); // Start the SMIL presentation smil.start(); // Wait for 10 seconds try { Thread.sleep(10000); } catch (InterruptedException e) { } System.out.println("SMILApp stopping."); // Stop the SMIL presentation smil.stop(); // Remove the SMIL component from the frame frame.removeAll(); frame.hide(); // Free memory smil.destroy(); // Clear variables frame = null; smil = null; // Exit System.exit(0); } }

Download the SMIL package

The SMIL package can be downloaded here.

NOTE: This package contains only the SMIL player, not the complete X-Smiles XML-browser. To download the complete X-Smiles browser, see the download page. Also, the required XML parser, xerces.jar is not included here.

SMIL package (280 kb) (For any platform with Java)