Fred LE COQUIL's blog https://docs.microsoft.com/archive/blogs/flecoqui/feed.xml Sharing information about Windows Phone, Windows Store applications... Wed, 17 Apr 2019 03:21:52 GMT en-US hourly 1 Building Audio/Video Applications based on Player Framework v2.0 for Windows Phone 8, Windows 8.1 and Windows Phone 8.1 https://docs.microsoft.com/archive/blogs/flecoqui/building-audiovideo-applications-based-on-player-framework-v2-0-for-windows-phone-8-windows-8-1-and-windows-phone-8-1 Wed, 28 May 2014 10:21:44 GMT https://blogs.msdn.microsoft.com/flecoqui/2014/05/28/building-audiovideo-applications-based-on-player-framework-v2-0-for-windows-phone-8-windows-8-1-and-windows-phone-8-1/ INTRODUCTION

This article describes the different steps  to create Windows Phone 8, Windows 8.1 and Windows Phone 8.1 applications playing video supporting the following formats:  
- Step 1: WMV, MP4, MPEG2-TS (only for Windows 8.1)    
- Step 2: WMV, MP4, MPEG2-TS (only for Windows 8.1) and Smooth Streaming     
- Step 3: WMV, MP4, MPEG2-TS (only for Windows 8.1), Smooth Streaming and MPEG DASH    
- Step 4: WMV, MP4, MPEG2-TS (only for Windows 8.1), Smooth Streaming and MPEG DASH protected with PlayReady    
The sample applications delivered with this article allow the user to define:    
- the video Uri,    
- the PlayReady license acquisition Uri,    
- the « Challenge Custom Data » for the PlayReady license acquisition.
If the PlayReady license acquisition Uri is not defined, the application will use the Uri defined in protection header of the manifest.
By default the applications use a list of videos supporting the different formats.
         image_thumb4                                                              image_thumb5
              Windows Phone 8                                                                           Windows Phone 8.1

                        image_thumb3
                                                                           Windows 8.1

image_thumb35

STEP 1: AUDIO/VIDEO PLAYER (WMV, MP4, MPEG2-TS)

The Windows Phone 8, Windows 8.1 and Windows Phone 8.1 Applications for Step 1 support the following formats:
- Windows: WMV, MP4, MPEG2-TS
- Windows Phone : WMV, MP4

Those formats are natively supported, no supplementary SDKs are required.

image_thumb9

Windows 8.1, Windows Phone 8.1 and Windows Phone 8.0 Applications:

On the XAML MainPage insert the MediaElement and call it « Player »    

<MediaElement x:Name="Player" Grid.Row="1" Grid.Column="2" Grid.RowSpan="4" Grid.ColumnSpan="1"
Stretch="Uniform" Margin="20,10,20,10" HorizontalAlignment="Center" VerticalAlignment="Center" />

In the method associated with Click event on button “Play”, initialize Player Source with the Uri of the video you want to play   

Player.Source = new Uri(MediaUri.Text);

Sample Uris compliant with WMV, MP4 and MPEG2-TS format are available on Microsoft Azure


http://livestreamingvm.cloudapp.net/vod/wmv/test1.wmv
http://livestreamingvm.cloudapp.net/vod/mp4/test1.mp4
http://livestreamingvm.cloudapp.net/vod/ts/test1.ts


STEP 2: AUDIO/VIDEO PLAYER (WMV, MP4, MPEG2-TS, SMOOTH STREAMING)

The Windows Phone 8, Windows 8.1 and Windows Phone 8.1 Applications for Step 2 support the following formats:
- Windows: WMV, MP4, MPEG2-TS and Smooth Streaming 
- Windows Phone : WMV, MP4 and Smooth Streaming


Supplementary SDKs are required to build the applications :

 image_thumb37

Windows 8.1 and Windows Phone 8.1 Applications:

Add a reference to « Microsoft Smooth Streaming Client SDK for Windows 8.1 » for Windows 8.1 application.

image_thumb13

Add a reference to « Microsoft Smooth Streaming Client SDK for Windows Phone 8.1 » for Windows Phone 8.1 application.

image_thumb14

On the XAML MainPage insert the MediaElement and call it  « Player »


<MediaElement x:Name="Player" Grid.Row="1" Grid.Column="2" 
Grid.RowSpan="4" Grid.ColumnSpan="1"
Stretch="Uniform" Margin="20,10,20,10" 
HorizontalAlignment="Center" VerticalAlignment="Center" />

Create a method RegisterPlugins which associates the Smooth Streaming library with the Smooth Streaming Uri opened by the MediaElement. This method is called in the method OnNavigatedTo. 

public Windows.Media.MediaExtensionManager MediaManager;
public IAdaptiveSourceManager AdaptiveSrcManager { get; private set; }
void RegisterPlugins()
{
     LogMessage("Register plugins");
     if (MediaManager == null)
                MediaManager = new Windows.Media.MediaExtensionManager();
     if (AdaptiveSrcManager == null)
                AdaptiveSrcManager = AdaptiveSourceManager.GetDefault();
     PropertySet ssps = new PropertySet();
     ssps["{A5CE1DE8-1D00-427B-ACEF-FB9A3C93DE2D}"] = AdaptiveSrcManager;


     MediaManager.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".ism", "text/xml", ssps);
     MediaManager.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".ism", "application/vnd.ms-sstr+xml", ssps);
     MediaManager.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".isml", "text/xml", ssps);
     MediaManager.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".isml", "application/vnd.ms-sstr+xml", ssps);
     MediaManager.RegisterSchemeHandler("Microsoft.Media.AdaptiveStreaming.SmoothSchemeHandler", "ms-sstr:", ssps);
} 

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    LogMessage("OnNavigatedTo");
    base.OnNavigatedTo(e);
    Application.Current.Suspending += App_Suspending;
    Application.Current.Resuming += App_Resuming;
    Player.MediaEnded += Player_MediaEnded;
    Player.MediaOpened += Player_MediaOpened;
    Player.MediaFailed += Player_MediaFailed;
#if WINDOOWS_PHONE_APP
    DisplayInformation.GetForCurrentView().OrientationChanged += OnOrientationChanged;
#endif
    RegisterPlugins();
}

In the method associated with Click event on button “Play”, initialize Player Source with the Uri of the video you want to play

Player.Source = new Uri(MediaUri.Text);

Sample Uris compliant with Smooth Streaming format are available on Microsoft Azure


http://livestreamingvm.cloudapp.net/vod/test1/test1.ism/manifest

Applications Windows Phone 8.0:

Add a reference to « Microsoft.Web.Media.SmoothStreaming » for Windows Phone 8.0 application.

image_thumb15

On the XAML MainPage :
- insert the MediaElement used to play WMV, MP4 content and call it « Player »
- insert the SmoothStreamingMediaElement used to play Smooth Streaming content and call it « PlayerSSME »

<MediaElement Visibility="Visible" x:Name="Player" Grid.Row="3" 
Stretch="Uniform" Grid.Column="0" Grid.ColumnSpan="3" Margin="10,10,10,10" 
HorizontalAlignment="Center" VerticalAlignment="Center" />
<ssme:SmoothStreamingMediaElement Visibility="Collapsed" 
x:Name="PlayerSSME" Grid.Row="3" Stretch="Uniform" Grid.Column="0" 
Grid.ColumnSpan="3" Margin="10,10,10,10" HorizontalAlignment="Center" 
VerticalAlignment="Center" />

In the method associated with Click event on button “Play”, initialize PlayerSSME SmoothStreamingSource with the Uri of the smooth streaming video you want to play, if you want to play MP4 or WMV video, initialize Player Source with the Uri of the WMV or MP4 video.

if (MediaUri.Text.EndsWith("/manifest", StringComparison.CurrentCultureIgnoreCase))
    PlayerSSME.SmoothStreamingSource = new Uri(MediaUri.Text);
else 
    Player.Source = new Uri(MediaUri.Text);

Sample Uris compliant with Smooth Streaming format are available on Microsoft Azure


http://livestreamingvm.cloudapp.net/vod/test1/test1.ism/manifest

STEP 3: AUDIO/VIDEO PLAYER (WMV, MP4, MPEG2-TS, SMOOTH STREAMING, MPEG DASH)

The Windows Phone 8, Windows 8.1 and Windows Phone 8.1 Applications for Step 3 support the following formats:
- Windows: WMV, MP4, MPEG2-TS, Smooth Streaming  and MPEG DASH 
- Windows Phone : WMV, MP4, Smooth Streaming  and MPEG DASH


Supplementary SDKs are required to build the applications :

image_thumb17

Windows 8.1 and Windows Phone 8.1 Applications:

Add a reference to:
« Microsoft Smooth Streaming Client SDK for Windows 8.1 »,
« Microsoft Player Framework », 
« Microsoft Player Framework Adaptive Streaming Plugin», 
« Microsoft Player Framework Dash Plugin» for Windows 8.1 application.

image_thumb18

Add a reference to:
« Microsoft Smooth Streaming Client SDK for Windows Phone 8.1 »,
« Microsoft Player Framework »,
« Microsoft Player Framework Adaptive Streaming Plugin»,
« Microsoft Player Framework Dash Plugin» for Windows Phone 8.1 application.

image_thumb19

On the XAML MainPage insert the « PlayerFramework:MediaPlayer » and call it « Player »

<PlayerFramework:MediaPlayer x:Name="Player" Grid.Row="1" Grid.Column="2" Grid.RowSpan="4" Grid.ColumnSpan="1" Margin="20,10,20,10"         
            IsTimelineVisible="false" IsTimeElapsedVisible="false" IsDurationVisible="false" IsTimeRemainingVisible="false« 
            IsInfoVisible="false"  IsMoreVisible="false«  IsFastForwardVisible="False" IsRewindVisible="False"
            IsSkipBackVisible="False" IsSkipAheadVisible="False"  IsSkipPreviousVisible="False"   IsReplayVisible="False"  
            IsAudioSelectionVisible="False" IsCaptionSelectionVisible="False" HorizontalAlignment="Center"  VerticalAlignment="Center"  
            IsFullScreenVisible="True" Background="Black"  />

Create a method RegisterPlugins which associates the Adaptive plugin with the Smooth Streaming Uri opened by the Player. This method is called in the method OnNavigatedTo.  Create a method RegisterDashPlugins which associates the DashDownloaderPlugin plugin with the Adaptive plugin used by the Player. This method is called before playing any MPEG DASH content.


public Microsoft.PlayerFramework.Adaptive.AdaptivePlugin adaptivePlugin;
public Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin dashDownloaderPlugin;

void RegisterDashPlugin(bool bRegister)
{
    Microsoft.PlayerFramework.Adaptive.AdaptivePlugin plugin = Player.Plugins.OfType<Microsoft.PlayerFramework.Adaptive.AdaptivePlugin>().First();
    if (plugin != null)
    {
        if (bRegister == true)
        {
            LogMessage("Register DASH plugin");
            if (dashDownloaderPlugin == null)
                dashDownloaderPlugin = new Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin();
            plugin.DownloaderPlugin = dashDownloaderPlugin;
        }
        else
        {
            LogMessage("Unregister DASH plugin");
            plugin.DownloaderPlugin = null;
        }
    }
}
void RegisterPlugins()
{
    LogMessage("Register plugins");

    if (adaptivePlugin == null)
        adaptivePlugin = new Microsoft.PlayerFramework.Adaptive.AdaptivePlugin();

    Player.Plugins.Add(adaptivePlugin);
}

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    LogMessage("OnNavigatedTo");
    base.OnNavigatedTo(e);
    Application.Current.Suspending += App_Suspending;
    Application.Current.Resuming += App_Resuming;
    Player.MediaEnded += Player_MediaEnded;
    Player.MediaOpened += Player_MediaOpened;
    Player.MediaFailed += Player_MediaFailed;
#if WINDOWS_PHONE_APP
    DisplayInformation.GetForCurrentView().OrientationChanged += OnOrientationChanged;
#endif
    RegisterPlugins();
}


In the method associated with Click event on button “Play”, call the method RegisterDashPlugin to register the DashDownloaderPlugin (if it’s a MPEG DASH uri), and then initialize Player Source with the Uri of the video you want to play. 

RegisterDashPlugin((MediaUri.Text.EndsWith(".mpd", StringComparison.CurrentCultureIgnoreCase) || 
                     MediaUri.Text.EndsWith("manifest(format=mpd-time-csf)", StringComparison.CurrentCultureIgnoreCase)));
Player.Source = new Uri(MediaUri.Text);

Sample Uris compliant with MPEG DASH format are available on Microsoft Azure.

http://wams.edgesuite.net/media/SintelTrailer_Smooth_SeekDemo/sintel_trailer-1080p.ism/manifest(format=mpd-time-csf)

Applications Windows Phone 8.0:

Add a reference to:
« Microsoft.Web.Media.SmoothStreaming »,
« Microsoft Player Framework »,
« Microsoft Player Framework Adaptive Streaming Plugin»,
« Microsoft Player Framework Dash Plugin» for the Windows Phone 8.0 application<

image_thumb20

On the XAML MainPage insert the « PlayerFramework:MediaPlayer » and call it « Player »

<PlayerFramework:MediaPlayer  Visibility="Visible" x:Name="Player"  Grid.Row="3" Grid.Column="0" 
Grid.ColumnSpan="3"  Grid.RowSpan="1"  Margin="10,10,10,10" Background="Black" Foreground="Black" 
IsAudioSelectionVisible="False" IsCaptionSelectionVisible="False"     HorizontalAlignment="Center"  VerticalAlignment="Center"  IsFullScreenVisible="False" />

Create a method RegisterPlugins which associates the Adaptive plugin with the Smooth Streaming Uri opened by the Player. This method is called in the method OnNavigatedTo.  Create a method RegisterDashPlugins which associates the DashDownloaderPlugin plugin with the Adaptive plugin used by the Player. This method is called before playing any MPEG DASH content.

public Microsoft.PlayerFramework.Adaptive.AdaptivePlugin adaptivePlugin;
public Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin dashDownloaderPlugin;

void RegisterDashPlugin(bool bRegister)
{
    Microsoft.PlayerFramework.Adaptive.AdaptivePlugin plugin = Player.Plugins.OfType<Microsoft.PlayerFramework.Adaptive.AdaptivePlugin>().First();
    if (plugin != null)
    {
        if (bRegister == true)
        {
            LogMessage("Register DASH plugin");
            if (dashDownloaderPlugin == null)
                dashDownloaderPlugin = new Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin();
            plugin.DownloaderPlugin = dashDownloaderPlugin;
        }
    }
}
void RegisterPlugins()
{
    LogMessage("Register plugins");
    if (adaptivePlugin == null)
        adaptivePlugin = new Microsoft.PlayerFramework.Adaptive.AdaptivePlugin();
    Player.Plugins.Add(adaptivePlugin);
}

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    LogMessage("OnNavigatedTo");
    base.OnNavigatedTo(e);
    PhoneApplicationService.Current.Deactivated += App_Suspending;
    PhoneApplicationService.Current.Activated += App_Resuming;
    Player.MediaEnded += Player_MediaEnded;
    Player.MediaOpened += Player_MediaOpened;
    Player.MediaFailed += Player_MediaFailed;
    RegisterPlugins();
}


In the method associated with Click event on button “Play”, first initialize the Player Source with null and close the player. Then call the method RegisterDashPlugin to register the DashDownloaderPlugin (if it’s a MPEG DASH Uri), and then initialize Player Source with the Uri of the video you want to play.


Player.Source = null;
Player.Close();

RegisterDashPlugin((MediaUri.Text.EndsWith(".mpd", StringComparison.CurrentCultureIgnoreCase) || 
                     MediaUri.Text.EndsWith("manifest(format=mpd-time-csf)", StringComparison.CurrentCultureIgnoreCase)));
Player.Source = new Uri(MediaUri.Text);


Sample Uris compliant with MPEG DASH format are available on Microsoft Azure.

http://wams.edgesuite.net/media/SintelTrailer_Smooth_SeekDemo/sintel_trailer-1080p.ism/manifest(format=mpd-time-csf)

STEP 4: AUDIO/VIDEO PLAYER (WMV, MP4, MPEG2-TS, SMOOTH STREAMING, MPEG DASH, PLAYREADY)

The Windows Phone 8, Windows 8.1 and Windows Phone 8.1 Applications for Step 4 support the following formats:
- Windows: WMV, MP4, MPEG2-TS, Smooth Streaming and MPEG DASH protected or not with PlayReady  DRM
- Windows Phone : WMV, MP4, Smooth Streaming and MPEG DASH protected or not with PlayReady DRM

Supplementary SDKs are required to build the applications :


image_thumb22

Steps to acquire a PlayReady license for Universal Apps (Windows 8.1 et Windows Phone 8.1) :

Before describing how the PlayReady client acquires the PlayReady license, some words about the Individualization. Every PlayReady client has a unique digital certificate and key, the installation of the certificate and the key is called Individualization.
Moreover, before the PlayReady client requests the license to decrypt the content, it must first determine whether the user’s computer has the appropriate PlayReady software installed. This software is called the Individualized Black boX (IBX) and is the client component of PlayReady that is required before any protected content can be played. The individualization component software enables the client computer to request and use a PlayReady license.
The PlayReady client for Windows Store applications supports dynamic individualization: the IBX is downloaded from the Individualization Server. In your application you can implement a Pro-Active Individualization Request or a Reactive Individualization Request.

  • A Pro-Active Individualization Request can be transmitted just after the installation of the application or when the user launches the application for the first time.
  • A Reactive Individualization Request is automatically prepared by the PlayReady client when the application is about to play an asset protected with PlayReady and if the IBX is not installed on the computer.

The schema below describes the acquisition of a PlayReady license to play an asset protected with PlayReady with a Reactive Individualization Request: 

image_thumb24  

The schema below describes the acquisition of a PlayReady license to play an asset protected with PlayReady without any Individualization Request as the Individualized Black Box (IBX) is already installed: 


image_thumb26

The schema below describes the exchanges between the client and the server when the application plays an asset protected with PlayReady when the Individualized Black Box (IBX) is already installed and the PlayReady license has already been acquired and the license is persistent: 


image_thumb28

Windows 8.1 and Windows Phone 8.1 applications:
Add a reference to:
« Microsoft Smooth Streaming Client SDK for Windows 8.1 », 
« Microsoft Player Framework », 
« Microsoft Player Framework Adaptive Streaming Plugin», 
« Microsoft Player Framework Dash Plugin», 
« Microsoft PlayReady Client SDK» for Windows 8.1 application.

image_thumb29

Add a reference to:
« Microsoft Smooth Streaming Client SDK for Windows Phone 8.1 », 
« Microsoft Player Framework », 
« Microsoft Player Framework Adaptive Streaming Plugin», 
« Microsoft Player Framework Dash Plugin», 
« Microsoft PlayReady Client SDK» for Windows Phone 8.1 application.

image_thumb30

On the XAML MainPage insert the « PlayerFramework:MediaPlayer » and call it « Player ».

<PlayerFramework:MediaPlayer x:Name="Player" Grid.Row="1" Grid.Column="2" Grid.RowSpan="4" Grid.ColumnSpan="1" Margin="20,10,20,10"         
            IsTimelineVisible="false" IsTimeElapsedVisible="false" IsDurationVisible="false" IsTimeRemainingVisible="false« 
            IsInfoVisible="false"  IsMoreVisible="false«  IsFastForwardVisible="False" IsRewindVisible="False"
            IsSkipBackVisible="False" IsSkipAheadVisible="False"  IsSkipPreviousVisible="False"   IsReplayVisible="False"  
            IsAudioSelectionVisible="False" IsCaptionSelectionVisible="False" HorizontalAlignment="Center"  VerticalAlignment="Center"  
            IsFullScreenVisible="True" Background="Black"  />


Create a method RegisterPlugins which associates the Adaptive plugin with the Smooth Streaming Uri opened by the Player, which creates a MediaProtectionManager associated with the Player and which registers the PlayReady events  « ServiceRequested » and « ComponentLoadFailed »
This method is called in the method OnNavigatedTo. 
Create a method RegisterDashPlugins which associates the DashDownloaderPlugin plugin with the Adaptive plugin used by the Player. This method is called before playing any MPEG DASH content.

public Microsoft.PlayerFramework.Adaptive.AdaptivePlugin adaptivePlugin;
public Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin dashDownloaderPlugin;

void RegisterDashPlugin(bool bRegister)
{
    Microsoft.PlayerFramework.Adaptive.AdaptivePlugin plugin = Player.Plugins.OfType<Microsoft.PlayerFramework.Adaptive.AdaptivePlugin>().First();
    if (plugin != null)
    {
        if (bRegister == true)
        {
            LogMessage("Register DASH plugin");
            if (dashDownloaderPlugin == null)
                dashDownloaderPlugin = new Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin();
            plugin.DownloaderPlugin = dashDownloaderPlugin;
        }
        else
        {
            LogMessage("Unregister DASH plugin");
            plugin.DownloaderPlugin = null;
        }
    }
}
void RegisterPlugins()
{
    LogMessage("Register plugins");

    if (adaptivePlugin == null)
        adaptivePlugin = new Microsoft.PlayerFramework.Adaptive.AdaptivePlugin();

    Player.Plugins.Add(adaptivePlugin);

    // PlayReady
    // Init PlayReady Protection Manager
    var protectionManager = new MediaProtectionManager();
    Windows.Foundation.Collections.PropertySet cpSystems = new Windows.Foundation.Collections.PropertySet();
    cpSystems.Add("{F4637010-03C3-42CD-B932-B48ADF3A6A54}", "Microsoft.Media.PlayReadyClient.PlayReadyWinRTTrustedInput"); //Playready
    protectionManager.Properties.Add("Windows.Media.Protection.MediaProtectionSystemIdMapping", cpSystems);
    protectionManager.Properties.Add("Windows.Media.Protection.MediaProtectionSystemId", "{F4637010-03C3-42CD-B932-B48ADF3A6A54}");
    this.Player.ProtectionManager = protectionManager;
    
    // PlayReady Events registration
    Player.ProtectionManager.ComponentLoadFailed += ProtectionManager_ComponentLoadFailed;
    Player.ProtectionManager.ServiceRequested += ProtectionManager_ServiceRequested;
}

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    LogMessage("OnNavigatedTo");
    base.OnNavigatedTo(e);
    Application.Current.Suspending += App_Suspending;
    Application.Current.Resuming += App_Resuming;
    Player.MediaEnded += Player_MediaEnded;
    Player.MediaOpened += Player_MediaOpened;
    Player.MediaFailed += Player_MediaFailed;
#if WINDOWS_PHONE_APP
    DisplayInformation.GetForCurrentView().OrientationChanged += OnOrientationChanged;
#endif
    RegisterPlugins();
}


To support PlayReady the application must call the license server to acquire the PlayReady license associated with the content protected with PlayReady. You need to include in the project the file  CommonLicenseRequest.cs. This file implements the common class based on HttpClient to acquire the PlayReady license.

The method ProtectionManager_ServiceRequested is called each time the application requests a PlayReady license or an individualization. If it’s a individualization request, the method ReactiveIndivRequest is called. If it’s a license request, the methode LicenseAcquisitionRequest is called.    

If the URL used to acquire the PlayReady License is not forced and is the one defined in the PlayReady protection header, the method LicenseAcquisitionRequest calls licenseRequest.BeginServiceRequest. If the URL to acquire the PlayReady License is forced by the application, the method LicenseAcquisitionRequest creates a PlayReady challenge using the ChallengeCustomData and then call licenseAcquisition.AcquireLicense using the URL defined by the user.  

