Getting Started Guide

Player Framework for Xaml-based Windows store applications

1. Make sure you have installed the tools and SDK for Windows 8.

2. Install the Visual Studio Extension SDK (Microsoft.PlayerFramework.vsix) by double clicking on the file.

3. Create a new project using the Windows Store Application templates for C# or Visual Basic.

4. Add 'Microsoft Player Framework' to your project references. Under References --> Windows --> Extensions
Note: the version number may differ depending on what version of the player framework you have installed.

5. Add the PlayerFramework namespace to your xaml file.

6. Add the MediaPlayer control that is part of the PlayerFramework namespace to the body of your Xaml file and set the source to a valid url. For example:
<Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
    <mmppf:MediaPlayer Source=""/>

That's all you need to get started. Run your app and see video player using the Player Framework. There is an extensive API as well as optional plugins to help customize the experience to the needs of your app.

Adding support for Smooth Streaming

1. Follow the instructions above to create a new app that uses the Microsoft Media Platform Player Framework for Xaml.

2. Install the Visual Studio Extension SDK for the Smooth Streaming Client (this is a separate download).

3. Add 'Microsoft Smooth Streaming Client SDK for Windows 8' and 'Microsoft Visual C++ Runtime Package' to your project References. Under References --> Microsoft--> Extensions

4. Add 'Microsoft Player Framework Adaptive Streaming Plugin' to your project references. Under References --> Windows --> Extensions

5. Modify the MediaPlayer control Xaml so it uses a valid smooth streaming url and adds the Adaptive plugin to the plugins collection on the player framework.

<mmppf:MediaPlayer Source="">
        <adaptive:AdaptivePlugin />
Note: alternatively, you can add the plugin in your code behind

6. Target your app to x86, x64, or ARM. Because the IIS Smooth Streaming Client is written in unmanaged code, AnyCPU will not work and instead you must target and build your app for each platform you wish to support.

That's all you need to get started. Run your test app watch Big Buck Bunny playing in smooth streaming!

Last edited Nov 30, 2012 at 12:15 AM by timgreenfield, version 16


AshwinBhanushali Jan 22, 2014 at 10:55 AM 
Hi Followed the steps mentioned above but I am getting
when I try to play the live video whose
url is rtsp://
can anyone help me on this.

pdii Jun 6, 2013 at 7:44 PM 
I want to be able to check in all required files for PlayerFramework so that developers and build servers could just get latest and build. They should not have to install the visx file in order to get their builds working.

When I add the Microsoft.PlayerFramework.dll (instead of using the Extensions method documented above) I am able to compile, but I get an error regarding not being able to create an instance of Microsoft.PlayerFramework.MediaPlayer

What is the correct process to incorporate the PlayerFramework dlls w/o having to manually install the vsix file?


robvig Nov 29, 2012 at 7:54 PM 
What would the code look like if I wanted the Source attribute to be dynamic (Data Driven)?
Thanks... Robert (SilverLight Newb)

Antonius123 Nov 4, 2012 at 6:19 PM 
how can you play the audio in the background ?

christostat Sep 19, 2012 at 3:47 PM 
Plain text captions does not seem to be there to add as a reference int the last release? Is fine in the May one I tested...

Will the Plain text captions be included in the final version?

Christos Tatitzikidis

lseidman Sep 17, 2012 at 7:08 AM 
Upon debugging without requesting anything, just before startup:

An exception of type 'Windows.UI.Xaml.Markup.XamlParseException' occurred in Test.exe but was not handled in user code

WinRT information: Cannot create instance of type 'Microsoft.PlayerFramework.MediaPlayer' [Line: 19 Position: 26]

Additional information: Unspecified error

vishal8181 Sep 13, 2012 at 1:34 PM 
I have Posted a question in this,Would be Glad if u guys can help

Julienv42 Jun 19, 2012 at 8:45 AM 
I've just tried moving my solution to the root of the disk, it changed nothing.
Here is the stacktrace:
à Microsoft.Expression.DesignHost.Isolation.Remoting.STAMarshaler.WaitForCompletion(NestedCallContext nestedCallContext, BlockingCall call, WaitHandle timeoutSignal)
à Microsoft.Expression.DesignHost.Isolation.Remoting.STAMarshaler.MarshalOut(Action action, Int32 targetApartmentId, WaitHandle aborted, WaitHandle timeoutSignal)
à Microsoft.Expression.DesignHost.Isolation.Remoting.ThreadMarshaler.MarshalOut[TValue](RemoteHandle`1 targetObject, Action action)
à Microsoft.Expression.DesignHost.Isolation.Remoting.ThreadMarshaler.MarshalOut[TResult,TValue](RemoteHandle`1 targetObject, Func`2 func)
à Microsoft.Expression.DesignHost.Isolation.Remoting.LocalDesignerService.CreateDesignerImpl(IHostSourceItem item, IHostTextEditor editor, RemoteCancellationToken remoteCancelToken)
à Microsoft.Expression.DesignHost.Isolation.Remoting.LocalDesignerService.Microsoft.Expression.DesignHost.IDesignerService.CreateDesigner(IHostSourceItem item, IHostTextEditor editor, CancellationToken cancelToken)
à Microsoft.Expression.DesignHost.IsolatedDesignerService.IsolatedDesignerView.CreateDesignerViewInfo(CancellationToken cancelToken)

lincolnvu Jun 18, 2012 at 7:58 PM 
System.IO.PathTooLongException is likely because the folder you extract to plus the project name create a very long string (this happened to me before). Try to put it to C: for instant.

Julienv42 Jun 18, 2012 at 3:40 PM 
Oh, it's alternating with another nasty message: a bunch of System.IO.PathTooLongException which makes no more sense.

I've got a 100% repro right now.

Julienv42 Jun 18, 2012 at 3:36 PM 
I've also got the Out of Memory message both in Visual Studio's designer and Blend.
Any clues?


timgreenfield Jun 4, 2012 at 9:07 PM 
The info above has now been updated to indicate the change where optional plugins must be manually added to the MediaPlayer.Plugins collection.

Also, for those migrating apps created with the Developer Preview version of Windows 8, please remove the xml you manually added to your appxmanifest file. This is no longer needed.


Tim Greenfield

ricardoschiller Jun 4, 2012 at 10:57 AM 
I had the playerframework working, with the smooth streaming beta 1 sdk, on the consumer preview. With the release preview smooth streaming videos stopped working.

A need a working version as soon as possible. Do you have an idea of how long it will take to produce a new working version for the win8 release preview?

Thank you,


kevinkao809 Jun 2, 2012 at 12:13 PM 
Out of memory message :
OutOfMemoryException: Insufficient memory to continue the execution of the program.
at System.Runtime.InteropServices.WindowsRuntime.IVector`1.InsertAt(UInt32 index, T value)
at System.Runtime.InteropServices.WindowsRuntime.VectorToListAdapter.InsertAtHelper[T](IVector`1 _this, UInt32 index, T item)
at System.Runtime.InteropServices.WindowsRuntime.VectorToListAdapter.Insert[T](Int32 index, T item)
InnerException: None

kevinkao809 Jun 2, 2012 at 12:07 PM 

I follow above steps, but get below error on Smooth Streaming.

1. In VS 2012 design view, it show "out of memory" on player page.
2."Can't Play Video" when run it.

These two error only happen on Smooth Streaming and XAML-base metro app.

My environment :
Windows 8 Release Preview. (Build 8400), Eng, 32bit
Smooth Streaming SDK Beta 1, Version 1.0
Player Framework Version : 1.2.0

Kevin Kao