####This project is licensed from Microsoft under the Apache 2.0 License
##Welcome to FFmpegInterop library for Windows.
FFmpegInterop is an open-source project that aims to provide an easy way to use FFmpeg in Windows 8.1 and Windows Phone 8.1 applications for playback of a variety of media contents. FFmpegInterop implements a MediaStreamSource which leverages FFmpeg to process media and uses the Windows media pipeline for playback.
One of the advantages of this approach is that audio and video synchronization is handled by the Windows media pipeline. You can also use the Windows built-in audio and video decoders which allows for better power consumption mobile devices.
##Prerequisites Getting a compatible build of FFmpeg is required for this to work.
You can get the code for FFmpeg on Github by cloning git://source.ffmpeg.org/ffmpeg.git.
You can follow the instructions on how to build FFmpeg for WinRT (Windows Phone and Windows Store) apps. This project is configured to use have FFmpeg in a folder next to the FFmpegInterop project.
git clone git://source.ffmpeg.org/ffmpeg.git
git clone git://github.com/microsoft/FFmpegInterop.git
If you have followed the Wiki instructions and have the appropriate builds of FFmpeg in the FFmpeg/Build/<platform>/<architecture> folders, FFmpegInterop should build cleanly giving you the interop object as well as 3 sample MediaPlayers (C++, C# and JS) that show how to connect the MediaStreamSource to a MediaElement or Video tag for playback.
###Using the FFmpegInterop object
Using the FFmpegInterop object is fairly straightforward and can be observed from the sample applications provided.
-
Get a stream for the media you want to playback.
-
Create a new FFmpegInteropObject using FFmpegInteropMSS.CreateFFmpegInteropMSSFromStream() passing it the stream and whether you want to force the decoding of the media (if you don't force decoding of the media, the MediaStreamSource will try to pass the compressed data for playback, this is currently enabled for mp3, aac and h.264 media).
-
Get the MediaStreamSource from the Interop object by invoking GetMediaStreamSource()
-
Assign the MediaStreamSource to your MediaElement or VideoTag for playback.
#####You can try to use the method FFmepgInteropMSS.CreateFFmpegInteropMSSFromUri to create a MediaStreamSource on a streaming source (shoutcast for example).
This project is in an early stage and we look forward to engaging with the community and hearing your feedback to figure out where we can take this project.
###The Windows OSS Team.