previous next

Chapter 2: SDK Organization

This chapter lists the header files and sample files you can use to create RealSystem G2 components; the chapters that follow describe in detail how to use these files. This chapter also describes plug-ins and other compiled binary files used with RealServer G2 and RealPlayer G2.

Binaries

RealSystem executable files and libraries are included in the following subdirectories of the SDK's /bin directory. Note that some UNIX platforms may not include all the plug-ins listed below.

player

Free downloads of RealPlayer are available at http://www.real.com. The following table lists the plug-ins included with the client. Your license agreement determines which components you can distribute with any application that includes RealPlayer functionality.

Player Core
Player Core Win32 MacOS Unix Win16
Installed to: \windows\system\ system folder:extensions:real /real \windows\system\
Player Core pnen3260.dll rmacore60.dll rmacore.so.6.0 pnen1660.dll
Player Runtime pncrt.dll pncrt.dll n/a n/a
Player Memory Manager n/a pnmm.lib n/a pnlo1660.dll
Window Manager n/a n/a unixsite.so.6.0 n/a

Core Components
Core Components Win32 MacOS Unix Win16
Installed to: \...\system\real\ system folder:extensions:real /real \...\system\real\
HTTP file system (short name: pn-http) http3260.dll httpfsys60.dll httpfsys.so.6.0 http1660.dll
Metafile file format meta3260.dll meta60.dll meta.so.6.0 meta1660.dll
RealMedia file format rmff3260.dll rmffplin60.dll rmffplin.so.6.0 rmff1660.dll
SDP stream description sdpp3260.dll sdpplin60.dll sdpplin.so.6.0 sdpp1660.dll
SMIL file format smlf3260.dll smlffplin60.dll smlffpln.so.6.0 smlf1660.dll
SMIL rendering smlr3260.dll smlrendr60.dll smlrendr.so.6.0 smlr1660.dll
Synchronized multimedia rendering smmr3260.dll smmrendr60.dll smmrendr.so.6.0 smmr1660.dll
Simple file system (short name: pn-local) smpl3260.dll smplfsys60.dll smplfsys.so.6.0 smpl1660.dll
Authentication/E-Commerce Plug-ins
Authentication Manager auth3260.dll authmgr60.dll authmgr.so.6.0 auth1660.dll
RealSystem 5.0 Authentication rn5a3260.dll rn5auth60.dll rn5auth.so.6.0 rn5a1660.dll
Basic Authentication basc3260.dll bascauth60.dll bascauth.so.6.0 basc1660.dll
Datatype Plug-ins
RealAudio rendering rare3260.dll rarender60.dll rarender.so.6.0 rare1660.dll
RealVideo rendering rvre3260.dll rvrend60.dll rvrend.so.6.0 rvre1660.dll
RealText file format rtff3260.dll rtffplin60.dll rtffplin.so.6.0 rtff1660.dll
RealText rendering rtre3260.dll rtrender60.dll rtrender.so.6.0 rtre1660.dll
RealPix file format pxff3260.dll pxff60.dll pxff.so.6.0 pxff1660.dll
RealPix rendering pxre3260.dll pxrend60.dll pxrend.so.6.0 pxre1660.dll
RealPix JPEG codec pxcj3260.dll pxcjpeg60.dll pxcjpeg.so.6.0 pxcj1660.dll
RealPix GIF codec pxcg3260.dll pxcgif60.dll pxcgif.so.6.0 pxcg1660.dll
RealFlash file format swff3260.dll swff60.dll swff.so.6.0 swff1660.dll
RealFlash rendering swfr3260.dll swfrend60.dll swfrend.so.6.0 swfr1660.dll

Codecs
Codecs Win32 MacOS Unix Win16
Installed to: \..\real\codecs\ system folder:extensions:real:codecs /real/codecs \..\real\codecs\
RealAudio Codecs 14_43260.dll 14_460.dll 14_4.so.6.0 14_41660.dll
28_83260.dll 28_860.dll 28_8.so.6.0 28_81660.dll
cokr3260.dll cokr60.dll cokr.so.6.0 cokr1660.dll
cook3260.dll cook60.dll cook.so.6.0 cook1660.dll
ddnt3260.dll ddnt60.dll dnet.so.6.0 ddnt1660.dll
dnet3260.dll dnet60.dll ddnt.so.6.0 dnet1660.dll
dspr3260.dll dspr60.dll dspr.so.6.0 dspr1660.dll
sipr3260.dll sipr60.dll sipr.so.6.0 sipr1660.dll
RealVideo Codecs drv13260.dll drv160.dll drv1.so.6.0 drv11660.dll
drv23260.dll drv260.dll drv2.so.6.0 drv21660.dll
rnco3260.dll rncolor60.dll rncolor.so.6.0 rnco1660.dll
rv103260.dll rv1060.dll rv10.so.6.0 rv101660.dll
rv203260.dll rv2060.dll rv20.so.6.0 rv201660.dll

