转一下大牛的嵌入web页播放视频方法（转）

Posted 2020-08-21 大连小肥云

来自：http://www.cnblogs.com/bandry/archive/2006/10/11/526229.html

 

 

 

在Web页中嵌入Media Player的方法比较简单，只要用html中的＜Object＞＜/Object＞可以了，如下所示。
＜OBJECT ID="WMPlay" WIDTH=320 HEIGHT=240
CLASSID="CLSID:22D6f312-B0F6-11D0-94AB-0080C74C7E95"
CODEBASE="http://activex.microsoft.com/activex/controls/mplayer/en/
nsmp2inf.cab#Version=6,4,5,715"
STANDBY="Loading Microsoft? Windows Media? Player components..."
TYPE="application/x-oleobject"＞
＜/OBJECT＞
　　其中ID是对象的名称，当用户在JavaScript要对Media Player进行控制时可以用该对象的名称WMPlay进行访问。CODEBASE指明当用户的浏览器中没有安装Player控件时可以从该URL指定的位置去获取。

　　当然在建立Player对象时也可以用＜PARAM ＞来为其指定参数。如下所示：

＜PARAM NAME="FileName" VALUE="C:ASFRootWelcome.asf"＞
＜PARAM NAME="ShowControls" VALUE="False"＞
＜PARAM NAME="AutoRewind" VALUE="True"＞
＜PARAM NAME="AutoStart" VALUE="False"＞

　　其中"FileName"参数表示Media Player要播放的文件活或流。"ShowControls"表示在播放时是否显示控制条。Media Player的参数很多，我们在此不再一一详述。读者如果需要了解更详细的内容可以参考Media Player SDK中的相关部分。
　　如果用户需要对Media Player进行控制可以用javascript进行控制。

　　在这个例子中，Media Player嵌入在Web页面中，在Media Player右边有一些按钮，利用这些按钮用户可以控制Media Player的播放活动。这些按钮的HTML代码如下：

＜form name="myform"＞
＜input type="button" width="15" value="No Controls " name="NoControls"
OnClick="controlType(false)"＞
＜input type="button" width="15" value="All Controls" name="Full"
Onclick="controlType(true)"＞
＜input type="button" width="15" value=" Small " name="Small"
OnClick="displaySize(1)"＞
＜input type="button" value=" Large " name="Large"
Onclick="displaySize(2)"＞
＜input type="button" width="15" value=" Normal " name="Normal"
Onclick="displaySize(0)"＞
＜input type="button" width="15" value=" Play " name="Play"
Onclick="PlayClick()"＞
＜input type="button" width="15" value=" Stop " name="Stop"
Onclick="StopClick()"＞
＜/form＞

　　相应的JavaScript代码为：

＜script language="javascript"＞
＜!--
var g_Browser = navigator.appName;
function controlType (setting)
{
if (g_Browser == "Netscape")
document.WMPlay.SetShowControls(setting);
else
document.WMPlay.ShowControls = setting;
}
function displaySize (setting)
{
if (g_Browser == "Netscape")
document.WMPlay.SetDisplaySize(setting);
else
document.WMPlay.DisplaySize = setting;
}
function PlayClick ()
{
document.WMPlay.Play();
}
function StopClick ()
{
document.WMPlay.Stop();
if (g_Browser == "Netscape")
document.WMPlay.SetCurrentPosition(0);
else
document.WMPlay.CurrentPosition = 0;
}
function PauseClick ()
{
document.WMPlay.Pause();
}
function PlayPauseClick ()
{
var state;
if (g_Browser == "Netscape")
state = document.WMPlay.GetPlayState();
else
state = document.WMPlay.PlayState;
if (state == 0)
document.WMPlay.Play();
else if (state == 1)
document.WMPlay.Play();
else if (state == 2)
document.WMPlay.Pause();

}
//--＞
＜/script＞

　　从这个例子可以看出当用户单即其中的某个按钮时，它对应的OnClick函数将被调用。在JavaScript函数中，可以直接用WMPlay来控制播放器的活动，比如开始播放，停止播放或占停播放，以及放大缩小等。
除了可以用动作比如鼠标的动作来对嵌入的Media Player进行控制外，还可以利用事件来对其进行控制。Microsoft? Windows Media? Player 支持的事件很多，有普通的鼠标事件，比如鼠标的单击、双击、鼠标的移动、鼠标键的按下与松开等，也有一些是Media Player特有的事件。与流播放有直接关系的事件有：OpenStateChange，PlayStateChange，Buffering，MarkerHit，ScriptCommand等。下面我们对这几个重要的事件做简单地介绍。

