Media Services ontwikkelen met .NET

In dit artikel wordt beschreven hoe u kunt beginnen met het ontwikkelen Media Services toepassingen met behulp van .NET.

Met Azure Media Services .NET SDK-bibliotheek kunt u met behulp Media Services .NET programmeren. Om het nog eenvoudiger te maken om met .NET te ontwikkelen, wordt Azure Media Services .NET SDK Extensions-bibliotheek aangeboden. Deze bibliotheek bevat een set extensiemethoden en helperfuncties die uw .NET-code vereenvoudigen. Beide bibliotheken zijn beschikbaar via NuGet en GitHub.

Vereisten

• Een Media Services-account in een nieuw of bestaand Azure-abonnement. Zie het artikel How to Create a Media Services Account (Een Media Services maken).
• Besturingssystemen: Windows 10, Windows 7, Windows 2008 R2 of Windows 8.
• .NET Framework 4.5 of hoger.
• Visual Studio.

Maak en configureer een Visual Studio-project.

In deze sectie ziet u hoe u een project in Visual Studio en instellen voor Media Services ontwikkeling. In dit geval is het project een C# Windows-consoletoepassing, maar dezelfde installatiestappen die hier worden weergegeven, zijn van toepassing op andere typen projecten die u kunt maken voor Media Services-toepassingen (bijvoorbeeld een Windows Forms-toepassing of een ASP.NET-webtoepassing).

In deze sectie ziet u hoe u NuGet kunt gebruiken om Media Services .NET SDK-extensies en andere afhankelijke bibliotheken toe te voegen.

U kunt ook de meest recente Media Services .NET SDK-bits van GitHub(github.com/Azure/azure-sdk-for-media-services of github.com/Azure/azure-sdk-for-media-services-extensions)krijgen, de oplossing bouwen en de verwijzingen naar het clientproject toevoegen. Alle benodigde afhankelijkheden worden automatisch gedownload en geëxtraheerd.

1. Maak in Visual Studio een nieuwe C#-consoletoepassing. Voer de Namen, Locatie en Oplossingsnaam in en klik vervolgens op OK.

2. Bouw de oplossing.

3. Gebruik NuGet om .NET SDK Extensions Azure Media Services (windowsazure.mediaservices.extensions) te installeren en toe te voegen. Als u dit pakket installeert, wordt ook de Media Services .NET SDK geïnstalleerd en worden alle andere vereiste afhankelijkheden toegevoegd.

   Zorg ervoor dat u de nieuwste versie van NuGet hebt geïnstalleerd. Zie NuGet voor meer informatie en installatie-instructies.

   1. Klik Solution Explorer met de rechtermuisknop op de naam van het project en kies NuGet-pakketten beheren.

   2. Het dialoogvenster NuGet-pakketten beheren wordt weergegeven.

   3. Zoek in de onlinegalerie naar Azure MediaServices Extensions, kies Azure Media Services .NET SDK Extensions (windowsazure.mediaservices.extensions) en klik vervolgens op de knop Installeren.

   4. Het project wordt gewijzigd en er worden verwijzingen naar de Media Services .NET SDK-extensies, Media Services .NET SDK en andere afhankelijke assemblies toegevoegd.

4. Als u een schonere ontwikkelomgeving wilt promoten, kunt u NuGet Package Restore inschakelen. Zie Voor meer informatie NuGet Package Restore".

5. Voeg een verwijzing naar System.Configuration-assembly toe. Deze assembly bevat de System.Configuration. ConfigurationManager-klasse die wordt gebruikt voor toegang tot configuratiebestanden (bijvoorbeeld App.config).

   1. Als u verwijzingen wilt toevoegen met behulp van het dialoogvenster Verwijzingen beheren, klikt u met de rechtermuisknop op de projectnaam in het Solution Explorer. Klik vervolgens op Toevoegen en klik vervolgens op Verwijzing....

   2. Het dialoogvenster Verwijzingen beheren wordt weergegeven.

   3. Zoek en selecteer onder .NET Framework-assembly's de assembly System.Configuration en druk op OK.

6. Open het App.config en voeg een sectie appSettings toe aan het bestand. Stel de waarden in die nodig zijn om verbinding te maken met Media Services API. Zie Access the Azure Media Services API with Azure AD authentication (Toegang tot Azure Media Services API met Azure AD-verificatie) voor meer informatie.

   Stel de waarden in die nodig zijn om verbinding te maken met behulp van de verificatiemethode van de service-principal.

   <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. Voeg de system.configuration-verwijzing toe aan uw project.

8. Overschrijf de bestaande using-instructies aan het begin van het bestand Program.cs met de volgende code:

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

   U bent nu klaar om te beginnen met het ontwikkelen van een Media Services toepassing.

Voorbeeld

Hier is een klein voorbeeld dat verbinding maakt met de AMS-API en een lijst met alle beschikbare mediaprocessors bevat.

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

Volgende stappen

U kunt nu verbinding maken met de AMS-API en beginnen met het ontwikkelen van.

Media Services-leertrajecten

Media Services v3 (recentste)

Bekijk de nieuwste versie van Azure Media Services.

• Overzicht
• Concepten
• Start met ontwikkelen
• Hulp bij migratie van v2 naar v3

Media Services v2 (verouderd)

• Overzicht
• Account maken
• Op aanvraag leveren
• Live leveren

Feedback geven

Geef via het forum User Voice uw feedback en suggesties om Azure Media Services te verbeteren. U kunt ook meteen naar een van de volgende categorieën gaan:

• Azure Media Player
• SDK-clientbibliotheken
• Coderen en verwerken
• Live streamen
• Media Analytics
• Azure-portal
• REST API en platform
• Video-on-Demand-streaming