JMF

Additional components (the JMF Base Classes) must be licensed from Javasoft for this feature of the RealSystem G2 SDK to function.

JMF Components
JMF Component Installed in
For JDK/JRE:
Java class archive rjmf.jar Java class path
JMF Core rjco3260.dll \windows\system
JNI passthrough DLL rjjn3260.dll \windows\system
For Netscape:
Java class archive rjmf.jar \netscape\program\java\classes
JMF Core rjco3260.dll \netscape\program\java\bin
JNI passthrough DLL rjjn3260.dll \netscape\program\java\bin

plugins

On UNIX and Windows NT, the SDK's bin/plugins directory holds the RealServer plug-ins listed below.

RealServer Plug-ins
Windows 32-bit UNIX Plug-in Type
allo3260.dll allow.so.6.0 Allowance plug-in
audp3260.dll audplin.so.6.0 Basic audio file format plug-in for .aiff, .au, and .wav formats
enco3260.dll encoplin.so.0.1 RealSystem default broadcast plug-in (short name: pn-encoder)
hmon3260.dll hmonfsys.so.6.0 HTML monitor plug-in
http3260.dll httpfsys.so.6.0 HTTP file system plug-in for Web servers (short name: pn-http)
liv33260.dll liv3pln.so.6.0 .ra and .rm live broadcast plug-in (short name: pn-live3)
ntlo3260.dll (none) NT logging plug-in
rmff3260.dll rmffplin.so.6.0 RealSystem (.rm and .ra) file format plug-in
rtff3260.dll rtffplin.so.6.0 RealText (.rt) file format plug-in
sdpp3260.dll sdpplin.so.6.0 Media header SDP stream description plug-in
smpl3260.dll smplfsys.so.6.0 Simple file system plug-in (short name: pn-local)
vidp3260.dll vidplin.so.6.0 Basic video file format plug-in for .avi, .mov, and .asf formats

server executable

Downloads of RealServer are available at http://www.real.com/products/.

Utilities

You can use the following utilities with RealSystem. They are installed with RealServer.

RealSystem Utilities
Windows 32-bit UNIX Description
encn3260.dll encnet.so.6.0 Library for remote broadcasting.
rtli3260.dll rtlive.so.6.0 Library for RealText broadcasting.
mkpnpass.exe mkpnpass Program that adds usernames and passwords to the system password file for authentication.

include Directory

The include directory of the SDK download contains the header files that describe the public interfaces of RealSystem. See "Appendix A: Interface List" for descriptions of the interfaces defined in these header files.

Header Files
File Defines
pnbastsd.h Definitions used by pntypes.h that correctly define the basic size types.
pncom.h Definitions for items required for COM interfaces in RealSystem.
pnresult.h Definitions for RealSystem status codes.
pntypes.h Definitions for several types used in RealSystem.
pnwintyp.h Definitions for several types related to Windows, Mac, and X-Windows GUI layers, as used in RealSystem.
pxresult.h Additional return values.
rmaaconf.h Autoconfiguration interfaces.
rmaallow.h Allowance plug-in interfaces.
rmaasm.h Adaptive Stream Management (ASM) and BackChannel interfaces.
rmaausvc.h Audio Services interfaces.
rmaauth.h Authentication and password handling interfaces.
rmaauthn.h Validation interfaces.
rmacfg.h Server configuration interfaces.
rmaclsnk.h Client advise sink interfaces.
rmacmenu.h Context menu interfaces.
rmacomm.h Common utility interfaces.
rmacore.h Client core interfaces.
rmadb.h Database interfaces.
rmadtcvt.h Data conversion and reversion interfaces.
rmaencod.h Remote broadcasting interfaces.
rmaengin.h Callback, networking, and scheduling interfaces.
rmaerror.h Error reporting interfaces.
rmaevent.h Definitions for classes of events.
rmafiles.h File system plug-in interfaces.
rmaformt.h File format and broadcast plug-in interfaces.
rmagroup.h header file for declaration of various group interfaces: IRMAGroup, IRMAGroupManager, IRMAGroupSink.
rmahyper.h Hypernavigation interfaces.
rmaiids.h All IIDs used in RealSystem interfaces.
rmalvpix.h Header file for RealPix live broadcast interfaces (IRMALiveRealPix and IRMALiveRealPixResponse) and structs for library initialization, image initialization, and effects parameters
rmalvtxt.h Header file for RealText live broadcast sample application.
rmamon.h System monitoring interfaces.
rmapckts.h Packet, buffer, and stream interfaces.
rmapends.h Get pending status interface.
rmaphook.h Client "hook" interface for recording presentations.
rmaplgns.h Additional plug-in interfaces.
rmaplugn.h Plug-in inspector interface.
rmappv.h Pay-per-view interfaces.
rmaprefs.h Persistent preferences interfaces.
rmapsink.h Player creation interfaces.
rmarendr.h Rendering plug-in interfaces.
rmasite2.h Windowing interfaces complementing those in rmawin.h.
rmaslta.h Simulated live transfer agent (SLTA) interfaces.
rmasrc.h Packet source interfaces.
rmaupgrd.h Automatic upgrade interfaces.
rmavalue.h Option and key value interfaces.
rmavsurf.h Platform-specific windowing functions.
rmawin.h Windowing interfaces.
rmaxmltg.h XMLTag object interfaces.