1 OpenStateChange 事件
OpenStateChange 事件表示Player的状态已经发生了改变。Media Player的打开状态有：
0 表示流已经关闭（nsClosed）
1 表示正在装入ASX文件（nsLoadingASX）
2 表示正在装入NSC文件（nsLoadingNSC）
3 表示正在寻找Media Server （nsLocating）
4 表示正在与Media Server建立连接（nsConnecting）
5 表示正在打开或侦听流信息（nsOpening）
6 表示流信息已经打开（nsOpen）
用JavaScript处理OpenStateChange事件的格式如下：
＜SCRIPT FOR="MediaPlayer" EVENT="OpenStateChange(lOldState, lNewState)"
LANGUAGE="JScript"＞
//insert script commands//
＜/SCRIPT＞
其中MediaPlayer是在＜OBJECT＞＜/OBJECT＞中定义的Media Player对象时的名字。

2 PlayStateChange 事件
PlayStateChange 事件表示Media Player的播放状态已经改变，Media Player可能的状态有：
0 播放已经停止（mpStopped）
1 播放暂停（mpPaused ）
2 正在播放（mpPlaying）
3 正在等待流开始（mpWaiting）
4 向前搜索（mpScanForward）
5 向后搜索（mpScanReverse）
6 向前跳跃（mpSkipForward）
7 向后跳跃（mpSkipReverse）
8 流已经关闭（mpClosed）

用JavaScript处理该事件的方法为：

＜SCRIPT FOR="MediaPlayer" EVENT="PlayStateChange(lOldState, lNewState)"
LANGUAGE="JScript"＞
//insert script commands//
＜/SCRIPT＞

3 Buffering 事件
　　Buffering事件表示Media Player正在缓冲数据准备播放。在进行流播放之前，Media Player必须要缓冲一定数量的数据之后才开始播放，Buffering事件反映了Player缓冲数据的状况。用JavaScript处理Buffering事件的方法为：

＜SCRIPT FOR="MediaPlayer" EVENT="Buffering(bStart)" LANGUAGE="JScript"＞
//insert script commands//
＜/SCRIPT＞

　　其中bStart为一个布尔变量，当它为TRUE时表示缓冲正在进行，反之表示缓冲已经结束。

4 ScriptCommand 事件

　　ScriptCommand事件表示Media Player接收到了Script 命令，这时用户可以利用对接收到Script命令进行分析以决定采取相应的处理。我们知道利用Media Tools的ASF Indexer工具可以给流添加Script命令，当流播放器Player接收到这些Script 命令时会激活这个事件处理方法，于是用户可以在事件处理方法中对Script命令进行处理。处理ScriptCommand的方法是：

＜SCRIPT FOR="MediaPlayer" EVENT="ScriptCommand(sType, sParam)"
LANGUAGE="JScript"＞
//insert script commands//
＜/SCRIPT＞

　　其中sType是Script命令的类型，Script命令的类型有URL，TEXT，EVENT等，用户可以根据Script命令类型的不同做不同的处理。比如，如果是URL命令，我们可以在指定的帧内打开sParam中指定的页面。

5 MarkHit 事件

　　MarkerHit事件同ScritpCommand事件一样，当媒体播放器在ASF流中遇到标记时会激活该事件，用户利用该事件可以知道当前的标记是第几个标记。MarkerHit事件的处理方法是：

＜SCRIPT FOR="MediaPlayer" EVENT="MarkerHit(lMarkerNum)" LANGUAGE="JScript"＞
//insert script commands//
＜/SCRIPT＞

　　当然，除了支持事件处理之外，做为一个ActiveX对象，Media Player还有很多的属性（Property）和方法（Method）可以供Web页使用。比如用MediaPlayer.MarkerCount 属性可以知道在ASF流中到底有多少个标记；利用MediaPlayer. CurrentPosition属性可以知道当前播放位置的时间等等。至于Media Player对象的方法我们在前面已经使用了很多，比如Play（）, Pause（）等均是Media Player的方法。由于Media Player对象的属性和方法太多，我们不可能在此一一介绍，而只是对几个较为重要的事件处理做了一定的介绍。用户在使用时可以参考Media Player SDK的帮助文档以获取更多的信息。
　　本文对Media Service的客户应用程序Media Player的使用，特别是在Web页中的使用做了简单的介绍。作为一个通用的媒体播放器，它还有很多的功能这里没有介绍，要了解一个软件的功能，最好的方法就是使用它。用户如果感兴趣可以从http://www.windowsmedia.com/上去免费下载。


