网页播放器的参数含义 Windows Media Player 网页播放器 参数含义

先来看一段老式播放器的代码——这是6.4版本的。而新式播放器呢，从MediaPlayer 9.0开始才出现，也就是说，只有安装了9.0或更高版本，这段代码才能正常工作。

接下来是新式播放器的代码，比老版本简洁不少：

Real Player 网页播放器 参数含义

每个参数都有自己的使命，下面逐一拆解：

• autostart：True/False，是否自动播放指定的源文件。
• backgroundcolor：十六进制或预定义颜色，指定图像窗口的背景色。
• center：True/False，是否以原始编码大小居中播放。
• classid：唯一字符串，用于标识ActiveX控件，识别嵌入的RealPlayer播放器。
• console：任意字符串，可将多个RealPlayer控制关联在一起，互不影响。
• controls：可选值包括ImageWindow、All、ControlPanel、PlayButton、PlayOnlyButton、PauseButton、StopButton、FFCtrl、RWCtrl、MuteCtrl、MuteVolume、VolumeSlider、PositionSlider、TACCtrl、HomeCtrl、InfoVolumePanel、InfoPanel、StatusBar、StatusField、PositionField，用于指定哪些控制可见。
• height：整形，元素高度（像素）。
• id：任意字符串，为元素指定名字。
• imagestatus：True/False，是否在图像窗口中显示状态信息，默认true。
• loop：True/False，是否无限循环。
• maintainaspect：True/False，默认拉伸所有片段充满图像窗口，设为true可保持原始比例。
• name：任意字符串，为元素指定名字（标签中建议用id）。
• noja va：True/False，避免启动Ja va虚拟机。
• nolabels：True/False，禁止显示标题或版权信息（RealPlayer 5.0以上此参数已无效）。
• nologo：True/False，避免RealPlayer启动时显示Logo图像。
• numloop：整形，指定文件循环次数，无需loop参数。
• prefetch：True/False，播放前是否获取流描述信息，默认False。
• region：任意字符串，配合SMIL使用，允许用HTML代替SMIL。
• scriptcallbacks：逗号分隔列表，指定浏览器的回调监控。
• shuffle：True/False，配合多文件RAM或SMIL文件，随机播放列表中的文件。
• src：合法相对或完整URL，指定播放文件地址。
• type：字符串，为嵌入插件指定MIME类型。
• width：整形，元素宽度（像素）。

RealPlayer 的函数、方法和过程

以下列出了RealPlayer ActiveX控件库（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 GetBandwidthA verage: 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视频控制之使用指南

这里我们重点说说Windows Media Player控件在网页中的各种控制。

播放方法和属性

除了最基础的播放、暂停、停止，媒体播放器还提供了扫描（Scanning）和搜索（Seeking）功能。扫描类似于录像机的快进快倒，而搜索则可以直接跳到剪辑中标记的特定时间点。

播放

指定要播放的媒体名称有两种方式：设置FileName属性，或调用Open方法。如果AutoStart为true，设置FileName后就会自动播放；否则需要调用Play方法。注意Open方法是异步的，不会等待其他进程结束。

媒体播放器还提供了类似录像机的控制方法：Play、Stop、Pause，以及PlayCount属性（设置播放次数）、AutoRewind属性（停止时是否返回开头）。

音频控制

• Balance：左右音箱声音平衡。
• Volume：音量大小。
• Mute：静音开关。
• 将ShowAudioControls设为true，可在控制栏添加声音控件。

扫描

• FastForward：快进。
• FastReverse：快倒。
• Rate：改变播放速率。
• 前提：CanScan和AllowScan都设为true。

搜索

• MarkerCount：剪辑中标记的总数量。
• CurrentMarker、GetMarkerName、GetMarkerTime：返回标记信息。
• MarkerHit事件：遇到标记时触发。
• CurrentPosition：当前位置（秒），可移动播放头。
• PositionChange事件：设置CurrentPosition时触发。
• 前提：要搜索任意时间，需CanSeek为true；要搜索到标记点，需CanSeekToMarkers为true。

媒体播放器的外观界面

通过以下属性控制哪些元素显示：

