HelixApp 专业流媒体影音防盗链

Chapter 6: 嵌入播放器方法

一个程序（application）或小程序（applet）或者控件可以使用本章介绍的方法来与RealOne播放器嵌入环境交换信息。这些方法是以字母顺序列出的，而且每个方法都包含了你如何利用Netscape plug-in技术或者是ActiveX控件技术来调用，一个指示调用语法的例子，以及向后兼容的版本提示。

更多信息： 了解更多关于方法的分类信息，比如那些是控制播放的方法参考Chapter 5。

注意： 许多下面列出的方法会返回一个boolean类型值给plug-ins类型调用。不过 Plug-in开发者可以安全的忽略大多数这些返回值，因为这些值都是一直返回true。返回false的情况只发生在有十分严重的错误时。如果你需要在你的工作脚本中获取问题结果，你就可能需要确认这些返回值。

CanPause

判断当前是否正在播放一段可暂停的影片。

CanPause(void)

在播放器正在播放影片时返回true，如果当前处于暂停或者停止状态返回false。

CanPlay

判断播放器是否当前处于暂停、停止或者正在播出的状态。

CanPlay(void)

暂停和停止状态返回true而播放器播出状态时显示false。

CanStop

判断播放器是否暂停或者播放状态。这个方法从RealPlayer5.0开始提供。

CanStop(void)

播放或者暂停状态时返回true，已经是停止状态时返回false。

DoGotoURL

使得控件尝试在浏览器的指定定位中打开要求的URL。内容必须是支持URL浏览的。这个方法在AxtiveX控件版本使用时兼容与RealPlayer5.0或者更高，但不兼容与5.0版的Netscape plug-in技术。

DoGotoURL(string url, string target)

url

要访问的URL

target

用于浏览的框架定位。

target参数是使用功能必须的，但是值可以被忽略。

返回void.

DoNextEntry

在播放包含多个影片的RAM (.ram或者.rpm)或SMIL文件中跳到下一个影片。在SMIL文件中一个<par>定义的组算作一个影片。

DoNextEntry(void)

为plug-in返回一个boolean值。

DoPause

暂停当前播放影片。相当于按下暂停按钮。

DoPause(void)

为plug-in返回 boolean 值。

DoPlay

播放当前影片，相当于按下播放按钮。

DoPlay(void)

为plug-in返回 boolean 值。

DoPrevEntry

Skips to the previous clip in a RAM (.ram or .rpm) or SMIL file that contains multiple clips. In a SMIL file, a <par> group is treated as a single clip.

DoPrevEntry(void)

为plug-in返回 boolean 值。

DoStop

停止播放。相当于按下停止按钮。这个方法从RealPlayer5.0开始提供。

DoStop(void)

为plug-in返回 boolean 值。

GetAuthor

获得当前影片的作者字符串。

GetAuthor(void)

返回包含当前影片作者的string类型返回值。

GetAutoGoToURL

获取AutoGoToURL是否被设置为允许。

GetAutoGoToURL(void)

警告！ 在不同的语言中使用这个方法可能稍微有一点变化。在C++中是 GetAutoGotoURL而在Java中是GetAutoGoToURL。这两个方式都可以用于Javascript或者VBScript。

如果被设置就返回true。如果被禁止就返回false。

GetAutoStart

判断播放是否会自动开始。

GetAutoStart(void)

会就返回true否则返回false。

GetBackgroundColor

获得当前图像窗口中设置的背景颜色。

GetBackgroundColor(void)

返回包含#RRGGBB格式RGB十六进制颜色值的string。这些值的颜色名字定义在SetBackgroundColor。

GetBandwidthAverage

获得作品播放的平均带宽值。

GetBandwidthAverage(void)

返回一个指示从开始播放到当前时间平均带宽的int32类型整数，单位是bit/s。

GetBandwidthCurrent

获得当前作品占用带宽。

GetBandwidthCurrent(void)