(默认0为否，-1或1为是) 
<object classid="clsid:22D6F312-B0F6-11D0-94AB-0080C74C7E95" id="MediaPlayer1" width="286" height="225"> 
<param name="Audiostream" value="/-1"> 
<param name="AutoSize" value="-1"> 
<!--是否自动调整播放大小--> 
<param name="AutoStart" value="-1"> 
<!--是否自动播放--> 
<param name="AnimationAtStart" value="-1"> 
<param name="AllowScan" value="-1"> 
<param name="AllowChangeDisplaySize" value="-1"> 
<param name="AutoRewind" value="0"> 
<param name="Balance" value="0"> 
<!--左右声道平衡,最左-9640,最右9640--> 
<param name="BaseURL" value> 
<param name="BufferingTime" value="15"> 
<!--缓冲时间--> 
<param name="CaptioningID" value> 
<param name="ClickToPlay" value="-1"> 
<param name="CursorType" value="0"> 
<param name="CurrentPosition" value="0"> 
<!--当前播放进度 -1 表示不变,0表示开头 单位是秒,比如10表示从第10秒处开始播放,值必须是-1.0或大于等于0--> 
<param name="CurrentMarker" value="0"> 
<param name="DefaultFrame" value> 
<param name="DisplayBackColor" value="0"> 
<param name="DisplayForeColor" value="16777215"> 
<param name="DisplayMode" value="0"> 
<param name="DisplaySize" value="0"> 
<!--视频1-50%, 0-100%, 2-200%,3-全屏 其它的值作0处理,小数则采用四舍五入然后按前的处理--> 
<param name="Enabled" value="-1"> 
<param name="EnableContextMenu" value="-1"> 
<!-是否用右键弹出菜单控制--> 
<param name="EnablePositionControls" value="-1"> 
<param name="EnableFullScreenControls" value="-1"> 
<param name="EnableTracker" value="-1"> 
<!--是否允许拉动播放进度条到任意地方播放--> 
<param name="Filename" value="01.wma" valuetype="ref"> 
<!--播放的文件地址--> 
<param name="InvokeURLs" value="-1"> 
<param name="Language" value="-1"> 
<param name="Mute" value="0"> 
<!--是否静音--> 
<param name="PlayCount" value="10"> 
<!--重复播放次数,0为始终重复--> 
<param name="PreviewMode" value="-1"> 
<param name="Rate" value="1"> 
<!--播放速率控制,1为正常,允许小数--> 
<param name="SAMIStyle" value> 
<!--SAMI样式--> 
<param name="SAMILang" value> 
<!--SAMI语言--> 
<param name="SAMIFilename" value> 
<!--字幕ID--> 
<param name="SelectionStart" value="-1"> 
<param name="SelectionEnd" value="-1"> 
<param name="SendOpenStateChangeEvents" value="-1"> 
<param name="SendWarningEvents" value="-1"> 
<param name="SendErrorEvents" value="-1"> 
<param name="SendKeyboardEvents" value="0"> 
<param name="SendMouseClickEvents" value="0"> 
<param name="SendMouseMoveEvents" value="0"> 
<param name="SendPlayStateChangeEvents" value="-1"> 
<param name="ShowCaptioning" value="0"> 
<!--是否显示字幕,为一块黑色,下面会有一大块黑色,一般不显示--> 
<param name="ShowControls" value="-1"> 
<!--是否显示控制,比如播放,停止,暂停--> 
<param name="ShowAudioControls" value="-1"> 
<!--是否显示音量控制--> 
<param name="ShowDisplay" value="0"> 
<!--显示节目信息,比如版权等--> 
<param name="ShowGotoBar" value="0"> 
<!--是否启用上下文菜单--> 
<param name="ShowPositionControls" value="-1"> 
<!--是否显示往前往后及列表,如果显示一般也都是灰色不可控制--> 
<param name="ShowStatusBar" value="-1"> 
<!--当前播放信息,显示是否正在播放,及总播放时间和当前播放到的时间--> 
<param name="ShowTracker" value="-1"> 
<!--是否显示当前播放跟踪条,即当前的播放进度条--> 
<param name="TransparentAtStart" value="-1"> 
<param name="VideoBorderWidth" value="0"> 
<!--显示部的宽部,如果小于视频宽,则最小为视频宽,或者加大到指定值,并自动加大高度.此改变只改变四周的黑框大小,不改变视频大小--> 
<param name="VideoBorderColor" value="0"> 
<!--显示黑色框的颜色, 为RGB值,比如ffff00为黄色--> 
<param name="VideoBorder3D" value="0"> 
<param name="Volume" value="0"> 
<!--音量大小,负值表示是当前音量的减值,值自动会取绝对值,最大为0,最小为-9640--> 
<param name="WindowlessVideo" value="0"> 
<!--如果是0可以允许全屏,否则只能在窗口中查看--> 
</object> 

上面的这个播放器是老式的那种，6.4版本！新式播放器是在MediaPlayer9.0以后出现的，也就是说只有装了9.0或9.0以上的播放器才能正常使用的。 

------------------------------------------------------------------------------- 