private const int MSPR_E_CONTENT_ENABLING_ACTION_REQUIRED = -2147174251;
private string PlayReadyLicenseUrl;
private string PlayReadyChallengeCustomData;

/// <summary>
/// Invoked when the Protection Manager can't load some components
/// </summary>
void ProtectionManager_ComponentLoadFailed(MediaProtectionManager sender, ComponentLoadFailedEventArgs e)
{
    LogMessage("ProtectionManager ComponentLoadFailed");
    e.Completion.Complete(false);
}
/// <summary>
/// Invoked to acquire the PlayReady License
/// </summary>
async void LicenseAcquisitionRequest(PlayReadyLicenseAcquisitionServiceRequest licenseRequest, MediaProtectionServiceCompletion CompletionNotifier, string Url, string ChallengeCustomData)
{
    bool bResult = false;
    string ExceptionMessage = string.Empty;

    try
    {
        if (!string.IsNullOrEmpty(Url))
        {
            LogMessage("ProtectionManager PlayReady Manual License Acquisition Service Request in progress - URL: " + Url);

            if (!string.IsNullOrEmpty(ChallengeCustomData))
            {
                System.Text.UTF8Encoding encoding = new System.Text.UTF8Encoding();
                byte[] b = encoding.GetBytes(ChallengeCustomData);
                licenseRequest.ChallengeCustomData = Convert.ToBase64String(b, 0, b.Length);
            }

            PlayReadySoapMessage soapMessage = licenseRequest.GenerateManualEnablingChallenge();

            byte[] messageBytes = soapMessage.GetMessageBody();
            HttpContent httpContent = new ByteArrayContent(messageBytes);

            IPropertySet propertySetHeaders = soapMessage.MessageHeaders;
            foreach (string strHeaderName in propertySetHeaders.Keys)
            {
                string strHeaderValue = propertySetHeaders[strHeaderName].ToString();

                // The Add method throws an ArgumentException try to set protected headers like "Content-Type"
                // so set it via "ContentType" property
                if (strHeaderName.Equals("Content-Type", StringComparison.OrdinalIgnoreCase))
                    httpContent.Headers.ContentType = MediaTypeHeaderValue.Parse(strHeaderValue);
                else
                    httpContent.Headers.Add(strHeaderName.ToString(), strHeaderValue);
            }
            CommonLicenseRequest licenseAcquision = new CommonLicenseRequest();
            HttpContent responseHttpContent = await licenseAcquision.AcquireLicense(new Uri(Url), httpContent);
            if (responseHttpContent != null)
            {
                Exception exResult = licenseRequest.ProcessManualEnablingResponse(await responseHttpContent.ReadAsByteArrayAsync());
                if (exResult != null)
                {
                    throw exResult;
                }
                bResult = true;
            }
            else
                ExceptionMessage = licenseAcquision.GetLastErrorMessage();
        }
        else
        {
            LogMessage("ProtectionManager PlayReady License Acquisition Service Request in progress - URL: " + licenseRequest.Uri.ToString());
            await licenseRequest.BeginServiceRequest();
            bResult = true;
        }
    }
    catch (Exception e)
    {
        ExceptionMessage = e.Message;
    }

    if (bResult == true)
        LogMessage(!string.IsNullOrEmpty(Url) ? "ProtectionManager Manual PlayReady License Acquisition Service Request successful" :
            "ProtectionManager PlayReady License Acquisition Service Request successful");
    else
        LogMessage(!string.IsNullOrEmpty(Url) ? "ProtectionManager Manual PlayReady License Acquisition Service Request failed: " + ExceptionMessage :
            "ProtectionManager PlayReady License Acquisition Service Request failed: " + ExceptionMessage);
    CompletionNotifier.Complete(bResult);
}
/// <summary>
/// Proactive Individualization Request 
/// </summary>
async void ProActiveIndivRequest()
{
    PlayReadyIndividualizationServiceRequest indivRequest = new PlayReadyIndividualizationServiceRequest();
    LogMessage("ProtectionManager PlayReady ProActive Individualization Service Request in progress...");
    bool bResultIndiv = await ReactiveIndivRequest(indivRequest, null);
    if (bResultIndiv == true)
        LogMessage("ProtectionManager PlayReady ProActive Individualization Service Request successful");
    else
        LogMessage("ProtectionManager PlayReady ProActive Individualization Service Request failed");

}
/// <summary>
/// Invoked to send the Individualization Request 
/// </summary>
async Task<bool> ReactiveIndivRequest(PlayReadyIndividualizationServiceRequest IndivRequest, MediaProtectionServiceCompletion CompletionNotifier)
{
    bool bResult = false;
    Exception exception = null;
    LogMessage("ProtectionManager PlayReady Individualization Service Request in progress...");
    try
    {
        await IndivRequest.BeginServiceRequest();
    }
    catch (Exception ex)
    {
        exception = ex;
    }
    finally
    {
        if (exception == null)
        {
            bResult = true;
        }
        else
        {
            COMException comException = exception as COMException;
            if (comException != null && comException.HResult == MSPR_E_CONTENT_ENABLING_ACTION_REQUIRED)
            {
                IndivRequest.NextServiceRequest();
            }
        }
    }
    if (bResult == true)
        LogMessage("ProtectionManager PlayReady Individualization Service Request successful");
    else
        LogMessage("ProtectionManager PlayReady Individualization Service Request failed");
    if (CompletionNotifier != null) CompletionNotifier.Complete(bResult);
    return bResult;

}
/// <summary>
/// Invoked to send a PlayReady request (Individualization or License request)
/// </summary>
async void ProtectionManager_ServiceRequested(MediaProtectionManager sender, ServiceRequestedEventArgs srEvent)
{
    LogMessage("ProtectionManager ServiceRequested");
    if (srEvent.Request is PlayReadyIndividualizationServiceRequest)
    {
        PlayReadyIndividualizationServiceRequest IndivRequest = srEvent.Request as PlayReadyIndividualizationServiceRequest;
        bool bResultIndiv = await ReactiveIndivRequest(IndivRequest, srEvent.Completion);
    }
    else if (srEvent.Request is PlayReadyLicenseAcquisitionServiceRequest)
    {
        PlayReadyLicenseAcquisitionServiceRequest licenseRequest = srEvent.Request as PlayReadyLicenseAcquisitionServiceRequest;
        LicenseAcquisitionRequest(licenseRequest, srEvent.Completion, PlayReadyLicenseUrl, PlayReadyChallengeCustomData);
    }
}

In the method associated with Click event on button “Play”, first initialize PlayReadyLicenseUrl with the Uri of the PlayReady Server (if defined), initialize PlayReadyChallengeCustomData with the data required to generate the PlayReady challenge (if defined). Then call the method RegisterDashPlugin to register the DashDownloaderPlugin (if it’s MPEG DASH Uri), and then initialize Player Source with the Uri of the video you want to play.

PlayReadyLicenseUrl = PlayReadyUri.Text;
PlayReadyChallengeCustomData = CustomData.Text;
RegisterDashPlugin((MediaUri.Text.EndsWith(".mpd", StringComparison.CurrentCultureIgnoreCase) || 
                     MediaUri.Text.EndsWith("manifest(format=mpd-time-csf)", StringComparison.CurrentCultureIgnoreCase)));
Player.Source = new Uri(MediaUri.Text);


Sample Uris compliant with MPEG DASH and Smooth Streaming protected with PlayReady format are available with the sample application.


http://playready.directtaps.net/smoothstreaming/SSWSS720H264PR/SuperSpeedway_720.ism/Manifest
http://wams.edgesuite.net/media/SintelTrailer_Smooth_from_WAME_CENC/NoSubSampleAdjustment/sintel_trailer-1080p.ism/manifest(format=mpd-time-csf)
http://wams.edgesuite.net/media/Tears_of_Steel_Smooth_1080p_Protected2/tears_of_steel_1080p.ism/manifest(format=mpd-time-csf)

By default the applications will try to play the following Smooth Streaming asset:
http://playready.directtaps.net/smoothstreaming/SSWSS720H264PR/SuperSpeedway_720.ism/Manifest
using the following URL for the license acquisition:
http://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight=1&UseSimpleNonPersistentLicense=1
This URL will return a non-persistent license. Each time the application will try to play the smooth streaming asset, a request to the PlayReady server will be transmitted.
By default, the challenge custom data is empty, you can change this field if the PlayReady server expect a specific challenge custom data.
If you use the following URL, the license returned will be persistent:
http://playready.directtaps.net/pr/svc/rightsmanager.asmx

Applications Windows Phone 8.0:

Add a reference to:
« Microsoft.Web.Media.SmoothStreaming », 
« Microsoft Player Framework »,
« Microsoft Player Framework Adaptive Streaming Plugin»,
« Microsoft Player Framework Dash Plugin» for Windows Phone 8.0 application.

image_thumb31              image_thumb33

Http Client Library:    
These PlayReady sample applications are based on Player Framework V2.0 and the PlayReady license acquisition is based on HttpClient class for both platforms Windows and Windows Phone.  
HttpClient is a part of .NET Framework 4.5 and Windows Store applications that provides developers an extremely easy way to connect with services across the Internet including REST-based services. HttpClient is available for Windows Phone developers provided you install the Microsoft HttpClient Libraries Nuget package.

On the XAML MainPage insert the « PlayerFramework:MediaPlayer » and call it « Player ».

<PlayerFramework:MediaPlayer  Visibility="Visible" x:Name="Player"  Grid.Row="3" Grid.Column="0" 
Grid.ColumnSpan="3"  Grid.RowSpan="1"  Margin="10,10,10,10" Background="Black" Foreground="Black" 
IsAudioSelectionVisible="False" IsCaptionSelectionVisible="False"     HorizontalAlignment="Center"  VerticalAlignment="Center"  IsFullScreenVisible="False" />

Create a method RegisterPlugins which associates the Adaptive plugin with the Smooth Streaming Uri opened by the Player, which initialize the property “LicenseAcquirer” of Player MediaElement.
This method is called in the method OnNavigatedTo. 
Create a method RegisterDashPlugins which associates the DashDownloaderPlugin plugin with the Adaptive plugin used by the Player. This method is called before playing any MPEG DASH content. 

public Microsoft.PlayerFramework.Adaptive.AdaptivePlugin adaptivePlugin;
public Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin dashDownloaderPlugin;

void RegisterDashPlugin(bool bRegister)
{
    Microsoft.PlayerFramework.Adaptive.AdaptivePlugin plugin = Player.Plugins.OfType<Microsoft.PlayerFramework.Adaptive.AdaptivePlugin>().First();
    if (plugin != null)
    {
        if (bRegister == true)
        {
            LogMessage("Register DASH plugin");
            if (dashDownloaderPlugin == null)
                dashDownloaderPlugin = new Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin();
            plugin.DownloaderPlugin = dashDownloaderPlugin;
        }
    }
}
void RegisterPlugins()
{
    LogMessage("Register plugins");
    if (adaptivePlugin == null)
        adaptivePlugin = new Microsoft.PlayerFramework.Adaptive.AdaptivePlugin();
    Player.Plugins.Add(adaptivePlugin);

    // PlayReady
    // Init PlayReady 
    adaptivePlugin.MediaElement.LicenseAcquirer = new WindowsPhoneLicenseAcquisition(null);
}

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    LogMessage("OnNavigatedTo");
    base.OnNavigatedTo(e);
    PhoneApplicationService.Current.Deactivated += App_Suspending;
    PhoneApplicationService.Current.Activated += App_Resuming;
    Player.MediaEnded += Player_MediaEnded;
    Player.MediaOpened += Player_MediaOpened;
    Player.MediaFailed += Player_MediaFailed;
    RegisterPlugins();
}

To support PlayReady, the application must call the license server to acquire the PlayReady license associated with the content. You need to include in the project the files  CommonLicenseRequest.cs and WindowsPhoneLicenseAcquisition.cs . The file CommonLicenseRequest.cs implements the common class based on HttpClient to acquire the PlayReady license. The file WindowsPhoneLicenseAcquisition.cs implements the class WindowsPhoneLicenseAcquisition derived from the PlayReady class LicenseAcquirer used to acquire the PlayReady license.

In the method associated with the Click event on the « Play » button,
- initialize PlayReadyLicenseUrl with the PlayReady server Uri (if defined),
- initialize PlayReadyChallengeCustomData with the data required to generate the PlayReady challenge (if defined),
- initialize Player Source to null and
- call the Player method « Close » du Player
- if PlayReadyChallengeCustomData is defined, initialize LicenseAcquirer.ChallengeCustomData of Player Media Element.
- if PlayReadyLicenseUrl is defined, initialize LicenseAcquirer.LicenseServerUriOverride of Player Media Element .
- call the method RegisterDashPlugin
- then initialize the Player Source with the content Uri . 

PlayReadyLicenseUrl = PlayReadyUri.Text;
     PlayReadyChallengeCustomData = CustomData.Text;

     // Reset the source and close the player
     Player.Source = null;
     Player.Close();

     Microsoft.PlayerFramework.Adaptive.AdaptivePlugin ap = Player.Plugins.OfType<Microsoft.PlayerFramework.Adaptive.AdaptivePlugin>().FirstOrDefault();
     if (ap != null)
     {
         if (!string.IsNullOrEmpty(PlayReadyChallengeCustomData))
         {
             System.Text.UTF8Encoding encoding = new System.Text.UTF8Encoding();
             byte[] b = encoding.GetBytes(PlayReadyChallengeCustomData);
             ap.MediaElement.LicenseAcquirer.ChallengeCustomData = Convert.ToBase64String(b, 0, b.Length);
         }
         if (!string.IsNullOrEmpty(PlayReadyLicenseUrl))
             ap.MediaElement.LicenseAcquirer.LicenseServerUriOverride = new Uri(PlayReadyLicenseUrl, UriKind.Absolute);
         else
             ap.MediaElement.LicenseAcquirer.LicenseServerUriOverride = null;
     }
 
       Player.Visibility = System.Windows.Visibility.Visible;
       PlayerSSME.Visibility = System.Windows.Visibility.Collapsed;

     /// if MPEG DASH Uri Register Dash Plugin 
     RegisterDashPlugin((MediaUri.Text.EndsWith(".mpd", StringComparison.CurrentCultureIgnoreCase) || MediaUri.Text.EndsWith("manifest(format=mpd-time-csf)", StringComparison.CurrentCultureIgnoreCase)));

     Player.Source = new Uri(MediaUri.Text);
Player.Source = null;
Player.Close();

RegisterDashPlugin((MediaUri.Text.EndsWith(".mpd", StringComparison.CurrentCultureIgnoreCase) || 
                     MediaUri.Text.EndsWith("manifest(format=mpd-time-csf)", StringComparison.CurrentCultureIgnoreCase)));
Player.Source = new Uri(MediaUri.Text);


Sample Uris compliant with MPEG DASH and Smooth Streaming protected with PlayReady format are available with the sample application.


http://playready.directtaps.net/smoothstreaming/SSWSS720H264PR/SuperSpeedway_720.ism/Manifest
http://wams.edgesuite.net/media/SintelTrailer_Smooth_from_WAME_CENC/NoSubSampleAdjustment/sintel_trailer-1080p.ism/manifest(format=mpd-time-csf)
http://wams.edgesuite.net/media/Tears_of_Steel_Smooth_1080p_Protected2/tears_of_steel_1080p.ism/manifest(format=mpd-time-csf)

BUILDING THE APPLICATIONS

In order to build the MediaPlayer sample applications for Windows Phone 8.0, Windows Phone 8.1 and Windows 8.1, make sure you have the basics installed: a computer running Windows 8.1, Visual Studio 2013 Update 2 with Windows Phone 8.1 SDK and the supplementary SDKs:

DOWNLOADING THE PROJECTS

Download:                          C# (15.7 MB)  
Requires:                             Windows Phone 8, Windows 8.1, Windows Phone 8.1, Visual Studio 2013 Update 2  
Last updated:                       5/28/2014
License:                                MS-LPL
Technologies:                      PlayReady, WMV, MP4, MPEG2-TS, Smooth Streaming, MPEG DASH, 
                                             Player Framework, C#, XAML  
Topics:                                  PlayReady Smooth Streaming MPEG DASH Player for Windows Phone and Windows Store

]]> Créer une application de lecture Audio/Vidéo pour Windows Phone 8, Windows 8.1 et Windows Phone 8.1 en utilisant le Player Framework v2.0 https://docs.microsoft.com/archive/blogs/flecoqui/crer-une-application-de-lecture-audiovido-pour-windows-phone-8-windows-8-1-et-windows-phone-8-1-en-utilisant-le-player-framework-v2-0 Wed, 28 May 2014 08:53:10 GMT https://blogs.msdn.microsoft.com/flecoqui/2014/05/28/crer-une-application-de-lecture-audiovido-pour-windows-phone-8-windows-8-1-et-windows-phone-8-1-en-utilisant-le-player-framework-v2-0/ INTRODUCTION

Cet article décrit les différentes étapes pour créer des applications Windows Phone 8, Windows 8.1 et Windows Phone 8.1 capables de jouer les formats de vidéos suivants:
- WMV, MP4, MPEG2-TS (Seulement pour Windows 8.1) pour l’étape 1,
- Smooth Streaming pour l’étape 2,
- MPEG DASH pour l’étape 3
- Smooth Streaming et MPEG DASH protégées par PlayReady pour l’étape 4.
Avec les exemples d’application fournis avec cet article l’utilisateur peut définir:
- l’URL de la vidéo,
- l’URL utilisée pour l’acquisition de la licence PlayReady,
- le « Challenge Custom Data » transmis au serveur PlayReady pour acquérir la licence PlayReady.
Si l’URL utilisée pour l’acquisition de licence n’est pas définie, l’application utilisera l’URL inclue dans l’en-tête de protection PlayReady du manifeste de la vidéo.
L’application propose par défaut une liste de vidéos pour tester les différents formats.
         image                                                              image
              Windows Phone 8                                                                           Windows Phone 8.1

                        image
                                                                           Windows 8.1

image

ETAPE 1: LECTEUR AUDIO/VIDEO (WMV, MP4, MPEG2-TS)

Les applications pour Windows Phone 8, Windows 8.1 et Windows Phone 8.1 de l’étape 1 sont capables de lire les formats suivants :
- pour Windows: WMV, MP4, MPEG2-TS
- pour Windows Phone : WMV, MP4,

Aucun SDK supplémentaire n’est nécessaire pour générer ces applications.

image

Applications Windows 8.1, Windows Phone 8.1 et Windows Phone 8.0 :

Sur la MainPage XAML insérer le MediaElement et nommer le « Player » 

<MediaElement x:Name="Player" Grid.Row="1" Grid.Column="2" Grid.RowSpan="4" Grid.ColumnSpan="1"
Stretch="Uniform" Margin="20,10,20,10" HorizontalAlignment="Center" VerticalAlignment="Center" />

Dans la méthode associée à l’événement Click sur le bouton « Play », initialiser la Source du Player avec l’url du fichier à jouer 

Player.Source = new Uri(MediaUri.Text);

Les urls associées à des fichiers WMV, MP4 et MPEG2-TS disponibles sur Microsoft Azure


http://livestreamingvm.cloudapp.net/vod/wmv/test1.wmv
http://livestreamingvm.cloudapp.net/vod/mp4/test1.mp4
http://livestreamingvm.cloudapp.net/vod/ts/test1.ts


ETAPE 2: LECTEUR AUDIO/VIDEO (WMV, MP4, MPEG2-TS, SMOOTH STREAMING)

Les applications pour Windows Phone 8, Windows 8.1 et Windows Phone 8.1 de l’étape 2 sont capables de lire les formats suivants :
- pour Windows: WMV, MP4, MPEG2-TS et Smooth Streaming
- pour Windows Phone : WMV, MP4 et Smooth Streaming

Les SDK supplémentaires suivants sont nécessaires pour générer ces applications :

 image

Applications Windows 8.1 et Windows Phone 8.1:

Ajouter une référence au « Microsoft Smooth Streaming Client SDK for Windows 8.1 » pour l’application Windows 8.1.

image

Ajouter une référence au « Microsoft Smooth Streaming Client SDK for Windows Phone 8.1 » pour l’application Windows Phone 8.1.

image

Sur la MainPage XAML insérer le MediaElement et nommer le « Player »


<MediaElement x:Name="Player" Grid.Row="1" Grid.Column="2" 
Grid.RowSpan="4" Grid.ColumnSpan="1"
Stretch="Uniform" Margin="20,10,20,10" 
HorizontalAlignment="Center" VerticalAlignment="Center" />

Créez une méthode RegisterPlugins qui associe la librairie Smooth Streaming avec l’ouverture d’url Smooth Streaming par le MediaElement. Cette méthode est appelée dans la méthode OnNavigatedTo. 

public Windows.Media.MediaExtensionManager MediaManager;
public IAdaptiveSourceManager AdaptiveSrcManager { get; private set; }
void RegisterPlugins()
{
     LogMessage("Register plugins");
     if (MediaManager == null)
                MediaManager = new Windows.Media.MediaExtensionManager();
     if (AdaptiveSrcManager == null)
                AdaptiveSrcManager = AdaptiveSourceManager.GetDefault();
     PropertySet ssps = new PropertySet();
     ssps["{A5CE1DE8-1D00-427B-ACEF-FB9A3C93DE2D}"] = AdaptiveSrcManager;


     MediaManager.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".ism", "text/xml", ssps);
     MediaManager.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".ism", "application/vnd.ms-sstr+xml", ssps);
     MediaManager.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".isml", "text/xml", ssps);
     MediaManager.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".isml", "application/vnd.ms-sstr+xml", ssps);
     MediaManager.RegisterSchemeHandler("Microsoft.Media.AdaptiveStreaming.SmoothSchemeHandler", "ms-sstr:", ssps);
} 

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    LogMessage("OnNavigatedTo");
    base.OnNavigatedTo(e);
    Application.Current.Suspending += App_Suspending;
    Application.Current.Resuming += App_Resuming;
    Player.MediaEnded += Player_MediaEnded;
    Player.MediaOpened += Player_MediaOpened;
    Player.MediaFailed += Player_MediaFailed;
#if WINDOOWS_PHONE_APP
    DisplayInformation.GetForCurrentView().OrientationChanged += OnOrientationChanged;
#endif
    RegisterPlugins();
}

Dans la méthode associée à l’événement Click sur le bouton « Play », initialiser la Source du Player avec l’url du fichier à jouer

Player.Source = new Uri(MediaUri.Text);

Les urls associées au smooth streaming sont disponibles sur Microsoft Azure


http://livestreamingvm.cloudapp.net/vod/test1/test1.ism/manifest

Applications Windows Phone 8.0:

Ajouter une référence au « Microsoft.Web.Media.SmoothStreaming » pour l’application Windows Phone 8.0.

image

Sur la MainPage XAML :
- insérer le MediaElement utilisé pour jouer le contenu WMV, MP4 et nommer le « Player »
- insérer le SmoothStreamingMediaElement utilisé pour jouer le contenu Smooth Streaming et nommer le « PlayerSSME »

<MediaElement Visibility="Visible" x:Name="Player" Grid.Row="3" 
Stretch="Uniform" Grid.Column="0" Grid.ColumnSpan="3" Margin="10,10,10,10" 
HorizontalAlignment="Center" VerticalAlignment="Center" />
<ssme:SmoothStreamingMediaElement Visibility="Collapsed" 
x:Name="PlayerSSME" Grid.Row="3" Stretch="Uniform" Grid.Column="0" 
Grid.ColumnSpan="3" Margin="10,10,10,10" HorizontalAlignment="Center" 
VerticalAlignment="Center" />