返回以bit/s为单位的表示当前带宽的int32类型整数值。

GetBufferingTimeElapsed

获取当前已经缓冲的时间。

GetBufferingTimeElapsed(void)

返回一个以微秒为单位的int32整数已经缓冲时间。

GetBufferingTimeRemaining

获取估计还需缓冲时间。

GetBufferingTimeRemaining(void)

返回以微秒为单位的int32整数估计还需缓冲时间值。

GetCanSeek

判断是否可以通过接口让用户随即定位影片。

GetCanSeek(void)

如果影片允许随即定位就返回true否则返回false。直播或者模拟直播时就返回false。

GetCenter

判断视觉类型是否是定义为显示在图像窗口的中心。

GetCenter(void)

返回true表示在图像窗口中心，否则返回 false (默认情况)来表示不是在中心。

GetClipHeight

获取影片高度。

GetClipHeight(void)

返回int32类型整数的影片高，单位是象素，如果返回值是0表示影片是不可见的。

GetClipWidth

获取作品宽度。

GetClipWidth(void)

返回int32类型整数的影片宽，单位是象素，如果返回值是0表示影片是不可见的。

GetConnectionBandwidth

获取用户设置在RealOne播放器偏好选项中的最大带宽。

GetConnectionBandwidth(void)

返回一个int32类型整数，它以bit/s为单位指示了在RealOne播放器偏好设置的连接类型中定义的最大带宽设置。

GetConsole

获取一个控制组的名字用于联系多个控制实例。

GetConsole(void)

返回一个string类型的值，用于表示当前嵌入控件联合的名字。

GetConsoleEvents

获取是否运行控件行为。

GetConsoleEvents(void)

返回值为true表示允许行为，否则返回false表示禁止行为。

更多信息： 参考"Event Handling"来了解关于控制行为的说明。

GetControls

获取一个可视的RealOne播放器控件控制名字。

GetControls(void)

返回一个当前name或者ID嵌入控件的string类型的控制名字。

更多信息： 有效的控制名字参考 "嵌入控制"。

GetCopyright

获取当前影片的版权信息。

GetCopyright(void)

返回 string 类型的当前作品版权信息。

GetCurrentEntry

获取当前正播放的影片序号。

GetCurrentEntry(void)

返回int32类型整数，它表示当前播放影片是正在播放列表中的序号。第一个影片序号为0。

警告！ 这个方法在不同的程序语言中的使用有些差别。在C++中，函数返回一个int16类型整数，而在Java中返回int32类型值。两种整数值都可以用于Javascript或VBScript。

GetDRMInfo

提供必要的客户端信息用于认证服务来获取一个唯一的认证用户。这个方法用于联系RealNetworks数字版权管理系统（RealNetworks digital rights management systems）。

GetDRMInfo (string identifier)

identifier

一个4个字母的字符串验证标示，它指出在那里进行验证。例如：RNBA表示RealNetworks媒体社区(RealNetworks Media Commerce Suite)。

返回字符串是如下格式（换行仅仅为了方便阅读理解）：

ClientPubKey=<客户端公开主键部分> &Challenge=<改变部分> &ExtraInfo=<扩展信息部分>

注意： 这个方法仅仅在高于 6.0.8.1024的建造版本中提供。

GetDoubleSize

获取是否当前图像显示为双倍模式。

GetDoubleSize(void)

返回true表示是双倍显示，否则返回false表示不是双倍尺寸模式。

注意： 这个方法仅仅在程序中的ActiveX控件或者plug-in插件中有效，而不能用于嵌入的WEB页面中。

GetEntryAbstract

获取指定列表项影片的择要。

GetEntryAbstract(int32 entry_index)

entry_index

需要返回择要的影片列表序号。第一个影片列表序号为0。

警告！ 它在不同的程序语言中使用时有细微区别。在C++中它需要是 int16类型参数，而在Java中需要int32变量参数。任何整数值类型都可以用于Javascript或者VBScript。

