Introduction

This guide will help you to use Javascript or ActiveX in two areas. First, it explains methods that you can use to coordinate streaming media and HTML pages in the various RealOne Player panes. Second, it shows how to use scripting to extend the functionality of the embedded player, a variation of RealOne Player that enables streaming media to play directly within a Web page.

Note: Although this guide shows you how to use Javascript and ActiveX with RealOne Player, it assumes that you are already familiar with these scripting technologies in general.

RealSystem Components

You need the following tools to create and test your scripted presentation:

RealOne Player

Use RealOne Player, available free at http://www.real.com, to test your Javascript or ActiveX extensions. The RealOne Player installation includes the Netscape plug-in and ActiveX control for embedded presentations.

RealSystem Server

RealSystem Server streams clips to RealPlayer. The server is not necessary for testing local playback of clips, but it is necessary for streaming presentations over a network. The RealSystem Server Administration Guide is available at the following Web address:

http://service.real.com/help/library/servers.html

RealSystem Software Development Kit (SDK)

The RealSystem SDK is not necessary for using RealOne Player's scriptable playback features. But it is required for advanced programming tasks, such as building a new client interface on top of the RealOne Player core. A knowledge of C++ programming is required to use the SDK. Register for and download the SDK from this Web page:

http://service.real.com/help/library/

How to Download This Guide to Your Computer

RealNetworks makes this guide available in the following formats for download to your computer:

The HTML+Javascript version, which you are viewing now, is available as a single, zipped archive that includes samples that you can play in RealOne Player. You can read this version with Netscape Navigator or Microsoft Internet Explorer.

The HTML Help version is available as a single .chm file for Windows 98 and later operating systems. It is identical to the HTML+Javascript version, except that it does not contain any sample files. The HTML Help version is smaller in size than the HTML+Javascript version, and it includes a search function.

An Adobe Acrobat (PDF) version includes page numbers in cross-references, making it more useful than the HTML versions when printed. You can download the free Acrobat viewer from Adobe's Web site at http://www.adobe.com/products/acrobat/readstep.html.

All of the online versions of this guide are available for individual download from RealNetworks' Technical Support Web site at:

http://service.real.com/help/library/encoders.html

How This Guide Is Organized

Part I: Scripting with RealOne Player

The chapters in this section explain how to use Javascript and ActiveX in the RealOne Player environment, in which RealOne Player launches as a separate application.

Chapter 1: RealOne Player Environment

This chapter explains the RealOne Player environment, covering the three- pane design. It introduces you to the variety of authoring methods you can use, and explains the functional areas in which you can use Javascript or ActiveX.

Chapter 2: RealOne Player Methods

This chapter lists the Javascript and ActiveX methods that you can use to control playback in the RealOne Player environment.

Chapter 3: RealOne Player Events

Refer to this chapter for information about the Javascript and ActiveX event handlers that provide information about RealOne Player activity.

Part II: Scripting with the Embedded Player

The chapters in this section explain how to use Javascript and VBScript in the embedded environment, in which RealOne Player functions as a browser helper application, but does not launch as a separate application.

Chapter 4: Embedded Environment

This chapter provides an overview of the embedded player, with descriptions of the <EMBED> and <OBJECT> tags used to embed presentations.

Chapter 5: Embedded Method Overviews

Read this chapter for an overview of the scripting methods available when you embed a presentation in a Web page.

Chapter 6: Embedded Player Methods

This chapter provides complete descriptions of all the embedded methods you can use to control an embedded presentation.

Chapter 7: Embedded Player Callbacks

This chapter lists all the callback methods that return information about the embedded presentation.

Conventions Used in this Guide

The following table explains the typographical conventions used in this guide.

Notational Conventions
Convention	Meaning
emphasis	Bold text is used for in-line headings, user-interface elements, URLs, and e-mail addresses.
terminology	Italic text is used for technical terms being introduced, and to lend emphasis to generic English words or phrases.
`syntax`	This font is used for fragments or complete lines of programming syntax (markup).
`syntax emphasis`	Bold syntax character formatting is used for program names and to emphasize specific syntax elements.
`variables`	Italic syntax character formatting denotes variables within fragments or complete lines of syntax.
`[options]`	Square brackets indicate values you may or may not need to use. As a rule, when you use these optional values, you do not include the brackets themselves.
`choice 1\|choice 2`	Vertical lines, or "pipes," separate values you can choose between.
...	Ellipses indicate nonessential information omitted from examples.

Additional Documentation Resources

In addition to this guide, you may need the following resources, which are available for download at http://service.real.com/help/library/encoders.html:

RealSystem Producer User's Guide

This user's guide gives you the step-by-step instructions for running RealSystem Producer™, which turns audio and video files into streaming RealAudio® and RealVideo® clips. An online version of this guide is available through the RealSystem Producer Help menu.

RealSystem iQ Production Guide

This guide is the main reference manual for streaming media production. Refer to it for instructions and tips on media production, as well as for complete information about using SMIL 2.0, RealText, and other RealSystem clip types.

Introduction to RealSystem iQ Production

This guide provides a simple, streamlined introduction to RealSystem production techniques. For new users, it provides basic information about streaming media, clip-encoded URLs, Ram files, and SMIL 2.0.

Technical Support

To reach RealNetworks' Technical Support, 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 respond promptly. For general information about RealNetworks' Technical Support, visit this Web page:

http://service.real.com/help/call.html

For More Information: Choose Help Page from the pull-down menu for additional information about obtaining assistance.

RealForum

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.