Dans la méthode associée à l’événement Click sur le bouton « Play », si l’url est une url Smooth Streaming, initialiser la Source du PlayerSSME avec l’url du fichier à jouer, sinon initialiser la Source du Player avec l’url du fichier à jouer

if (MediaUri.Text.EndsWith("/manifest", StringComparison.CurrentCultureIgnoreCase))
    PlayerSSME.SmoothStreamingSource = new Uri(MediaUri.Text);
else 
    Player.Source = new Uri(MediaUri.Text);

Les urls associées au smooth streaming sont disponibles sur Microsoft Azure


http://livestreamingvm.cloudapp.net/vod/test1/test1.ism/manifest

ETAPE 3: LECTEUR AUDIO/VIDEO (WMV, MP4, MPEG2-TS, SMOOTH STREAMING, MPEG DASH)

Les applications pour Windows Phone 8, Windows 8.1 et Windows Phone 8.1 de l’étape 3 sont capables de lire les formats suivants :
- pour Windows: WMV, MP4, MPEG2-TS, Smooth Streaming et MPEG DASH
- pour Windows Phone : WMV, MP4, Smooth Streaming et MPEG DASH

Les SDK supplémentaires suivants sont nécessaires pour générer ces applications :

image

Applications Windows 8.1 et Windows Phone 8.1:

Ajouter une référence au « Microsoft Smooth Streaming Client SDK for Windows 8.1 », au « Microsoft Player Framework », au « Microsoft Player Framework Adaptive Streaming Plugin», au « Microsoft Player Framework Dash Plugin» pour l’application Windows 8.1.

image

Ajouter une référence au:
« Microsoft Smooth Streaming Client SDK for Windows Phone 8.1 »,
« Microsoft Player Framework »,
« Microsoft Player Framework Adaptive Streaming Plugin»,
« Microsoft Player Framework Dash Plugin» pour l’application Windows Phone 8.1.

image

Sur la MainPage XAML insérer le « PlayerFramework:MediaPlayer » et nommer le « Player »

<PlayerFramework:MediaPlayer x:Name="Player" Grid.Row="1" Grid.Column="2" Grid.RowSpan="4" Grid.ColumnSpan="1" Margin="20,10,20,10"         
            IsTimelineVisible="false" IsTimeElapsedVisible="false" IsDurationVisible="false" IsTimeRemainingVisible="false« 
            IsInfoVisible="false"  IsMoreVisible="false«  IsFastForwardVisible="False" IsRewindVisible="False"
            IsSkipBackVisible="False" IsSkipAheadVisible="False"  IsSkipPreviousVisible="False"   IsReplayVisible="False"  
            IsAudioSelectionVisible="False" IsCaptionSelectionVisible="False" HorizontalAlignment="Center"  VerticalAlignment="Center"  
            IsFullScreenVisible="True" Background="Black"  />

Créez une méthode RegisterPlugins qui associe le plugin Adaptive avec le Player. Cette méthode est appelée dans la méthode OnNavigatedTo.
Créez une méthode RegisterDashPlugins qui associe le plugin DashDownloaderPlugin avec le plugin Adaptive du Player. Cette méthode est appelée avant de jouer un contenu MPEG DASH.


public Microsoft.PlayerFramework.Adaptive.AdaptivePlugin adaptivePlugin;
public Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin dashDownloaderPlugin;

void RegisterDashPlugin(bool bRegister)
{
    Microsoft.PlayerFramework.Adaptive.AdaptivePlugin plugin = Player.Plugins.OfType<Microsoft.PlayerFramework.Adaptive.AdaptivePlugin>().First();
    if (plugin != null)
    {
        if (bRegister == true)
        {
            LogMessage("Register DASH plugin");
            if (dashDownloaderPlugin == null)
                dashDownloaderPlugin = new Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin();
            plugin.DownloaderPlugin = dashDownloaderPlugin;
        }
        else
        {
            LogMessage("Unregister DASH plugin");
            plugin.DownloaderPlugin = null;
        }
    }
}
void RegisterPlugins()
{
    LogMessage("Register plugins");

    if (adaptivePlugin == null)
        adaptivePlugin = new Microsoft.PlayerFramework.Adaptive.AdaptivePlugin();

    Player.Plugins.Add(adaptivePlugin);
}

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    LogMessage("OnNavigatedTo");
    base.OnNavigatedTo(e);
    Application.Current.Suspending += App_Suspending;
    Application.Current.Resuming += App_Resuming;
    Player.MediaEnded += Player_MediaEnded;
    Player.MediaOpened += Player_MediaOpened;
    Player.MediaFailed += Player_MediaFailed;
#if WINDOWS_PHONE_APP
    DisplayInformation.GetForCurrentView().OrientationChanged += OnOrientationChanged;
#endif
    RegisterPlugins();
}


Dans la méthode associée à l’événement Click sur le bouton « Play », initialiser la Source du Player avec l’url du fichier à jouer. S’il s’agit d’un contenu MPEG DASH, appeler la méthode RegisterDashPlugin préalablement.

RegisterDashPlugin((MediaUri.Text.EndsWith(".mpd", StringComparison.CurrentCultureIgnoreCase) || 
                     MediaUri.Text.EndsWith("manifest(format=mpd-time-csf)", StringComparison.CurrentCultureIgnoreCase)));
Player.Source = new Uri(MediaUri.Text);

Les urls associées au MPEG DASH sont disponibles sur Microsoft Azure

http://wams.edgesuite.net/media/SintelTrailer_Smooth_SeekDemo/sintel_trailer-1080p.ism/manifest(format=mpd-time-csf)

Applications Windows Phone 8.0:

Ajouter une référence au:
« Microsoft.Web.Media.SmoothStreaming »,
« Microsoft Player Framework »,
« Microsoft Player Framework Adaptive Streaming Plugin»,
« Microsoft Player Framework Dash Plugin» pour l’application Windows Phone 8.0.

image

Sur la MainPage XAML insérer le « PlayerFramework:MediaPlayer » et nommer le « Player »

<PlayerFramework:MediaPlayer  Visibility="Visible" x:Name="Player"  Grid.Row="3" Grid.Column="0" 
Grid.ColumnSpan="3"  Grid.RowSpan="1"  Margin="10,10,10,10" Background="Black" Foreground="Black" 
IsAudioSelectionVisible="False" IsCaptionSelectionVisible="False"     HorizontalAlignment="Center"  VerticalAlignment="Center"  IsFullScreenVisible="False" />

Créez une méthode RegisterPlugins qui associe le plugin Adaptive avec le Player. Cette méthode est appelée dans la méthode OnNavigatedTo.
Créez une méthode RegisterDashPlugins qui associe le plugin DashDownloaderPlugin avec le plugin Adaptive du Player. Cette méthode est appelée avant de jouer un contenu MPEG DASH.

public Microsoft.PlayerFramework.Adaptive.AdaptivePlugin adaptivePlugin;
public Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin dashDownloaderPlugin;

void RegisterDashPlugin(bool bRegister)
{
    Microsoft.PlayerFramework.Adaptive.AdaptivePlugin plugin = Player.Plugins.OfType<Microsoft.PlayerFramework.Adaptive.AdaptivePlugin>().First();
    if (plugin != null)
    {
        if (bRegister == true)
        {
            LogMessage("Register DASH plugin");
            if (dashDownloaderPlugin == null)
                dashDownloaderPlugin = new Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin();
            plugin.DownloaderPlugin = dashDownloaderPlugin;
        }
    }
}
void RegisterPlugins()
{
    LogMessage("Register plugins");
    if (adaptivePlugin == null)
        adaptivePlugin = new Microsoft.PlayerFramework.Adaptive.AdaptivePlugin();
    Player.Plugins.Add(adaptivePlugin);
}

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    LogMessage("OnNavigatedTo");
    base.OnNavigatedTo(e);
    PhoneApplicationService.Current.Deactivated += App_Suspending;
    PhoneApplicationService.Current.Activated += App_Resuming;
    Player.MediaEnded += Player_MediaEnded;
    Player.MediaOpened += Player_MediaOpened;
    Player.MediaFailed += Player_MediaFailed;
    RegisterPlugins();
}


Dans la méthode associée à l’événement Click sur le bouton « Play », initialiser la Source du Player à null et appeler la méthode « Close » du Player, puis initialiser la Source du Player avec l’url du fichier à jouer. S’il s’agit d’un contenu MPEG DASH, appeler la méthode RegisterDashPlugin préalablement.


Player.Source = null;
Player.Close();

RegisterDashPlugin((MediaUri.Text.EndsWith(".mpd", StringComparison.CurrentCultureIgnoreCase) || 
                     MediaUri.Text.EndsWith("manifest(format=mpd-time-csf)", StringComparison.CurrentCultureIgnoreCase)));
Player.Source = new Uri(MediaUri.Text);


Les urls associées au MPEG DASH sont disponibles sur Microsoft Azure

http://wams.edgesuite.net/media/SintelTrailer_Smooth_SeekDemo/sintel_trailer-1080p.ism/manifest(format=mpd-time-csf)

ETAPE 4: LECTEUR AUDIO/VIDEO (WMV, MP4, MPEG2-TS, SMOOTH STREAMING, MPEG DASH, PLAYREADY)

Les applications pour Windows Phone 8, Windows 8.1 et Windows Phone 8.1 de l’étape 4 sont capables de lire les formats suivants :
- pour Windows: WMV, MP4, MPEG2-TS, Smooth Streaming et MPEG DASH protégés ou non avec le DRM PlayReady
- pour Windows Phone : WMV, MP4, Smooth Streaming et MPEG DASH protégés ou non avec le DRM PlayReady

Les SDK supplémentaires suivants sont nécessaires pour générer ces applications :


image

Les étapes pour l’acquisition d’une licence PlayReady pour les applications de type Universal Apps (Windows 8.1 et Windows Phone 8.1) :

Avant de décrire comment le client PlayReady acquiert la licence PlayReady, quelques mots sur le mécanisme d’individualisation. Chaque client PlayReady est associé à un unique certificat et à une clé unique, l’installation de ce certificat et de cette clé s’appelle l’individualisation.
De plus avant que le client PlayReady demande une licence pour décripter le contenu, il doit d’abord déterminer si le logiciel PlayReady adéquat est installé sur l’ordinateur de l’utilisateur. Ce logiciel est appelé “individualized black box” (appelé aussi IBX) et est le composant PlayReady client nécessaire pour pouvoir jouer des contenus protégés par PlayReady. Ce composant logiciel permet à l’application cliente de demander et d’utiliser une licence PlayReady.
Le client PlayReady pour les applications du Windows Store supporte l’individualisation dynamique: le certificat, la clé, l’IBX sont télélchargés depuis le serveur d’individualisation. Dans votre application Windows Store vous pouvez implémenter une demande d’individualisation réactive ou une demande d’individualisation pro-active.

· La demande pro-active d’individualisation peut être transmise après l’installation de l’application ou quand l’utilisateur lance l’application pour la première fois.

· La demande réactive d’individualisation est automatiquement préparée par le client PlayReady quand l’application est sur le point de jouer un contenu protégé par PlayReady et si le certificat, la clé et l’IBX ne sont pas déjà installés sur l’ordinateur.

Le schéma ci-dessous décrit l’acquisition d’une licence PlayReady pour jouer un contenu protégé par PlayReady avec la transmission d’une requête réactive d’individualisation préalable: 
image

Le schéma ci-dessous décrit l’acquisition d’une licence PlayReady pour jouer un contenu protégé par PlayReady sans transmission d’une requête d’individualisation comme l’IBX est déjà installé: 
image

Le schéma ci-dessous décrit les échanges entre le client et le serveur quand l’application joue un contenu protégé par PlayReady quand l’IBX est déjà installé et la licence PlayReady déjà acquise: 
image

Applications Windows 8.1 et Windows Phone 8.1:

Ajouter une référence au:
« Microsoft Smooth Streaming Client SDK for Windows 8.1 »,
« Microsoft Player Framework »,
« Microsoft Player Framework Adaptive Streaming Plugin»,
« Microsoft Player Framework Dash Plugin»,
« Microsoft PlayReady Client SDK» pour l’application Windows 8.1.

image

Ajouter une référence au:
« Microsoft Smooth Streaming Client SDK for Windows Phone 8.1 »,
« Microsoft Player Framework »,
« Microsoft Player Framework Adaptive Streaming Plugin»,
« Microsoft Player Framework Dash Plugin»,
« Microsoft PlayReady Client SDK» pour l’application Windows Phone 8.1.

image

Sur la MainPage XAML insérer le « PlayerFramework:MediaPlayer » et nommer le « Player »

<PlayerFramework:MediaPlayer x:Name="Player" Grid.Row="1" Grid.Column="2" Grid.RowSpan="4" Grid.ColumnSpan="1" Margin="20,10,20,10"         
            IsTimelineVisible="false" IsTimeElapsedVisible="false" IsDurationVisible="false" IsTimeRemainingVisible="false« 
            IsInfoVisible="false"  IsMoreVisible="false«  IsFastForwardVisible="False" IsRewindVisible="False"
            IsSkipBackVisible="False" IsSkipAheadVisible="False"  IsSkipPreviousVisible="False"   IsReplayVisible="False"  
            IsAudioSelectionVisible="False" IsCaptionSelectionVisible="False" HorizontalAlignment="Center"  VerticalAlignment="Center"  
            IsFullScreenVisible="True" Background="Black"  />


Créez une méthode RegisterPlugins qui associe le plugin Adaptive avec le Player, qui créé un MediaProtectionManager associé au Player et qui enregistre les événements PlayReady « ServiceRequested » et « ComponentLoadFailed »
Cette méthode est appelée dans la méthode OnNavigatedTo.
Créez une méthode RegisterDashPlugins qui associe le plugin DashDownloaderPlugin avec le plugin Adaptive du Player. Cette méthode est appelée avant de jouer un contenu MPEG DASH.

public Microsoft.PlayerFramework.Adaptive.AdaptivePlugin adaptivePlugin;
public Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin dashDownloaderPlugin;

void RegisterDashPlugin(bool bRegister)
{
    Microsoft.PlayerFramework.Adaptive.AdaptivePlugin plugin = Player.Plugins.OfType<Microsoft.PlayerFramework.Adaptive.AdaptivePlugin>().First();
    if (plugin != null)
    {
        if (bRegister == true)
        {
            LogMessage("Register DASH plugin");
            if (dashDownloaderPlugin == null)
                dashDownloaderPlugin = new Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin();
            plugin.DownloaderPlugin = dashDownloaderPlugin;
        }
        else
        {
            LogMessage("Unregister DASH plugin");
            plugin.DownloaderPlugin = null;
        }
    }
}
void RegisterPlugins()
{
    LogMessage("Register plugins");

    if (adaptivePlugin == null)
        adaptivePlugin = new Microsoft.PlayerFramework.Adaptive.AdaptivePlugin();

    Player.Plugins.Add(adaptivePlugin);

    // PlayReady
    // Init PlayReady Protection Manager
    var protectionManager = new MediaProtectionManager();
    Windows.Foundation.Collections.PropertySet cpSystems = new Windows.Foundation.Collections.PropertySet();
    cpSystems.Add("{F4637010-03C3-42CD-B932-B48ADF3A6A54}", "Microsoft.Media.PlayReadyClient.PlayReadyWinRTTrustedInput"); //Playready
    protectionManager.Properties.Add("Windows.Media.Protection.MediaProtectionSystemIdMapping", cpSystems);
    protectionManager.Properties.Add("Windows.Media.Protection.MediaProtectionSystemId", "{F4637010-03C3-42CD-B932-B48ADF3A6A54}");
    this.Player.ProtectionManager = protectionManager;
    
    // PlayReady Events registration
    Player.ProtectionManager.ComponentLoadFailed += ProtectionManager_ComponentLoadFailed;
    Player.ProtectionManager.ServiceRequested += ProtectionManager_ServiceRequested;
}

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    LogMessage("OnNavigatedTo");
    base.OnNavigatedTo(e);
    Application.Current.Suspending += App_Suspending;
    Application.Current.Resuming += App_Resuming;
    Player.MediaEnded += Player_MediaEnded;
    Player.MediaOpened += Player_MediaOpened;
    Player.MediaFailed += Player_MediaFailed;
#if WINDOWS_PHONE_APP
    DisplayInformation.GetForCurrentView().OrientationChanged += OnOrientationChanged;
#endif
    RegisterPlugins();
}


Pour supporter PlayReady l’application doit appeler le serveur de licence pour acquérir la licence PlayReady associé au contenu à jouer par le Player. Il faut pour cela inclure le fichier CommonLicenseRequest.cs dans le projet. Ce fichier contient le code source de la classe commune utilisant HttpClient pour l’acquisition de la licence PlayReady.

La méthode ProtectionManager_ServiceRequested est appelée à chaque demande d’acquisition de licence ou à chaque demande d’invidualisation. S’il s’agit d’une demande d’individualisation la méthode ReactiveIndivRequest est appelée. S’il s’agit d’une demande d’acquisition de licence la méthode LicenseAcquisitionRequest est appelée.    

Si l’URL utilisée pour l’acquisition de licence PlayReady n’est pas précisée par l’utilisateur, l’application utilisera l’URL définie dans l’entête de protection PlayReady du manifeste de la vidéo, la méthode LicenseAcquisitionRequest appelle licenseRequest.BeginServiceRequest. Si l’URL utilisée pour l’acquisition de licence PlayReady est précisée par l’utilisateur, la méthode LicenseAcquisitionRequest crée un challenge PlayReady en utilisant la valeur du champ ChallengeCustomData et appelle la méthode licenseAcquisition.AcquireLicense en utilisant l’URL définie par l’utilisateur. 

private const int MSPR_E_CONTENT_ENABLING_ACTION_REQUIRED = -2147174251;
private string PlayReadyLicenseUrl;
private string PlayReadyChallengeCustomData;

/// <summary>
/// Invoked when the Protection Manager can't load some components
/// </summary>
void ProtectionManager_ComponentLoadFailed(MediaProtectionManager sender, ComponentLoadFailedEventArgs e)
{
    LogMessage("ProtectionManager ComponentLoadFailed");
    e.Completion.Complete(false);
}
/// <summary>
/// Invoked to acquire the PlayReady License
/// </summary>
async void LicenseAcquisitionRequest(PlayReadyLicenseAcquisitionServiceRequest licenseRequest, MediaProtectionServiceCompletion CompletionNotifier, string Url, string ChallengeCustomData)
{
    bool bResult = false;
    string ExceptionMessage = string.Empty;

    try
    {
        if (!string.IsNullOrEmpty(Url))
        {
            LogMessage("ProtectionManager PlayReady Manual License Acquisition Service Request in progress - URL: " + Url);

            if (!string.IsNullOrEmpty(ChallengeCustomData))
            {
                System.Text.UTF8Encoding encoding = new System.Text.UTF8Encoding();
                byte[] b = encoding.GetBytes(ChallengeCustomData);
                licenseRequest.ChallengeCustomData = Convert.ToBase64String(b, 0, b.Length);
            }

            PlayReadySoapMessage soapMessage = licenseRequest.GenerateManualEnablingChallenge();

            byte[] messageBytes = soapMessage.GetMessageBody();
            HttpContent httpContent = new ByteArrayContent(messageBytes);

            IPropertySet propertySetHeaders = soapMessage.MessageHeaders;
            foreach (string strHeaderName in propertySetHeaders.Keys)
            {
                string strHeaderValue = propertySetHeaders[strHeaderName].ToString();

                // The Add method throws an ArgumentException try to set protected headers like "Content-Type"
                // so set it via "ContentType" property
                if (strHeaderName.Equals("Content-Type", StringComparison.OrdinalIgnoreCase))
                    httpContent.Headers.ContentType = MediaTypeHeaderValue.Parse(strHeaderValue);
                else
                    httpContent.Headers.Add(strHeaderName.ToString(), strHeaderValue);
            }
            CommonLicenseRequest licenseAcquision = new CommonLicenseRequest();
            HttpContent responseHttpContent = await licenseAcquision.AcquireLicense(new Uri(Url), httpContent);
            if (responseHttpContent != null)
            {
                Exception exResult = licenseRequest.ProcessManualEnablingResponse(await responseHttpContent.ReadAsByteArrayAsync());
                if (exResult != null)
                {
                    throw exResult;
                }
                bResult = true;
            }
            else
                ExceptionMessage = licenseAcquision.GetLastErrorMessage();
        }
        else
        {
            LogMessage("ProtectionManager PlayReady License Acquisition Service Request in progress - URL: " + licenseRequest.Uri.ToString());
            await licenseRequest.BeginServiceRequest();
            bResult = true;
        }
    }
    catch (Exception e)
    {
        ExceptionMessage = e.Message;
    }

    if (bResult == true)
        LogMessage(!string.IsNullOrEmpty(Url) ? "ProtectionManager Manual PlayReady License Acquisition Service Request successful" :
            "ProtectionManager PlayReady License Acquisition Service Request successful");
    else
        LogMessage(!string.IsNullOrEmpty(Url) ? "ProtectionManager Manual PlayReady License Acquisition Service Request failed: " + ExceptionMessage :
            "ProtectionManager PlayReady License Acquisition Service Request failed: " + ExceptionMessage);
    CompletionNotifier.Complete(bResult);
}
/// <summary>
/// Proactive Individualization Request 
/// </summary>
async void ProActiveIndivRequest()
{
    PlayReadyIndividualizationServiceRequest indivRequest = new PlayReadyIndividualizationServiceRequest();
    LogMessage("ProtectionManager PlayReady ProActive Individualization Service Request in progress...");
    bool bResultIndiv = await ReactiveIndivRequest(indivRequest, null);
    if (bResultIndiv == true)
        LogMessage("ProtectionManager PlayReady ProActive Individualization Service Request successful");
    else
        LogMessage("ProtectionManager PlayReady ProActive Individualization Service Request failed");

}
/// <summary>
/// Invoked to send the Individualization Request 
/// </summary>
async Task<bool> ReactiveIndivRequest(PlayReadyIndividualizationServiceRequest IndivRequest, MediaProtectionServiceCompletion CompletionNotifier)
{
    bool bResult = false;
    Exception exception = null;
    LogMessage("ProtectionManager PlayReady Individualization Service Request in progress...");
    try
    {
        await IndivRequest.BeginServiceRequest();
    }
    catch (Exception ex)
    {
        exception = ex;
    }
    finally
    {
        if (exception == null)
        {
            bResult = true;
        }
        else
        {
            COMException comException = exception as COMException;
            if (comException != null && comException.HResult == MSPR_E_CONTENT_ENABLING_ACTION_REQUIRED)
            {
                IndivRequest.NextServiceRequest();
            }
        }
    }
    if (bResult == true)
        LogMessage("ProtectionManager PlayReady Individualization Service Request successful");
    else
        LogMessage("ProtectionManager PlayReady Individualization Service Request failed");
    if (CompletionNotifier != null) CompletionNotifier.Complete(bResult);
    return bResult;

}
/// <summary>
/// Invoked to send a PlayReady request (Individualization or License request)
/// </summary>
async void ProtectionManager_ServiceRequested(MediaProtectionManager sender, ServiceRequestedEventArgs srEvent)
{
    LogMessage("ProtectionManager ServiceRequested");
    if (srEvent.Request is PlayReadyIndividualizationServiceRequest)
    {
        PlayReadyIndividualizationServiceRequest IndivRequest = srEvent.Request as PlayReadyIndividualizationServiceRequest;
        bool bResultIndiv = await ReactiveIndivRequest(IndivRequest, srEvent.Completion);
    }
    else if (srEvent.Request is PlayReadyLicenseAcquisitionServiceRequest)
    {
        PlayReadyLicenseAcquisitionServiceRequest licenseRequest = srEvent.Request as PlayReadyLicenseAcquisitionServiceRequest;
        LicenseAcquisitionRequest(licenseRequest, srEvent.Completion, PlayReadyLicenseUrl, PlayReadyChallengeCustomData);
    }
}