返回string类型所请求序号影片的择要。

GetEntryAuthor

获取指定列表序号影片的作者。

GetEntryAuthor(int32 entry_index)

entry_index

需要返回作者信息的影片列表序号。第一个影片列表序号为0。

返回string类型的请求序号影片的作者信息。

GetEntryCopyright

获取指定列表序号影片的版权信息。

GetEntryCopyright(int32 entry_index)

entry_index

需要返回版权信息的影片列表序号。第一个影片列表序号为0。

返回string类型的请求序号影片的版权信息。

GetEntryTitle

获取指定列表序号影片的标题。

GetEntryTitle(int32 entry_index)

entry_index

需要返回标题的影片列表序号。第一个影片列表序号为0。

返回string类型的请求序号影片的标题。

GetFullScreen

获取图像是否全屏显示模式。

GetFullScreen(void)

返回true表示是全屏模式，否则返回 false表示不是全屏模式。

GetImageStatus

获取是否允许状态字符串写入图像窗口。

GetImageStatus(void)

返回true (默认)表示允许状态字符串写入图像窗口，否则返回 false表示不向图像窗口发送状态字符串。

GetLastErrorMoreInfoURL

为最后的错误提供的“更多信息”URL。

GetLastErrorMoreInfoURL(void)

返回 string类型值，它指示了“更多信息”URL。它也可能返回一个空（例如不存在对应的“更多信息”URL）。

GetLastErrorRMACode

获得最后错误的RMA错误代码。 RMA错误代码是描述在SDK头文件pnresult.h中的，它们在如下位置：

http://www.realnetworks.com/resources/server/

在常规操作时，所有组件执行后都会从Helix Server获得如下的基本代码返回值：

PNR_FAIL—操作失败。

PNR_OK—操作成功。

PNR_UNEXPECTED—调用发生意外或者方法未提供。

GetLastErrorRMACode(void)

返回最近错误的int32类型错误代码值。

GetLastErrorSeverity

获取最后错误的错误层次。

GetLastErrorSeverity(void)

返回int32类型的错误层次。

警告！ 它在不同的程序语言下调用方法有细微差别。在C++中返回值是 int16类型的值，而在Java中返回 int32类型值。在Javascript或VBScript中这两种类型没有区别。

错误层次约定见下表：

错误层次
层次	约定情况	使用情况
0	Panic（核心的）	Error可能导致系统崩溃。 RealOne播放器会马上进行调整行为。这可能包括关闭影片。
1	Severe（严重的）	Error要求尽快的进行调整和处理。 RealOne播放器在需要的情况下可能会关闭影片。
2	Critical（重要的）	Error要求用户进行必要的调整。 RealOne播放器在需要的情况下可能会关闭影片。
3	General（常规的）	Error 是常规的系统操作引发的，但不会导致特别严重的问题。
4	Warning（警告的）	Warning表示要求调整，但不会引发特别严重问题的情况。
5	Notice（提醒的）	Notice是不会导致系统问题，但需要注意的情况。
6	Informational（信息化）	Informational消息而已。
7	Debug（调试）	仅仅在调试程序是的信息。

GetLastErrorUserCode

指明最后一次的用户错误代码。

GetLastErrorUserCode(void)

返回一个指示用户错误代码的int32类型数字。这个方法常规情况下是一直返回0的，除非使用了对错误行为有自定义错误代码的定制插件。

GetLastErrorUserString

获得最后一次错误对话框中的文字信息。

GetLastErrorUserString(void)

返回最后一次错误对话框中的文字（字符串）。这个方法常规情况下会返回空字符串，除非使用了对错误行为有自定义错误文字的定制插件。

GetLastMessage

获得由 OnShowStatus 回调方法返回的最后一次状态消息内容。

注意： 这个方法仅仅是ActiveX控件内置的。如果你是为Netscape plug-in编程，请使用GetLastStatus方法。

