An Embedded RealPlayer is a variation of RealPlayer® that enables RealMedia™ content to be played back directly within a Web page, rather than launching RealPlayer as a separate application. Content played in an Embedded RealPlayer is called an embedded presentation.
You can create an Embedded RealPlayer for your Web page using the Netscape plug-in or ActiveX control that comes with the RealPlayer installation. By including the plug-in or control in your HTML application, you gain access to methods that set and retrieve presentation attributes, control the clip playback, and handle user interactions. While the methods are most commonly accessed from Java, JavaScript, or VBScript, they can also be developed using C++ and other programming languages.
Before you begin embedding presentations in your web page, you should first obtain and read the RealSystem iQ Production Guide available at http://service.real.com/help/library/encoders.html. This manual describes how to assemble a RealSystem presentation that can be used with the Embedded RealPlayer controls.
Version 2 of this guide includes significant changes to the Netscape plug-in and ActiveX control API sets, improved sample applications, and a new callback event handling mechanism. The following sections highlight these changes. For more detailed descriptions of the changes, see the remaining chapters in this guide.
Several methods have been removed from the ActiveX and Netscape APIs and are no longer supported. Calls to any of these functions will be ignored by the Embedded RealPlayer because no new methods have been introduced to the API sets to replace the removed methods.
 |
For More Information: For a complete list of all removed methods, see "Methods Removed From the ActiveX and Netscape API Sets". |
Several methods are considered to be obsolete in versions later than RealPlayer 8.x, but may be used depending on your development platform and application requirements. In some instances, new methods have been added to the API sets to replace some of the obsolete methods. When this is the case, it is strongly recommended that you use the new method.
|
For More Information: For a complete list of all obsolete methods, see "Obsolete Methods in the ActiveX and Netscape API Sets". |
Netscape® version 6.0 does not support callback event handling in the same manner as previous versions. For this reason, Embedded RealPlayer introduces a new mechanism for event handling involving the use of JavaScript and callback methods in a Netscape plug-in. The procedure is available for Netscape running on Microsoft Windows® or Macintosh®, and Microsoft Internet Explorer® running on Macintosh. For more information about using the new mechanism, see "Handling Callback Events From RealPlayer".
You need the following tools to create and test your embedded presentation:
Use RealPlayer, available free at http://www.real.com, to test your JavaScript or VBScript extensions. The RealPlayer installation includes the Netscape plug-in and ActiveX control for embedded playback.
RealSystem Server streams clips to RealPlayer. The server is not necessary for testing local playback of embedded clips, but is necessary for streaming presentations to RealPlayer over a network. The RealSystem Server Administration Guide is available at http://service.real.com/help/library/servers.html.
The RealSystem SDK is not necessary for extending RealPlayer's embedded playback features, but is required for advanced programming tasks such as building a new client interface on top of the RealPlayer core. A knowledge of C++ programming is required to use the SDK. Register for and download the SDK at http://www.realnetworks.com/devzone/.
This manual contains the following chapters:
This chapter provides an overview of embedding RealPlayer presentations on a
Web page, with descriptions of the <EMBED> tag for plug-ins and the <OBJECT>
tag for ActiveX controls. A list of the available tag parameters is also provided.
This chapter provides a basic overview of scripting for the Embedded RealPlayer controls on your Web page, with emphasis on the methods supplied with the RealPlayer.
This chapter provides an overview of how to use the RealPlayer callback methods.
This chapter provides complete descriptions of all the RealPlayer embedded methods.
This chapter provides complete descriptions of all the RealPlayer callback methods.
In addition, an appendix, "Compatibility", is included that describes the compatibility of this version of the Embedded RealPlayer methods and callbacks to those of previous versions.
The following table explains the conventions used in this manual.
For technical support with RealSystem, please fill out the form at:
http://customerrelations.real.com/scripts/rnforms/contact_tech_service.asp
The information you provide in this form will help technical support personnel to give you a prompt response. For general information about RealNetworks' technical support, visit http://service.real.com/help/call.html
RealNetworks also encourages you to join RealForum, an e-mail discussion group about RealSystem products where developers and content producers post tips and ask for assistance. RealNetworks employees monitor the postings and offer suggestions as appropriate. You can sign up for RealForum by connecting to http://realforum.real.com/ and clicking on New user.
|
©2001 RealNetworks, Inc. All rights reserved.
For more information, visit RealNetworks Click here if the Table of Contents frame is not visible at the left side of your screen. |