第09单元 解码控件开发说明文档.docVIP

文档说明书 WDMMSDK版本号： 更新日期：2011.7.8 1．前言 该SDK中负责从网络上接收流媒体数据并进行解码和播放，适合于网络多媒体处理中不同应用的一套SDK。可选择的开发工具有:VC,VB,javascript,vbscript。该控件WDMMSDK.dll (SDK)在进行开发和使用之前首先进行注册，要支持MPEG4视频解码要保证在WDMMSDK.dll文件的同级目录下要增加videocodec目录并且把MPEG4的解码库mpeg4codec.dll拷到目录下(该动态连接库不需要注册)，也可以拷到和控件WDMMSDK.dll同一目录下。 说明： 该sdk为MPEG2/4解码控件，其中WDMMSDK.DLL为解码控件，需要注册才能使用，该控件支持了MPEG2视音频的解码，同时该控件可以自动加载其他视频压缩格式的解码库，其中视频解码库放置的目录为：控件WDMMSDK.DLL所在的文件目录下的videocodec文件夹里(该文件夹内的解码库不需要注册)或者控件WDMMSDK.DLL所在的文件目录下。 注意： 要保证wdmmsdk.dll在全英文的目录下； 同时用多个控件解码时候，最多只能有一个控件播放音频，其余都要关闭音频播放，否则可能访问声卡冲突，出问题。 2．接口 1）Connect long Connect(BSTR url,VARIANT reserver) 接口功能： 连接一个视频源 参数说明： url: BSTR ，视频源的URL地址，格式如下： file://文件地址, 如：file://c:\test.mpg udp://udp地址:端口号，如：udp://1:8000 c. tcp://tcp地址:端口号，如：tcp://1:8000 d. disk://e: e. remote://地址:端口，如：remote://2:4000 f. relay://relay服务器地址:返回视频数据端口@视频源地址:视频源端口|转发的组播地址[可选]，如：relay://2:4000@:4500| g. http://地址:端口号/stream/n，:端口号可选，如果不加端口号，默认为80端口，地址可以是IP地址，也可以是机器名，n是指设备的第n路视频,如：1:8000/stream/1,1/stream/1, :8000/stream/1等都合法。 h. 以上的URL之一 [空格] –audio=MP2@以上URL之一，视频和音频分开传输第一个URL传视频，第二个URL传音频，目前单独传输的音频只支持Mpeg Audio Layer2，以后会扩展。 例如： 9:6100/stream/1 -audio=MP2@udp://:4005 udp://:4001 -audio=MP2@udp://:4005 为了尽快解出图像，可以用URL+MUXTYPE:TS[PS,VES]指定媒体流的类型，和下面reserver定义一致，也就是说，reserver里的很多参数可以在URL里输入，而不必用reserver传入。如果不指定MUXTYPE，控件会自动分析码流。 reserver : VARIANT,开始连接的选项，格式为：选项1:参数+选项2:参数+……+选项n:参数，选项支持如下： MUXTYPE:TS[PS,VES,PES],目前参数只能是TS、PS或者VES流，该选项指定视频流的复用类型，当使用该选项时，当时接收的视频源地址可以没有数据，而解码立即返回，解码软件处于等待状态，注：当打开的视频源地址不是UDP模式时候无效； RECFROM:URL，url为ip地址，如，该选项表示在接收视频数据时使用了recfrom的过滤功能，指定只对该ip地址(参数传入)编码器的视频数据进行解码而避免多个视频源冲突，参数有几个特殊值：表示不进行过滤，它的效果等同于没有该选项，55表示保留最后一次设置的过滤地址。(注：在每次连接的时候假如没有该选项或者选项为则不采取过滤功能，以前设置的无效。在连接后可以通过SendCommand函数改变过滤地址，详情请看函数的MPLAYER_CMD_PEEK命令)； RECTIMEOUT:n，表示进行UDP/HTTP连接开始要等待数据的时间，假如超过该等待时间没有收到数据则Connect失败，不进行解码，如果不指定超时则缺省值是5秒，n表示等待的时间,单位为秒，n大于等于0有效，n等于0表示不做超时处理，永远等待。注：在配置文件中当有选项UdpTimeout且配置的时间大于0时候取配置超时，换句话说：配置文件的配置优先级大于连接选项；n等于0?时候要指定MUXTYPE，否则只有等收到数据Connect才返回，如果没有数据则应用程序处于挂起状态，没有反应。 SHOT:path,表示连