下面是新式播放器代码，相对以前的来说要简单很多： 
<object id="player" height="64" width="260" classid="CLSID:6BF52A52-394A-11d3-B153-00C04F79FAA6"> 
<param NAME="AutoStart" VALUE="-1"> 
<!--是否自动播放--> 
<param NAME="Balance" VALUE="0"> 
<!--调整左右声道平衡,同上面旧播放器代码--> 
<param name="enabled" value="-1"> 
<!--播放器是否可人为控制--> 
<param NAME="EnableContextMenu" VALUE="-1"> 
<!--是否启用上下文菜单--> 
<param NAME="url" VALUE="1.wma"> 
<!--播放的文件地址--> 
<param NAME="PlayCount" VALUE="1"> 
<!--播放次数控制,为整数--> 
<param name="rate" value="1"> 
<!--播放速率控制,1为正常,允许小数,1.0-2.0--> 
<param name="currentPosition" value="0"> 
<!--控件设置:当前位置--> 
<param name="currentMarker" value="0"> 
<!--控件设置:当前标记--> 
<param name="defaultFrame" value=""> 
<!--显示默认框架--> 
<param name="invokeURLs" value="0"> 
<!--脚本命令设置:是否调用URL--> 
<param name="baseURL" value=""> 
<!--脚本命令设置:被调用的URL--> 
<param name="stretchToFit" value="0"> 
<!--是否按比例伸展--> 
<param name="volume" value="50"> 
<!--默认声音大小0%-100%,50则为50%--> 
<param name="mute" value="0"> 
<!--是否静音--> 
<param name="uiMode" value="mini"> 
<!--播放器显示模式:Full显示全部;mini最简化;None不显示播放控制,只显示视频窗口;invisible全部不显示--> 
<param name="windowlessVideo" value="0"> 
<!--如果是0可以允许全屏,否则只能在窗口中查看--> 
<param name="fullScreen" value="0"> 
<!--开始播放是否自动全屏--> 
<param name="enableErrorDialogs" value="-1"> 
<!--是否启用错误提示报告--> 
<param name="SAMIStyle" value> 
<!--SAMI样式--> 
<param name="SAMILang" value> 
<!--SAMI语言--> 
<param name="SAMIFilename" value> 
<!--字幕ID--> 
</object> 

Real Player 网页播放器 参数含义 

参数：autostart 属性：True或是False 作用：指定是否自动播放指定的源文件 
参数：backgroundcolor 属性：任何用符号“#”开头的16进制数值或是任何预定义的颜色作用：指定图像窗口的背景颜色 
参数：center 属性：True或是False 作用：指定片断使用初始编码大小播放，并且在图像窗口的中央。 
参数：classid 属性："clsid：CFCDAA03-8BE4-1lcf-B84B0020AFBBCCFA:** 作用：用于指定ActiveX控件的唯一的字符串标示，可以认出嵌入的RealPalyer播放器。 
参数：console 属性：任何字符串作用：可以将各种不同的RealPlayer控制聚集在网页上，这样它们可以交互使用或是保持独立，而且互相不影响 
参数：controls 属性：ImageWindow，All，ControlPanel，PlavButton，PlayOnlyButton， PauseButton,StopButton，FFCtrl，RWCtrl，MuteCtrl，MuteVolume，VolumeSlider，PositionSlider,TACCtrl，HomeCtrl，InfoVolumePanel，InfoPanel，StatusBar，StatusField，PositionField 作用：可以让你指定那些控制是可见的。 
参数：height 属性：任何整数值作用：指定RealPlayer元素的高度，单位:像素 
参数：id 属性：任何字符串作用：为标签中的RealPlayer元素指定名字。 
参数：imagestatus 属性：True或是False 作用：指定是否在图像窗口中显示状态信息，默认值是true 
参数：loop 属性：True或是False 作用：可以让你指定片断是否无限循环 
参数：maintainaspect 属性：True或是False 作用：默认RealPlayer拉伸所有的片断来充满整个图像窗口。 
参数：name 属性：任何字符串作用：为标签中的RealPlayer元素指定名字(在标签中使用id) 
参数：nojava 属性：True或是False 作用：避免启动Java虚拟机 
参数：nolabels 属性：True或是False 作用：可以禁止显示标题或是版权信息(realplayer5.0以上时，它是垃圾...) 
参数：nologo 属性：True或是False 作用：避免RealPlayer启动时在图像窗口中显示 
参数：numloop 属性：任何整数值作用：让你能够指定文件片循环的次数，不需要参数loop 
参数：prefetch 属性：True或是False 作用：指定在播放前，RealPlayer是否可以获得流描述信息，默认值是False
参数：region 属性：任何字符串作用：同SMIL一起使用。允许你指定使用HTML代替SMIL 
参数：scriptcallbacks 属性：用逗号分割的列表作用：指定浏览器的回调监控（好高级的东东！） 
参数：shuffle 属性：True或是False 作用：同多文件片的ram文件或是SMIL文件一起使用。可以让RealPlayer随机播放列表中的文件 
参数：src 属性：任何合法的相对或是完整的URL 作用：指定播放的文件或是源文件的地址 
参数：type 属性：字符串作用：为嵌入插件指定MIME类型 
参数：width 属性：任何整数值作用：指定RealPlayer元素的宽度 

RealPlayer的一些函数、方法和过程 

这是 Real Player ActiveX Control Library (Version 1.0) 的所有函数与方法，有兴趣可以研究一下。 

