KB326: Displaying an RTSP stream in Moxie using VLC Media Player

KB326: Displaying an RTSP stream in Moxie using VLC M
Published on Omnivex (https://www.omnivex.com)
KB326: Displaying an RTSP stream in Moxie using VLC Media Player
Installing VLC Media Player ActiveX plugin
Note: VLC Media Player ActiveX plugin must be installed on all computers where a Moxie Studio or
Player is expected to be able to display the RTSP stream.
1. Download 32-bit VLC Media Player for Windows setup file from http://www.videolan.org
Note: As of 2016.02.18 the current version is 2.2.2
2. Run setup file. The VLC media player Setup wizard appears.
Note: As of 2016.02.18 the current setup file is named vlc-2.2.2-win32.exe
3. Click Next.
4. The next screen differs depending on whether VLC Media Player is already installed:
a. If this is a new installation of VLC Media Player, the License Agreement page appears.
Read through the license agreement. If you accept the terms of the agreement, click
Next.
Page 1 of 9
KB326: Displaying an RTSP stream in Moxie using VLC M
Published on Omnivex (https://www.omnivex.com)
b. If this is an upgrade of VLC Media Player, select Change settings (advanced) and
click Next.
Page 2 of 9
KB326: Displaying an RTSP stream in Moxie using VLC M
Published on Omnivex (https://www.omnivex.com)
c. If this is a reinstallation of the VLC Media Player, select Add/Remove/Reinstall
components and click Next.
Page 3 of 9
KB326: Displaying an RTSP stream in Moxie using VLC M
Published on Omnivex (https://www.omnivex.com)
5. From the Choose Components page, in the Custom list:
1. Clear:
Desktop Shortcut
Mozilla plugin
File type associations
2. Select:
ActiveX plugin
Delete preferences and cache
Note: Only the selection of the ActiveX plugin is required; clearing or selecting other
components is only recommended.
6. Click Next.
7. If this is a new installation of VLC Media Player, choose the install location and click Install.
8. When the Completing the VLC media player Setup Wizard page appears, click Finish.
Page 4 of 9
KB326: Displaying an RTSP stream in Moxie using VLC M
Published on Omnivex (https://www.omnivex.com)
9. When VLC Media Player starts for the first time, a Privacy and Network Access Policy dialog
appears. For implementing streaming in web content, typically neither retrieval of metadata nor
checking for VLC updates is necessary. Clearing Allow metadata network access and
Regularly check for VLC updates is recommended. Click Continue.
Page 5 of 9
KB326: Displaying an RTSP stream in Moxie using VLC M
Published on Omnivex (https://www.omnivex.com)
10. Close VLC Media Player.
Creating HTML that uses the VLC Media Player ActiveX plugin
Documentation for how to use the VLC Media Player ActiveX plugin can be found here:
https://wiki.videolan.org/Documentation:WebPlugin/
To get started:
1. Copy and paste this sample HTML into Notepad:
<!DOCTYPE html>
<html>
<body marginwidth="0" marginheight="0" topmargin="0" leftmargin="0">
<object classid="clsid:9BE31822-FDAD-461B-AD51-BE1D1C159921"
codebase="http://download.videolan.org/pub/videolan/vlc/last/win32/axvlc.cab"
width="1280"
height="720"
id="vlc">
<param name="target" value="rtsp://<address here>" />
<param name="allowfullscreen" value="false" />
<param name="controls" value="false" />
<param name="loop" value="true" />
</object>
</body>
</html>
Page 6 of 9
KB326: Displaying an RTSP stream in Moxie using VLC M
Published on Omnivex (https://www.omnivex.com)
2. Replace the width and height values with the dimensions of your Moxie web zone. Ideally the
RTSP video stream, Moxie web zone and HTML parameters use the same width and height
values.
3. Replace the target address with the address of your RTSP encoder hardware.
4. Save the file using a .html extension. In our tests, we used a Matrox Maevex 5150 as well as
the Extron SMP 351.
Note: To mute the stream audio, add a parameter named mute with a value of true.
Modifying Internet Explorer settings to enable HTML testing in an
IE window
Once you have created HTML that uses the VLC Media Player ActiveX plugin, you should test your HTML
file in an Internet Explorer window to ensure that it works as intended. To do this, IE must be configured
to enable HTML testing.
1. Open Internet Explorer.
2. Open IE's Internet Options.
3. Select Allow active content to run files on My Computer*.
Page 7 of 9
KB326: Displaying an RTSP stream in Moxie using VLC M
Published on Omnivex (https://www.omnivex.com)
4. Click OK.
5. Restart your computer.
To test your HTML file, right-click it and select Open with Internet Explorer.
Displaying HTML using the Moxie web zone
There are two ways to provide the HTML to Moxie Players. You can either:
Page 8 of 9
KB326: Displaying an RTSP stream in Moxie using VLC M
Published on Omnivex (https://www.omnivex.com)
1. add the file to a workspace using the Moxie Studio’s Data Manager module or
2. the file can be hosted on a web server.
In most cases either option works, however if any of the Moxie Players fail to reliably load the VLC Media
Player ActiveX plugin then hosting the file on a web server may resolve the issue. Once you have either
added the HTML file to a workspace or uploaded the file to a web server, move on to the next step.
1. From Moxie Studio’s Layout Designer module insert a new web zone.
2. When the Web Browser dialog box appears, either:
a. click the ellipsis button and browse for the HTML file in your workspace or
b. paste the web URL for your hosted HTML file
3. Click OK.
4. Open the Properties dialog for the web zone.
5. In the left pane, click Size & Position and change the Width and Height values to match the
width and height defined in your HTML file.
6. In the left pane, click Web and change the Browser width, Browser height, Viewport width
and Viewport height values to match the width and height defined in your HTML file.
7. Change the Rendering setting to Better performance.
8. Click OK.
Note: Using the Better performance rendering option results in significantly different
behavior than the default Allow layers on top option. Aside from causing the web zone to
render on top of all other zones, regardless of z-order in the layout, this option also prevents
zone scaling from working as expected. This means that the rendered web content only fits
within the zone when the Moxie Player window’s resolution matches the layout’s resolution. If
you have any questions, contact Omnivex Technical Services ([email protected]).
Select rating
Give KB326: Displaying
Give KB326: Displaying
Rate
Give KB326: Displaying
Give KB326: Displaying
Give KB326: Displaying
Source URL: https://www.omnivex.com/support/kb/326
Rate the usefulness of this information
an
an
an
an
an
RTSP
RTSP
RTSP
RTSP
RTSP
stream
stream
stream
stream
stream
in
in
in
in
in
Moxie
Moxie
Moxie
Moxie
Moxie
using
using
using
using
using
Page 9 of 9
VLC
VLC
VLC
VLC
VLC
Media
Media
Media
Media
Media