|
|
There are two ways to incorporate IP/TV into your Web environment, each requiring varying levels of customizing on your part. The two methods are as follows:
The following sections describe how to launch, run, and customize an IP/TV program plugin, and how to access the IP/TV sample plugin.
To launch IP/TV Viewer as a plugin, open your browser and enter the plugin's URL. Ask your system administrator for the exact location and name of the browser plugin web page. For example, the URL http://<mywebserver>/yourplugin.htm will jump to the web page named yourplugin.htm, which is located on the web server named webserver.
After you launch the plugin, the browser web page with the embedded IP/TV plugin appears. Figure 12-1 shows a sample plugin with all the toolbar settings defined.
Figure 12-1 is an example of an on-demand program plugin window. A scheduled program plugin window has different VCR controls.
The VCR controls for an on-demand program include: Stop/Play, positioning buttons, Position Control slider, Mute button, and volume control. For a scheduled program, the VCR controls include: Stop/Play, Mute button, and volume control.
See the "Menu Bar and Tool Icon Reference" appendix in the IP/TV Viewer User Guide for a complete listing of plugin window toolbar buttons and icons.
To create an IP/TV plugin and customize the "look and feel" of the plugin's toolbar, use the EMBED tag or OBJECT ID tag on the plugin's HTML source page. Use the EMBED tag for either the Netscape Navigator or Internet Explorer browsers. Use the OBJECT ID tag for the Internet Explorer browser only. Note that the IP/TV plugin only supports scripting when the EMBED tag for Netscape Navigator is used. If you want to add scripting and are using Internet Explorer, then you must use the OBJECT ID tag.
For Netscape Navigator or Internet Explorer, use the EMBED tag on the HTML source page of the plugin which lets you create and customize the look of the embedded IP/TV plugin window. Follow these steps:
Step 1 Open the Content Manager and click either OnDemand programs or Scheduled programs.
Step 2 Scroll to the desired program and click the Review link. The Review Program page appears.
Step 3 Scroll to the bottom of the page and click Load Plugin. A sample web page with the IP/TV plugin playing your selected program appears. This sample web page has all the default settings.
Step 4 If you like the way the web page looks, save it with an .htm extension and go to Step 6. If you do not like the way the web page looks, go to Step 5.
Step 5 To change the default settings, you need to access the program's .htm file in a text editor. To do this, click View Page>Source (for Netscape Navigator) or click View>Source (for Internet Explorer) to display the web page's .htm file.
Step 6 Change the default settings of the EMBED tag in the .htm file using the following parameters:
<EMBED TYPE="application/x-sdp"
SRC="path/file.sdp"
NAME=name
WIDTH=width
HEIGHT=height
[AUTOSTART= {TRUE | FALSE}]
[INVOKEURLS= {TRUE | FALSE}]
[SHOWTOOLBARS= {TRUE | FALSE}]
[SHOWPOSITIONTOOLBAR= {TRUE | FALSE}]
[SHOWVCRTOOLBAR= {TRUE | FALSE}]
[SHOWAUDIOTOOLBAR= {TRUE | FALSE}]
[SHOWSURFTOOLBAR= {TRUE | FALSE}]
[SHOWMISCTOOLBAR= {TRUE | FALSE}]
[SHOWDETACHTOOLBAR= {TRUE | FALSE}]
[SHOWSTATUSBAR= {TRUE | FALSE}]
[SHOWMINVIEW= {TRUE | FALSE}]>
Table 12-1 for a description of EMBED tag and OBJECT ID tag parameters section describes EMBED tag and OBJECT ID tag parameters.
For Internet Explorer use the OBJECT ID tag on the HTML source page of the plugin which lets you create and customize the look of the embedded IP/TV plugin. Follow these steps:
Step 1 Follow Steps 1 through 5 (and Step 6 if necessary) in the "Using the EMBED Tag" section earlier in this chapter.
Step 2 Change the default settings of the OBJECT ID tag in the .htm file using the following parameters:
<OBJECT ID="plugin_title"
WIDTH=width
HEIGHT=height
CLASSID= CLSID:364752D0-9065-11D2-8210-0060B0F139BD
[<PARAM Name="FILENAME"VALUE={"SDP FILENAME"}]
[<PARAM Name="AUTOSTART"VALUE={"TRUE | FALSE"}]
[<PARAM Name="INVOKEURLS"VALUE={"TRUE | FALSE"}]
[<PARAM Name="SHOWTOOLBAR"VALUE={"TRUE | FALSE"}]
[<PARAM Name="SHOWPOSITIONTOOLBAR"VALUE={"TRUE | FALSE"}]
[<PARAM Name="SHOWVCRTOOLBAR"VALUE={"TRUE | FALSE"}]
[<PARAM Name="SHOWAUDIOTOOLBAR"VALUE={"TRUE | FALSE"}]
[<PARAM Name="SHOWSURFTOOLBAR"VALUE={"TRUE | FALSE"}]
[<PARAM Name="SHOWMISCTOOLBAR"VALUE={"TRUE | FALSE"}]
[<PARAM Name="SHOWDETACHTOOLBAR"VALUE={"TRUE | FALSE"}]
[<PARAM Name="SHOWSTATUSBAR"VALUE={"TRUE | FALSE"}]
[<PARAM Name="SHOWMINVIEW"VALUE={"TRUE | FALSE"}]
</OBJECT>
Table 12-1 describes all EMBED tag and OBJECT ID tag parameters.
| Parameter | Values | Description |
|---|---|---|
TYPE | application/x-sdp | Specifies the MIME type of the EMBED and OBJECT ID tags and determines which plugin to load. This parameter is required for the EMBED tag and optional for the OBJECT ID tag. |
SRC= 1 FILENAME= 2 | path/file | Specifies the name of the .sdp file to be launched. If you specify a full path name, it must be enclosed in quotation marks. You can reference the program ID from the Content Manager. To reference an .sdp file directly from the Content Manager, enter the full path name. For example: " |
NAME= 1 | plugin name | Indicates the plugin name in the EMBED tag. |
OBJECT ID= 2 | plugin name | Indicates the plugin name in the OBJECT ID tag. |
CLASSID= 2 | CiscoMedia.OCX ID | Identifies the object implementation. The CiscoMedia.OCX ID is: |
WIDTH= | width | The width in pixels from the left edge of the plugin window to the right edge of the plugin. This parameter is required. |
HEIGHT= | height | The height in pixels from the top of the Viewer window to the bottom of the VCR controls. This parameter is required. |
AUTOSTART | TRUE or FALSE | Specifies whether to start playing the clip automatically. |
INVOKEURLS | TRUE or FALSE | Specifies whether to invoke URLs in a browser that are contained in an .asf file. |
RESIZEVIDEO | TRUE or FALSE | Specifies video resizing. |
SHOWAUDIOTOOLBAR | TRUE or FALSE | Displays/hides the Audio toolbar. |
SHOWDETACHTOOLBAR | TRUE or FALSE | |
SHOWMINVIEW | TRUE or FALSE | Specifies whether the plugin viewer window is displayed in minimal view. Minimal view displays only one toolbar including the Stop/Play, Mute, and Audio buttons. True displays only the minimal view and overrides the settings of all other property values. False (default) displays the normal view. Note that if False is set the state of the status bar is solely dependent on the SHOWSTATUSBAR value. Other toolbars are shown or hidden depending on the relation between their property values and the SHOW TOOLBAR value. For example, if SHOWTOOLBAR=TRUE, and SHOWSURFTOOLBAR=FALSE, then the Surf toolbar is hidden. If SHOWTOOLBAR=FALSE, then none of the toolbars is shown. |
SHOWMISCTOOLBAR | TRUE or FALSE | Displays/hides the Misc toolbar. |
SHOWPOSITIONTOOLBAR | TRUE or FALSE | Displays/hides the Position toolbar. |
SHOWSURFTOOLBAR | TRUE or FALSE | Displays/hides the Change Program list. |
SHOWSTATUSBAR | TRUE or FALSE | Displays/hides the IP/TV plugin status bar. |
SHOWTOOLBAR | TRUE or FALSE | Displays/hides all toolbars. |
SHOWVCRTOOLBAR | TRUE or FALSE | Displays/hides the VCR toolbar. |
SURFOPTIONx 3 | x, y.sdp | Add scheduled or on-demand program names to the Change Programs list box. the value x is each instance of an .sdp file. It can be 1, 2, 3 up to 32. The value y.sdp is the name of the .sdp file that contains the program name you want listed in the Change Programs list box. You can enter this option in the EMBED command up to 32 times. This parameter is optional. |
| 1Used only in the EMBED tag. 2Used only in the OBJECT ID tag. 3Do not mix scheduled and on-demand programs in the SURF_OPTION list. |
To prevent video from being clipped off, you need to consider the toolbar dimensions when designing the HTML source page for the plugin. The width and height in the EMBED or OBJECT ID tag refers to the size of window covering video and toolbars.
Toolbar dimension information is as follows:
For example, suppose the existing video size is 320 x 240 and the HTML page author chooses to show the Position toolbar, VCR toolbar, Audio toolbar, Misc toolbar, Surf toolbar, and status bar. The author needs to set the width of the plugin window to be the maximum of the video width, the sum of VCR toolbar and Audio toolbar width, and the sum of Misc toolbar and Surf toolbar width. The height of the plugin window needs to be set to be the sum of the video height, Position toolbar height, VCR toolbar height, Surf toolbar height and status bar height. In this case, the video size would be 320x348.
IP/TV plugin supports several attributes that let you manipulate playback of content. These attributes include playback methods and seeking methods and properties. Playback methods for media content are: Play, Pause, and Stop. Seeking methods and properties are: MarkerName method, CurrentMarker property, Current Position, and MarkerCount property.
Table 12-2 lists and describes the methods and properties the IP/TV plugin supports.
| Method or Property | Syntax | Description |
|---|---|---|
Play method | plugin_name.Play | Starts playing a clip from the starting position or continues playing a paused clip. This method has no parameters. |
Pause method | plugin_name.Pause | Suspends playback at the current position in the clip. This method performs the same action as clicking the VCR control Pause button. This method has no parameters and does not return a value. |
Stop method | plugin_name.Stop | Stops playback of the current clip. This method has no parameters and does not return a value. |
MarkerName method | plugin_name. | Returns a string containing the name of the marker, given its marker number. MarkerNum is a long value specifying the number of the marker name to return. |
CurrentMarker property | plugin_name. plugin_name. | Sets a Long value indicating the current marker number. Before you attempt to set this property, determine whether a file has markers and their number by using MarkerCount. If a file has no markers, setting CurrentMarker to anything except 0 (zero) results in an error. Setting CurrentMarker to a number higher than MarkerCount also results in an error. |
| plugin_name. plugin_name. | Returns a Long value indicating the current marker number. This property always returns the current or last marker, which means the actual file position can be either at the current marker or before the next marker. Markers are numbered beginning at 1, so if a file has markers, setting CurrentMarker to 0 (zero) to changes the file position to zero. |
CurrentPosition property | plugin_name. plugin_name. | Sets a Long value of the clip's current position in seconds. |
| plugin_name. plugin_name. | Returns a Long value of the clip's current position in seconds. |
MarkerCount property | plugin_name. plugin_name. | Returns a Long value of number of markers in the current clip. This property returns zero if a file has no markers, or if the FileName property is not set. Marker numbers start at 1. |
| 1This syntax is specific to the EMBED tag. 2This syntax is specific to the OBJECT ID tag. |
The following example displays a program's customized .htm file using the EMBED tag.
<HTML><HEAD><TITLE>IP/TV Netscape-style Plugin: Cisco Systems, Inc.</TITLE></HEAD><BODY BGCOLOR="C0C0C0"><CENTER><H2>IP/TV Web Video</H2><P><!-- modify the URL below to point to download.pl and your programwhere download.pl is in the [iptv-scripts] directory,eg. http://myhostname/cgi-bin/iptv or http://myhostname/scriptsand yourfile is in the programs subdirectory--><EMBED SRC="samplemarker.sdp"NAME =IPTVPluginWIDTH=420HEIGHT=320ShowMinView=true></EMBED><form><input type=buttononclick="document.IPTVPlugin.Play()"value=play><input type=buttononclick="document.IPTVPlugin.Stop()"value=stop><input type=buttononclick="document.IPTVPlugin.SetCurrentMarker(parseInt(form.editSeek.value))"value=seek><input name=editSeektype=textvalue=1size=10><form></CENTER>
The following example displays a program's customized .htm file using the OBJECT ID tag.
<OBJECT ID="IPTVPlayer" WIDTH=400 HEIGHT=400 CLASSID="CLSID:364752D0-9065-11D2-8210-0060B0F139BD"> <PARAM Name="AutoStart" Value="true"> <PARAM Name="InvokeURLs" Value="false"> <PARAM NAME="FileName" Value="mpeg_vod.sdp"> <PARAM NAME="ShowToolbars" Value="true"> <PARAM NAME="ShowVCRToolbar" Value="true"> <PARAM NAME="ShowAudioToolbar" Value="true"> <PARAM NAME="ShowSurfToolbar" Value="true"> <PARAM NAME="ShowMiscToolbar" Value="true"> <PARAM NAME="ShowDetachToolbar" Value="true"> <PARAM NAME="ShowMinView" Value="false"> <PARAM NAME="InvokeURLs" Value="false"> <PARAM NAME="ResizeVideo" Value="false"> <PARAM NAME="ShowStatusBar" Value="true"> <PARAM NAME="SurfOption1" Value="concert_vod.sdp"> <PARAM NAME="SurfOption32" Value="http://pub-pc/servlet/OdPublish?ProgID=907984166"> </OBJECT> <form> <input type=button onclick="document.IPTVPlayer.Play()"
value=play> <input type=button onclick="document.IPTVPlayer.Stop()" value=stop> <input type=button onclick="document.IPTVPlayer.Pause()" value=pause> <input type=button onclick="document.IPTVPlayer.CurrentMarker=parseInt(form.editSeek.value)" value=seek> <input name=editSeek type=text value=0 size=10> <form> </CENTER>
If desired, you can use the sample plugin that comes with IP/TV which is useful if you want to launch and run IP/TV Viewer solely from a browser without any customization. To access the sample plugin, perform the following steps:
Step 1 Open your browser.
Step 2 In your browser enter the URL http://<mywebserver>/iptvfiles/iptv.htm,
IP/TV Web Video. All programs on the Content Manager are listed in the Change Program list.This section provides an example of a Web Presenter program IP/TV plugin. Figure 12-2 shows a browser web page containing a plugin with three frames: Video frame, Table of Contents frame, and the Slide Presentation frame. The HTML source page for each frame is located in the following directory on the IP/TV 3.0 CD-ROM: \Samples\Plugins\Presenter\demo.htm.
You can set up IP/TV Viewer to be used as a helper application. The following sections describe how to launch, run, and customize the IP/TV helper application.
To launch IP/TV Viewer as a helper application, open your browser and go to the web page that contains the IP/TV Viewer helper application link. Ask your system administrator for the exact location and name of the web page that contains this link. Click the link to launch IP/TV Viewer.
After launching the IP/TV helper application by clicking its web link, the IP/TV Viewer main window and then viewer window appear. The designated program begins to play in the viewer window. The program behaves exactly the same as when you launch IP/TV Viewer as a standard application.
See the "Menu Bar and Icon Reference" appendix in the IP/TV Viewer User Guide for a complete listing of viewer window toolbar buttons and icons.
Step 1 Open the Content Manager and click either OnDemand programs or Scheduled programs.
Step 2 Scroll to the desired program and click the Review link. The Review Program page appears.
Step 3 Scroll to the bottom of the page and click Load Helper Application. A sample web page that contains the helper application anchor and link appears (see Figure 12-3).
Step 4 If you like the way the web page looks, save it with an .htm extension and go to Step 6. If you do not like the way the web page looks, go to Step 5.
Step 5 To change the default settings, you need to access the program's HTML web page in a text editor. To do this, click View>Source (for Netscape Navigator) or click View>Page Source (for Internet Explorer) to display the web page's .htm file.
You can make changes in this file or copy and paste the information into another .htm file.
Step 6 Change the following helper application anchor and link commands in the .htm file.
<A HREF="path/file">
Link </A>
Table 12-3 describes the helper application anchor and link parameters.
| Parameter | Value | Description |
HREF= | path/file | Specifies the name of the .ipt file to be launched. If you specify a full path name, it must be enclosed in quotation marks. For example: "http://web-server/.../xxx.ipt". |
Link= | message text | The text that appears as a link in the browser web page. When you click this link, the designated program is launched in a separate IP/TV plugin window. |
The following sample .htm file contains the helper application anchor and link commands.
<HTML><HEAD>
<TITLE>IP/TV Web Video</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<CENTER>
<H2>Yourcompany's IP/TV Web Video Page</H2>
<P>
<A HREF="http://mywebserver/iptv/download.pl/137475.ipt">Play IP/TV Viewer Now</A>
<P>To customize: view and save the HTML source for this page
</CENTER>
</BODY>
</HTML>
Posted: Thu Oct 28 16:02:26 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.