samples Directory

The samples directory contains sample C++ files, as well as header files and make files or project files, for making RealSystem components. Use the sample files to learn about the RealSystem architecture and build your own plug-ins. The samples directory contains three subdirectories for introductory, intermediate, and advanced samples. Many of the samples include a directory of test data you can use for testing the compiled plug-in.

intro

The samples/intro directory contains the following introductory sample file subdirectories. The sample file code in these subdirectories introduces basic RealSystem concepts and functionality.

Introductory Samples
Directory Sample
authsys1 Authenticating file system plug-in.
converter Data conversion plug-in for the server. This information is restored using the data reversion sample.
exallow Basic allowance plug-in.
ff1rendr Basic rendering plug-in.
filefmt1 Basic file format plug-in.
filesys1 Basic file system plug-in.
hellowld A "hello world" plug-in that introduces basic features of RealSystem.
reverter Data reversion plug-in for the player. This sample restores the information converted by the data conversion sample.

intermed

The samples/intermed directory contains the following intermediate sample file subdirectories. The sample code in these subdirectories provides more advanced functionality than the introductory samples.

Intermediate Samples
Directory Sample
ex2strms Example file format plug-in that reads a container file of type .ef2 and plays two streams simultaneously.
exauddev Example audio device application.
exaudio Example midstream playback audio rendering plug-in.
exauth Example authentication plug-in.
exencaud Example RTP-audio remote broadcast encoder application.
exencode Example live encoder based on the remote encoder API.
exffplin Example file format plug-in that works with exrender.
exlivess Example RealPix slideshow application.
exlivpix Sample RealPix broadcast application.
exlivpln Example broadcast plug-in.
exlogpln Example logging plug-in.
exlvtext Sample RealText broadcast application.
exmonpln Example monitor plug-in.
exppvpln Example pay-per-view plug-in.
exrender Example rendering plug-in that works with exffplin.
exvslta Example simulated live broadcast application.
exvsrndr Example rendering plug-in using video surface interfaces.
exwnrndr Example rendering plug-in for single-window display.
mtestclnt Example Motif-based test client running on Unix only.
pcmrendr Example implementation of a basic PCM audio rendering plug-in.
pmffplin Example post-processed audio file format plug-in.
pmrendr Example post-processed audio rendering plug-in.
testplay Simplified RealSystem client application to test plug-ins.
winhdrs Example of how to use RFC822 headers with the HTTP protocol.

advanced

The samples/advanced directory contains the following advanced sample file subdirectories. The sample file code in these subdirectories illustrates more advanced RealSystem functionality than the intermediate samples.

Advanced Samples
Directory Sample
exaudio Audio Services rendering plug-in that shows how to create a new player to start a new timeline and use it for instantaneous sound.
expksink Monitor plug-in that receives notifications about and examines the headers and packets sent to the server from a live source.
exrender Rendering plug-in that shows how to create a new player to start a new timeline and play continuous background music, or open a different, unrelated URL, such as a stream for an advertisement.
exwlsite Top-level client that shows how to capture or intercept video frames.
pcmrendr Audio Services rendering plug-in sample for PCM data that shows how to get notifications when the audio stream is running dry.


Copyright © 2000 RealNetworks
For technical support, please contact supportsdk@real.com.
This file last updated on 05/17/00 at 12:50:16.
previous next