Dans la méthode associée à l’événement Click sur le bouton « Play », initialiser PlayReadyLicenseUrl avec l’Url du serveur PlayReady (si celui-ci est défini), initialiser PlayReadyChallengeCustomData avec les données nécessaires pour la génération du challenge PlayReady (si celles-ci sont définies), initialiser la Source du Player avec l’url du fichier à jouer. S’il s’agit d’un contenu MPEG DASH, appeler la méthode RegisterDashPlugin préalablement.

PlayReadyLicenseUrl = PlayReadyUri.Text;
PlayReadyChallengeCustomData = CustomData.Text;
RegisterDashPlugin((MediaUri.Text.EndsWith(".mpd", StringComparison.CurrentCultureIgnoreCase) || 
                     MediaUri.Text.EndsWith("manifest(format=mpd-time-csf)", StringComparison.CurrentCultureIgnoreCase)));
Player.Source = new Uri(MediaUri.Text);


Les urls associées aux contenus Smooth Streaming et MPEG DASH protégés par PlayReady sont disponibles sur Microsoft Azure


http://playready.directtaps.net/smoothstreaming/SSWSS720H264PR/SuperSpeedway_720.ism/Manifest
http://wams.edgesuite.net/media/SintelTrailer_Smooth_from_WAME_CENC/NoSubSampleAdjustment/sintel_trailer-1080p.ism/manifest(format=mpd-time-csf)
http://wams.edgesuite.net/media/Tears_of_Steel_Smooth_1080p_Protected2/tears_of_steel_1080p.ism/manifest(format=mpd-time-csf)

Par défaut, le contenu Smooth Streaming suivant
http://playready.directtaps.net/smoothstreaming/SSWSS720H264PR/SuperSpeedway_720.ism/Manifest utilisé pour les tests PlayReady est associé à l’URL suivante, la licence retournée par le serveur PlayReady sera persistante:
http://playready.directtaps.net/pr/svc/rightsmanager.asmx
En utilisant l’URL suivante pour l’acquisition de licence:
http://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight=1&UseSimpleNonPersistentLicense=1
Cette URL renverra une licence non persistante. A chaque tentative de lecture du contenu smooth streaming, une requête sera transmise au serveur PlayReady.
Enfin, par défaut, le challenge custom data est vide, vous devez modifier ce champ si le serveur PlayReady attend un challenge custom data spécifique.

Applications Windows Phone 8.0:

Ajouter une référence au:
« Microsoft.Web.Media.SmoothStreaming »,
« Microsoft Player Framework »,
« Microsoft Player Framework Adaptive Streaming Plugin»,
« Microsoft Player Framework Dash Plugin» pour l’application Windows Phone 8.0.

image              image

Librairie Http Client:
Les exemples d’application PlayReady fournis avec cet article sont basés sur Player Framework V2.0 et l’acquisition des licences PlayReady est basée sur la classe HttpClient pour les deux plates-formes Windows et Windows Phone.  
HttpClient fait partie intégrante de NET Framework 4.5 et des applications Windows Store et fournit aux développeurs la possibilité d’écrire très facilement des applications se connectant à des services Internet incluant les services basés sur des APIs REST. HttpClient est également disponible pour les développeurs Windows Phone 8.0 si vous installez le package Nuget : « Microsoft http Client Libraries »
Sur la MainPage XAML insérer le « PlayerFramework:MediaPlayer » et nommer le « Player »

<PlayerFramework:MediaPlayer  Visibility="Visible" x:Name="Player"  Grid.Row="3" Grid.Column="0" 
Grid.ColumnSpan="3"  Grid.RowSpan="1"  Margin="10,10,10,10" Background="Black" Foreground="Black" 
IsAudioSelectionVisible="False" IsCaptionSelectionVisible="False"     HorizontalAlignment="Center"  VerticalAlignment="Center"  IsFullScreenVisible="False" />

Créez une méthode RegisterPlugins qui associe le plugin Adaptive avec le Player et initialise LicenseAcquirer du Media Element du Player. Cette méthode est appelée dans la méthode OnNavigatedTo.
Créez une méthode RegisterDashPlugins qui associe le plugin DashDownloaderPlugin avec le plugin Adaptive du Player. Cette méthode est appelée avant de jouer un contenu MPEG DASH.


public Microsoft.PlayerFramework.Adaptive.AdaptivePlugin adaptivePlugin;
public Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin dashDownloaderPlugin;

void RegisterDashPlugin(bool bRegister)
{
    Microsoft.PlayerFramework.Adaptive.AdaptivePlugin plugin = Player.Plugins.OfType<Microsoft.PlayerFramework.Adaptive.AdaptivePlugin>().First();
    if (plugin != null)
    {
        if (bRegister == true)
        {
            LogMessage("Register DASH plugin");
            if (dashDownloaderPlugin == null)
                dashDownloaderPlugin = new Microsoft.Media.AdaptiveStreaming.Dash.DashDownloaderPlugin();
            plugin.DownloaderPlugin = dashDownloaderPlugin;
        }
    }
}
void RegisterPlugins()
{
    LogMessage("Register plugins");
    if (adaptivePlugin == null)
        adaptivePlugin = new Microsoft.PlayerFramework.Adaptive.AdaptivePlugin();
    Player.Plugins.Add(adaptivePlugin);

    // PlayReady
    // Init PlayReady 
    adaptivePlugin.MediaElement.LicenseAcquirer = new WindowsPhoneLicenseAcquisition(null);
}

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    LogMessage("OnNavigatedTo");
    base.OnNavigatedTo(e);
    PhoneApplicationService.Current.Deactivated += App_Suspending;
    PhoneApplicationService.Current.Activated += App_Resuming;
    Player.MediaEnded += Player_MediaEnded;
    Player.MediaOpened += Player_MediaOpened;
    Player.MediaFailed += Player_MediaFailed;
    RegisterPlugins();
}

Pour supporter PlayReady l’application doit appeler le serveur de licence pour acquérir la licence PlayReady associé au contenu à jouer par le Player. Il faut pour cela inclure les fichiers CommonLicenseRequest.cs et WindowsPhoneLicenseAcquisition.cs dans le projet. Le fichier CommonLicenseRequest.cs contient le code source de la classe commune utilisant HttpClient pour l’acquisition de la licence PlayReady. Le fichier WindowsPhoneLicenseAcquisition.cs contient le code source de la classe WindowsPhoneLicenseAcquisition dérivée de la classe PlayReady LicenseAcquirer utilisée pour l’acquisition de licence PlayReady.

Dans la méthode associée à l’événement Click sur le bouton « Play »,
- initialiser PlayReadyLicenseUrl avec l’Url du serveur PlayReady (si celui-ci est défini),
- initialiser PlayReadyChallengeCustomData avec les données nécessaires pour la génération du challenge PlayReady (si celles-ci sont définies),
- initialiser la Source du Player à null et
- appeler la méthode « Close » du Player
- Si PlayReadyChallengeCustomData est renseigné, initialiser LicenseAcquirer.ChallengeCustomData du Media Element associé au Player.
- Si PlayReadyLicenseUrl est renseigné, initialiser LicenseAcquirer.LicenseServerUriOverride du Media Element associé au Player.
- appeler la méthode RegisterDashPlugin
- puis initialiser la Source du Player avec l’url du fichier à jouer. 

PlayReadyLicenseUrl = PlayReadyUri.Text;
     PlayReadyChallengeCustomData = CustomData.Text;

     // Reset the source and close the player
     Player.Source = null;
     Player.Close();

     Microsoft.PlayerFramework.Adaptive.AdaptivePlugin ap = Player.Plugins.OfType<Microsoft.PlayerFramework.Adaptive.AdaptivePlugin>().FirstOrDefault();
     if (ap != null)
     {
         if (!string.IsNullOrEmpty(PlayReadyChallengeCustomData))
         {
             System.Text.UTF8Encoding encoding = new System.Text.UTF8Encoding();
             byte[] b = encoding.GetBytes(PlayReadyChallengeCustomData);
             ap.MediaElement.LicenseAcquirer.ChallengeCustomData = Convert.ToBase64String(b, 0, b.Length);
         }
         if (!string.IsNullOrEmpty(PlayReadyLicenseUrl))
             ap.MediaElement.LicenseAcquirer.LicenseServerUriOverride = new Uri(PlayReadyLicenseUrl, UriKind.Absolute);
         else
             ap.MediaElement.LicenseAcquirer.LicenseServerUriOverride = null;
     }
 
       Player.Visibility = System.Windows.Visibility.Visible;
       PlayerSSME.Visibility = System.Windows.Visibility.Collapsed;

     /// if MPEG DASH Uri Register Dash Plugin 
     RegisterDashPlugin((MediaUri.Text.EndsWith(".mpd", StringComparison.CurrentCultureIgnoreCase) || MediaUri.Text.EndsWith("manifest(format=mpd-time-csf)", StringComparison.CurrentCultureIgnoreCase)));

     Player.Source = new Uri(MediaUri.Text);
Player.Source = null;
Player.Close();

RegisterDashPlugin((MediaUri.Text.EndsWith(".mpd", StringComparison.CurrentCultureIgnoreCase) || 
                     MediaUri.Text.EndsWith("manifest(format=mpd-time-csf)", StringComparison.CurrentCultureIgnoreCase)));
Player.Source = new Uri(MediaUri.Text);


Les urls associées au contenu Smooth Streaming et MPEG DASH protégés par PlayReady sont disponibles sur Microsoft Azure


http://playready.directtaps.net/smoothstreaming/SSWSS720H264PR/SuperSpeedway_720.ism/Manifest
http://wams.edgesuite.net/media/SintelTrailer_Smooth_from_WAME_CENC/NoSubSampleAdjustment/sintel_trailer-1080p.ism/manifest(format=mpd-time-csf)
http://wams.edgesuite.net/media/Tears_of_Steel_Smooth_1080p_Protected2/tears_of_steel_1080p.ism/manifest(format=mpd-time-csf)

GENERATION DES APPLICATIONS

Pour générer les exemples d’application pour Windows Phone 8.0, Windows Phone 8.1 et Windows 8.1 vous devez disposer d’un ordinateur sous Windows 8.1, du Visual Studio 2013 Update 2 avec le Windows Phone 8.1 SDK et des SDKs supplémentaires :

TELECHARGEMENT DES PROJETS

Téléchargement:                  C# (15.7 MB)
Pre-requis:                           Windows Phone 8, Windows 8.1, Windows Phone 8.1, Visual Studio 2013 Update 2
Dernière modification:         5/28/2014
Licence:                                MS-LPL
Technologies:                       PlayReady, WMV, MP4, MPEG2-TS, Smooth Streaming, MPEG DASH, 
                                             Player Framework, C#, XAML
Thème:                                  PlayReady Smooth Streaming MPEG DASH Player for Windows Phone and Windows Store

]]> Communication Bluetooth entre Applications Windows Phone et Applications Windows Store https://docs.microsoft.com/archive/blogs/flecoqui/communication-bluetooth-entre-applications-windows-phone-et-applications-windows-store Fri, 13 Dec 2013 09:56:00 GMT https://blogs.msdn.microsoft.com/flecoqui/2013/12/13/communication-bluetooth-entre-applications-windows-phone-et-applications-windows-store/ Introduction

Cet article explique comment créer des applications Windows 8.1 et Windows Phone 8 supportant une communication d’application à application via Bluetooth. Avec ces applications, l'utilisateur peut :
-transmettre et recevoir des messages texte
-transmettre des photos (Application Windows Phone 8 )
-recevoir et enregistrer des photos (Application Windows 8.1)
L'application Windows Store s'exécute comme un serveur Bluetooth et l'application Windows Phone s'exécute comme un client Bluetooth.

Afin de supporter une communication d’application-à-application via Bluetooth, vous n'avez pas besoin d’utiliser les services de périphériques supplémentaires comme un routeur Wi-Fi, un câble USB. Le Windows Phone et l'ordinateur ou la tablette exécutant Windows 8.1 s’auto suffisent pour la communication Bluetooth.

Quand j'ai commencé à écrire les applications Windows Phone et Windows Store, je souhaitais utiliser l'API PeerFinder qui est disponible sur les deux plates-formes, malheureusement actuellement il ne semble pas possible de faire communiquer une application Windows Phone avec une application Windows Store en utilisant cette API.  J'ai donc décidé d'utiliser Bluetooth Rfcomm pour la communication entre les deux plates-formes. Cette approche nécessite de préalablement appairer les deux périphériques avant de lancer les applications

Dès que vous êtes en mesure de créer une application Windows Phone communicant avec une application Windows Store, vous pouvez lier le déploiement d’une application Windows Store avec une application Windows Phone qui peut jouer le rôle d’application compagnon de l’application Windows Store.

Pour générer les applications de cet article Visual Studio 2013 et le SDK Windows Phone 8 sont nécessaires.

Appairer le Windows Phone avec l’ordinateur

Avant de lancer les applications vous devez appairer votre Windows Phone avec votre ordinateur exécutant Windows 8.1.

1. Sur l’ordinateur sous Windows 8.1, sélectionnez la page de configuration ”PC and Devices” . Puis sélectionnez la page de configuration “Bluetooth”.
           clip_image002_thumb[1]

2. Sur le Windows Phone, assurez-vous que le Bluetooth est activé. Sélectionnez la page de configuration “Bluetooth” et activez le Bluetooth.
                   clip_image004_thumb[1]                clip_image006_thumb[1]

3. Sur l’ordinateur, sélectionnez le Windows Phone que vous souhaitez appairer dans la liste des périphériques Bluetooth, et cliquez sur le bouton “Pair” .
                          clip_image008_thumb[1]

4. Sur le Windows Phone, acceptez la demande d’appairage.
                                               clip_image010_thumb[2]

5. Sur l’ordinateur, confirmez l’appairage.
                              clip_image012_thumb[1]

6. Sur les deux périphériques, le périphérique pair est affiché comme étant connecté.
                               clip_image014_thumb[1]
                                                clip_image016_thumb[1]

7. Les périphériques sont maintenant appairés, vous pouvez lancer les applications sur les deux plates-formes.

Connecter les applications

1. Sur l’ordinateur, lancez l’application server Bluetooth.
                                               clip_image018_thumb
clip_image020_thumb[1]

2. Sur le Windows Phone, lancez l’application Bluetooth cliente.
                                         clip_image022_thumb

3. Vérifiez sur le Windows Phone et l’ordinateur que dans la section Settings le “Service Name” est le même, le GUID doit être le même sur les deux plates-formes pour autoriser une communication entre les applications. Le GUID est défini dans le code source de l’application et dans le manifeste de l’application Windows Store.
        clip_image024_thumb[1]              clip_image026_thumb[2]

4. Sur l’application Windows Phone naviguer vers le pivot “Connection”. Sélectionnez le nom de l’ordinateur dans la liste “Paired devices” et cliquez sur le bouton “Connect”.
                                                   clip_image028_thumb[1]

5. Comme il s''agit de la première connexion une boîte de dialogue apparaît sur l’écran de l’ordinateur. Autorisez l’application Windows à utiliser votre Windows Phone
                       clip_image030_thumb[1]

6. Dès que la connexion est accepté sur le serveur, l’état de l’application client est affiché comme “Connecté”
                                                    clip_image032_thumb[2]

7. L’état de l’application serveur  est aussi affiché comme “Connecté”
                                     clip_image034_thumb[1]

8. Les applications sont maintenant connectées, vous pouvez échanger des informations comme des messages et des photos entre les applications.

Transmettre et recevoir des messages

1. Sur le Windows Phone, naviguez vers le pivot “Messages”, entrez une chaîne de caractères dans le champ d’édition “Message” et cliquez sur le bouton “Send”.
                       clip_image036_thumb[1]              clip_image038_thumb[1]

2. Le même message est affiché quelques secondes plus tard dans la section “Messages” de l’application Windows 8.1.
                           clip_image040_thumb[1]

3. Vous pouvez aussi transmettre un message  de l’application Windows vers l’application Windows Phone.
                          clip_image042_thumb[1]

4. Et recevoir le même message sur votre Windows Phone.
                                              clip_image044_thumb[1]

Transmettre et recevoir  des photos

1. Sur votre Windows Phone, naviguez vers le pivot “Files” , et cliquez sur le bouton “Select Picture”.
                                               clip_image046_thumb[1]

2. Naviguez parmi les différents albums et sélectionnez la photo que vous souhaitez transmettre à l’application Windows.
                              clip_image048_thumb[1]             clip_image050_thumb[1]

3. Dès que la photo est sélectionnée, le chemin du fichier et la taille du fichier sont affichés sur l’écran du Windows Phone.
                                                               clip_image052_thumb[2]

4. Cliquez sur le bouton “Send Picture”  pour transmettre la photo.
                                                             clip_image054_thumb[1]

5. La photo s’affiche sur l’écran de l’ordinateur dans le section “Files” de l’application.
                                    clip_image056_thumb[1]

6. Si vous double-cliquez sur la photo, celle-ci s’affiche en plein écran. Enfin, vous pouvez sauvegarder la photo sur le disque dur de votre ordinateur en cliquant sur le bouton “Save image”.

                clip_image058_thumb[1]        clip_image060_thumb[1]

Utiliser le protocole  Bluetooth Rfcomm pour la communication entre applications Windows et applications Windows Phone

Une fois que la connexion est établie entre l'application Windows Phone et l'application Windows à l'aide de l’API Windows.Networking.Sockets.StreamSocket, les deux applications peuvent échanger des commandes en utilisant les services du  protocole Bluetooth Rfcomm.

Avec les applications disponibles avec cet article, une commande Bluetooth  peut transporter  un message texte, une photo.

Par exemple:
Commande Message :
command=message|content=<Message Content>
Commande Picture File :
command=picture|path=<Picture Path>|size=<Picture Size>|content=<Picture Content>

Ce modèle d’échanges peut être étendu pour supporter de nouveaux scénarios de type compagnon où une commande pourrait transporter un fichier audio, un fichier vidéo, un évènement de type appuie d’une touche clavier , …
clip_image062_thumb[1]

Générer les applications avec Visual Studio 2013

Pour générer l’application serveur Bluetooth pour Windows Store et l’application client Bluetooth pour Windows Phone, assurez-vous d’avoir: 
1. un ordinateur supportant Windows 8.1
2. un smart phone supportant Windows Phone 8 
3. Visual Studio 2013,
4. Windows Phone 8 SDK.

Explorer le projet de l’application  Windows Store

Le projet de l’application Windows Store est un projet XAML/C#. 
                                 clip_image064_thumb[1]

  • MainPage.xaml.cs contient le code source de la page principale.
  • App.xaml.cs contient le code source de la classe App.
  • WindowsBluetoothRfcommServer.cs contient l’implémentation de la classe WindowsBluetoothRfcommServer.
  • ApplicationConfiguration.cs contient le code source utilisé pour sauvegarder et restaurer les paramètres de l’application.

         Code source partagé entre l’application Windows et l’application Windows Phone

  • BluetoothService.cs contient le Service ID utiliser pour la communication Bluetooth et identification des applications.
  • BluetoothServer.cs contient la définition de l’interface du serveur Bluetooth.
  • BluetoothDevice.cs contient la définition de la classe BluetoothDevice.
  • BluetoothCommand.cs contient la définition des classes BluetoothCommand, BluetoothCommandMessage, et BluetoothCommandPicture.

    Les états du serveur Bluetooth:

                                                image_thumb[3]

WindowsBluetoothRfcommServer méthode Initialization:
Cette méthode crée RfcommServiceProvider et vérifie si le Bluetooth est activé sur l’ordinateur

public async Task<BluetoothServerReturnCode> Initialization()
{
    try
    {
        rfcommProvider = await RfcommServiceProvider.CreateAsync(
            RfcommServiceId.FromUuid(_BluetoothServiceUuid));
        if (rfcommProvider != null)
        {
            SetState(BluetoothServerState.Stopped);
            return BluetoothServerReturnCode.Success;
        }
        else
            return BluetoothServerReturnCode.InitError;

    }
    catch (Exception e)
    {
        if ((uint)e.HResult == ERR_BLUETOOTH_OFF)
            return BluetoothServerReturnCode.InitBluetoothOff;
        else if ((uint)e.HResult == ERR_MISSING_CAPS)
            return BluetoothServerReturnCode.InitMissingCaps;
        else if ((uint)e.HResult == ERR_NOT_ADVERTISING)
            return BluetoothServerReturnCode.InitNotAdvertising;

        NotifyLog("Error", "Exception in Initialization - " + e.Message);
        return BluetoothServerReturnCode.InitException;
    }
}

WindowsBluetoothRfcommServer méthode Start:
Cette méthode crée un StreamSocketListener et attend les connexions pour le BluetoothServiceUuid. Elle lance également le Bluetooth Advertising pour le service Rfcomm.

public async Task<BluetoothServerReturnCode> Start()
{
    try
    {
        NotifyLog("Information", "Starting the server...");
        if (rfcommProvider == null)
            rfcommProvider = await RfcommServiceProvider.CreateAsync(
                RfcommServiceId.FromUuid(_BluetoothServiceUuid));

        if (rfcommProvider != null)
        {
            if (socketListener != null)
            {
                socketListener.Dispose();
                socketListener = null;
            }


            // Create a listener for this service and start listening
            socketListener = new StreamSocketListener();
            socketListener.ConnectionReceived += OnConnectionReceived;

            await socketListener.BindServiceNameAsync(rfcommProvider.ServiceId.AsString(),
                SocketProtectionLevel.BluetoothEncryptionAllowNullAuthentication);

            // Set the SDP attributes and start Bluetooth advertising
            DataWriter sdpWriter = new DataWriter();

            // Write the Service Name Attribute.
            sdpWriter.WriteByte(SdpServiceNameAttributeType);

            // The length of the UTF-8 encoded Service Name SDP Attribute.
            sdpWriter.WriteByte((byte)BluetoothServiceDisplayName.Length);

            // The UTF-8 encoded Service Name value.
            sdpWriter.UnicodeEncoding = Windows.Storage.Streams.UnicodeEncoding.Utf8;
            sdpWriter.WriteString(BluetoothServiceDisplayName);

            // Set the SDP Attribute on the RFCOMM Service Provider.
            if(rfcommProvider.SdpRawAttributes.ContainsKey(SdpServiceNameAttributeId))
                rfcommProvider.SdpRawAttributes.Remove(SdpServiceNameAttributeId);
            rfcommProvider.SdpRawAttributes.Add(SdpServiceNameAttributeId, sdpWriter.DetachBuffer());
            // Start Bluetooth advertising
            SetState(BluetoothServerState.Started); 
            rfcommProvider.StartAdvertising(socketListener);
            NotifyLog("Information", "Server Started");
            return BluetoothServerReturnCode.Success;
        }
    }
    catch(Exception e)
    {
        if ((uint)e.HResult == ERR_BLUETOOTH_OFF)
            return BluetoothServerReturnCode.StartBluetoothOff;
        else if ((uint)e.HResult == ERR_MISSING_CAPS)
            return BluetoothServerReturnCode.StartMissingCaps;
        else if ((uint)e.HResult == ERR_NOT_ADVERTISING)
            return BluetoothServerReturnCode.StartNotAdvertising;
        NotifyLog("Error", "Exception in Start - " + e.Message);
        return BluetoothServerReturnCode.StartException;
    }
    return BluetoothServerReturnCode.StartError;
}

