UPnPLite: A C# repository from ofirmakmal

UPnPLite

The UPnPLite is a high-performance, lite UPnP/DLNA framework for discovering and controlling media devices over the network.

Currently, next platforms are supported:

.NET 4.5
WinRT
Windows Phone 8

Prerequisites

In order to build sources, be sure that next prerequisites are installed:

.NET Framework 4.5
Windows Phone 8 SDK
Reactive Extensions v2.0.20823 and upper

Installation

The installation process is quite manual at the moment, but it will be improved subsequently.

To start using the UPnPLite, please follow next steps:

Download sources git clone git://github.com/SNIKO/UPnPLite.git
Build \sources\UPnPLite.sln solution;
Run RegisterBinaries.bat script. It will register binaries into GAC to make them available in "Reference Manager";
Add SV.UPnPLite.dll assembly to your project and enjoy using it.

Usage

UPnP Examples

Searching for UPnP devices:

var devicesDiscovery = new CommonUPnPDevicesDiscovery();

// Receiving notifications about new devices added to a network
devicesDiscovery.DevicesActivity.Where(e => e.Activity == DeviceActivity.Available).Subscribe(e =>
{	
	Console.WriteLine("{0} found", e.Device.FriendlyName);
});

// Receiving notifications about devices left the network
devicesDiscovery.DevicesActivity.Where(e => e.Activity == DeviceActivity.Gone).Subscribe(e =>
{
	Console.WriteLine("{0} gone", e.Device.FriendlyName);
});

//  Receiving notifications about new devices of specific type added to the network
var newMediaServers = from activityInfo in devicesDiscovery.DevicesActivity
                      where activityInfo.Activity == DeviceActivity.Available && activityInfo.Device.DeviceType == "urn:schemas-upnp-org:device:MediaServer"
                      select activityInfo.Device;

newMediaServers.Subscribe(server => 
{
	Console.WriteLine("{0} found", server.FriendlyName);
});

// Getting currently available devices
var devices = devicesDiscovery.DiscoveredDevices;

Invoking action on UPnP service:

var devicesDiscovery = new CommonUPnPDevicesDiscovery();
var rendererDevice = devicesDiscovery.DiscoveredDevices.First(device => device.DeviceType == "urn:schemas-upnp-org:device:MediaRenderer");
var renderingControlService = rendererDevice.Services.First(service => service.ServiceType == "urn:upnp-org:serviceId:RenderingControl");
			
var args = new Dictionary<string, object>();
args["InstanceID"] = 0;
args["Channel"] = "Master";
args["DesiredVolume"] = 80;

var response = await renderingControlService.InvokeActionAsync("SetVolume", args);

DLNA Examples

Searching for media devices:

var mediaServersDiscovery = new MediaServersDiscovery();
var mediaRenderersDiscovery = new MediaRenderersDiscovery();

// Enumerating currently available servers
foreach (var server in mediaServersDiscovery.DiscoveredDevices)
{
	Console.WriteLine("Server found: {0}", server.FriendlyName);
}

// Receiving notifications about new media servers added to a network
mediaServersDiscovery.DevicesActivity.Where(e => e.Activity == DeviceActivity.Available).Subscribe(e =>
{
	Console.WriteLine("Server found: {0}", e.Device.FriendlyName);
});

// Receiving notifications about media renderers left the network
mediaRenderersDiscovery.DevicesActivity.Where(e => e.Activity == DeviceActivity.Gone).Subscribe(e =>
{
	Console.WriteLine("Renderer gone: {0}", e.Device.FriendlyName);
});

Browsing media on MediaServer:

var mediaServersDiscovery = new MediaServersDiscovery();
var server = mediaServersDiscovery.DiscoveredDevices.First();

// Requesting root media objects
var rootObjects = await server.BrowseAsync();
var rootContainers = rootObjects.OfType<MediaContainer>();
var rootMediaItems = rootObjects.OfType<MediaItem>();			

// Requesting media objects from child container
var containerToBrowse = rootContainers.First();
var childContainerObjects = await server.BrowseAsync(containerToBrowse);

Searching for media items on MediaServer:

var mediaServersDiscovery = new MediaServersDiscovery();
var server = mediaServersDiscovery.DiscoveredDevices.First();

// Find all music tracks
var musicTracks = await server.SearchAsync<MusicTrack>();
foreach (var track in musicTracks)
{
	Console.WriteLine("Title={0}, Album={1}, Artist={2}", track.Title, track.Album, track.Artist);
}

// Find all video items
var videos = await server.SearchAsync<VideoItem>();
foreach (var video in videos)
{
	Console.WriteLine("Title={0}, Genre={1}", video.Title, video.Genre);
}

Playing the media on MediaRenderer:

var mediaServersDiscovery = new MediaServersDiscovery();
var mediaRenderersDiscovery = new MediaRenderersDiscovery();
			
var server = mediaServersDiscovery.DiscoveredDevices.First();
var renderer = mediaRenderersDiscovery.DiscoveredDevices.First();

var musicTracks = await server.SearchAsync<MusicTrack>();
var track = musicTracks.First();
						
await renderer.OpenAsync(track);
await renderer.PlayAsync();

// Subscribing for a playback position change
renderer.PositionChanges.Subscribe(position =>
{
	Console.WriteLine("Position changed: {0}", position);
});

// Subscribing for a playback state change
renderer.StateChanges.Subscribe(state =>
{
	Console.WriteLine("Playback state changed: {0}", state);
});