Programowanie Media Services przy użyciu platformy .NETMedia Services development with .NET

logo usługi Media Servicesmedia services logo


Uwaga

Do usługi Media Services w wersji 2 nie są już dodawane żadne nowe funkcje.No new features or functionality are being added to Media Services v2.
Zapoznaj się z najnowszą wersją Media Services wersja 3.Check out the latest version, Media Services v3. Zobacz też wskazówki dotyczące migracji od wersji 2 do V3Also, see migration guidance from v2 to v3

W tym artykule omówiono sposób rozpoczynania opracowywania aplikacji Media Services przy użyciu platformy .NET.This article discusses how to start developing Media Services applications using .NET.

Biblioteka Azure Media Services zestawu SDK platformy .NET umożliwia programowanie Media Services przy użyciu platformy .NET.The Azure Media Services .NET SDK library enables you to program against Media Services using .NET. Aby jeszcze bardziej ułatwić programowanie przy użyciu platformy .NET, podano bibliotekę rozszerzeń zestawu SDK platformy .net Azure Media Services .To make it even easier to develop with .NET, the Azure Media Services .NET SDK Extensions library is provided. Ta biblioteka zawiera zestaw metod rozszerzających i funkcji pomocniczych, które upraszczają kod platformy .NET.This library contains a set of extension methods and helper functions that simplify your .NET code. Obie biblioteki są dostępne za poorednictwem NuGet i GitHub.Both libraries are available through NuGet and GitHub.

Wymagania wstępnePrerequisites

  • Konto usługi Media Services w nowej lub istniejącej subskrypcji platformy Azure.A Media Services account in a new or existing Azure subscription. Zapoznaj się z artykułem jak utworzyć konto Media Services.See the article How to Create a Media Services Account.
  • Systemy operacyjne: Windows 10, Windows 7, Windows 2008 R2 lub Windows 8.Operating Systems: Windows 10, Windows 7, Windows 2008 R2, or Windows 8.
  • .NET Framework 4,5 lub nowszy..NET Framework 4.5 or later.
  • Programu Visual Studio.Visual Studio.

Tworzenie i konfigurowanie projektu programu Visual StudioCreate and configure a Visual Studio project

W tej sekcji pokazano, jak utworzyć projekt w programie Visual Studio i skonfigurować go do tworzenia Media Services.This section shows you how to create a project in Visual Studio and set it up for Media Services development. W takim przypadku projekt jest aplikacją konsolową dla systemu Windows w języku C#, ale te same kroki konfiguracji mają zastosowanie do innych typów projektów, które można utworzyć dla Media Services aplikacji (na przykład aplikacja Windows Forms lub aplikacja sieci Web ASP.NET).In this case, the project is a C# Windows console application, but the same setup steps shown here apply to other types of projects you can create for Media Services applications (for example, a Windows Forms application or an ASP.NET Web application).

W tej sekcji pokazano, jak Media Services dodać rozszerzenia zestawu SDK platformy .NET i inne zależne biblioteki przy użyciu narzędzia NuGet .This section shows how to use NuGet to add Media Services .NET SDK extensions and other dependent libraries.