GetLastMessage(void)

返回包含最后一次状态消息的字符串。

GetLastStatus

获得由 OnShowStatus回调方法返回的最后一次状态消息内容。

注意：这个方法仅仅对Netscape plug-in有效，如果你为ActiveX控件编程，请用 GetLastMessage方法。

GetLastStatus(void)

返回包含最后一次状态消息的字符串。

GetLength

获取影片总长。

GetLength(void)

以微秒(milliseconds)为单位，返回指示影片总长的int32类型整数值，该值>=0 。

GetLiveState

获得当前影片直播状态。

GetLiveState(void)

是直播返回true，否则返回false。

GetLoop

获取影片是否被设置为循环播放。

GetLoop(void)

如果被设置为循环播放直到中止则返回true，否则返回false(影片不循环播放是默认情况)。

GetMaintainAspect

获取是否允许保持视觉比例。

GetMaintainAspect(void)

如果允许保持视觉比例则返回true，否则返回false(默认情况)这时影片回被拉伸以适应窗口。

GetMute

获取是否被禁音。

GetMute(void)

被禁音就返回true，否则返回false。

GetNumEntries

获取播放列表的片段总数。

GetNumEntries(void)

警告！ 实是上它的使用在不同的程序语言下有些细微差别。在 C++下函数返回的是int16类型数字，而在Java是int32类型返回值，利用Javascript或 VBScript开发是不区分数字值类型的。

返回指示播放列表总包含片段总数的int32值，如果只有一个片段就返回"1"。

GetNumLoop

获取影片循环播放的次数。

GetNumLoop(void)

返回由SetNumLoop设置的影片循环播放次数int32类型值。

GetNumSources

获取作品源编号。

GetNumSources(void)

警告！实是上它的使用在不同的程序语言下有些细微差别。在 C++下函数返回的是int16类型数字，而在Java是int32类型返回值，利用Javascript或 VBScript开发是不区分数字值类型的。

返回指示作品源编号的int32类型值。(译者注：这个值到底有何具体意义我其实也搞不明白，查找了多方解释也没有弄清楚，不过它和后面的GetSourceTransport有点联系的，它的返回值用作GetSourceTransport的传入参数，可以获得播放形式返回值。)

GetOriginalSize

获得影片播放是否是默认尺寸。

GetOriginalSize(void)

是则返回true，否则返回false。

GetPacketsEarly

获取已经从Helix Server获得的数据包数量。

注意： 这个方法只用于ActiveX。

GetPacketsEarly(void)

返回表示已经获取数据包数量的int32类型数。

GetPacketsLate

获取对当前播放还将从 Helix Server取得的用于播放的数据包总数。

GetPacketsLate(void)

返回表示还需获取的数据包数量的int32类型数。

GetPacketsMissing

获取已经被忽略（丢失）的从 Helix Server 传输用于播放的数据包总数统计。

GetPacketsMissing(void)

返回表示已忽略的数据包数量的int32类型数。

GetPacketsOutOfOrder

获取指示从 Helix Server 发出的数据包总数。

GetPacketsOutOfOrder(void)

返回表示从 Helix Server 发出的数据包总数量的int32类型数。

GetPacketsReceived

获取当前已经接收到的从Helix Server传出数据包数量。

GetPacketsReceived(void)

返回表示已经接收到从 Helix Server 发出的数据包总数量的int32类型数。(译者注：注意和GetPacketsEarly区别，这个可以应用的范围更广。)

GetPacketsTotal

获取应该用于当前影片播放的总数据包量。这个方法报告的总数据包量实际上包括已经获取的数据包和被丢失的数据包，如果没有掉包，则返回值应该和 GetPacketsReceived的返回值相同。

GetPacketsTotal(void)

返回表示总包量的int32类型数。

GetPlayState

获取播放状态。

GetPlayState(void)

返回表示播放状态的int32类型值，它们的指示意思见下：