• ShowControls：是否显示控制栏（含播放控件）。
• ShowAudioControls：是否在控制栏显示声音控件。
• ShowPositionControls：是否显示位置控件（向后跳进、快退、快进、向前跳进、预览）。
• ShowTracker：是否显示搜索栏。
• ShowDisplay：是否显示信息面板。
• ShowCaptioning：是否显示字幕面板。
• ShowGotoBar：是否显示转到栏。
• ShowStatusBar：是否显示状态栏。

播放列表

• Next方法：跳到下一个剪辑。
• Previous方法：跳回上一个剪辑。
• PreviewMode：是否处于预览模式。
• CanPreview：是否允许预览模式。
• 在Windows媒体元文件中，可用PREVIEWDURATION指定每个剪辑的预览时间，默认10秒。
• 元文件还支持添加水印（watermarks）和横幅（banners），以及广告插入时的无间隙流切换。

节目信息

使用GetMediaInfoString方法可返回剪辑或节目的相关信息：文件名、标题、描述、作者、版权、级别、URL（logo icon、watermark、banner的地址）。如果元文件中也指定了信息，则优先返回元文件中的内容。

在元文件中，可以用PARAM标签为每个剪辑添加自定义信息，通过GetMediaParameter方法访问。

以下属性返回大小和时间信息：

• ImageSourceHeight、ImageSourceWidth：图像窗口显示尺寸。
• Duration：剪辑长度（秒），检查IsDurationValid判断是否有效（广播视频长度不可预测）。

字幕

使用.smi文件添加字幕，相关属性：

• SAMIFileName：指定.smi文件名。
• SAMILang：指定语言（未指定则使用第一种）。
• SAMIStyle：字幕文字大小和样式。
• ShowCaptioning：是否显示字幕面板。

脚本命令

流媒体文件中可嵌入脚本命令，与特定时间同步。命令由一对Unicode字符串组成：第一个标识命令类型，第二个指定要执行的内容。当流播放到对应时间时，控件会向网页发送ScriptCommand事件。

媒体播放器自动处理以下内嵌脚本命令：

• URL型：打开指定URL，可指定帧。通过InvokeURLs属性控制是否自动处理，设为false则只触发事件，可选择性处理。基地址由BaseURL指定。
• FILENAME型：将FileName设置为脚本命令提供的文件并播放。此类型无法禁止。
• TEXT型：在字幕窗口显示文本或HTML内容。
• EVENT型：在元文件中搜索匹配的EVENT元素，执行其中的条目。
• OPENEVENT型：检查EVENT元素并打开匹配标题，但不播放，直到收到同名真实事件。

捕捉键盘和鼠标事件

• 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，则不显示错误框，而是发送错误事件；设为false则显示错误框。

支持的错误事件：Error（危险错误）、Warning（非危险错误）。

检测错误信息：HasError（是否有错误）、ErrorCode（错误代码）、ErrorDescription（错误描述）、ErrorCorrection（校正方式）。

播放CD

媒体播放器将CD视为单一音频流，每个音轨开头有标记。要在网页中播放CD，将FileName设为CDAUDI（注意冒号）：

之后用Play方法播放。也可在Windows媒体元文件中指定播放顺序和音轨信息，示例如下：

Windows Media Technologies
(c) 1999, Microsoft, Inc.

如何贴RM、RA、RAM类型的音乐

使用以下代码：

如何贴MIDI、ASF、WMA、ASX类型的音乐

使用bgsound标签

注意：编辑文章时请使用HTML代码模式，否则代码会以文本形式显示。音乐文件不宜过大，否则影响浏览速度，甚至导致浏览器停止响应。

音乐文件的URL即音乐文件的网址。获取方法：在音乐链接上右键 -> 复制快捷方式，然后粘贴到代码中。

如果加了背景音乐后无法正常收听，可能有两个原因：一是音乐地址错误（误把HTML结尾的网址当成音乐地址），二是音乐文件太大，需要很长时间才能播放。

Windows Media Player 控件的常用属性及方法

以WMP 9.0控件为例，在Delphi 7.0中常用的属性与方法如下（Ja vaScript中用法几乎完全相同）。假设控件名为wmp。

常用的差不多就这些，更完整的资料请查阅Windows Media Player 9 SDK文档。另外，当前媒体在当前播放列表中的编号，这个属性在SDK中似乎没有直接暴露，如果遇到相关需求，可以结合实际项目自行探索。