function GetSource: WideString; 
procedure SetSource(const lpszNewValue: WideString); 
function GetConsole: WideString; 
procedure SetConsole(const lpszNewValue: WideString); 
function GetControls: WideString; 
procedure SetControls(const lpszNewValue: WideString); 
function GetNoLabels: WordBool; 
procedure SetNoLabels(bNewValue: WordBool); 
function GetAutoStart: WordBool; 
procedure SetAutoStart(bNewValue: WordBool); 
function GetAutoGotoURL: WordBool; 
procedure SetAutoGotoURL(bNewValue: WordBool); 
function GetVolume: Smallint; 
procedure SetVolume(nVol: Smallint); 
function GetMute: WordBool; 
procedure SetMute(bMute: WordBool); 
function GetLoop: WordBool; 
procedure SetLoop(bVal: WordBool); 
function GetImageStatus: WordBool; 
procedure SetImageStatus(bEnable: WordBool); 
function GetPacketsTotal: Integer; 
function GetPacketsReceived: Integer; 
function GetPacketsOutOfOrder: Integer; 
function GetPacketsMissing: Integer; 
function GetPacketsEarly: Integer; 
function GetPacketsLate: Integer; 
function GetBandwidthAverage: Integer; 
function GetBandwidthCurrent: Integer; 
procedure DoPlayPause; 
procedure DoStop; 
procedure DoNextItem; 
procedure DoPrevItem; 
function CanPlayPause: WordBool; 
function CanStop: WordBool; 
function HasNextItem: WordBool; 
function HasPrevItem: WordBool; 
function HasNextEntry: WordBool; 
function HasPrevEntry: WordBool; 
procedure DoNextEntry; 
procedure DoPrevEntry; 
procedure AboutBox; 
procedure EditPreferences; 
procedure HideShowStatistics; 
function IsStatisticsVisible: WordBool; 
procedure DoGotoURL(const url: WideString; const target: WideString); 
procedure DoPlay; 
procedure DoPause; 
function GetPosition: Integer; 
function GetPlayState: Integer; 
function GetLength: Integer; 
function GetTitle: WideString; 
function GetAuthor: WideString; 
function GetCopyright: WideString; 
function GetClipWidth: Integer; 
function GetClipHeight: Integer; 
function CanPlay: WordBool; 
function CanPause: WordBool; 
procedure SetPosition(lPosition: Integer); 
function GetNumLoop: Integer; 
procedure SetNumLoop(lVal: Integer); 
function GetCenter: WordBool; 
procedure SetCenter(bVal: WordBool); 
function GetNoLogo: WordBool; 
procedure SetNoLogo(bVal: WordBool); 
function GetMaintainAspect: WordBool; 
procedure SetMaintainAspect(bVal: WordBool); 
function GetBackgroundColor: WideString; 
procedure SetBackgroundColor(const pVal: WideString); 
function GetStereoState: WordBool; 
function GetLiveState: WordBool; 
function GetShowStatistics: WordBool; 
procedure SetShowStatistics(bVal: WordBool); 
function GetShowPreferences: WordBool; 
procedure SetShowPreferences(bVal: WordBool); 
function GetShowAbout: WordBool; 
procedure SetShowAbout(bVal: WordBool); 
function GetOriginalSize: WordBool; 
procedure SetOriginalSize; 
function GetDoubleSize: WordBool; 
procedure SetDoubleSize; 
function GetFullScreen: WordBool; 
procedure SetFullScreen; 
function GetEnableContextMenu: WordBool; 
procedure SetEnableContextMenu(bVal: WordBool); 
function GetEnableOriginalSize: WordBool; 
procedure SetEnableOriginalSize(bVal: WordBool); 
function GetEnableDoubleSize: WordBool; 
procedure SetEnableDoubleSize(bVal: WordBool); 
function GetEnableFullScreen: WordBool; 
procedure SetEnableFullScreen(bVal: WordBool); 
function GetEnableMessageBox: WordBool; 
procedure SetEnableMessageBox(bVal: WordBool); 
procedure SetTitle(const pVal: WideString); 
procedure SetAuthor(const pVal: WideString); 
procedure SetCopyright(const pVal: WideString); 
function GetWantKeyboardEvents: WordBool; 
procedure SetWantKeyboardEvents(bWantsEvents: WordBool); 
function GetWantMouseEvents: WordBool; 
procedure SetWantMouseEvents(bWantsEvents: WordBool); 
function GetNumEntries: Smallint; 
function GetCurrentEntry: Smallint; 
function GetEntryTitle(uEntryIndex: Smallint): WideString; 
function GetEntryAuthor(uEntryIndex: Smallint): WideString; 
function GetEntryCopyright(uEntryIndex: Smallint): WideString; 
function GetEntryAbstract(uEntryIndex: Smallint): WideString; 
procedure SetCanSeek(bCanSeek: WordBool); 
function GetCanSeek: WordBool; 
function GetBufferingTimeElapsed: Integer; 
function GetBufferingTimeRemaining: Integer; 
function GetConnectionBandwidth: Integer; 
function GetPreferedLanguageString: WideString; 
function GetPreferedLanguageID: Integer; 
function GetUserCountryID: Integer; 
function GetNumSources: Smallint; 
function GetSourceTransport(nSourceNum: Smallint): WideString; 
function GetWantErrors: WordBool; 
procedure SetWantErrors(bVal: WordBool); 
function GetShuffle: WordBool; 
procedure SetShuffle(bVal: WordBool); 
function GetVersionInfo: WideString; 
function GetLastMessage: WideString; 
function GetLastErrorSeverity: Integer; 
function GetLastErrorRMACode: Integer; 
function GetLastErrorUserCode: Integer; 
function GetLastErrorUserString: WideString; 
function GetLastErrorMoreInfoURL: WideString; 
procedure SetPreFetch(bVal: WordBool); 
function GetPreFetch: WordBool; 
procedure SetRegion(const pVal: WideString); 
function GetRegion: WideString; 
function GetIsPlus: WordBool; 
function GetConsoleEvents: WordBool; 
procedure SetConsoleEvents(bVal: WordBool); 
function GetDRMInfo(const pVal: WideString): WideString; 
property ControlInterface: IRealAudio read GetControlInterface; 
property DefaultInterface: IRealAudio read GetControlInterface; 

网页中WMP视频控制之使用指南 

□播放方法和属性 
除播放、暂停、停止外，媒体播放器还可用下面的属性： 
扫描(Scanning)——与录像机的快进快倒功能类似； 
搜索(Seeking)——直接移到剪辑中标记的特定上演时间； 

□播放 
媒体播放器提供了两种技术来指定要播放的媒体名称(剪辑)，你可以设置 FileName 属性，或调用 Open 方法。 如果 AutoStart 属性的值是 true 的话，当 FileName 属性被设置成该电影剪辑的 URL 后，该电影剪辑将开始播放；否则电影剪辑不会开始播放， 除非你调用 Play 方法。 Open 方法开始播放是异步的，它不象 Play 方法要等到其他的进程结束后才开始播放。 
媒体播放器提供了下面的类似录像机的属性和方法来控制流媒体的播放： 
Play、Stop、Pause 方法，来开始、停止、暂停流媒体。 
PlayCount 属性，设置文件播放的次数。 
AutoRewind 属性，确定当停止播放时是否返回到电影剪辑的开始部分。 

□音频控制 
媒体播放器提供了下面的属性来管理音频： 
Balance 属性，确定左右音箱的声音平衡； 
Volume 属性，用来加大或降低音量； 
Mute 属性，用来关闭或打开声音； 
※你可以将 ShowAudioControls 属性设为 true 来在控制栏添加处理声音的控件。 

□扫描 
媒体播放器提供了下面的属性用以扫描： 
FastForward 方法，快进； 
FastReverse 方法，快倒； 
Rate属性，改变播放速率； 
※要想使电影剪辑能被扫描，必须将 CanScan 和 AllowScan 属性设为 true。 

□搜索 
用于搜索的属性有： 
MarkerCount 属性，指剪辑中标记的总数量； 
CurrentMaker、GetMarkerName、GetMarkerTime 方法，用于返回标记信息； 
MarkerHit 事件，当遇到标记时触发； 
CurrentPosition 属性，当前位置(用秒度量)，可用来将播放头移到剪辑中指定的点； 
PositionChange 事件，当设置 CurrentPosition 属性时触发； 
※要想搜索到任意的时间，必须将 CanSeek 属性设为 true，要想搜索到标记点，必须将 CanSeekToMarkers 属性设为 true。 

□媒体播放器的外观界面 
在网页中，你可以通过相关属性来控制媒体播放器的哪些部分出现，哪些部分不出现。 
媒体播放器包括如下元素： 
Video Display Panel：视频显示面板； 
Video Border：视频边框； 
Closed Captioning Display Panel；字幕显示面板； 
Track Bar；搜索栏； 
Control Bar with Audio and Position Controls：带有声音和位置控制的控制栏； 
Go To Bar：转到栏； 
Display Panel：显示面板； 
Status Bar：状态栏； 
下面的属性用来决定显示哪一个元素： 
ShowControls 属性：是否显示控制栏（包括播放控件及可选的声音和位置控件）； 
ShowAudioControls 属性：是否在控制栏显示声音控件（静音按钮和音量滑块）； 
ShowPositionControls 属性：是否在控制栏显示位置控件（包括向后跳进、快退、快进、向前跳进、预览播放列表中的每个剪辑）； 
ShowTracker 属性：是否显示搜索栏； 
ShowDisplay 属性：是否显示显示面板（用来提供节目与剪辑的信息）； 
ShowCaptioning 属性：是否显示字幕显示面板； 
ShowGotoBar 属性：是否显示转到栏； 
ShowStatusBar 属性：是否显示状态栏； 