WindowsBluetoothRfcommServer méthode OnConnectionReceived:
Cette méthode est appelée quand le serveur reçoit une demande de connexion. Elle sauvegarde les information sur le client Bluetooth. Enfin elle appelle la méthode ReceiveIncommingCommands pour recevoir les commandes Bluetooth.

private void OnConnectionReceived(StreamSocketListener sender, 
    StreamSocketListenerConnectionReceivedEventArgs args)
{
    try
    {
        // Don't need the listener anymore
        socketListener.Dispose();
        socketListener = null;

        socket = args.Socket;
        if((socket!=null) && (socket.Information!=null))
        {
            _connectedDeviceDisplayName = "Remote Address: " + socket.Information.RemoteAddress.DisplayName + " Remote Port: " + socket.Information.RemotePort + " Remote Service: " + socket.Information.RemoteServiceName;
            _connectedDeviceHostName = socket.Information.RemoteHostName.DisplayName;
            _connectedDeviceServiceName = socket.Information.RemoteServiceName;
        }

        SetState(BluetoothServerState.Connected);
        NotifyLog("Information", "Client connected" );

        if (ConnectionReceived != null)
        {
            BluetoothDevice device = new BluetoothDevice(_connectedDeviceHostName,_connectedDeviceServiceName,_connectedDeviceDisplayName);
            ConnectionReceived(this, device);
        }
    }
    catch (Exception e)
    {
        NotifyLog("Error", "Exception in OnConnectionReceived - " + e.Message);
        return;
    }
    ReceiveIncomingCommands();
}


WindowsBluetoothRfcommServer méthode Disconnect:
Cette méthode appelle ForceDisconnect pour déconnecter la connexion en cours, elle crée un nouveau StreamSocketListener et attend les demandes de connexion.

public async Task<BluetoothServerReturnCode> Disconnect()
{
    try
    {
        ForceDisconnect();
        // Create a listener for this service and start listening
        if(socketListener==null)
        {
            socketListener = new StreamSocketListener();
            socketListener.ConnectionReceived += OnConnectionReceived;

            await socketListener.BindServiceNameAsync(rfcommProvider.ServiceId.AsString(),
                SocketProtectionLevel.BluetoothEncryptionAllowNullAuthentication);
        }
        NotifyLog("Information", "Client Disconnected");
      
    }
    catch (Exception e)
    {
        NotifyLog("Error", "Exception in Disconnect - " + e.Message);
        return BluetoothServerReturnCode.DisconnectException;
    }
    finally
    {
        reader = null;
        writer = null;
        socket = null;
    }
    return BluetoothServerReturnCode.Success;
}


WindowsBluetoothRfcommServer méthode Stop:
Si le serveur était connecté, cette méthode appelle la méthode ForceDisconnect pour déconnecter la connexion en cours. Elle stoppe également l’advertising Bluetooth en cours et libère les sockets.

public  BluetoothServerReturnCode Stop()
{
    try
    {
        NotifyLog("Information", "Stopping the server..." );
        if (GetState() == BluetoothServerState.Connected)
        {
            ForceDisconnect();
        }
        SetState(BluetoothServerState.Stopped);
        if (rfcommProvider != null)
        {
            rfcommProvider.StopAdvertising();
            rfcommProvider = null;
        }

        if (socketListener != null)
        {
            socketListener.Dispose();
            socketListener = null;
        }
        NotifyLog("Information", "Server stopped");
    }
    catch (Exception e)
    {
        NotifyLog("Error", "Exception in Stop - " + e.Message);
        return BluetoothServerReturnCode.StopException;
    }
    finally
    {
        rfcommProvider = null;
        socketListener = null;
        writer = null;
        socket = null;
    }
    return BluetoothServerReturnCode.Success;
}

 

L’application Windows et l’application Windows Phone utilisent le même Service Uuid pour permettre une communication entre les deux applications. Pour l’application Windows Store le Service Uuid est défini dans le manifeste de l’application et dans le code source.
La section suivante est ajoutée dans le manifeste de l’application:

<Capabilities>
  <Capability Name="internetClient" />
  <Capability Name="picturesLibrary" />
  <m2:DeviceCapability Name="bluetooth.rfcomm">
    <m2:Device Id="any">
      <m2:Function Type="serviceId:17890000-0068-0069-1532-1992D79BE4D8" />
    </m2:Device>
  </m2:DeviceCapability>
</Capabilities>

Le fichier BluetoothService.cs contient également la déclaration du ServiceID :

public class BluetoothRfcommGlobal
{
   // Service uuid: shared between the bluetooth server (Windows 8 Application) and the bluetoth client (Windows Phone Application)
   public static Guid BluetoothServiceUuid = new Guid("17890000-0068-0069-1532-1992D79BE4D8");
   // Service display name: shared between the bluetooth server (Windows 8 Application) and the bluetoth client (Windows Phone Application)
   public static string BluetoothServiceDisplayName = "My Bluetooth Rfcomm Service";
}


La classe WindowsBluetoothRfcommServer est instanciée dans le constructeur de la classe App.  

public App()
{
    this.InitializeComponent();

    this.Suspending += OnSuspending;
    this.Resuming += OnResuming;
    BluetoothRfcommServer = new WindowsBluetoothRfcommServer(BluetoothServiceUuid, BluetoothServiceDisplayName, ApplicationConfiguration.AutoStart);
}

La classe WindowsBluetoothRfcommServer est Initialisée et démarrée (Méthode Start)  dans la méthode OnNavigatedTo de la MainPage.

// Initialize Blutooth Server to check whether the bluetooth is on
if (((App.Current as App).BluetoothRfcommServer != null) && ((App.Current as App).BluetoothRfcommServer.GetState() == BluetoothServerState.Created))
{
    BluetoothServerReturnCode r = await(App.Current as App).BluetoothRfcommServer.Initialization();
    if ((r == BluetoothServerReturnCode.Success) && ((App.Current as App).BluetoothRfcommServer.AutoStart == true))
    {
        r = await(App.Current as App).BluetoothRfcommServer.Start();
    }
    if (r != BluetoothServerReturnCode.Success)
    {
        if ((r == BluetoothServerReturnCode.InitMissingCaps) || (r == BluetoothServerReturnCode.StartMissingCaps))
        {
            Windows.UI.Popups.MessageDialog messageDialog = new Windows.UI.Popups.MessageDialog("bluetooth.rfcomm Capability missing in the application manifest", "Windows Bluetooth Server");
            await messageDialog.ShowAsync();
        }
        else if ((r == BluetoothServerReturnCode.InitBluetoothOff) || (r == BluetoothServerReturnCode.StartBluetoothOff))
        {
            Windows.UI.Popups.MessageDialog messageDialog = new Windows.UI.Popups.MessageDialog("Bluetooth is off, bluetooth is required to launch the server", "Windows Bluetooth Server");
            await messageDialog.ShowAsync();
        }
        else if (r == BluetoothServerReturnCode.StartNotAdvertising)
        {
            Windows.UI.Popups.MessageDialog messageDialog = new Windows.UI.Popups.MessageDialog("Bluetooth Advertising Error, restart the application", "Windows Bluetooth Server");
            await messageDialog.ShowAsync();
        }
        else
        {
            Windows.UI.Popups.MessageDialog messageDialog = new Windows.UI.Popups.MessageDialog("Error occurs while initializing the server", "Windows Bluetooth Server");
            await messageDialog.ShowAsync();
        }
    }
}

Dès que la classe WindowsBluetoothRfcommServer est dans l’état “started”, elle peut recevoir les demandes de connexion en provenance des applications Bluetooth. Quand l’application est connectée avec un client Bluetooth, la classe WindowsBluetoothRfcommServer appelle la méthode WindowsBluetoothRfcomm_ConnectionReceived.

void BluetoothRfcommServer_ConnectionReceived(IBluetoothServer sender, BluetoothDevice args)
{
    ClearMessage();
    AddLog("Connected with " + (App.Current as App).BluetoothRfcommServer.ConnectedDeviceDisplayName);
}


Quand la classe WindowsBluetoothRfcommServer est dans l’état “connected”, elle peut recevoir et transmettre des commandes Bluetouth. Quand elle reçoit une commande la classe WindowsBluetoothRfcommServer appelle la méthode BluetoothRfcommServer_CommandReceived.

void BluetoothRfcommServer_CommandReceived(IBluetoothServer sender, BluetoothCommand args)
 {
     AddLog("Command received " + args.ToString());
     
     if (args.GetType() == typeof(BluetoothCommandMessage))
     {
         BluetoothCommandMessage bm = args as BluetoothCommandMessage;
         if(bm!=null)
             AddMessage("Message Received: " + bm.MessageContent);
     }
     else if (args.GetType() == typeof(BluetoothCommandPicture))
     {
         RunOnDispatcherThread(() =>
         {
             BluetoothCommandPicture bp = args as BluetoothCommandPicture;
             if (bp != null)
             {
                 DisplayImage(bp.PictureContent);
                 if (bp.PictureContent.Length > 0)
                 {
                     _ImageBuffer = new byte[bp.PictureSize];
                     if (_ImageBuffer != null)
                         Array.Copy(bp.PictureContent, _ImageBuffer, bp.PictureContent.Length);
                 }
             }
         }); 

     }
 }

Explorer le projet de l’application  Windows Phone 8

Le projet de l’application Windows Phone est un projet XAML/C#. 
                                          clip_image066_thumb[1]

  • MainPage.xaml.cs contient le code source de la page principale.
  • App.xaml.cs contient l’implémentation de la classe App.
  • WindowsBluetoothRfcommClient.cs contient l’implémentation de la classe WindowsBluetoothRfcommClient.
  • ApplicationConfiguration.cs contient le code source utilisé pour sauvegarder et restaurer les paramètres de l’application.

         Code source partagé entre l’application Windows et l’application Windows Phone

  • BluetoothService.cs contient le Service ID utilisé pour la communication Bluetooth.
  • BluetoothClient.cs contient la définition de l’interface BluetoothClient.
  • BluetoothDevice.cs contient la définition de la classe BluetoothDevice.
  • BluetoothCommand.cs contient la définition des classes BluetoothCommand, BluetoothCommandMessage, BluetoothCommandPicture.


Les états de la classe BluetoothRfcommClient:

                                              image_thumb[1]

WindowsPhoneBluetoothRfcommClient méthode Initialization:
Cette méthode vérifie que l’application ne s’exécute pas dans l’émulateur et le Bluetooth est activé sur le Windows Phone.  

public async Task<BluetoothClientReturnCode> Initialization()
{
    if (Microsoft.Devices.Environment.DeviceType == Microsoft.Devices.DeviceType.Emulator)
    {
        return BluetoothClientReturnCode.InitEmulator;
    }

    try
    {
        PeerFinder.AlternateIdentities["Bluetooth:Paired"] = "";
        var Peers = await PeerFinder.FindAllPeersAsync();
    }
    catch (Exception ex)
    {
        if ((uint)ex.HResult == ERR_BLUETOOTH_OFF)
        {
            return BluetoothClientReturnCode.InitBluetoothOff;
        }
        else if ((uint)ex.HResult == ERR_MISSING_CAPS)
        {
            return BluetoothClientReturnCode.InitMissingCaps;
        }
        else if ((uint)ex.HResult == ERR_NOT_ADVERTISING)
        {
            return BluetoothClientReturnCode.InitNotAdvertising;
        }
        else
        {
            return BluetoothClientReturnCode.InitError;
        }
    }
    finally
    {
        PeerFinder.Stop();
    }
    SetState(BluetoothClientState.Initialized);
    return BluetoothClientReturnCode.Success;

}


WindowsPhoneBluetoothRfcommClient méthode Connect :
Cette méthode crée une StreamSocket utilisée pour établir une connexion avec le serveur Bluetooth. Si la connexion est réussie, les informations sur le serveur Bluetooth sont sauvegardées. Elle appelle ensuite la méthode ReceiveIncommingCommands pour recevoir les commandes Bluetooth. 

public async Task<BluetoothClientReturnCode> Connect(BluetoothDevice device)
{
    NotifyLog("Information", "Connecting Client...");
    if (socket == null)
        socket = new StreamSocket();
    try
    {
        await socket.ConnectAsync(new Windows.Networking.HostName(device.HostName), BluetoothServiceName);
    }
    catch (Exception ex)
    {
        NotifyLog("Error", "Exception in Connect - " + ex.Message);
        return BluetoothClientReturnCode.ConnectError;
    }
    SetState(BluetoothClientState.Connected);

    // Connected no need for advertising anymore
    PeerFinder.Stop();
    _connectedDeviceDisplayName = device.DisplayName;
    _connectedDeviceHostName = device.HostName;
    _connectedDeviceServiceName = BluetoothServiceName;
    NotifyLog("Information", "Client connected");

    // Reception loop
    ReceiveIncomingCommands();

    return BluetoothClientReturnCode.Success;
}


WindowsPhoneBluetoothRfcommClient méthode Disconnect :
Cette méthode libère l’ensemble des ressources utilisées pour la communication Bluetooth (StreamSocket) .

public BluetoothClientReturnCode Disconnect()
{
    try
    {
        NotifyLog("Information", "Disconnecting Client...");
        SetState(BluetoothClientState.Initialized);

        _connectedDeviceDisplayName = "";
        _connectedDeviceHostName = "";
        _connectedDeviceServiceName = "";

        if (socket != null)
        {
            socket.Dispose();
            socket = null;
        }

        if (writer != null)
        {
            writer.DetachStream(); 
            writer.Dispose();
            writer = null;
        }
        if (reader != null)
        {
            
            reader.Dispose();
            reader = null;
        }
        NotifyLog("Information", "Client Disconnected");

    }
    catch (Exception e)
    {
        NotifyLog("Error", "Exception in Disconnect - " + e.Message);
        return BluetoothClientReturnCode.DisconnectException;
    }
    finally
    {
        reader = null;
        writer = null;
        socket = null;
    }
    return BluetoothClientReturnCode.Success;
}


L’application Windows et l’application Windows Phone utilisent le même Service Uuid pour permettre une communication entre les deux applications. Pour l’application Windows Phone le Service Uuid est défini dans le code source dans le fichier BluetoothService.cs.

public class BluetoothRfcommGlobal
{
   // Service uuid: shared between the bluetooth server (Windows 8 Application) and the bluetoth client (Windows Phone Application)
   public static Guid BluetoothServiceUuid = new Guid("17890000-0068-0069-1532-1992D79BE4D8");
   // Service display name: shared between the bluetooth server (Windows 8 Application) and the bluetoth client (Windows Phone Application)
   public static string BluetoothServiceDisplayName = "My Bluetooth Rfcomm Service";
}

La classe WindowsBluetoothRfcommClient est instanciée dans le constructeur de la classe App.

public App()
{
    // Global handler for uncaught exceptions.
    UnhandledException += Application_UnhandledException;

    // Standard XAML initialization
    InitializeComponent();

    // Phone-specific initialization
    InitializePhoneApplication();

    // Language display initialization
    InitializeLanguage();

    // Show graphics profiling information while debugging.
    if (Debugger.IsAttached)
    {
        // Display the current frame rate counters
        Application.Current.Host.Settings.EnableFrameRateCounter = true;

        // Show the areas of the app that are being redrawn in each frame.
        //Application.Current.Host.Settings.EnableRedrawRegions = true;

        // Enable non-production analysis visualization mode,
        // which shows areas of a page that are handed off to GPU with a colored overlay.
        //Application.Current.Host.Settings.EnableCacheVisualization = true;

        // Prevent the screen from turning off while under the debugger by disabling
        // the application's idle detection.
        // Caution:- Use this under debug mode only. Application that disables user idle detection will continue to run
        // and consume battery power when the user is not using the phone.
        PhoneApplicationService.Current.UserIdleDetectionMode = IdleDetectionMode.Disabled;
    }
    // Call BluetoothRfcommClient constructor
    BluetoothRfcommClient = new WindowsPhoneBluetoothRfcommClient(BluetoothServiceUuid, BluetoothServiceDisplayName, ApplicationConfiguration.AutoStart);
}

  
La classe WindowsBluetoothRfcommClient est initialisée dans la méthode OnNavigatedTo de la classe MainPage.  

protected override async void OnNavigatedTo(NavigationEventArgs e)
{
    // Check if BluetoothRfcommClient instance
    if ((App.Current as App).BluetoothRfcommClient == null)
        return;
    // Check BluetoothRfcommClient State
    // If State == BluetoothClientState.Created, the bluetooth client didn't start
    if ((App.Current as App).BluetoothRfcommClient.GetState() == BluetoothClientState.Created)
    {
        BluetoothClientReturnCode r = await(App.Current as App).BluetoothRfcommClient.Initialization();
        if (r != BluetoothClientReturnCode.Success)
        {
            if ((r == BluetoothClientReturnCode.InitMissingCaps) || (r == BluetoothClientReturnCode.StartMissingCaps))
            {
                MessageBox.Show("bluetooth.rfcomm Capability missing in the application manifest", "Windows Phone Bluetooth Client", MessageBoxButton.OK);
            }
            else if ((r == BluetoothClientReturnCode.InitBluetoothOff) || (r == BluetoothClientReturnCode.StartBluetoothOff))
            {
                MessageBox.Show("Bluetooth is off, bluetooth is required to launch the client", "Windows Phone Bluetooth Client", MessageBoxButton.OK);
                {
                    ConnectionSettingsTask connectionSettingsTask = new ConnectionSettingsTask();
                    connectionSettingsTask.ConnectionSettingsType = ConnectionSettingsType.Bluetooth;
                    connectionSettingsTask.Show();
                }
            }
            else if (r == BluetoothClientReturnCode.StartNotAdvertising)
            {
                MessageBox.Show("Bluetooth Advertising Error, restart the application", "Windows Phone Bluetooth Client", MessageBoxButton.OK);
            }
            else
            {
                MessageBox.Show("Error occurs while initializing the client", "Windows Phone Bluetooth Client", MessageBoxButton.OK);
            }
            return;
        }
    }

    // Subscribe to CommandReceived, LogReceived and StateChanged
    (App.Current as App).BluetoothRfcommClient.LogReceived += BluetoothRfcommClient_LogReceived;
    (App.Current as App).BluetoothRfcommClient.CommandReceived += BluetoothRfcommClient_CommandReceived;
    (App.Current as App).BluetoothRfcommClient.StateChanged += BluetoothRfcommClient_StateChanged;

    // Update IsConnected state
    UpdateIsConnectedAndImageLoaded();

    // Fill the list of Paired Devices 
    FillListPairedDevices();

}


Dès que la classe WindowsBluetoothRfcommClient est initialisée, l’utilisateur peut connecter l’application Windows Phone avec l’application sœur s’exécutant sur l’ordinateur Windows 8.1. Dans ce cas, l’application appelle la méthode ButtonConnect_Click.

private async void ButtonConnect_Click(object sender, RoutedEventArgs e)
{
    if ((ListDevices.SelectedIndex >= 0) && (ListDevices.SelectedIndex < ListDevices.Items.Count))
    {
        BluetoothDevice d = ListDevices.Items[ListDevices.SelectedIndex] as BluetoothDevice;
        if(d!=null)
        {
            BluetoothClientReturnCode r = await (App.Current as App).BluetoothRfcommClient.Connect(d);
            if(r == BluetoothClientReturnCode.Success)
            {
                // Start Message loop
                ClearMessage();
                ClearFile();
            }
        }
    };
}

Quand la classe WindowsBluetoothRfcommClient est connectée, elle peut recevoir les commandes Bluetooth, dans ce cas la classe WindowsBluetoothRfcommClient appelle la méthode BluetoothRfcommClient_CommandReceived.

void BluetoothRfcommClient_CommandReceived(IBluetoothClient sender, BluetoothCommand args)
{
    AddLog("Command received " + args.ToString());
    if (args.GetType() == typeof(BluetoothCommandMessage))
    {
        BluetoothCommandMessage bm = args as BluetoothCommandMessage;
        if(bm!=null)
            AddMessage("Message Received: " + bm.MessageContent);
    }
    else if (args.GetType() == typeof(BluetoothCommandPicture))
    {
        BluetoothCommandPicture bp = args as BluetoothCommandPicture;
        if(bp!=null)
            AddFile("File Received: " + bp.PicturePath);
    }
}


Quand la classe WindowsBluetoothRfcommClient est connectée, l’utilisateur peut également transmettre des commandes Bluetooth, dans ce cas l’application appelle la méthode ButtonSend_Click.

private async void ButtonSend_Click(object sender, RoutedEventArgs e)
{
    if (!string.IsNullOrEmpty(Message.Text))
    {
        BluetoothCommandMessage bm = new BluetoothCommandMessage();
        if (bm != null)
        {
            bm.CreateMessageCommand(Message.Text);
            BluetoothClientReturnCode r = await (App.Current as App).BluetoothRfcommClient.SendCommand(bm);
            if (r == BluetoothClientReturnCode.Success)
                AddMessage("Message Sent: " + Message.Text);
        }
    }
}

Télécharger le projet

Téléchargement:                   C# (200 KB)
Prérequis:                              Windows 8.1, Windows Phone 8, Visual Studio 2013, Windows Phone 8 SDK 
Dernière modification:          12/13/2013
Licence:                                 MS-LPL
Technologies:                        Bluetooth, Rfcomm, StreamSocket, PeerFinder, RfcommServiceProvider,
                                              StreamSocketListener, C#, XAML
Thème:                                  Communication Bluetooth entre applications Windows Store et Windows Phone

]]> Windows Store and Windows Phone App-to-App communication over Bluetooth https://docs.microsoft.com/archive/blogs/flecoqui/windows-store-and-windows-phone-app-to-app-communication-over-bluetooth Fri, 13 Dec 2013 06:51:00 GMT https://blogs.msdn.microsoft.com/flecoqui/2013/12/13/windows-store-and-windows-phone-app-to-app-communication-over-bluetooth/ Introduction

This article describes how to create Windows 8.1 and Windows Phone 8 applications supporting App-to-App communication over Bluetooth. With these applications, the user can:
- send and receive text messages
- send pictures (Windows Phone 8 Application)
- receive and save pictures (Windows 8.1 Application)
The Windows Store application is running as a Bluetooth server and the Windows Phone application is running as a Bluetooth client.

In order to successfully support App-to-App communication over Bluetooth, you don’t need any specific peripherals like Wi-Fi router, USB cable. The Windows Phone and the computer or tablet running Windows 8.1 are self-sufficient regarding the Bluetooth communication.

Initially, when I started to write these samples, I wanted to use the PeerFinder API which is available on both platforms, unfortunately I didn't find any way to use this API to allow a communication between a computer running Windows 8.1 and a Windows Phone 8. Finally I decided to use Bluetooth Rfcomm for the communication between both platforms. This approach requires to pair both devices at least one time before launching the applications.

Once you are able to create a Windows Store application and a Windows Phone application talking to each other over Bluetooth, you can bundle a Windows Store application with a Windows Phone application which could be a companion application of the Windows Store application.

To build the sample the Visual Studio 2013, the Windows Phone 8 SDK are required.

Pairing devices

Before launching the applications you need to pair over Bluetooth the Windows Phone and the computer running Windows 8.1.

1. On the computer running Windows 8.1, select ”PC and Devices” settings page. Select “Bluetooth” settings page.
           clip_image002

2. On the Windows Phone, ensure Bluetooth is ON. Select “Bluetooth” settings page and turn on Bluetooth.
                   clip_image004                clip_image006

3. On the computer, select the Windows Phone in the list of the Bluetooth device, and tap on the “Pair” button.
                          clip_image008

4. On the Windows Phone, accept the pair request.
                                               clip_image010

5. On the computer, confirm the pairing.
                              clip_image012

6. On both devices, the peer devices should be displayed as connected.
                               clip_image014
                                                clip_image016