0 —停止的

1 —链接中

2 — 缓冲中

3 —播放中

4 — 暂停的

5 — 定位中

GetPosition

取得当前影片播放位置。

GetPosition(void)

以微秒(milliseconds)为单位，返回指示播放位置的int32类型数字，该值>=0而且<=影片总长。

GetPreFetch

获取是否设置 PREFETCH (预取)

GetPreFetch(void)

如果允许预取则返回true否则返回false

GetShowAbout

获取关于对话框(About box)是否被打开。

GetShowAbout(void)

如果打开就返回true，否则返回false。

GetShowPreferences

获取是否打开了参数对话框( Preferences dialog box)。

GetShowPreferences(void)

打开了返回true，否则返回false。

GetShowStatistics

获取是否打开了统计对(Statistics dialog box )话框。

GetShowStatistics(void)

打开了则返回true，否则返回false，默认是没有打开的。

GetShuffle

获取是否允许缓冲播放( shuffle play)。

GetShuffle(void)

如果允许缓冲播放则返回true，否则返回false。

GetSource

获取当前播放的URL地址。

GetSource(void)

返回表示当前播放URL的字符串。

GetSourceTransport

获取指示当前播放的传输协议类型文本信息。

GetSourceTransport(int32 source_number)

source_number

一个用户判断协议的指定的源编号，其范围可以从1到n，这里的n是由 GetNumSources获取的源编号值。

警告！ 这个参数值的类型在不同的编程语言中略有区别，在C++中是int16类型，在Java中是int32类型，在 Javascript或者VBScript中不区分。

返回表示源传输协议的字符串，有local或者 udp以及 tcp三种可能值。

GetStereoState

获取影片是否是立体声。

GetStereoState(void)

如果是则返回true，是单声道返回false，方法在Netscape plug-ins中返回一个布尔值。

GetTitle

获取影片标题文本。

GetTitle(void)

返回影片的标题字符串。

GetVersionInfo

返回嵌入播放器的主版本号和辅版本号(注意这里不是父播放器的，而是嵌入播放器的——译者注：即根据嵌入的classID相关的编号，例如你安装的是realone player，但嵌入作品可能调用的是realplayer8)。

GetVersionInfo(void)

返回类似6.0.0.128这样表示版本信息的字符串。

GetVolume

获取当前音量。

GetVolume(void)

警告！ 它在不同的编程语言中有些细微差别，在C++中返回int16类型值，在Java中返回int32类型，在 Javascript或VBScript中不区分。

返回表示音量的int32类型数，范围在0到100。

GetWantErrors

获取是否允许显示错误信息对话框。

GetWantErrors(void)

如果已经捕获到错误，而错误信息对话框当前还没有显示则返回true，如果错误信息已经显示否则返回false。

GetWantKeyboardEvents

获取是否允许发送键盘行为(即 OnKeyDown, OnKeyPress, 和 OnKeyUp 回调是否发送)。

GetWantKeyboardEvents(void)

允许发送就返回true，否则返回false，通常默认是不允许的，即返回false。

GetWantMouseEvents

获取是否允许发送鼠标行为(即 OnLButtonDown, OnLButtonUp, OnMouseMove, OnRButtonDown, 和 OnRButtonUp 回调是否发送)。

GetWantMouseEvents(void)

允许则返回true，否则返回false，通常默认是不允许的，即返回false。

HasNextEntry

测试是否还有可用的下个片段。这个测试下个影片的功能只有在播放RAM (.ram 或 .rpm 扩展名)或者SMIL文件这种可包含多个影片的文件时才有效。在SMIL文件中每个<par>表示一个单独的影片。

HasNextEntry(void)

如果有则返回true，否则返回false。

HasPrevEntry

测试是否还有可用的前个片段。这个测试下个影片的功能只有在播放RAM (.ram 或 .rpm 扩展名)或者SMIL文件这种可包含多个影片的文件时才有效。在SMIL文件中每个<par>表示一个单独的影片。