□播放列表 
媒体播放器提供下面的方法来访问播放列表中的剪辑： 
Next 方法，跳到节目（播放列表）中的下一个剪辑； 
Previous 方法，跳回到节目中的上一个剪辑； 
媒体播放器的一个特性是能够预览节目中的每一个剪辑，使用如下属性： 
PreviewMode 属性，决定媒体播放器当前是否处于预览模式； 
CanPreview 属性，决定媒体播放器能否处于预览模式； 
在windows 媒体元文件中，可以为每一个剪辑指定预览时间——PREVIEWDURATION,如果没有指定，那么默认的预览时间是10秒钟。 
你也可以用Windows 媒体元文件来添加 watermarks 与 banners，元文件也支持插入广告时的无间隙流切换。 

□节目信息 
使用 GetMediaInfoString 方法可以返回相关剪辑或节目的如下信息： 
文件名：File name 
标题：Title 
描述：Description 
作者：Author 
版权：Copyright 
级别：Rating 
URLs：logo icon、watermark、banner的地址 
剪辑信息可以放在媒体文件中，也可以放在Windows 媒体元文件中，或者两者都放。如果在元文件中指定了剪辑信息，那么用 GetMediaInfoString 方法返回的就是元文件中的信息，而不会返回剪辑中包含的信息。 
在元文件中，附加信息可以放置在每一个剪辑或节目的 PARAM标签中。你可以为每个剪辑添加任意多个 PARAM 标签，用来存储自定义的信息或链接到相关站点。在 PARAM 标签中的信息可以通过 GetMediaParameter 方法来访问。 
下面的属性返回有关大小和时间的信息： 
ImageSourceHeight、ImageSourceWidth：返回图像窗口的显示尺寸； 
Duration 属性，返回剪辑的长度(秒)， 要检测这个属性是否包含有效的数值，请检查IsDurationValid 属性。(对于广播的视频，其长度是不可预知的)。 

□字幕 
你可以用 .smi 文件来为你的节目添加字幕。媒体播放器支持下面的属性来处理字幕： 
SAMIFileName 属性，指定 .smi 文件的名字； 
SAMILang 属性，指定字幕的语言(如果没有指定则使用第一种语言)； 
SAMIStyle 属性，指定字幕的文字大小和样式； 
ShowCaptioning 属性，决定是否显示字幕显示面板； 

□脚本命令 
伴随音频、视频流，你可以在流媒体文件中加入脚本命令。脚本命令是多媒体流中与特定时间同步的多对Unicode串。第一个串标识待发命令的类型，第二个串指定要执行的命令。 
当流播放到与脚本相关的时间时，控件会向网页发送一个 scriptCommand事件，然后由事件处理进程来响应这个事件。脚本命令字符串会作为脚本命令事件的参数传递给事件处理器。 
媒体播放器会自动处理下面类型的内嵌脚本命令： 
1)URL型命令：当媒体播放器控件收到一个URL型的命令时，指定的URL会被装载到用户的默认浏览器。如果媒体播放器嵌在一个分帧的HTML文件中，URL页可以装载到由脚本命令指定的帧内。如果脚本命令没有指定一个帧，将由 DefaultFrame 属性决定将 URL 页装入哪一帧。 
你可以通过设置 InvokeURLs 属性来决定是否自动处理 URL 型的脚本命令。如果这个属性的值为 false ，媒体播放器控件将忽视 URL型命令。但是脚本命令事件仍会触发，这就允许你有选择地处理 URL 型命令。 
URL 型命令指定的是 URL 的相对地址。基地址是由 BaseURL属性指定的。媒体播放器控件传送的脚本命令事件的命令参数是链接好的地址。 
2)FILENAME型命令：当媒体播放器控件收到一个FILENAME型的命令时，它将 FileName属性设置为脚本命令提供的文件，之后媒体播放器会打开这个文件开始播放。 媒体播放器控件总是自动处理 FILENAME 型命令，不象 URL 型命令，它们不能被禁止。 
3)TEXT型命令：当媒体播放器控件收到一个 TEXT型的命令时，它会将命令的内容显示在控件的字幕窗口。内容可以是纯文本的，也可以是 HTML。 
4)EVENT型命令：当媒体播放器控件收到一个 EVENT型的命令时，它会在媒体元文件中搜索 EVENT 元素的 NAME 属性。如果 NAME 属性与脚本命令中的第二个字符串匹配，媒体播放器控件就执行包含在 EVENT 元素中的条目。 
5)OPENEVENT型命令：当媒体播放器控件收到一个 OPENEVENT型的命令时，它会在媒体元文件中检查 EVENT 元素，并打开匹配的标题，但不播放，直到收到来自 EVENT型命令的同名真实事件。 

□捕捉键盘和鼠标事件 
EnableContextMenu 与 ClickToPlay 属性为用户提供了在图像窗口进行操作的方法。 
如果 EnableContextMenu 属性为 true ，在图像窗口右击鼠标可以打开关联菜单，如果将ClickToPlay 属性设为 true ，用户可以单击图像窗口进行播放与暂停的切换。 
要接收鼠标移动和单击事件，请将 SendMouseMoveEvents 和 SendMouseClickEvents 属性设为 true 。鼠标事件有： 
MouseDown，当用户按下鼠标时产生； 
MouseUp，当用户释放鼠标时产生； 
MouseMove，当用户移动鼠标时产生； 
Click，当用户在媒体播放器上单击鼠标按钮时产生； 
DbClick，当用户在媒体播放器上双击鼠标按钮时产生； 
要接收键盘事件，请将 SendKeyboardEvents 属性设为 true 。键盘事件有： 
KeyDown，当用户按下一个键时产生； 
KeyUp，当用户释放一个键时产生； 
KeyPress，当用户按下并释放一个键时产生； 

□监测流状态与网络链接 
流状态属性包括： 
PlayState：播放状态； 
OpenState：打开状态； 
Bandwidth：带宽； 
支持的事件有： 
OpenStateChange：打开状态改变(仅当SendOpenStateChangeEvents属性为true时触发) 
PlayStateChange：播放状态改变(仅当SendPlayStateChangeEvents属性为true时触发) 
EndOfStream：流结束时触发； 
NewStream：打开新流时触发； 
网络接收属性包括： 
ReceptionQuality：接收质量； 
ReceivedPackets：已经收到的包； 
LostPackets：丢失的包； 
监测缓冲的属性有： 
BufferingTime：缓冲时间； 
BufferingCount：缓冲次数； 
BufferingProgress：缓冲进程； 
Buffering：缓冲事件； 

□错误处理 
媒体播放器提供了内建的错误处理功能——在对话框或状态栏显示错误信息。 另外，你可以自己添加错误处理程序。如果 SendErrorEvents 属性设置为 true，将不会显示错误框，而是发送错误事件；如果 SendErrorEvents 属性设置为 false，将显示错误框，而是发送错误事件。 
媒体播放器支持下面的错误处理事件： 
Error 事件，指有危险性错误发生； 
Warning 事件，指发生了非危险性的错误； 
当你的应用程序接收到一个错误事件，你可以检测下面的属性来确定具体的错误信息： 
HasError：检测目前的媒体播放器是否有错误； 
ErrorCode：提供与该类型错误相关的代码值； 
ErrorDescription：提供错误的描述信息； 
ErrorCorrection：指定媒体播放器对该类型的错误进行校正； 

□播放CD 
媒体播放器将 CD 看作（在每个音轨的开头具有标记的）单一音频流。 要在网页中使用CD，你需要将 FileName 属性设为 CDAUDIO:，必须带有冒号，如下所示： 
<HTML> 
<HEAD><TITLE>CD Audio Playback Example</TITLE></HEAD> 
<BODY> 
<OBJECT ID="MediaPlayer" 
CLASSID="CLSID:22d6f312-b0f6-11d0-94ab-0080c74c7e95" 
WIDTH="320" 
HEIGHT="508" 
STYLE="position:absolute; left:0px; top:70px;" > 
<PARAM NAME="FileName" value="/cdaudio:"> 
<PARAM NAME="AutoStart" VALUE="0"> 
<PARAM NAME="ShowControls" VALUE="1"> 
<PARAM NAME="ShowStatusBar" VALUE="1"> 
<PARAM NAME="ShowDisplay" VALUE="1"> 
</OBJECT> 
</BODY> 
</HTML> 
之后你可以用 Play 方法播放 CD 了。 
你可以在 windows 媒体元文件中指定播放顺序以及每个音轨的信息。示例如下： 

<ASX VERSION="3.0"> 
<TITLE>CD Audio with the Media Player</TITLE> 
<AUTHOR>Windows Media Technologies</AUTHOR> 
<COPYRIGHT>(c) 1999, Microsoft, Inc.</COPYRIGHT> 

<ENTRY> 
<TITLE>Track 1: Title 1</TITLE> 
<REF href="/cdaudio:" /> 
<STARTMARKER NUMBER="1"/> 
<ENDMARKER NUMBER="2"/> 
</ENTRY> 

<ENTRY> 
<TITLE>Track 2: Title 2</TITLE> 
<REF href="/cdaudio:" /> 
<STARTMARKER NUMBER="2"/> 
<ENDMARKER NUMBER="3"/> 
</ENTRY> 

<ENTRY> 
<TITLE>Track 3: Title 3</TITLE> 
<REF href="/cdaudio:" /> 
<STARTMARKER NUMBER="3"/> 
<ENDMARKER NUMBER="4"/> 
</ENTRY> 

<ENTRY> 
<TITLE>Track 4: Title 4</TITLE> 
<REF href="/cdaudio:" /> 
<STARTMARKER NUMBER="4"/> 
</ENTRY> 
</ASX>