7. The devices are now paired, you can launch the applications on both platforms.

Connecting the applications

1. On the computer running Windows 8.1, launch the Bluetooth Server application.
                                               clip_image018
clip_image020

2. On the Windows Phone, launch the Bluetooth client application.
                                         clip_image022

3. Check in the Settings section that the “Service Name” are the same, it’s mandatory to successfully connect the client application with the server application. The GUID is defined in the application source code and in the Windows 8 application manifest.
        clip_image024              clip_image026

4. On the Windows Phone application navigate to “Connection” pivot. Select the computer name in the list of paired devices and tap on the “Connect” button.
                                                   clip_image028

5. As it’s the first application connection a dialog box appears on the computer running the server application. Allow the Windows application to use your Windows Phone
                       clip_image030

6. Once the connection is accepted on the server side, the client application state is displayed as “Connected”
                                                    clip_image032

7. The server application state is also displayed as “Connected”
                                     clip_image034

8. The applications are now connected, you can exchange text messages and pictures between both applications.

Sending and receiving text messages

1. On the Windows Phone, navigate to the Messages pivot, enter a text and tap on “Send” button.
                       clip_image036              clip_image038

2. You should receive the same message on your application running on Windows 8.1.
                           clip_image040

3. You can also send a message from the Windows application towards the Windows Phone application.
                          clip_image042

4. And receive the message on the Windows Phone.
                                              clip_image044

Sending and receiving pictures

1. On the Windows Phone, navigate to the “Files” pivot, and tap on “Select Picture” button.
                                               clip_image046

2. Navigate among the albums and select the picture you want to send to the Windows Application.
                              clip_image048             clip_image050

3. Once the picture is selected, the path and the size of the picture are displayed on the screen.
                                                               clip_image052

4. Tap on the “Send Picture” button to send the picture.
                                                             clip_image054

5. On the computer screen the picture is displayed in the Files section
                                    clip_image056

6. If you double-tap on the picture, the picture is displayed in full screen. At least you can save the picture on your hard drive if you tap on the “Save Image” button.

                clip_image058        clip_image060

Using Bluetooth Rfcomm for the communication between Windows and Windows Phone applications

Once the connection is established between the Windows Phone application and the Windows application using Windows.Networking.Sockets.StreamSocket, both applications can exchange commands over Bluetooth Rfcomm.
With the current applications, a command can be a text message, a picture.
The syntax associated with a command is the following:

command=<BluetoothCommand>|[[<Attribute0Key>=<Attribute0>]|[<Attribute1Key>=<Attribute1>] ... |[<AttributeNKey>=<AttributeN>]...]]

For instance:
Message Command:
command=message|content=<Message Content>
Picture File Command:
command=picture|path=<Picture Path>|size=<Picture Size>|content=<Picture Content>

This model can be extended to support new companion scenarios, a command could transport Audio files, Video files, keyboard events, …
clip_image062

Building the sample applications

In order to build the Bluetooth server sample application for Windows Store and the Bluetooth client sample application for Windows Phone, make sure you have the basics installed:
1. a computer running Windows 8.1
2. a Windows Phone running Windows Phone 8 
3. Visual Studio 2013,
4. Windows Phone 8 SDK.

Exploring the Windows Store Application project

The Windows Store Application project is a XAML based project. 
                                 clip_image064

  • MainPage.xaml.cs contains the main page source code.
  • App.xaml.cs contains the implementation of the App class.
  • WindowsBluetoothRfcommServer.cs contains the implementation of the WindowsBluetoothRfcommServer class.
  • ApplicationConfiguration.cs contains the source code used to store and retrieve the application settings in the local app store.

         Shared source code between Windows and Windows Phone

  • BluetoothService.cs contains the Service ID used for the Bluetooth Communication.
  • BluetoothServer.cs contains the definition of the Bluetooth Server Interface.
  • BluetoothDevice.cs contains the definition of the BluetoothDevice class.
  • BluetoothCommand.cs contains the definition of the BluetoothCommand, BluetoothCommandMessage, BluetoothCommandPicture classes.

    WindowsBluetoothRfcommServer states: 
     
                                              image

WindowsBluetoothRfcommServer Initialization method:
This method creates the RfcommServiceProvider and check if Bluetooth is not off on the computer

public async Task<BluetoothServerReturnCode> Initialization()
{
    try
    {
        rfcommProvider = await RfcommServiceProvider.CreateAsync(
            RfcommServiceId.FromUuid(_BluetoothServiceUuid));
        if (rfcommProvider != null)
        {
            SetState(BluetoothServerState.Stopped);
            return BluetoothServerReturnCode.Success;
        }
        else
            return BluetoothServerReturnCode.InitError;

    }
    catch (Exception e)
    {
        if ((uint)e.HResult == ERR_BLUETOOTH_OFF)
            return BluetoothServerReturnCode.InitBluetoothOff;
        else if ((uint)e.HResult == ERR_MISSING_CAPS)
            return BluetoothServerReturnCode.InitMissingCaps;
        else if ((uint)e.HResult == ERR_NOT_ADVERTISING)
            return BluetoothServerReturnCode.InitNotAdvertising;

        NotifyLog("Error", "Exception in Initialization - " + e.Message);
        return BluetoothServerReturnCode.InitException;
    }
}

WindowsBluetoothRfcommServer Start method:
This method creates a listener and start listening. It also starts advertising for the Rfcomm Service.

public async Task<BluetoothServerReturnCode> Start()
{
    try
    {
        NotifyLog("Information", "Starting the server...");
        if (rfcommProvider == null)
            rfcommProvider = await RfcommServiceProvider.CreateAsync(
                RfcommServiceId.FromUuid(_BluetoothServiceUuid));

        if (rfcommProvider != null)
        {
            if (socketListener != null)
            {
                socketListener.Dispose();
                socketListener = null;
            }


            // Create a listener for this service and start listening
            socketListener = new StreamSocketListener();
            socketListener.ConnectionReceived += OnConnectionReceived;

            await socketListener.BindServiceNameAsync(rfcommProvider.ServiceId.AsString(),
                SocketProtectionLevel.BluetoothEncryptionAllowNullAuthentication);

            // Set the SDP attributes and start Bluetooth advertising
            DataWriter sdpWriter = new DataWriter();

            // Write the Service Name Attribute.
            sdpWriter.WriteByte(SdpServiceNameAttributeType);

            // The length of the UTF-8 encoded Service Name SDP Attribute.
            sdpWriter.WriteByte((byte)BluetoothServiceDisplayName.Length);

            // The UTF-8 encoded Service Name value.
            sdpWriter.UnicodeEncoding = Windows.Storage.Streams.UnicodeEncoding.Utf8;
            sdpWriter.WriteString(BluetoothServiceDisplayName);

            // Set the SDP Attribute on the RFCOMM Service Provider.
            if(rfcommProvider.SdpRawAttributes.ContainsKey(SdpServiceNameAttributeId))
                rfcommProvider.SdpRawAttributes.Remove(SdpServiceNameAttributeId);
            rfcommProvider.SdpRawAttributes.Add(SdpServiceNameAttributeId, sdpWriter.DetachBuffer());
            // Start Bluetooth advertising
            SetState(BluetoothServerState.Started); 
            rfcommProvider.StartAdvertising(socketListener);
            NotifyLog("Information", "Server Started");
            return BluetoothServerReturnCode.Success;
        }
    }
    catch(Exception e)
    {
        if ((uint)e.HResult == ERR_BLUETOOTH_OFF)
            return BluetoothServerReturnCode.StartBluetoothOff;
        else if ((uint)e.HResult == ERR_MISSING_CAPS)
            return BluetoothServerReturnCode.StartMissingCaps;
        else if ((uint)e.HResult == ERR_NOT_ADVERTISING)
            return BluetoothServerReturnCode.StartNotAdvertising;
        NotifyLog("Error", "Exception in Start - " + e.Message);
        return BluetoothServerReturnCode.StartException;
    }
    return BluetoothServerReturnCode.StartError;
}

WindowsBluetoothRfcommServer OnConnectionReceived method:
This method is called when the server receives a connection request. It saves the information of the Bluetooth Client device. At least, it calls the method ReceiveIncommingCommands to receive commands.

private void OnConnectionReceived(StreamSocketListener sender, 
    StreamSocketListenerConnectionReceivedEventArgs args)
{
    try
    {
        // Don't need the listener anymore
        socketListener.Dispose();
        socketListener = null;

        socket = args.Socket;
        if((socket!=null) && (socket.Information!=null))
        {
            _connectedDeviceDisplayName = "Remote Address: " + socket.Information.RemoteAddress.DisplayName + " Remote Port: " + socket.Information.RemotePort + " Remote Service: " + socket.Information.RemoteServiceName;
            _connectedDeviceHostName = socket.Information.RemoteHostName.DisplayName;
            _connectedDeviceServiceName = socket.Information.RemoteServiceName;
        }

        SetState(BluetoothServerState.Connected);
        NotifyLog("Information", "Client connected" );

        if (ConnectionReceived != null)
        {
            BluetoothDevice device = new BluetoothDevice(_connectedDeviceHostName,_connectedDeviceServiceName,_connectedDeviceDisplayName);
            ConnectionReceived(this, device);
        }
    }
    catch (Exception e)
    {
        NotifyLog("Error", "Exception in OnConnectionReceived - " + e.Message);
        return;
    }
    ReceiveIncomingCommands();
}


WindowsBluetoothRfcommServer Disconnect method:
This method calls ForceDisconnect to disconnect the current connection, it creates a new listener and start listening for the next connection.

public async Task<BluetoothServerReturnCode> Disconnect()
{
    try
    {
        ForceDisconnect();
        // Create a listener for this service and start listening
        if(socketListener==null)
        {
            socketListener = new StreamSocketListener();
            socketListener.ConnectionReceived += OnConnectionReceived;

            await socketListener.BindServiceNameAsync(rfcommProvider.ServiceId.AsString(),
                SocketProtectionLevel.BluetoothEncryptionAllowNullAuthentication);
        }
        NotifyLog("Information", "Client Disconnected");
      
    }
    catch (Exception e)
    {
        NotifyLog("Error", "Exception in Disconnect - " + e.Message);
        return BluetoothServerReturnCode.DisconnectException;
    }
    finally
    {
        reader = null;
        writer = null;
        socket = null;
    }
    return BluetoothServerReturnCode.Success;
}


WindowsBluetoothRfcommServer Stop method:
IF the server was connected this method call ForceDisconnect to disconnect the current connection, it stops Bluetooth advertising and clears all the sockets.

public  BluetoothServerReturnCode Stop()
{
    try
    {
        NotifyLog("Information", "Stopping the server..." );
        if (GetState() == BluetoothServerState.Connected)
        {
            ForceDisconnect();
        }
        SetState(BluetoothServerState.Stopped);
        if (rfcommProvider != null)
        {
            rfcommProvider.StopAdvertising();
            rfcommProvider = null;
        }

        if (socketListener != null)
        {
            socketListener.Dispose();
            socketListener = null;
        }
        NotifyLog("Information", "Server stopped");
    }
    catch (Exception e)
    {
        NotifyLog("Error", "Exception in Stop - " + e.Message);
        return BluetoothServerReturnCode.StopException;
    }
    finally
    {
        rfcommProvider = null;
        socketListener = null;
        writer = null;
        socket = null;
    }
    return BluetoothServerReturnCode.Success;
}



The Windows Application and the Windows Phone Application use the same Service Uuid to enable the communication between both applications. For the Windows Store application the Service Uuid is defined in the application manifest and in the source code.
The following section is added in the Capabilities of the manifest:

<Capabilities>
  <Capability Name="internetClient" />
  <Capability Name="picturesLibrary" />
  <m2:DeviceCapability Name="bluetooth.rfcomm">
    <m2:Device Id="any">
      <m2:Function Type="serviceId:17890000-0068-0069-1532-1992D79BE4D8" />
    </m2:Device>
  </m2:DeviceCapability>
</Capabilities>

The file BluetoothService.cs contains the declaration of the ServiceID as well:

public class BluetoothRfcommGlobal
{
   // Service uuid: shared between the bluetooth server (Windows 8 Application) and the bluetoth client (Windows Phone Application)
   public static Guid BluetoothServiceUuid = new Guid("17890000-0068-0069-1532-1992D79BE4D8");
   // Service display name: shared between the bluetooth server (Windows 8 Application) and the bluetoth client (Windows Phone Application)
   public static string BluetoothServiceDisplayName = "My Bluetooth Rfcomm Service";
}


The WindowsBluetoothRfcommServer is instantiated in the App constructor. 

public App()
{
    this.InitializeComponent();

    this.Suspending += OnSuspending;
    this.Resuming += OnResuming;
    BluetoothRfcommServer = new WindowsBluetoothRfcommServer(BluetoothServiceUuid, BluetoothServiceDisplayName, ApplicationConfiguration.AutoStart);
}

The WindowsBluetoothRfcommServer is Initialized and Started in the method OnNavigatedTo of MainPage class.

// Initialize Blutooth Server to check whether the bluetooth is on
if (((App.Current as App).BluetoothRfcommServer != null) && ((App.Current as App).BluetoothRfcommServer.GetState() == BluetoothServerState.Created))
{
    BluetoothServerReturnCode r = await(App.Current as App).BluetoothRfcommServer.Initialization();
    if ((r == BluetoothServerReturnCode.Success) && ((App.Current as App).BluetoothRfcommServer.AutoStart == true))
    {
        r = await(App.Current as App).BluetoothRfcommServer.Start();
    }
    if (r != BluetoothServerReturnCode.Success)
    {
        if ((r == BluetoothServerReturnCode.InitMissingCaps) || (r == BluetoothServerReturnCode.StartMissingCaps))
        {
            Windows.UI.Popups.MessageDialog messageDialog = new Windows.UI.Popups.MessageDialog("bluetooth.rfcomm Capability missing in the application manifest", "Windows Bluetooth Server");
            await messageDialog.ShowAsync();
        }
        else if ((r == BluetoothServerReturnCode.InitBluetoothOff) || (r == BluetoothServerReturnCode.StartBluetoothOff))
        {
            Windows.UI.Popups.MessageDialog messageDialog = new Windows.UI.Popups.MessageDialog("Bluetooth is off, bluetooth is required to launch the server", "Windows Bluetooth Server");
            await messageDialog.ShowAsync();
        }
        else if (r == BluetoothServerReturnCode.StartNotAdvertising)
        {
            Windows.UI.Popups.MessageDialog messageDialog = new Windows.UI.Popups.MessageDialog("Bluetooth Advertising Error, restart the application", "Windows Bluetooth Server");
            await messageDialog.ShowAsync();
        }
        else
        {
            Windows.UI.Popups.MessageDialog messageDialog = new Windows.UI.Popups.MessageDialog("Error occurs while initializing the server", "Windows Bluetooth Server");
            await messageDialog.ShowAsync();
        }
    }
}

Once the WindowsBluetoothRfcommServer is started, it’s waiting for incoming connection requests from client devices. When the application is connected, the WindowsBluetoothRfcommServer calls the method WindowsBluetoothRfcomm_ConnectionReceived.

void BluetoothRfcommServer_ConnectionReceived(IBluetoothServer sender, BluetoothDevice args)
{
    ClearMessage();
    AddLog("Connected with " + (App.Current as App).BluetoothRfcommServer.ConnectedDeviceDisplayName);
}


When the WindowsBluetoothRfcommServer is connected, it can receive Bluetooth commands, in that case the WindowsBluetoothRfcommServer calls the method BluetoothRfcommServer_CommandReceived.

void BluetoothRfcommServer_CommandReceived(IBluetoothServer sender, BluetoothCommand args)
 {
     AddLog("Command received " + args.ToString());
     
     if (args.GetType() == typeof(BluetoothCommandMessage))
     {
         BluetoothCommandMessage bm = args as BluetoothCommandMessage;
         if(bm!=null)
             AddMessage("Message Received: " + bm.MessageContent);
     }
     else if (args.GetType() == typeof(BluetoothCommandPicture))
     {
         RunOnDispatcherThread(() =>
         {
             BluetoothCommandPicture bp = args as BluetoothCommandPicture;
             if (bp != null)
             {
                 DisplayImage(bp.PictureContent);
                 if (bp.PictureContent.Length > 0)
                 {
                     _ImageBuffer = new byte[bp.PictureSize];
                     if (_ImageBuffer != null)
                         Array.Copy(bp.PictureContent, _ImageBuffer, bp.PictureContent.Length);
                 }
             }
         }); 

     }
 }

Exploring the Windows Phone 8 Application project

The Windows Phone 8 Application project is a XAML based project. 
                                          clip_image066

  • MainPage.xaml.cs contains the main page source code.
  • App.xaml.cs contains the implementation of the App class.
  • WindowsBluetoothRfcommClient.cs contains the implementation of the WindowsBluetoothRfcommClient class.
  • ApplicationConfiguration.cs contains the source code used to store and retrieve the application settings in the local app store.

         Shared source code between Windows and Windows Phone

  • BluetoothService.cs contains the Service ID used for the Bluetooth Communication.
  • BluetoothClient.cs contains the definition of the Bluetooth Client Interface.
  • BluetoothDevice.cs contains the definition of the BluetoothDevice class.
  • BluetoothCommand.cs contains the definition of the BluetoothCommand, BluetoothCommandMessage, BluetoothCommandPicture classes.


BluetoothRfcommClient states:

                                              image

WindowsPhoneBluetoothRfcommClient Initialization method:
This method checks if  the application is not running in the Windows Phone Emulator, it also checks if Bluetooth is not off on the Windows Phone.  

public async Task<BluetoothClientReturnCode> Initialization()
{
    if (Microsoft.Devices.Environment.DeviceType == Microsoft.Devices.DeviceType.Emulator)
    {
        return BluetoothClientReturnCode.InitEmulator;
    }

    try
    {
        PeerFinder.AlternateIdentities["Bluetooth:Paired"] = "";
        var Peers = await PeerFinder.FindAllPeersAsync();
    }
    catch (Exception ex)
    {
        if ((uint)ex.HResult == ERR_BLUETOOTH_OFF)
        {
            return BluetoothClientReturnCode.InitBluetoothOff;
        }
        else if ((uint)ex.HResult == ERR_MISSING_CAPS)
        {
            return BluetoothClientReturnCode.InitMissingCaps;
        }
        else if ((uint)ex.HResult == ERR_NOT_ADVERTISING)
        {
            return BluetoothClientReturnCode.InitNotAdvertising;
        }
        else
        {
            return BluetoothClientReturnCode.InitError;
        }
    }
    finally
    {
        PeerFinder.Stop();
    }
    SetState(BluetoothClientState.Initialized);
    return BluetoothClientReturnCode.Success;

}


WindowsPhoneBluetoothRfcommClient Connect method:
This method creates a StreamSocket used to create a connection with the Bluetooth Device. If the connection is sucessful, It saves the information of the Bluetooth Server device. At least it calls the method ReceiveIncommingCommands to receive commands. 

public async Task<BluetoothClientReturnCode> Connect(BluetoothDevice device)
{
    NotifyLog("Information", "Connecting Client...");
    if (socket == null)
        socket = new StreamSocket();
    try
    {
        await socket.ConnectAsync(new Windows.Networking.HostName(device.HostName), BluetoothServiceName);
    }
    catch (Exception ex)
    {
        NotifyLog("Error", "Exception in Connect - " + ex.Message);
        return BluetoothClientReturnCode.ConnectError;
    }
    SetState(BluetoothClientState.Connected);

    // Connected no need for advertising anymore
    PeerFinder.Stop();
    _connectedDeviceDisplayName = device.DisplayName;
    _connectedDeviceHostName = device.HostName;
    _connectedDeviceServiceName = BluetoothServiceName;
    NotifyLog("Information", "Client connected");

    // Reception loop
    ReceiveIncomingCommands();

    return BluetoothClientReturnCode.Success;
}


WindowsPhoneBluetoothRfcommClient Disconnect method:
This method clears the StreamSocket to disconnect the current connection.

public BluetoothClientReturnCode Disconnect()
{
    try
    {
        NotifyLog("Information", "Disconnecting Client...");
        SetState(BluetoothClientState.Initialized);

        _connectedDeviceDisplayName = "";
        _connectedDeviceHostName = "";
        _connectedDeviceServiceName = "";

        if (socket != null)
        {
            socket.Dispose();
            socket = null;
        }

        if (writer != null)
        {
            writer.DetachStream(); 
            writer.Dispose();
            writer = null;
        }
        if (reader != null)
        {
            
            reader.Dispose();
            reader = null;
        }
        NotifyLog("Information", "Client Disconnected");

    }
    catch (Exception e)
    {
        NotifyLog("Error", "Exception in Disconnect - " + e.Message);
        return BluetoothClientReturnCode.DisconnectException;
    }
    finally
    {
        reader = null;
        writer = null;
        socket = null;
    }
    return BluetoothClientReturnCode.Success;
}


The Windows Application and the Windows Phone Application use the same Service Uuid to enable the communication between both applications. For the Windows Phone application the Service Uuid is defined in the source code in the file BluetoothService.cs which contains the declaration of the ServiceID as well:

public class BluetoothRfcommGlobal
{
   // Service uuid: shared between the bluetooth server (Windows 8 Application) and the bluetoth client (Windows Phone Application)
   public static Guid BluetoothServiceUuid = new Guid("17890000-0068-0069-1532-1992D79BE4D8");
   // Service display name: shared between the bluetooth server (Windows 8 Application) and the bluetoth client (Windows Phone Application)
   public static string BluetoothServiceDisplayName = "My Bluetooth Rfcomm Service";
}

The WindowsBluetoothRfcommClient is instantiated in the App constructor.

public App()
{
    // Global handler for uncaught exceptions.
    UnhandledException += Application_UnhandledException;

    // Standard XAML initialization
    InitializeComponent();

    // Phone-specific initialization
    InitializePhoneApplication();

    // Language display initialization
    InitializeLanguage();

    // Show graphics profiling information while debugging.
    if (Debugger.IsAttached)
    {
        // Display the current frame rate counters
        Application.Current.Host.Settings.EnableFrameRateCounter = true;

        // Show the areas of the app that are being redrawn in each frame.
        //Application.Current.Host.Settings.EnableRedrawRegions = true;

        // Enable non-production analysis visualization mode,
        // which shows areas of a page that are handed off to GPU with a colored overlay.
        //Application.Current.Host.Settings.EnableCacheVisualization = true;

        // Prevent the screen from turning off while under the debugger by disabling
        // the application's idle detection.
        // Caution:- Use this under debug mode only. Application that disables user idle detection will continue to run
        // and consume battery power when the user is not using the phone.
        PhoneApplicationService.Current.UserIdleDetectionMode = IdleDetectionMode.Disabled;
    }
    // Call BluetoothRfcommClient constructor
    BluetoothRfcommClient = new WindowsPhoneBluetoothRfcommClient(BluetoothServiceUuid, BluetoothServiceDisplayName, ApplicationConfiguration.AutoStart);
}

  
The WindowsBluetoothRfcommClient is Initialized in the method OnNavigatedTo of MainPage class. 

protected override async void OnNavigatedTo(NavigationEventArgs e)
{
    // Check if BluetoothRfcommClient instance
    if ((App.Current as App).BluetoothRfcommClient == null)
        return;
    // Check BluetoothRfcommClient State
    // If State == BluetoothClientState.Created, the bluetooth client didn't start
    if ((App.Current as App).BluetoothRfcommClient.GetState() == BluetoothClientState.Created)
    {
        BluetoothClientReturnCode r = await(App.Current as App).BluetoothRfcommClient.Initialization();
        if (r != BluetoothClientReturnCode.Success)
        {
            if ((r == BluetoothClientReturnCode.InitMissingCaps) || (r == BluetoothClientReturnCode.StartMissingCaps))
            {
                MessageBox.Show("bluetooth.rfcomm Capability missing in the application manifest", "Windows Phone Bluetooth Client", MessageBoxButton.OK);
            }
            else if ((r == BluetoothClientReturnCode.InitBluetoothOff) || (r == BluetoothClientReturnCode.StartBluetoothOff))
            {
                MessageBox.Show("Bluetooth is off, bluetooth is required to launch the client", "Windows Phone Bluetooth Client", MessageBoxButton.OK);
                {
                    ConnectionSettingsTask connectionSettingsTask = new ConnectionSettingsTask();
                    connectionSettingsTask.ConnectionSettingsType = ConnectionSettingsType.Bluetooth;
                    connectionSettingsTask.Show();
                }
            }
            else if (r == BluetoothClientReturnCode.StartNotAdvertising)
            {
                MessageBox.Show("Bluetooth Advertising Error, restart the application", "Windows Phone Bluetooth Client", MessageBoxButton.OK);
            }
            else
            {
                MessageBox.Show("Error occurs while initializing the client", "Windows Phone Bluetooth Client", MessageBoxButton.OK);
            }
            return;
        }
    }

    // Subscribe to CommandReceived, LogReceived and StateChanged
    (App.Current as App).BluetoothRfcommClient.LogReceived += BluetoothRfcommClient_LogReceived;
    (App.Current as App).BluetoothRfcommClient.CommandReceived += BluetoothRfcommClient_CommandReceived;
    (App.Current as App).BluetoothRfcommClient.StateChanged += BluetoothRfcommClient_StateChanged;

    // Update IsConnected state
    UpdateIsConnectedAndImageLoaded();

    // Fill the list of Paired Devices 
    FillListPairedDevices();

}


Once the WindowsBluetoothRfcommClient is initialized, the user can connect the application with the service running on a device running Windows 8.1 in that case the application calls the method ButtonConnect_Click.

private async void ButtonConnect_Click(object sender, RoutedEventArgs e)
{
    if ((ListDevices.SelectedIndex >= 0) && (ListDevices.SelectedIndex < ListDevices.Items.Count))
    {
        BluetoothDevice d = ListDevices.Items[ListDevices.SelectedIndex] as BluetoothDevice;
        if(d!=null)
        {
            BluetoothClientReturnCode r = await (App.Current as App).BluetoothRfcommClient.Connect(d);
            if(r == BluetoothClientReturnCode.Success)
            {
                // Start Message loop
                ClearMessage();
                ClearFile();
            }
        }
    };
}



When the WindowsBluetoothRfcommClient is connected, it can receive Bluetooth commands, in that case the WindowsBluetoothRfcommClient calls the method BluetoothRfcommClient_CommandReceived.

void BluetoothRfcommClient_CommandReceived(IBluetoothClient sender, BluetoothCommand args)
{
    AddLog("Command received " + args.ToString());
    if (args.GetType() == typeof(BluetoothCommandMessage))
    {
        BluetoothCommandMessage bm = args as BluetoothCommandMessage;
        if(bm!=null)
            AddMessage("Message Received: " + bm.MessageContent);
    }
    else if (args.GetType() == typeof(BluetoothCommandPicture))
    {
        BluetoothCommandPicture bp = args as BluetoothCommandPicture;
        if(bp!=null)
            AddFile("File Received: " + bp.PicturePath);
    }
}


When the WindowsBluetoothRfcommClient is connected, the user can send Bluetooth commands as well, in that case the application calls the method ButtonSend_Click.

private async void ButtonSend_Click(object sender, RoutedEventArgs e)
{
    if (!string.IsNullOrEmpty(Message.Text))
    {
        BluetoothCommandMessage bm = new BluetoothCommandMessage();
        if (bm != null)
        {
            bm.CreateMessageCommand(Message.Text);
            BluetoothClientReturnCode r = await (App.Current as App).BluetoothRfcommClient.SendCommand(bm);
            if (r == BluetoothClientReturnCode.Success)
                AddMessage("Message Sent: " + Message.Text);
        }
    }
}

Downloading the projects

Download:        C# (200 KB)
Requires:           Windows 8.1, Windows Phone 8, Visual Studio 2013, Windows Phone 8 SDK
Last updated:    12/13/2013
License:              MS-LPL
Technologies:    Bluetooth, Rfcomm, StreamSocket, PeerFinder, C#, XAML
Topics:               Windows Store and Windows Phone App-to-App communication over Bluetooth

]]> Application de lecture Audio/Vidéo pour Windows 8 et Windows Phone 8 utilisant les services de la classe HttpClient pour l’acquisition de la licence PlayReady https://docs.microsoft.com/archive/blogs/flecoqui/application-de-lecture-audiovido-pour-windows-8-et-windows-phone-8-utilisant-les-services-de-la-classe-httpclient-pour-lacquisition-de-la-licence-playready Fri, 18 Oct 2013 06:30:00 GMT https://blogs.msdn.microsoft.com/flecoqui/2013/10/18/application-de-lecture-audiovido-pour-windows-8-et-windows-phone-8-utilisant-les-services-de-la-classe-httpclient-pour-lacquisition-de-la-licence-playready/ Introduction

Cet article décrit comment créer des applications Windows 8 et Windows Phone 8 capables de jouer des vidéos Smooth Streaming protégées par PlayReady.  Avec les exemples d’application fournis avec cet article l’utilisateur peut définir:
- l’URL de la vidéo Smooth Streaming,
- l’URL utilisée pour l’acquisition de la licence PlayReady,
- le « Challenge Custom Data » transmis au serveur PlayReady pour acquérir la licence PlayReady.
Si l’URL utilisée pour l’acquisition de licence n’est pas définie, l’application utilisera l’URL inclue dans l’en-tête de protection PlayReady du manifeste de la vidéo.
                                                                    clip_image002

                                     clip_image004

Les étapes pour l’acquisition d’une licence PlayReady pour les applications du Windows Store:

Avant de décrire comment le client PlayReady acquiert la licence PlayReady, quelques mots sur le mécanisme d’individualisation. Chaque client PlayReady est associé à un unique certificat et à une clé unique, l’installation de ce certificat et de cette clé s’appelle l’individualisation.
De plus avant que le client PlayReady ne demande une licence pour décrypter le contenu, il doit d’abord déterminer si le logiciel PlayReady ad hoc est installé sur l’ordinateur de l’utilisateur. Ce logiciel est appelé “Individualized Black boX” (appelé aussi IBX) et est le composant PlayReady client nécessaire pour pouvoir jouer des contenus protégés par PlayReady. Ce composant logiciel permet à l’application cliente de demander et d’utiliser une licence PlayReady.
Le client PlayReady pour les applications du Windows Store supporte l’individualisation dynamique: l’IBX est télélchargé depuis le serveur d’individualisation. Dans votre application Windows Store vous pouvez implémenter une demande d’individualisation réactive ou une demande d’individualisation pro-active.

  • · La demande pro-active d’individualisation peut être transmise après l’installation de l’application ou quand l’utilisateur lance l’application pour la première fois.
  • · La demande réactive d’individualisation est automatiquement préparée par le client PlayReady quand l’application est sur le point de jouer un contenu protégé par PlayReady et si l’IBX n’est pas déjà installé sur l’ordinateur.

Le schéma ci-dessous décrit l’acquisition d’une licence PlayReady pour jouer un contenu protégé par PlayReady avec la transmission d’une requête réactive d’individualisation préalable: 
clip_image006

Le schéma ci-dessous décrit l’acquisition d’une licence PlayReady pour jouer un contenu protégé par PlayReady sans transmission d’une requête d’individualisation comme l’IBX est déjà installé: 
clip_image008

Le schéma ci-dessous décrit les échanges entre le client et le serveur quand l’application joue un contenu protégé par PlayReady quand l’IBX est déjà installé et la licence PlayReady déjà acquise: 
clip_image010

Librairie Http Client:


Les exemples d’application PlayReady fournis avec cet article sont basés sur Player Framework V1.2 et l’acquisition des licences PlayReady est basée sur la classe HttpClient pour les deux plates-formes Windows et Windows Phone.  
HttpClient fait partie intégrante de NET Framework 4.5 et des applications Windows Store et fournit aux développeurs la possibilité d’écrire très facilement des applications se connectant à des services Internet incluant les services basés sur des APIs REST. HttpClient est maintenant disponible pour les développeurs Windows Phone si vous installez le package Nuget : « Microsoft http Client Libraries »
clip_image012

Générer les exemples d’application

Pour générer les exemples d’application PlayReady pour Windows Store et Windows Phone vous devez disposer:
1. d’un ordinateur sous Windows 8,
2. du Visual Studio 2012,
3. du Windows Phone 8 SDK.

Pour générer l’application pour Windows Store vous devez installer:
1. Le Smooth Streaming Client SDK for Windows 8
2. Le PlayReady Client SDK for Windows Store Apps
3. Le Player Framework for Windows 8 and Windows Phone 8 (v1.2).

Pour générer l’application pour Windows Phone vous devez installer:
1. Le Microsoft Smooth Streaming Client 2.0 RTW
2. Le Player Framework for Windows 8 and Windows Phone 8 (v1.2).
L’application pour Windows Phone 8 est livrée avec les packages Nuget suivants:
1. Microsoft HTTP Client Libraries: Microsof.Net.Http 
2. Microsoft BCL Portability Pack: Microsoft.BCL
3. Microsoft BCL Build Components: Microsoft.BCL.Build

Installer le Microsoft Smooth Streaming Client SDK pour Windows 8

1. Téléchargez le SDK client Smooth Streaming depuis ce lien:
http://visualstudiogallery.msdn.microsoft.com/04423d13-3b3e-4741-a01c-1ae29e84fea6
2. Double-cliquez sur le fichier VSIX pour lancer l’installation
clip_image014
3. Sur la boîte de dialogue « VSIX Installer » cliquez sur le bouton Install
clip_image016
4. Après quelques secondes, le SDK est installé. Cliquez sur le bouton Close pour fermer la boîte de dialogue « VSIX Installer ».
clip_image018

Installer le Microsoft PlayReady Client SDK for Windows Store Apps

1. Téléchargez le SDK PlayReady Client depuis ce lien:
http://visualstudiogallery.msdn.microsoft.com/e02ccac7-f3eb-4b53-b11a-c657d5631483
2. Double-cliquez sur le fichier VSIX pour lancer l’installation
clip_image020
3. Sur la boîte de dialogue « VSIX Installer » cliquez sur le bouton Install
clip_image022
4. Après quelques secondes, le SDK est installé. Cliquez sur le bouton Close pour fermer la boîte de dialogue « VSIX Installer ».
clip_image024

Installer le Microsoft Smooth Streaming Client 2.0 RTW

1. Téléchargez le SDK Smooth Streaming Client depuis ce ligne:
http://www.microsoft.com/en-us/download/details.aspx?id=29940
2. Double-cliquez sur le fichier MSI pour lancer l’installation
clip_image026
3. Sur la boîte de dialogue « Microsoft Smooth Streaming Client 2.0 Setup » cliquez sur le bouton Next
clip_image028
4. Sur la boîte de dialogue « Microsoft Smooth Streaming Client 2.0 Setup » cliquez sur le bouton Next
clip_image030
5. Sur la boîte de dialogue « Microsoft Smooth Streaming Client 2.0 Setup » cliquez sur le bouton Next
clip_image032
6. Sur la boîte de dialogue « Microsoft Smooth Streaming Client 2.0 Setup » cliquez sur le bouton Install
clip_image034
7. Sur la boîte de dialogue « Microsoft Smooth Streaming Client 2.0 Setup » cliquez sur le bouton Finish
clip_image036

Installer le Player Framework pour Windows 8 et Windows Phone 8 (v1.2)

1. Téléchargez le Player Framework depuis ce lien:
http://playerframework.codeplex.com/releases/view/105214
2. Double-cliquez sur le fichier VSIX pour lancer l’installation
clip_image038
3. On the VSIX Installer dialog box click on the Install button
clip_image040
4. Après quelques secondes, le SDK est installé. Cliquez sur le bouton Close pour fermer la boîte de dialogue.
clip_image042

Ouvrir et Générer la solution

Dès que les SDKs sont installés, vous pouvez ouvrir le fichier Solution pour générer les applications pour Windows Store et Windows Phone.

1. Démarrez Visual Studio 2012 et sélectionnez File > Open > Project/Solution.

2. Déplacez-vous dans le répertoire dans lequel vous avez décompressé le fichier ZIP et double-cliquez sur le fichier solution Microsoft Visual Studio.
clip_image044

3. Vérifiez qu’il n’y a pas d’avertissement pour les références Windows 8.
clip_image046

4. Vérifiez qu’il n’y a pas d’avertissement pour les références Windows Phone 8.
clip_image048

5. Les deux projets utilisent un code source C# commun pour l’acquisition de la license PlayReady : CommonLicenseRequest.cs
clip_image050

6. Le fichier CommonLicenseRequest.cs a été partagé entre les deux projets en utilisant l’option Add As Link pour l’ajout d’élément existant dans le projet.
clip_image052

7. Appuyez sur F7 ou utilisez Build > Build Solution pour générer les exemples.

Exploration du projet de l’application Windows Store

Le projet de l’application Windows Store est un projet XAML. 

clip_image054

  • MainPage.cs contient le code source de la page principale.
  • CommonLicenseRequest.cs contient le code source de la classe commune utilisant HttpClient pour l’acquisition de la licence PlayReady.
  • ApplicationConfiguration.cs contient le code source pour stocker les paramètres de l’application.

Les événements PlayReady et Smooth Streaming sont enregistrés dans le constructeur de la classe MainPage. 

public MainPage()
{
    this.InitializeComponent();

    // Add Plugins
    Player.Plugins.Add(new Microsoft.PlayerFramework.Adaptive.AdaptivePlugin());

    // Init PlayReady Protection Manager
    var protectionManager = new MediaProtectionManager();
    Windows.Foundation.Collections.PropertySet cpSystems = new Windows.Foundation.Collections.PropertySet();
    cpSystems.Add("{F4637010-03C3-42CD-B932-B48ADF3A6A54}", "Microsoft.Media.PlayReadyClient.PlayReadyWinRTTrustedInput"); //Playready
    protectionManager.Properties.Add("Windows.Media.Protection.MediaProtectionSystemIdMapping", cpSystems);
    protectionManager.Properties.Add("Windows.Media.Protection.MediaProtectionSystemId", "{F4637010-03C3-42CD-B932-B48ADF3A6A54}");
    this.Player.ProtectionManager = protectionManager;
    // PlayReady Events registration
    Player.ProtectionManager.ComponentLoadFailed += ProtectionManager_ComponentLoadFailed;
    Player.ProtectionManager.ServiceRequested += ProtectionManager_ServiceRequested;


    // Init Smooth Streaming Handler
    Windows.Media.MediaExtensionManager extensions = new Windows.Media.MediaExtensionManager();
    extensions.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".ism", "text/xml");
    extensions.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".isml", "text/xml");
    extensions.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".ism", "application/vnd.ms-ss");
    extensions.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".isml", "application/vnd.ms-ss");
    extensions.RegisterSchemeHandler("Microsoft.Media.AdaptiveStreaming.SmoothSchemeHandler", "ms-sstr:");
    Player.MediaExtensionManager = extensions;

La méthode ProtectionManager_ServiceRequested est appelée à chaque demande d’acquisition de licence ou à chaque demande d’invidualisation. S’il s’agit d’une demande d’individualisation la méthode ReactiveIndivRequest est appelée. S’il s’agit d’une demande d’acquisition de licence la méthode LicenseAcquisitionRequest est appelée.    

async void ProtectionManager_ServiceRequested(MediaProtectionManager sender, ServiceRequestedEventArgs srEvent)
{
    LogMessage("ProtectionManager ServiceRequested");
    if (srEvent.Request is PlayReadyIndividualizationServiceRequest)
    {
        PlayReadyIndividualizationServiceRequest IndivRequest = srEvent.Request as PlayReadyIndividualizationServiceRequest;
        bool bResultIndiv = await ReactiveIndivRequest(IndivRequest, srEvent.Completion);
    }
    else if (srEvent.Request is PlayReadyLicenseAcquisitionServiceRequest)
    {
        PlayReadyLicenseAcquisitionServiceRequest licenseRequest = srEvent.Request as PlayReadyLicenseAcquisitionServiceRequest;
        LicenseAcquisitionRequest(licenseRequest, srEvent.Completion, PlayReadyLicenseUrl, PlayReadyChallengeCustomData);
    }
}


Si l’URL utilisée pour l’acquisition de licence PlayReady n’est pas précisée par l’utilisateur, l’application utilisera l’URL définie dans l’entête de protection PlayReady du manifeste de la vidéo, la méthode LicenseAcquisitionRequest appelle licenseRequest.BeginServiceRequest. Si l’URL utilisée pour l’acquisition de licence PlayReady est précisée par l’utilisateur, la méthode LicenseAcquisitionRequest crée un challenge PlayReady en utilisant la valeur du champ ChallengeCustomData et appelle la méthode licenseAcquisition.AcquireLicense en utilisant l’URL définie par l’utilisateur.

/// <summary>
/// Invoked to acquire the PlayReady License
/// </summary>
async void LicenseAcquisitionRequest(PlayReadyLicenseAcquisitionServiceRequest licenseRequest, MediaProtectionServiceCompletion CompletionNotifier, string Url, string ChallengeCustomData)
{
    bool bResult = false;
    string ExceptionMessage = string.Empty;

    try
    {
        if (!string.IsNullOrEmpty(Url))
        {
            LogMessage("ProtectionManager PlayReady Manual License Acquisition Service Request in progress - URL: " + Url);

            if (!string.IsNullOrEmpty(ChallengeCustomData))
            {
                System.Text.UTF8Encoding encoding = new System.Text.UTF8Encoding();
                byte[] b = encoding.GetBytes(ChallengeCustomData);
                licenseRequest.ChallengeCustomData = Convert.ToBase64String(b, 0, b.Length);
            }

            PlayReadySoapMessage soapMessage = licenseRequest.GenerateManualEnablingChallenge(); 
            
            byte[] messageBytes = soapMessage.GetMessageBody();
            HttpContent httpContent = new ByteArrayContent(messageBytes);

            IPropertySet propertySetHeaders = soapMessage.MessageHeaders;
            foreach (string strHeaderName in propertySetHeaders.Keys)
            {
                string strHeaderValue = propertySetHeaders[strHeaderName].ToString();

                // The Add method throws an ArgumentException try to set protected headers like "Content-Type"
                // so set it via "ContentType" property
                if (strHeaderName.Equals("Content-Type", StringComparison.OrdinalIgnoreCase))
                    httpContent.Headers.ContentType = MediaTypeHeaderValue.Parse(strHeaderValue);
                else
                    httpContent.Headers.Add(strHeaderName.ToString(), strHeaderValue);
            }
            CommonLicenseRequest licenseAcquision = new CommonLicenseRequest();
            HttpContent responseHttpContent = await licenseAcquision.AcquireLicense(new Uri(Url), httpContent);
            if (responseHttpContent != null)
            {
                Exception exResult = licenseRequest.ProcessManualEnablingResponse(await responseHttpContent.ReadAsByteArrayAsync());
                if (exResult != null)
                {
                    throw exResult;
                }
                bResult = true;
            }
            else
                ExceptionMessage = licenseAcquision.GetLastErrorMessage();
        }
        else
        {
            LogMessage("ProtectionManager PlayReady License Acquisition Service Request in progress - URL: " + licenseRequest.Uri.ToString());
            await licenseRequest.BeginServiceRequest();
            bResult = true;
        }
    }
    catch (Exception e)
    {
        ExceptionMessage = e.Message;
    }
    
    if (bResult == true)
            LogMessage(!string.IsNullOrEmpty(Url) ? "ProtectionManager Manual PlayReady License Acquisition Service Request successful":
                "ProtectionManager PlayReady License Acquisition Service Request successful");
    else
        LogMessage(!string.IsNullOrEmpty(Url) ? "ProtectionManager Manual PlayReady License Acquisition Service Request failed: "+ExceptionMessage :
            "ProtectionManager PlayReady License Acquisition Service Request failed: " + ExceptionMessage);
    CompletionNotifier.Complete(bResult);
}

The method AcquireLicense sends the PlayReady license Http Request to the PlayReady server. The request contains the PlayReady challenge and add http headers. The method PostAsync of class HttpClient is used to transmit this request.

/// <summary>
 /// Invoked to acquire the PlayReady license.
 /// </summary>
 /// <param name="licenseServerUri">License Server URI to retrieve the PlayReady license.</param>
 /// <param name="httpRequestContent">HttpContent including the Challenge transmitted to the PlayReady server.</param>
 public async virtual Task<HttpContent> AcquireLicense(Uri licenseServerUri, HttpContent httpRequestContent)
 {
     try
     {
         HttpClient httpClient = new HttpClient();
         httpClient.DefaultRequestHeaders.Add("msprdrm_server_redirect_compat", "false");
         httpClient.DefaultRequestHeaders.Add("msprdrm_server_exception_compat", "false");

         HttpResponseMessage response = await httpClient.PostAsync(licenseServerUri, httpRequestContent);
         response.EnsureSuccessStatusCode();

         if (response.StatusCode == HttpStatusCode.OK)
         {
             _lastErrorMessage = string.Empty;
             return response.Content;
         }
         else
         {
             _lastErrorMessage = "AcquireLicense - Http Response Status Code: " + response.StatusCode.ToString();
         }
     }
     catch (Exception exception)
     {
         _lastErrorMessage = exception.Message;
         return null;
     }
     return null;
 }

 

Exploration du projet de l’application Windows Phone 8

Le projet de l’application Windows Phone 8 est un projet XAML. 
clip_image056

  • · MainPage.cs contient le code source de la page principale.
  • · CommonLicenseRequest.cs contient le code source commun pour l’acquisition de la licence PlayReady en utilisant la classe HttpClient.  
  • · ApplicationConfiguration.cs contient le code source utilisé pour stocker et restaurer les paramètres de l’application.    
  • · WindowsPhoneLicenseAcquisition.cs contient le code source de la classe WindowsPhoneLicenseAcquisition dérivée de la classe PlayReady LicenseAcquirer utilisée pour l’acquisition de licence PlayReady.

Dans le constructeur de la page principale, les événements PlayReady sont enregistrés par la classe WindowsPhoneLicenseAcquisition.  

//Add Smooth Streaming and Caption plugins 
Microsoft.PlayerFramework.Adaptive.AdaptivePlugin AP = new Microsoft.PlayerFramework.Adaptive.AdaptivePlugin();
Player.Plugins.Add(AP);
Player.Plugins.Add(new Microsoft.PlayerFramework.TimedText.CaptionsPlugin());
Microsoft.PlayerFramework.Adaptive.AdaptivePlugin ap = Player.Plugins.OfType<Microsoft.PlayerFramework.Adaptive.AdaptivePlugin>().FirstOrDefault();
if (ap != null)
{
    ap.MediaElement.LicenseAcquirer = new WindowsPhoneLicenseAcquisition(LogMessage);
    ap.MediaElement.MediaFailed += Player_MediaFailed;
}

La méthode OnAcquireLicense est appelée pour acquérir la licence PlayReady. Si LicenseServerUriOverride est défini il s’agit d’une acquisition de licence manuelle. La méthode converti la Stream qui contient le challenge PlayReady en un objet HttpContent avant d’appeler _licenseRequest.AcquireLicense qui est la méthode commune pour l’acquisition de licence PlayReady pour les applications Windows Phone et Windows Store.