HasPrevEntry(void)

如果有则返回true，否则返回false。

SetAuthor

设置作者信息以替换已有的影片作者信息，以后 GetAuthor会返回新的值。

SetAuthor(string new_author)

new_author

要设置的信息内容，这里的作者信息会覆盖一个多片段影片中所有子片段影片的作者信息作为 GetAuthor返回值。information in a multiclip presentation.

为plug-in返回 boolean 值。

SetAutoGoToURL

指定是否允许自动打开URL，这个方法在RealPlayer5以上版本可用。

SetAutoGoToURL(boolean enable_start)

警告！ 这个方法在不同语言中有细微区别，在 C++中调用SetAutoGotoURL而在 Java中是SetAutoGoToURL，此外在Javascript 或 VBScript里不区分。

enable_start

如果设置为true，则 RealPlay plug-in 自动链接到URL，如果设置为false，则onGoToURL被Java applet或VBScript相应定义替代。

更多信息：从 RealPlayer G2开始，也可在<EMBED>或 <OBJECT>标签中用 AUTOGOTOURL参数进行设置。

为plug-in返回 boolean 值。

SetAutoStart

设置是否允许自动开始播放有效影片。这个方法在 Netscape plug-ins 和 ActiveX 控件中是向后兼容于 RealPlayer version 5.0或更高版本的。

SetAutoStart(boolean auto_start)

auto_start

如果设置为true，则允许自动播放一次有效的影片，否则需要明确控制才能开始播放。

为plug-in返回 boolean 值。

更多信息： 如果利用 RealPlayer version 5.0或更高开发 Netscape plug-in，你可用在标签定义中采用 AUTOSTART 参数进行设置。

SetBackgroundColor

指定image窗口控件的背景颜色。

SetBackgroundColor(string color)

color

RGB16进制颜色字符串格式为 #RRGGBB, 或者安下面的颜色名。


`white (#FFFFFF)`	`silver (#C0C0C0)`	`gray (#808080)`	`black (#000000)`
`yellow (#FFFF00)`	`fuchsia (#FF00FF)`	`red (#FF0000)`	`maroon (#800000)`
`lime (#00FF00)`	`olive (#808000)`	`green (#008000)`	`purple (#800080)`
`aqua (#00FFFF)`	`teal (#008080)`	`blue (#0000FF)`	`navy (#000080)`

为plug-in返回 boolean 值。

更多信息： 你可用 BACKGROUNDCOLOR参数在标签定义中进行设置。

SetCanSeek

设置是否允许通过用户接口随机定位。

SetCanSeek(boolean can_seek)

can_seek

如果设置为true(默认)，则允许用户在影片中随机定位，否则不允许。这个功能不能用于直播和模拟直播的情况中。

为plug-in返回 boolean 值。

SetCenter

设置是否播出按原始分辨力居中显示。

SetCenter(boolean value)

value

为true则设置居中显示，设置为false(默认)则不居中，而是以高和宽扩展到填满图像窗口。

注意： 这个 SetCenter 和 SetMaintainAspect 方法是不能同时被设置为 true的，他们是互斥的，如果在 SetMaintainAspect 方法中设置为 true,则 SetCenter 方法中必须设置为 false。

为plug-in返回 boolean 值。

更多信息： 可在 CENTER 标签参数描述中了解到相关信息。

SetConsole

设置一个控件与其他的控件联动起来。对每个控件只需要调用这个方法一次来设置成联动状态。所有有相同 console（控制）名字的控件是联动的。比如，你在一个页面中有多个播放和停止按钮，他们有相同的控制名字就可以用来控制同一段影片播放。如果控制名字是 _master 则表示和页面中所有的控件都联动。

SetConsole(string console)

console

要设置的控制名。要同页面中嵌入的某个控件名字或者ID关联起来，例如：

document.playcontrol.SetConsole("console1") — Javascript

