Media Services utveckling med .NET

I den här artikeln beskrivs hur du börjar utveckla Media Services program med hjälp av .NET.

Med Azure Media Services .NET SDK-biblioteket kan du programmera mot Media Services med hjälp av .NET. För att göra det ännu enklare att utveckla med .NET finns Azure Media Services bibliotek för .NET SDK-tillägg. Det här biblioteket innehåller en uppsättning tilläggsmetoder och hjälpfunktioner som förenklar .NET-koden. Båda biblioteken är tillgängliga via NuGet och GitHub.

Förutsättningar

• Ett Media Services-konto i en ny eller befintlig Azure-prenumeration. Se artikeln How to Create a Media Services Account.
• Operativsystem: Windows 10, Windows 7, Windows 2008 R2 eller Windows 8.
• .NET Framework 4.5 eller senare.
• Visual Studio.

Skapa och konfigurera ett Visual Studio-projekt

Det här avsnittet visar hur du skapar ett projekt i Visual Studio konfigurera det för Media Services utveckling. I det här fallet är projektet ett C# Windows-konsolprogram, men samma installationssteg som visas här gäller för andra typer av projekt som du kan skapa för Media Services-program (till exempel ett Windows Forms-program eller ett ASP.NET-webbprogram).

Det här avsnittet visar hur du använder NuGet för att lägga Media Services .NET SDK-tillägg och andra beroende bibliotek.

Du kan också hämta de senaste Media Services .NET SDK-bitarna från GitHub (github.com/Azure/azure-sdk-for-media-services eller github.com/Azure/azure-sdk-for-media-services-extensions), skapa lösningen och lägga till referenser till klientprojektet. Alla nödvändiga beroenden laddas ned och extraheras automatiskt.

1. Skapa ett nytt C#-konsolprogram i Visual Studio. Ange Namn, Plats och Lösningsnamn och klicka sedan på OK.

2. Skapa lösningen.

3. Använd NuGet för att installera och Azure Media Services .NET SDK-tillägg (windowsazure.mediaservices.extensions). När du installerar det här paketet installeras även Media Services .NET SDK och lägger till alla andra nödvändiga beroenden.

   Kontrollera att du har den senaste versionen av NuGet installerad. Mer information och installationsanvisningar finns i NuGet.

   1. I Solution Explorer högerklickar du på namnet på projektet och väljer Hantera NuGet-paket.

   2. Dialogrutan Hantera NuGet-paket öppnas.

   3. I onlinegalleriet söker du efter Azure MediaServices-tillägg, väljer Azure Media Services .NET SDK-tillägg (windowsazure.mediaservices.extensions) och klickar sedan på knappen Installera.

   4. Projektet ändras och referenser till Media Services .NET SDK-tillägg, Media Services .NET SDK och andra beroende sammansättningar läggs till.

4. Överväg att aktivera NuGet-paketåterställning för att främja en renare utvecklingsmiljö. Mer information finns i NuGet Package Restore" (NuGet-paketåterställning).

5. Lägg till en referens till System.Configuration-sammansättningen. Den här sammansättningen innehåller System.Configuration. ConfigurationManager-klass som används för att komma åt konfigurationsfiler (till exempel App.config).

   1. Om du vill lägga till referenser med hjälp av dialogrutan Hantera referenser högerklickar du på projektnamnet i Solution Explorer. Klicka sedan på Lägg till och sedan på Referens....

   2. Dialogrutan Hantera referenser visas.

   3. Under .NET Framework-sammansättningar hittar och väljer du System.Configuration-sammansättningen och trycker på OK.

6. Öppna filen App.config och lägg till ett appSettings-avsnitt i filen. Ange de värden som behövs för att ansluta till Media Services API. Mer information finns i Access the Azure Media Services API with Azure AD authentication (Få åtkomst till API:et för Azure Media Services med Azure AD-autentisering).

   Ange de värden som behövs för att ansluta med autentiseringsmetoden för tjänstens huvudnamn.

   <configuration>
   ...
       <appSettings>
           <add key="AMSAADTenantDomain" value="tenant"/>
           <add key="AMSRESTAPIEndpoint" value="endpoint"/>
           <add key="AMSClientId" value="id"/>
           <add key="AMSClientSecret" value="secret"/>
       </appSettings>
   </configuration>
   

7. Lägg till System.Configuration-referensen i projektet.

8. Skriva över de befintliga using-isatserna i början av filen Program.cs med följande kod:

   using System;
   using System.Configuration;
   using System.IO;
   using Microsoft.WindowsAzure.MediaServices.Client;
   using System.Threading;
   using System.Collections.Generic;
   using System.Linq;
   

   Nu är du redo att börja utveckla ett Media Services program.

Exempel

Här är ett litet exempel som ansluter till AMS-API:et och visar en lista över alla tillgängliga medieprocessorer.

class Program
{
    // Read values from the App.config file.

    private static readonly string _AADTenantDomain =
        ConfigurationManager.AppSettings["AMSAADTenantDomain"];
    private static readonly string _RESTAPIEndpoint =
        ConfigurationManager.AppSettings["AMSRESTAPIEndpoint"];
    private static readonly string _AMSClientId =
        ConfigurationManager.AppSettings["AMSClientId"];
    private static readonly string _AMSClientSecret =
        ConfigurationManager.AppSettings["AMSClientSecret"];
        
    private static CloudMediaContext _context = null;
    static void Main(string[] args)
    {
        AzureAdTokenCredentials tokenCredentials = 
            new AzureAdTokenCredentials(_AADTenantDomain,
                new AzureAdClientSymmetricKey(_AMSClientId, _AMSClientSecret),
                AzureEnvironments.AzureCloudEnvironment);

        var tokenProvider = new AzureAdTokenProvider(tokenCredentials);

        _context = new CloudMediaContext(new Uri(_RESTAPIEndpoint), tokenProvider);
        
        // List all available Media Processors
        foreach (var mp in _context.MediaProcessors)
        {
            Console.WriteLine(mp.Name);
        }
        
    }

Nästa steg

Nu kan du ansluta till AMS-API:et och börja utveckla.

Sökvägar för Media Services-utbildning

Media Services v3 (senaste)

Kolla in den senaste versionen av Azure Media Services!

• Översikt
• Begrepp
• Börja utveckla
• Vägledning för migrering från v2 till v3

Media Services v2 (äldre)

• Översikt
• Skapa konto
• Leverera på begäran
• Leverera Live

Ge feedback

Använd User Voice-forumet för att ge feedback och förslag på hur Azure Media Services kan förbättras. Du kan även gå direkt till någon av följande kategorier:

• Azure Media Player
• SDK-klientbibliotek
• Kodning och bearbetning
• Liveuppspelning
• Medieanalys
• Azure Portal
• REST-API och plattform
• Videoströmning på begäran