Chapter 3: Installation

This chapter describes how to install RealPlayer, RealServer, and TestPlayer for use with the RealSystem G2 SDK.

Installing RealPlayer and TestPlay

RealSystem includes two applications that you can use to test your streaming datatype plug-ins. The first application is RealPlayer G2, the standard RealSystem client. RealPlayer G2 is not included with this SDK, but free downloads are available at http://www.real.com/products/. Use RealPlayer G2 to test your streaming datatype.

The second application, TestPlay, has the RealPlayer G2 core with a command line interface. Use it to test streaming datatypes in a client environment other than RealPlayer. You can use TestPlay, for example, to mimic the delivery of streaming data directly within a Web browser. By testing plug-ins using both RealPlayer and TestPlay, you may find problems in one environment that do not appear in the other. Because TestPlay demonstrates how a client application uses the RealSystem Transport Engine (client "core"), you can use TestPlay as the basis for embedding RealSystem client functionality in an application.

Additional Information
For more on customized client applications, see "Chapter 20: Top-Level Client".

	Additional Information
For more on customized client applications, see "Chapter 20: Top-Level Client".

Installing RealPlayer on Windows

Running the RealPlayer installer (http://www.real.com/products/) does the following:

Installs RealPlayer, which has this default location:
```
c:\Program Files\Common Files\Real\
```
Places PNEN3260.DLL, PNUI3260.DLL, and PNCRT.DLL in:
```
c:\Program Files\Common Files\Real\Common
```

Installs plug-ins in:


c:\Program Files\Common Files\Real\Plugins

Installs codecs in:


c:\Program Files\Common Files\Real\Codecs.

Configures Web browsers to launch RealPlayer when they receive a file with the .ram or .rpm extension.

The RealPlayer subdirectory preference settings are stored in the Windows registry under the following keys:


HKEY_CLASSES_ROOT
    \Software
        \RealNetworks
            \Preferences
                \DT_Common
                \DT_Plugins
                 \DT_Codecs

Test that RealPlayer installed correctly by using the Open File command to play any of the .rm or .ra files in the sdk/testdata directory.

Using the RTP Data Format

To set RealPlayer to use the RTP data transport format instead of the standard RDT when receiving files from RealServer, add the following registry key:


HKEY_CLASSES_ROOT
    \Software
        \RealNetworks
            \RealPlayer
                \6.0
                    \Preferences
                        \UseRTP

Set the default value to 1 to use RTP as the data transport. Setting the default as 0 makes the client use RDT.

Installing RealPlayer on Macintosh

The RealPlayer G2 for Macintosh installer is available at http://www.real.com/products/. Plug-ins are installed in:


System:Extensions:Real:Plugins

Codecs are installed in:


System:Extensions:Real:Codecs

If you have a previous version of RealPlayer installed, the installation overwrites older versions of files in the Real folder, but does not delete plug-ins or codecs you have placed in the folder.

Test that RealPlayer installed correctly by using the Open File command to play any of the .rm or .ra files in the sdk/testdata directory.

Installing TestPlay

TestPlay is provided as source code in sdk/samples/intermed/testplay. Because TestPlay uses the same transport engine, plug-ins, and codecs as RealPlayer, install the latest version of RealPlayer for your platform as described above. Then compile TestPlay in the RealPlayer directory.

Additional Information
For general build instructions, see "Compiling a Plug-In".

	Additional Information
For general build instructions, see "Compiling a Plug-In".

Installing and Running RealServer G2

RealServer G2 runs under UNIX or Windows 32-bit operating systems. You need to install RealServer when developing with this SDK. RealServer binaries are not included with this SDK, but free downloads of the basic RealServer are available at http://www.real.com/products/.

RealServer requires a license key to run. You receive a license key by e-mail based on the information you provided when downloading RealServer. You will need to copy information contained in the e-mail to RealServer's configuration file or Web-based administration interface.

For instructions on configuring and running RealServer, see RealServer Administration Guide available in HTML format with your downloaded RealServer G2 executables. RealServer documentation is also available at http://service.real.com/help/library/servers.html.

Configuring Your Web Server to Work with RealServer

RealServer works with any Web server that supports configurable MIME types. Setting the correct MIME types in the Web server makes a Web browser play a RealSystem file with RealPlayer rather than download the file to the browser. In addition to defining your own datatypes in your Web server, make sure that the following are defined:


application/smil (for files with a .smi extension) 
audio/x-pn-realaudio (for files with a .ra, .rm, or .ram extension) 
audio/x-pn-realaudio-plugin (for files with a .rpm extension)

The procedure for configuring MIME types varies from one Web server to another. Refer to http://www.real.com/help/content/servmime.html or your Web server documentation for more information.

Monitoring RealServer

A sample server monitor plug-in is provided in source code as samples/intermed/exmonpln/exmonpln.cpp. Do the following to install the sample monitor:

Compile the plug-in for your platform.

Additional Information
For general build instructions, see "Compiling a Plug-In".
Copy the compiled monitor plug-in to the plug-ins subdirectory.
Restart RealServer.
Connect to RealServer through a RealSystem client.
Check the monitor's output in the console window of the RealServer machine.

Additional Information
For more on this sample code, see " Modifying the Monitor Plug-in Sample Code".