Document.playcontrol.SetConsole("console1") — VBScript

为plug-in返回 boolean 值。

更多信息： 你可在 CONSOLE 标签参数中找到相关信息。

SetConsoleEvents

设置是否允许控制行为。这个方法控制是否提供控件的回调功能。

它不支持 ActiveX。.

SetConsoleEvents(boolean value)

value

如果设置为true，则所有行为都会发送给程序，包括了控制类行为，如果设置为 false，则仅仅非控制类行为会被发送（译者注：设置为true，则 GetConsoleEvents返回true，反之 GetConsoleEvents返回false）。

为plug-in返回 boolean 值。

更多信息： 参考控件行为中 "行为处理" 的解释。

SetControls

设置控件的可视化类型。

SetControls(string controls)

controls

要设置的控件类型名字。类型名字需要和页面中嵌入的某个控件的名字或者ID关联起来，例如：

document.playcontrol.SetControls("PlayOnlyButton") — Javascript

Document.playcontrol.SetControls("PlayOnlyButton") — VBScript

为plug-in返回 boolean 值。

更多信息： 参考页面标签定义参数中的 CONTROLS。

SetCopyright

设置当前影片作品的版权信息以覆盖作品原有版权信息，此后的 GetCopyright 调用会返回新值。

SetCopyright(string copyright)

copyright

要设置成的值。可以覆盖一个多片段作品中所有子影片的版权信息。

为plug-in返回 boolean 值。

SetDoubleSize

设置图像窗口为双倍标准尺寸。

SetDoubleSize(void)

为plug-in返回 boolean 值。

注意： 这个方法只能用于一般嵌入 ActiveX controls 和扩展( plug-ins)的程序中，不能在Web嵌入中应用。

SetFullScreen

设置全屏显示模式。

SetFullScreen(void)

为plug-in返回 boolean 值。

注意： 设置后可用利用 Esc 键返回原始的尺寸。

SetImageStatus

允许或者禁止在图像窗口的底部显示状态信息文本。

SetImageStatus(boolean enabled)

enabled

设置为true (默认)，则状态信息文本会写入图像窗口，设置为false则不写。

为plug-in返回 boolean 值。

SetLoop

指定是否允许作品循环播放。

SetLoop(boolean set)

set

如果设置为true，则播放会循环持续到手动中止。如果设置为false则不会循环(默认)。

为plug-in返回 boolean 值。

更多信息： 标签定义中，你也可用 LOOP 参数进行指定。

SetMaintainAspect

设置影片播放是否按比例自动适应窗口尺寸。

SetMaintainAspect(boolean set)

set

如果设置为true，则按比例自动适应显示窗口，如果设置为false (默认)，则显示会填满窗口而可能出现比例失调。

注意： SetMaintainAspect 和 SetCenter方法不能同时设置为true。因此，如果你在 SetCenter中设置了 true，则 SetMaintainAspect 方法要设置 false。

为plug-in返回 boolean 值。

更多信息： 你也可在标签MAINTAINASPECT 定义中进行设置。

SetMute

设置禁音状态。

SetMute(boolean mute)

mute

如果设置为true则禁音，否则不禁音。

为plug-in返回 boolean 值。

SetNumLoop

指定影片循环播放次数。

SetNumLoop(int32 number_of_loops)

number_of_loops

要指定的播放次数。

为plug-in返回 boolean 值。

更多信息： 你也可以 NUMLOOP 标签参数进行指定。

SetOriginalSize

设置窗口为常规尺寸（影片的）。

SetOriginalSize(void)

为plug-in返回 boolean 值。

SetPosition

定位影片到指定的位置。

SetPosition(int32 position)

position

要指定的位置，以微秒为单位。有效值为 >=0 而且 <=整个影片长度。 如果试图传入一个 >总长度的值，则 SetPosition 会定位到末尾。

注意： 影片的持续播放要等定位到指定位置后才能重新开始。

