User Guide

496 Chapter 12: Methods
Example
The following code shows that the realPlayerPromptToInstall() function is set to TRUE,
which means users who do not have RealPlayer will be prompted to install it:
-- Lingo syntax
put(realPlayerPromptToInstall()) -- 1
// JavaScript syntax
-- Lingo syntax
trace(realPlayerPromptToInstall()); // 1
The following code sets the realPlayerPromptToInstall() function to FALSE, which means
that users will not be prompted to install RealPlayer unless you have created a detection and
alert system:
-- Lingo syntax
realPlayerPromptToInstall(FALSE)
// JavaScript syntax
realPlayerPromptToInstall(0);
realPlayerVersion()
Usage
-- Lingo syntax
realPlayerVersion()
// JavaScript syntax
realPlayerVersion();
Description
RealMedia function; returns a string identifying the build number of the RealPlayer software
installed on the user’s system, or an empty string if RealPlayer is not installed. Users must have
RealPlayer 8 or later in order to view Director movies containing RealMedia content. On
Windows systems, build numbers 6.0.8.132 or later indicate that RealPlayer 8 is installed. On
Macintosh systems, RealPlayer Core component build numbers 6.0.7.1001 or later indicate that
RealPlayer 8 is installed.
The purpose of this function is to allow you to create your own RealPlayer detection and alert
system, if you do not want to use the one provided by the function
realPlayerPromptToInstall() on page 495.
If you choose to create your own detection and alert system using the
realPlayerVersion()
function, you must do the following:
• Call realPlayerPromptToInstall(FALSE) (by default, this function is set to TRUE) before
any RealMedia cast members are referenced in Lingo or appear in the Score. This function
should be set in a
prepareMovie event handler in a movie script.
• Use the xtraList system property to verify that the Xtra for RealMedia (RealMedia Asset.x32)
is listed in the Movie Xtras dialog box. The realPlayerVersion() function will not work if
the Xtra for RealMedia is not present.
The build number returned by this function is the same as the build number you can display
in RealPlayer.