Media Services vývoje s .NET

Tento článek popisuje, jak začít s vývojem Media Services aplikací pomocí .NET.

Knihovna Azure Media Services .NET SDK umožňuje programovat proti Media Services pomocí .NET. Pro usnadnění vývoje pomocí .NET je k dispozici Azure Media Services .NET SDK Extensions. Tato knihovna obsahuje sadu rozšiřujících metod a pomocových funkcí, které zjednodušují kód .NET. Obě knihovny jsou k dispozici prostřednictvím NuGet a GitHub.

Požadavky

• Účet Media Services v novém nebo existujícím předplatném Azure. Další informace najdete v článku Vytvoření Media Services účtu.
• Operační systémy: Windows 10, Windows 7, Windows 2008 R2 nebo Windows 8.
• .NET Framework verze 4.5 nebo novější.
• Visual Studio

Vytvoření a konfigurace projektu Visual Studia

Tato část ukazuje, jak vytvořit projekt v Visual Studio a nastavit ho pro Media Services vývoj. V tomto případě je projekt konzolovou aplikací jazyka C Windows#, ale zde uvedené kroky nastavení platí pro jiné typy projektů, které můžete vytvořit pro aplikace Media Services (například aplikaci Windows Forms nebo webovou aplikaci ASP.NET).

Tato část ukazuje, jak pomocí NuGet přidat Media Services .NET SDK a další závislé knihovny.

Případně můžete získat nejnovější bity sady .NET SDK Media Services z GitHub (github.com/Azure/azure-sdk-for-media-services nebo github.com/Azure/azure-sdk-for-media-services-extensions), sestavit řešení a přidat odkazy na projekt klienta. Všechny potřebné závislosti se stáhnou a extrahují automaticky.

1. Vytvořte novou konzolovou aplikaci v jazyce C# v sadě Visual Studio. Zadejte Název, Umístění a Název řešení a pak klikněte na OK.

2. Sestavte řešení.

3. Pomocí NuGet nainstalujte a přidejte Azure Media Services .NET SDK Extensions (windowsazure.mediaservices.extensions). Při instalaci tohoto balíčku se nainstaluje také sada SDK služby Media Services pro .NET a přidá všechny ostatní požadované závislosti.

   Ujistěte se, že máte nainstalovanou nejnovější NuGet. Další informace a pokyny k instalaci najdete v tématu NuGet.

   1. V Průzkumník řešení klikněte pravým tlačítkem na název projektu a zvolte Spravovat NuGet balíčky.

   2. Zobrazí se dialogové okno Správa balíčků NuGet.

   3. V online galerii vyhledejte Rozšíření Azure MediaServices, zvolte Azure Media Services Rozšíření sady .NET SDK (windowsazure.mediaservices.extensions) a potom klikněte na tlačítko Nainstalovat.

   4. Projekt se upravuje a odkazuje na Media Services .NET SDK, Media Services .NET SDK a další závislá sestavení.

4. Pokud chcete podpořit čistější vývojové prostředí, zvažte povolení NuGet obnovení balíčků. Další informace najdete v NuGet obnovení balíčků.

5. Přidejte odkaz na sestavení System.Configuration. Toto sestavení obsahuje System.Configuration. Třída ConfigurationManager, která se používá pro přístup ke konfiguračním souborům (například App.config).

   1. Pokud chcete přidat odkazy pomocí dialogového okna Spravovat odkazy, klikněte pravým tlačítkem na název projektu v Průzkumník řešení. Potom klikněte na Přidat a pak klikněte na Odkaz....

   2. Zobrazí se dialogové okno Spravovat odkazy.

   3. V části Sestavení rozhraní .NET Framework vyhledejte a vyberte sestavení System.Configuration a stiskněte OK.

6. Otevřete soubor App.config a přidejte do souboru oddíl appSettings. Nastavte hodnoty potřebné pro připojení k Media Services API. Další informace najdete v tématu Přístup k rozhraní API Azure Media Services s ověřováním Azure AD.

   Nastavte hodnoty potřebné pro připojení pomocí metody ověřování pomocí objektu služby.

   <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. Přidejte do projektu odkaz System.Configuration.

8. Přepište existující příkazy using na začátku souboru Program.cs následujícím kódem:

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

   V tuto chvíli jste připraveni začít s vývojem Media Services aplikace.

Příklad

Tady je malý příklad, který se připojí k rozhraní AMS API a zobrazí seznam všech dostupných procesorů médií.

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);
        }
        
    }

Další kroky

Teď se můžete připojit k rozhraní AMS API a začít vyvíjet.

Mapy kurzů k Media Services

Media Services v3 (nejnovější)

Podívejte se na nejnovější verzi Azure Media Services.

• Přehled
• Koncepty
• Zahájení vývoje
• Pokyny k migraci z v2 na v3

Media Services v2 (starší verze)

• Přehled
• Vytvořit účet
• Doručení na vyžádání
• Doručovat živě

Poskytnutí zpětné vazby

Pomocí fóra User Voice můžete poskytnout zpětnou vazbu a zaslat návrhy pro zlepšení služeb Azure Media Services. Můžete také přejít přímo na jednu z následujících kategorií:

• Přehrávač médií Azure
• Klientské knihovny SDK
• Kódování a zpracování
• Živé streamování
• Media Analytics
• Azure Portal
• Rozhraní API REST a platforma
• Streamování videa na vyžádání