为plug-in返回 boolean 值。

SetPreFetch

允许或者禁止 PREFETCH 播放模式。

SetPreFetch(boolean set)

set

如果设置为true， PREFETCH 播放模式被允许。否则设置为false (默认)，表示 PREFETCH 播放模式被禁止。

为plug-in返回 boolean 值。

更多信息： 你可以在标签定义中用 PREFETCH 标签参数进行设定。

SetShowAbout

显示RealOne Player 的关于对话框。

SetShowAbout(boolean set)

set

设置为true，则RealOne Player 的关于对话框会被显示。当这个对话框已经显示时，设置为false实际上什么也不发生，你必须手动按下对话框中的按钮来关闭。

为plug-in返回 boolean 值。

SetShowPreferences

打开 RealOne播放器环境并显示RealOne Player 参数选择对话框。

SetShowPreferences(boolean set)

set

设置为true，则RealOne Player 的参数选择对话框会被显示。当这个对话框已经显示时，设置为false实际上什么也不发生，你必须手动按下对话框中的按钮来关闭。

为plug-in返回 boolean 值。

SetShowStatistics

设置RealOne Player 状态对话框是否可见。

SetShowStatistics(boolean set)

set

设置为true，则显示RealOne Player 状态对话框，如果已经可见，而又设置为 false 则关闭。

为plug-in返回 boolean 值。

SetShuffle

随机播放所有影片，但排除已经播放过的影片。只用于播放包含多个影片的 RAM文件 (.ram 或 .rpm 为扩展名 ) 或者 SMIL文件中只包含一个影片序列的情况。

SetShuffle(boolean set)

set

如果设置为true，则影片会被随机播放，如果设置为 false，则按影片在 RAM 文件或者 SMIL文件中的原有顺序进行播放。

为plug-in返回 boolean 值。

更多信息： 你也可以在标签定义中利用 SHUFFLE 参数进行设置。

SetSource

指定要播放影片的URL。这个方法在 Netscape plug-ins中向后兼容与RealPlayer 版本 5.0或更高，但不兼容与版本 5.0 ActiveX 控件。

SetSource(string source)

source

要播放影片的 URL。URL可以由 rtsp://， http://， pnm://，或者 file://开始。

为plug-in返回 boolean 值。

更多信息： 也可在标签定义中利用 SRC 标签参数进行设置。

SetTitle

设置当前影片标题，它会覆盖所有存在的子标题信息，会作为 GetTitle 新的返回值。

SetTitle(string title)

title

要设置的标题。这个值会覆盖多片段影片作品中的所有子标题信息。

为plug-in返回 boolean 值。

SetVolume

设置音量。

SetVolume(int16 volume)

volume

要设置的音量值，有效值是 0到 100。

警告！ 它在不同的编程语言中有些细微差别，在C++中用int16类型值，在Java中用int32类型，在 Javascript或VBScript中不区分。

返回值为空。

SetWantErrors

设置错误接收。

SetWantErrors(boolean set)

set

如果设置为true，则错误被捕获，但不显示错误对话框，如果设置为 false，错误对话框会显示在播放器中。

为plug-in返回 boolean 值。

SetWantKeyboardEvents

是否发送键盘行为 (实际上就是设置是否 OnKeyDown，OnKeyPress和 OnKeyUp 回调被发送)。

SetWantKeyboardEvents(boolean set)

set

如果设置为true，键盘行为会被发送。如果设置为false (默认)，键盘行为不会发送。

为plug-in返回 boolean 值。

SetWantMouseEvents

是否发送鼠标行为 (实际上就是设置是否 OnLButtonDown， OnLButtonUp， OnMouseMove， OnRButtonDown和OnRButtonUp回调被发送)。

SetWantMouseEvents(boolean set)

set

如果设置为true，鼠标行为会被发送。如果设置为false (默认)，鼠标行为不会发送。

为plug-in返回 boolean 值。