protected async override void OnAcquireLicense(System.IO.Stream licenseChallenge, Uri licenseServerUri)
{

    // Need to resolve the URI for the License Server -- make sure it is correct
    // and store that correct URI as resolvedLicenseServerUri.
    Uri resolvedLicenseServerUri;
    if (LicenseServerUriOverride == null)
    {
        if (_LogMessage != null) _LogMessage("PlayReady License Acquisition Service Request in progress - URL: " + licenseServerUri.ToString());
        resolvedLicenseServerUri = licenseServerUri;
    }
    else
    {
        if (_LogMessage != null) _LogMessage("PlayReady Manual License Acquisition Service Request in progress - URL: " + LicenseServerUriOverride.ToString());
        resolvedLicenseServerUri = LicenseServerUriOverride;
    }

    try
    {
        StreamReader sr = new StreamReader(licenseChallenge);
        string challengeString = sr.ReadToEnd();
        Byte[] Data = System.Text.Encoding.UTF8.GetBytes(challengeString);
        HttpContent httpRequestContent = new ByteArrayContent(Data);

        httpRequestContent.Headers.ContentType = new MediaTypeHeaderValue("text/xml");
        httpRequestContent.Headers.ContentLength = Data.Length;


        HttpContent httpResponseContent = await _licenseRequest.AcquireLicense(resolvedLicenseServerUri, httpRequestContent);
        if (httpResponseContent != null)
        {
            Stream srep = await httpResponseContent.ReadAsStreamAsync();
            if (srep != null)
            {
                if (_LogMessage != null) _LogMessage("PlayReady License Acquisition successful.");
                SetLicenseResponse(srep);
                return;
            }
        }
        else
            if (_LogMessage != null) _LogMessage("PlayReady License Acquisition failed. Exception: " + _licenseRequest.GetLastErrorMessage());
    }
    catch(Exception e)
    {
        if (_LogMessage != null) _LogMessage("PlayReady License Acquisition failed. Exception: " + e.Message);
    }
    
    if (_LogMessage != null) _LogMessage("PlayReady License Acquisition failed.");
    // Call CancelAsync 
    // In that case the MediaElement transitions from the AcquiringLicense state to the error state and
    // calling this method causes playback to fail with a "license acquisition failure" error.
    try
    {
        CancelAsync();
    }
    catch
    {
    }

}

Tests des applications Windows Store and Windows Phone

Par défaut les applications essaieront de jouer le contenu Smooth Streaming suivant:
http://playready.directtaps.net/smoothstreaming/SSWSS720H264PR/SuperSpeedway_720.ism/Manifest
en utilisant l’URL suivante pour l’acquisition de licence:
http://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight=1&UseSimpleNonPersistentLicense=1
Cette URL renverra une licence non persistante. A chaque tentative de lecture du contenu smooth streaming, une requête sera transmise au serveur PlayReady.
Par défaut, le challenge custom data est vide, vous devez modifier ce champ si le serveur PlayReady attend un challenge custom data spécifique.
Licence persistante:
Si vous utilisez l’URL suivante, la licence retournée par le serveur PlayReady sera persistante:
http://playready.directtaps.net/pr/svc/rightsmanager.asmx

Téléchargement des projets

Téléchargement:              C# (3.3 MB)
Prérequis:                         Windows 8, Visual Studio 2012, Windows Phone 8 SDK
Dernière modification:    10/18/2013
Licence:                            MS-LPL
Technologies:                   PlayReady, Smooth Streaming, PlayerFramework, C#, XAML
Thème:                             PlayReady Smooth Streaming Player for Windows Phone and Windows Store

]]> Audio/Video Player for Windows 8 and Windows Phone 8 using HttpClient to acquire a PlayReady License https://docs.microsoft.com/archive/blogs/flecoqui/audiovideo-player-for-windows-8-and-windows-phone-8-using-httpclient-to-acquire-a-playready-license Mon, 14 Oct 2013 09:01:00 GMT https://blogs.msdn.microsoft.com/flecoqui/2013/10/14/audiovideo-player-for-windows-8-and-windows-phone-8-using-httpclient-to-acquire-a-playready-license/

Introduction

This article describes how to create Windows 8 and Windows Phone 8 applications playing Smooth Streaming assets protected with PlayReady.  With the sample c# applications provided with this article, the user can define:
- the URL of the Smooth Streaming asset you want to play,
- the URL used for the PlayReady license acquisition,
- the Challenge Custom Data transmitted to the PlayReady server to acquire the license.
If the URL used for the license acquisition is empty, the player will use the license acquisition URL included in the PlayReady protection header (if available).

                                      image   
  image

Steps to acquire a PlayReady license for Windows Store Applications

Before describing how the PlayReady client acquires the PlayReady license, some words about the Individualization. Every PlayReady client has a unique digital certificate and key, the installation of the certificate and the key is called Individualization.

Moreover, before the PlayReady client requests the license to decrypt the content, it must first determine whether the user’s computer has the appropriate PlayReady software installed. This software is called the Individualized Black boX (IBX) and is the client component of PlayReady that is required before any protected content can be played. The individualization component software enables the client computer to request and use a PlayReady license.

The PlayReady client for Windows Store applications supports dynamic individualization: the IBX is downloaded from the Individualization Server. In your application you can implement a Pro-Active Individualization Request or a Reactive Individualization Request.

  • A Pro-Active Individualization Request can be transmitted just after the installation of the application or when the user launches the application for the first time.
  • A Reactive Individualization Request is automatically prepared by the PlayReady client when the application is about to play an asset protected with PlayReady and if the IBX is not installed on the computer.

The schema below describes the acquisition of a PlayReady license to play an asset protected with PlayReady with a Reactive Individualization Request: 

image

The schema below describes the acquisition of a PlayReady license to play an asset protected with PlayReady without any Individualization Request as the Individualized Black Box (IBX) is already installed: 

image


The schema below describes the exchanges between the client and the server when the application plays an asset protected with PlayReady when the Individualized Black Box (IBX) is already installed and the PlayReady license has already been acquired and the license is persistent: 

image

Http Client Libraries:

These PlayReady sample applications are based on Player Framework V1.2 and the PlayReady license acquisition is based on HttpClient class for both platforms Windows and Windows Phone.  
HttpClient is a part of .NET Framework 4.5 and Windows Store applications that provides developers an extremely easy way to connect with services across the Internet including REST-based services. HttpClient is now available for Windows Phone developers provided you install the Microsoft HttpClient Libraries Nuget package.

image

Building the sample applications

In order to build the Player sample applications for Windows Store and Windows Phone, make sure you have the basics installed:
1. a computer running Windows 8,
2. Visual Studio 2012,
3. Windows Phone 8 SDK.

For the Windows Store player application you need to install:
1. The Smooth Streaming Client SDK for Windows 8
2. The PlayReady Client SDK for Windows Store Apps
3. The Player Framework for Windows 8 and Windows Phone 8 (v1.2).

For the Windows Phone 8 player application you need to install:
1. The Microsoft Smooth Streaming Client 2.0 RTW
2. The Player Framework for Windows 8 and Windows Phone 8 (v1.2).
The  Windows Phone 8 player application is delivered with the following Nuget packages:
1. Microsoft HTTP Client Libraries: Microsof.Net.Http 
2. Microsoft BCL Portability Pack: Microsoft.BCL
3. Microsoft BCL Build Components: Microsoft.BCL.Build

Installing the Microsoft Smooth Streaming Client SDK for Windows 8


1. Download the Smooth Streaming Client SDK from this link: http://visualstudiogallery.msdn.microsoft.com/04423d13-3b3e-4741-a01c-1ae29e84fea6
2. Double click on the VSIX file to launch the installation
      image
3. On the VSIX Installer dialog box click on the Install button
      image
4. After few seconds, the SDK is installed. Click on the Close button to close the VSIX Installer dialog box.
       image

Installing the Microsoft PlayReady Client SDK for Windows Store Apps


1. Download the PlayReady Client SDK from this link:
http://visualstudiogallery.msdn.microsoft.com/e02ccac7-f3eb-4b53-b11a-c657d5631483
2. Double click on the VSIX file to launch the installation
      image
3. On the VSIX Installer dialog box click on the Install button
      image
4. After few seconds, the SDK is installed. Click on the Close button to close the VSIX Installer dialog box.
       image

Installing the Microsoft Smooth Streaming Client 2.0 RTW


1. Download the Smooth Streaming Client SDK from this link:
http://www.microsoft.com/en-us/download/details.aspx?id=29940
2. Double click on the MSI file to launch the installation
      image
3. On the Microsoft Smooth Streaming Client 2.0 setup dialog box click on the Next button
      image
4. On the Microsoft Smooth Streaming Client 2.0 setup dialog box check the check box and click on the Next button
      image
5. On the Microsoft Smooth Streaming Client 2.0 setup dialog box click on the Next button
      image
6. On the Microsoft Smooth Streaming Client 2.0 setup dialog box click on the Install button
      image
7. After few seconds, the SDK is installed. Click on the Finish button to close the dialog box.
      image     

Installing the Player Framework for Windows 8 and Windows Phone 8 (v1.2)


1. Download the Player Framework from this link:
http://playerframework.codeplex.com/releases/view/105214  
2. Double click on the VSIX file to launch the installation
      image
3. On the VSIX Installer dialog box click on the Install button
     image
4. After few seconds, the SDK is installed. Click on the Close button to close the VSIX Installer dialog box.
     image

Opening and building the Solution


Once the SDKs are installed you can open the Solution file associated with the sample applications.

  1. Start Visual Studio 2012 and select File > Open > Project/Solution.
  2. Go to the directory in which you unzipped the sample. Go to the directory named for the sample, and double-click the Microsoft Visual Studio Solution (.sln) file.
    image
  3. Check there is no warning for the Windows 8 references
    image
  4. Check there is no warning for the Windows Phone 8 references
    image
  5. Both projects use a common C# source code file for PlayReady license acquisition CommonLicenseRequest.cs
    image
  6. The file CommonLicenseRequest.cs has been shared between both projects using the Visual Studio option Add As Link for the Add Existing Item menu .
    image
  7. Press F7 or use Build > Build Solution to build the samples.

Exploring the Windows Store Player Application project

The Windows Store Player Application project is a XAML based project. 

                image      

  • MainPage.cs contains the main page source code.
  • CommonLicenseRequest.cs contains the source code to acquire the PlayReady license using HttpClient class.
  • ApplicationConfiguration.cs contains the source code used to store and retrieve the application settings in the local app store.

      
     
In the main page constructor, the PlayReady and Smooth Streaming events are registered.  

public MainPage()
{
    this.InitializeComponent();

    // Add Plugins
    Player.Plugins.Add(new Microsoft.PlayerFramework.Adaptive.AdaptivePlugin());

    // Init PlayReady Protection Manager
    var protectionManager = new MediaProtectionManager();
    Windows.Foundation.Collections.PropertySet cpSystems = new Windows.Foundation.Collections.PropertySet();
    cpSystems.Add("{F4637010-03C3-42CD-B932-B48ADF3A6A54}", "Microsoft.Media.PlayReadyClient.PlayReadyWinRTTrustedInput"); //Playready
    protectionManager.Properties.Add("Windows.Media.Protection.MediaProtectionSystemIdMapping", cpSystems);
    protectionManager.Properties.Add("Windows.Media.Protection.MediaProtectionSystemId", "{F4637010-03C3-42CD-B932-B48ADF3A6A54}");
    this.Player.ProtectionManager = protectionManager;
    // PlayReady Events registration
    Player.ProtectionManager.ComponentLoadFailed += ProtectionManager_ComponentLoadFailed;
    Player.ProtectionManager.ServiceRequested += ProtectionManager_ServiceRequested;


    // Init Smooth Streaming Handler
    Windows.Media.MediaExtensionManager extensions = new Windows.Media.MediaExtensionManager();
    extensions.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".ism", "text/xml");
    extensions.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".isml", "text/xml");
    extensions.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".ism", "application/vnd.ms-ss");
    extensions.RegisterByteStreamHandler("Microsoft.Media.AdaptiveStreaming.SmoothByteStreamHandler", ".isml", "application/vnd.ms-ss");
    extensions.RegisterSchemeHandler("Microsoft.Media.AdaptiveStreaming.SmoothSchemeHandler", "ms-sstr:");
    Player.MediaExtensionManager = extensions;
 

The method ProtectionManager_ServiceRequested is called each time a PlayReady license or a Individualization are requested. If it’s an Individualisation request the method ReactiveIndivRequest is called. If it’s a PlayReady License request the method LicenseAcquisitionRequest is called.    

/// <summary>
/// Invoked to send a PlayReady request (Individualization or License request)
/// </summary>
async void ProtectionManager_ServiceRequested(MediaProtectionManager sender, ServiceRequestedEventArgs srEvent)
{
    LogMessage("ProtectionManager ServiceRequested");
    if (srEvent.Request is PlayReadyIndividualizationServiceRequest)
    {
        PlayReadyIndividualizationServiceRequest IndivRequest = srEvent.Request as PlayReadyIndividualizationServiceRequest;
        bool bResultIndiv = await ReactiveIndivRequest(IndivRequest, srEvent.Completion);
    }
    else if (srEvent.Request is PlayReadyLicenseAcquisitionServiceRequest)
    {
        PlayReadyLicenseAcquisitionServiceRequest licenseRequest = srEvent.Request as PlayReadyLicenseAcquisitionServiceRequest;
        LicenseAcquisitionRequest(licenseRequest, srEvent.Completion, PlayReadyLicenseUrl, PlayReadyChallengeCustomData);
    }
}
If the URL used to acquire the PlayReady License is not forced and is the one defined in the PlayReady protection header, the method LicenseAcquisitionRequest calls licenseRequest.BeginServiceRequest. If the URL to acquire the PlayReady License is forced by the application, the method LicenseAcquisitionRequest creates a PlayReady challenge using the ChallengeCustomData and then call licenseAcquisition.AcquireLicense using the URL defined by the user. 
/// <summary>
/// Invoked to acquire the PlayReady License
/// </summary>
async void LicenseAcquisitionRequest(PlayReadyLicenseAcquisitionServiceRequest licenseRequest, MediaProtectionServiceCompletion CompletionNotifier, string Url, string ChallengeCustomData)
{
    bool bResult = false;
    string ExceptionMessage = string.Empty;

    try
    {
        if (!string.IsNullOrEmpty(Url))
        {
            LogMessage("ProtectionManager PlayReady Manual License Acquisition Service Request in progress - URL: " + Url);

            if (!string.IsNullOrEmpty(ChallengeCustomData))
            {
                System.Text.UTF8Encoding encoding = new System.Text.UTF8Encoding();
                byte[] b = encoding.GetBytes(ChallengeCustomData);
                licenseRequest.ChallengeCustomData = Convert.ToBase64String(b, 0, b.Length);
            }

            PlayReadySoapMessage soapMessage = licenseRequest.GenerateManualEnablingChallenge(); 
            
            byte[] messageBytes = soapMessage.GetMessageBody();
            HttpContent httpContent = new ByteArrayContent(messageBytes);

            IPropertySet propertySetHeaders = soapMessage.MessageHeaders;
            foreach (string strHeaderName in propertySetHeaders.Keys)
            {
                string strHeaderValue = propertySetHeaders[strHeaderName].ToString();

                // The Add method throws an ArgumentException try to set protected headers like "Content-Type"
                // so set it via "ContentType" property
                if (strHeaderName.Equals("Content-Type", StringComparison.OrdinalIgnoreCase))
                    httpContent.Headers.ContentType = MediaTypeHeaderValue.Parse(strHeaderValue);
                else
                    httpContent.Headers.Add(strHeaderName.ToString(), strHeaderValue);
            }
            CommonLicenseRequest licenseAcquision = new CommonLicenseRequest();
            HttpContent responseHttpContent = await licenseAcquision.AcquireLicense(new Uri(Url), httpContent);
            if (responseHttpContent != null)
            {
                Exception exResult = licenseRequest.ProcessManualEnablingResponse(await responseHttpContent.ReadAsByteArrayAsync());
                if (exResult != null)
                {
                    throw exResult;
                }
                bResult = true;
            }
            else
                ExceptionMessage = licenseAcquision.GetLastErrorMessage();
        }
        else
        {
            LogMessage("ProtectionManager PlayReady License Acquisition Service Request in progress - URL: " + licenseRequest.Uri.ToString());
            await licenseRequest.BeginServiceRequest();
            bResult = true;
        }
    }
    catch (Exception e)
    {
        ExceptionMessage = e.Message;
    }
    
    if (bResult == true)
            LogMessage(!string.IsNullOrEmpty(Url) ? "ProtectionManager Manual PlayReady License Acquisition Service Request successful":
                "ProtectionManager PlayReady License Acquisition Service Request successful");
    else
        LogMessage(!string.IsNullOrEmpty(Url) ? "ProtectionManager Manual PlayReady License Acquisition Service Request failed: "+ExceptionMessage :
            "ProtectionManager PlayReady License Acquisition Service Request failed: " + ExceptionMessage);
    CompletionNotifier.Complete(bResult);
}
The method AcquireLicense sends the PlayReady license Http Request to the PlayReady server. The request contains the PlayReady challenge and add http headers. The method PostAsync of class HttpClient is used to transmit this request. 
/// <summary>
/// Invoked to acquire the PlayReady license.
/// </summary>
/// <param name="licenseServerUri">License Server URI to retrieve the PlayReady license.</param>
/// <param name="httpRequestContent">HttpContent including the Challenge transmitted to the PlayReady server.</param>
public async virtual Task<HttpContent> AcquireLicense(Uri licenseServerUri, HttpContent httpRequestContent)
{
    try
    {
        HttpClient httpClient = new HttpClient();
        httpClient.DefaultRequestHeaders.Add("msprdrm_server_redirect_compat", "false");
        httpClient.DefaultRequestHeaders.Add("msprdrm_server_exception_compat", "false");

        HttpResponseMessage response = await httpClient.PostAsync(licenseServerUri, httpRequestContent);
        response.EnsureSuccessStatusCode();

        if (response.StatusCode == HttpStatusCode.OK)
        {
            _lastErrorMessage = string.Empty;
            return response.Content;
        }
        else
        {
            _lastErrorMessage = "AcquireLicense - Http Response Status Code: " + response.StatusCode.ToString();
        }
    }
    catch (Exception exception)
    {
        _lastErrorMessage = exception.Message;
        return null;
    }
    return null;
}
        

Exploring the Windows Phone 8 Player Application project

The Windows Phone 8 Player Application project is a XAML based project. 

                image    

  • MainPage.cs contains the main page source code.    
  • CommonLicenseRequest.cs contains the source code to acquire the PlayReady license using HttpClient class.  
  • ApplicationConfiguration.cs contains the source code used to store and retrieve the application settings in the local app store.    
  • WindowsPhoneLicenseAcquisition.cs contains the source code of the class WindowsPhoneLicenseAcquisition derived from PlayReady class LicenseAcquirer used to acquire the PlayReady license.

In the main page constructor, the PlayReady events are registered using the class WindowsPhoneLicenseAcquisition.  

//Add Smooth Streaming and Caption plugins 
Microsoft.PlayerFramework.Adaptive.AdaptivePlugin AP = new Microsoft.PlayerFramework.Adaptive.AdaptivePlugin();
Player.Plugins.Add(AP);
Player.Plugins.Add(new Microsoft.PlayerFramework.TimedText.CaptionsPlugin());
Microsoft.PlayerFramework.Adaptive.AdaptivePlugin ap = Player.Plugins.OfType<Microsoft.PlayerFramework.Adaptive.AdaptivePlugin>().FirstOrDefault();
if (ap != null)
{
    // Register PlayReady LicenseAcquirer
    ap.MediaElement.LicenseAcquirer = new WindowsPhoneLicenseAcquisition(LogMessage);
    ap.MediaElement.MediaFailed += Player_MediaFailed;
}
        
The method OnAcquireLicense is called to acquire a PlayReady license. If the LicenseServerUriOverride is defined it’s a manual license acquisition. The method convert the Stream which contains the PlayReady Challenge into a HttpContent object before calling _licenseRequest.AcquireLicense which is the common method to acquire the PlayReady license for Windows Phone and Windows Store application. 
protected async override void OnAcquireLicense(System.IO.Stream licenseChallenge, Uri licenseServerUri)
{

    // Need to resolve the URI for the License Server -- make sure it is correct
    // and store that correct URI as resolvedLicenseServerUri.
    Uri resolvedLicenseServerUri;
    if (LicenseServerUriOverride == null)
    {
        if (_LogMessage != null) _LogMessage("PlayReady License Acquisition Service Request in progress - URL: " + licenseServerUri.ToString());
        resolvedLicenseServerUri = licenseServerUri;
    }
    else
    {
        if (_LogMessage != null) _LogMessage("PlayReady Manual License Acquisition Service Request in progress - URL: " + LicenseServerUriOverride.ToString());
        resolvedLicenseServerUri = LicenseServerUriOverride;
    }

    try
    {
        StreamReader sr = new StreamReader(licenseChallenge);
        string challengeString = sr.ReadToEnd();
        Byte[] Data = System.Text.Encoding.UTF8.GetBytes(challengeString);
        HttpContent httpRequestContent = new ByteArrayContent(Data);

        httpRequestContent.Headers.ContentType = new MediaTypeHeaderValue("text/xml");
        httpRequestContent.Headers.ContentLength = Data.Length;


        HttpContent httpResponseContent = await _licenseRequest.AcquireLicense(resolvedLicenseServerUri, httpRequestContent);
        if (httpResponseContent != null)
        {
            Stream srep = await httpResponseContent.ReadAsStreamAsync();
            if (srep != null)
            {
                if (_LogMessage != null) _LogMessage("PlayReady License Acquisition successful.");
                SetLicenseResponse(srep);
                return;
            }
        }
        else
            if (_LogMessage != null) _LogMessage("PlayReady License Acquisition failed. Exception: " + _licenseRequest.GetLastErrorMessage());
    }
    catch(Exception e)
    {
        if (_LogMessage != null) _LogMessage("PlayReady License Acquisition failed. Exception: " + e.Message);
    }
    
    if (_LogMessage != null) _LogMessage("PlayReady License Acquisition failed.");
    // Call CancelAsync 
    // In that case the MediaElement transitions from the AcquiringLicense state to the error state and
    // calling this method causes playback to fail with a "license acquisition failure" error.
    try
    {
        CancelAsync();
    }
    catch
    {
    }
}

 

Testing the Windows Store and Windows Phone PlayReady Player applications

By default the applications will try to play the following Smooth Streaming asset:
http://playready.directtaps.net/smoothstreaming/SSWSS720H264PR/SuperSpeedway_720.ism/Manifest
using the following URL for the license acquisition:
http://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight=1&UseSimpleNonPersistentLicense=1 
This URL will return a non-persistent license. Each time the application will try to play the smooth streaming asset, a request to the PlayReady server will be transmitted.
By default, the challenge custom data is empty, you can change this field if the PlayReady server expect a specific challenge custom data.
Persistent license:
If you use the following URL, the license returned will be persistent:
http://playready.directtaps.net/pr/svc/rightsmanager.asmx

Downloading the projects

Download:        C# (3.3 MB)
Requires:           Windows 8, Visual Studio 2012, Windows Phone 8 SDK
Last updated:    10/18/2013
License:              MS-LPL
Technologies:    PlayReady, Smooth Streaming, PlayerFramework, C#, XAML
Topics:               PlayReady Smooth Streaming Player for Windows Phone and Windows Store

]]>