Alternatywnie możesz uzyskać najnowsze Media Services .NET SDK z usługi GitHub (GitHub.com/Azure/Azure-SDK-for-Media-Services lub GitHub.com/Azure/Azure-SDK-for-Media-Services-Extensions), skompilować rozwiązanie i dodać odwołania do projektu klienta.Alternatively, you can get the latest Media Services .NET SDK bits from GitHub (github.com/Azure/azure-sdk-for-media-services or github.com/Azure/azure-sdk-for-media-services-extensions), build the solution, and add the references to the client project. Wszystkie niezbędne zależności są pobierane i wyodrębniane automatycznie.All the necessary dependencies get downloaded and extracted automatically.

  1. Utwórz nową aplikację konsoli języka C# w programie Visual Studio.Create a new C# Console Application in Visual Studio. Wprowadź nazwę, lokalizacjęi nazwę rozwiązania, a następnie kliknij przycisk OK.Enter the Name, Location, and Solution name, and then click OK.

  2. Skompiluj rozwiązanie.Build the solution.

  3. Zainstaluj i Dodaj rozszerzenia Azure Media Services .NET SDK (windowsazure. MediaServices. Extensions) przy użyciu narzędzia NuGet .Use NuGet to install and add Azure Media Services .NET SDK Extensions (windowsazure.mediaservices.extensions). Podczas instalacji tego pakietu instalowany jest również zestaw .NET SDK usługi Media Services oraz dodawane są wszystkie inne wymagane zależności.Installing this package, also installs Media Services .NET SDK and adds all other required dependencies.

    Upewnij się, że masz zainstalowaną najnowszą wersję narzędzia NuGet.Ensure that you have the newest version of NuGet installed. Aby uzyskać więcej informacji i instrukcje dotyczące instalacji, zobacz NuGet.For more information and installation instructions, see NuGet.

    1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy nazwę projektu i wybierz polecenie Zarządzaj pakietami NuGet.In Solution Explorer, right-click the name of the project and choose Manage NuGet Packages.

    2. Zostanie wyświetlone okno dialogowe Zarządzanie pakietami NuGet.The Manage NuGet Packages dialog box appears.

    3. W galerii online Wyszukaj rozszerzenia MediaServices platformy Azure, Azure Media Services wybierz pozycję rozszerzenia zestawu .NET SDK (windowsazure. MediaServices. Extensions), a następnie kliknij przycisk Instaluj .In the Online gallery, search for Azure MediaServices Extensions, choose Azure Media Services .NET SDK Extensions (windowsazure.mediaservices.extensions), and then click the Install button.

    4. Projekt zostanie zmodyfikowany i odwołuje się do Media Services rozszerzeń zestawu .NET SDK, Media Services .NET SDK i innych zależnych zestawów.The project is modified and references to the Media Services .NET SDK Extensions, Media Services .NET SDK, and other dependent assemblies are added.

  4. Aby podwyższyć poziom czystego środowiska programistycznego, należy rozważyć włączenie przywracania pakietów NuGet.To promote a cleaner development environment, consider enabling NuGet Package Restore. Aby uzyskać więcej informacji, zobacz przywracanie pakietów NuGet ".For more information, see NuGet Package Restore".

  5. Dodaj odwołanie do System.Configzestawu wersja .Add a reference to System.Configuration assembly. Ten zestaw zawiera System.Configwersja. Klasa ConfigurationManager , która jest używana do uzyskiwania dostępu do plików konfiguracji (na przykład App.config).This assembly contains the System.Configuration.ConfigurationManager class that is used to access configuration files (for example, App.config).

    1. Aby dodać odwołania za pomocą okna dialogowego Zarządzanie odwołaniami, kliknij prawym przyciskiem myszy nazwę projektu w Eksplorator rozwiązań.To add references using the Manage References dialog, right-click the project name in the Solution Explorer. Następnie kliknij przycisk Dodaj, a następnie kliknij pozycję odwołanie....Then, click Add, then click Reference....

    2. Zostanie wyświetlone okno dialogowe Zarządzanie odwołaniami.The Manage References dialog appears.

    3. W obszarze zestawy .NET Framework Znajdź i wybierz System.Configzestaw wersja i naciśnij przycisk OK.Under .NET framework assemblies, find and select the System.Configuration assembly and press OK.

  6. Otwórz plik App.config i Dodaj do pliku sekcję AppSettings .Open the App.config file and add an appSettings section to the file. Ustaw wartości, które są konieczne do nawiązania połączenia z interfejsem API Media Services.Set the values that are needed to connect to the Media Services API. Aby uzyskać więcej informacji, zobacz dostęp do interfejsu API Azure Media Services przy użyciu uwierzytelniania usługi Azure AD.For more information, see Access the Azure Media Services API with Azure AD authentication.

    Ustaw wartości, które są konieczne do nawiązania połączenia przy użyciu metody uwierzytelniania nazwy głównej usługi .Set the values that are needed to connect using the Service principal authentication method.

    <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. Dodaj System.Configodwołanie wersja do projektu.Add the System.Configuration reference to your project.

  8. Zastąp istniejące instrukcje using na początku pliku program.cs następującym kodem:Overwrite the existing using statements at the beginning of the Program.cs file with the following code:

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

    Teraz możesz rozpocząć tworzenie aplikacji Media Services.At this point, you are ready to start developing a Media Services application.

PrzykładExample

Oto mały przykład, który nawiązuje połączenie z interfejsem API usługi AMS i wyświetla listę wszystkich dostępnych procesorów multimediów.Here is a small example that connects to the AMS API and lists all available Media Processors.

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

Następne krokiNext steps

Teraz możesz nawiązać połączenie z interfejsem API usługi AMS i rozpocząć Tworzenieaplikacji.Now you can connect to the AMS API and start developing.

Ścieżki szkoleniowe dotyczące usługi Media ServicesMedia Services learning paths

Azure Media Services w wersji 3 (najnowsza)Media Services v3 (latest)

Zapoznaj się z najnowszą wersją Azure Media Services.Check out the latest version of Azure Media Services!

Media Services w wersji 2 (starsza wersja)Media Services v2 (legacy)

Wyraź opinięProvide feedback

Skorzystaj z forum User Voice, aby przekazać opinie i sugestie dotyczące sposobów usprawnienia usługi Azure Media Services.Use the User Voice forum to provide feedback and make suggestions on how to improve Azure Media Services. Możesz także przejść bezpośrednio do jednej z następujących kategorii:You also can go directly to one of the following categories: