.NET ile Media Services GeliştirmeMedia Services development with .NET

Not

Media Services v2’ye herhangi bir yeni özellik veya işlevsellik eklenmemektedir.No new features or functionality are being added to Media Services v2.
En son sürüm olan Media Services v3’ü inceleyin.Check out the latest version, Media Services v3. Ayrıca bkz geçiş kılavuzuna v2'den v3Also, see migration guidance from v2 to v3

Bu makalede, .NET ile Media Services uygulama geliştirmeye başlamanın anlatılmaktadır.This article discusses how to start developing Media Services applications using .NET.

Azure Media Services .NET SDK'sı kitaplığı .NET kullanarak Media Services karşı programlama yapmanızı sağlar.The Azure Media Services .NET SDK library enables you to program against Media Services using .NET. .NET ile geliştirme daha da kolay hale getirmek için Azure Media Services .NET SDK uzantıları kitaplığı sağlanır.To make it even easier to develop with .NET, the Azure Media Services .NET SDK Extensions library is provided. Bu kitaplık, genişletme yöntemleri ve .NET kodunuzu basitleştirerek yardımcı işlevler kümesi içerir.This library contains a set of extension methods and helper functions that simplify your .NET code. Her iki kitaplıkları aracılığıyla kullanılabilir NuGet ve GitHub.Both libraries are available through NuGet and GitHub.

ÖnkoşullarPrerequisites

  • Yeni veya mevcut bir Azure aboneliğinde bir Media Services hesabı.A Media Services account in a new or existing Azure subscription. Makaleye göz atın Media Services hesabı oluşturma.See the article How to Create a Media Services Account.
  • İşletim sistemleri: Windows 10, Windows 7, Windows 2008 R2 veya Windows 8.Operating Systems: Windows 10, Windows 7, Windows 2008 R2, or Windows 8.
  • .NET framework 4.5 veya üzeri..NET Framework 4.5 or later.
  • Visual Studio.Visual Studio.

Visual Studio projesi oluşturup yapılandırmaCreate and configure a Visual Studio project

Bu bölümde Visual Studio'da bir proje oluşturun ve Media Services Geliştirme döngünüzün kümesi gösterilmektedir.This section shows you how to create a project in Visual Studio and set it up for Media Services development. Bu durumda, projedir bir C# Windows konsol uygulaması, ancak burada gösterilen aynı kurulum adımları diğer (örneğin, bir Windows Forms uygulaması veya ASP.NET Web uygulaması) için Media Services uygulamaları oluşturma proje türleri için geçerlidir.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).

Bu bölümde, nasıl kullanılacağını gösterir NuGet Media Services .NET SDK uzantıları ve diğer bağımlı kitaplıkların eklemek için.This section shows how to use NuGet to add Media Services .NET SDK extensions and other dependent libraries.

Alternatif olarak, Github'dan son Media Services .NET SDK'sı bitleri alabilirsiniz (github.com/Azure/azure-sdk-for-media-services veya github.com/Azure/azure-sdk-for-media-services-extensions) çözümü oluşturun ve istemci projesi başvuruları ekleyin.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. Gereken tüm bağımlılıkları indirilir ve otomatik olarak ayıklanan.All the necessary dependencies get downloaded and extracted automatically.

  1. Visual Studio’da yeni bir C# Konsol Uygulaması oluşturun.Create a new C# Console Application in Visual Studio. Girin adı, konumu, ve çözüm adıve ardından Tamam'a tıklayın.Enter the Name, Location, and Solution name, and then click OK.

  2. Çözümü derleyin.Build the solution.

  3. Kullanım NuGet yüklemek ve eklemek için Azure Media Services .NET SDK uzantıları (windowsazure.mediaservices.extensions).Use NuGet to install and add Azure Media Services .NET SDK Extensions (windowsazure.mediaservices.extensions). Bu paketin yüklenmesiyle Media Services .NET SDK da yüklenir ve diğer tüm gerekli bağımlılıklar eklenir.Installing this package, also installs Media Services .NET SDK and adds all other required dependencies.

    En yeni sürümünü NuGet yüklü olduğundan emin olun.Ensure that you have the newest version of NuGet installed. Daha fazla bilgi ve yükleme yönergeleri için bkz. NuGet.For more information and installation instructions, see NuGet.

    1. Çözüm Gezgini'nde proje adına sağ tıklayın ve seçin NuGet paketlerini Yönet.In Solution Explorer, right-click the name of the project and choose Manage NuGet Packages.

    2. NuGet paketlerini Yönet iletişim kutusu görüntülenir.The Manage NuGet Packages dialog box appears.

    3. Çevrimiçi Galerisi, Azure MediaServices uzantıları, arama düğmesini Azure Media Services .NET SDK uzantıları (windowsazure.mediaservices.extensions) ve ardından Yükleme düğmesi.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. Proje değiştirildi ve Media Services .NET SDK uzantıları, Media Services .NET SDK'sı ve diğer bağımlı derlemeler için başvurular eklenir.The project is modified and references to the Media Services .NET SDK Extensions, Media Services .NET SDK, and other dependent assemblies are added.

  4. Temiz bir geliştirme ortamı yükseltmek için NuGet paketi geri yüklemeyi etkinleştirme göz önünde bulundurun.To promote a cleaner development environment, consider enabling NuGet Package Restore. Daha fazla bilgi için NuGet paketi geri yüklemeyi ".For more information, see NuGet Package Restore".

  5. Bir başvuru ekleyin System.Configuration derleme.Add a reference to System.Configuration assembly. Bu derleme System.Configuration içerir. ConfigurationManager yapılandırma dosyaları (örneğin, App.config) erişmek için kullanılan sınıf.This assembly contains the System.Configuration.ConfigurationManager class that is used to access configuration files (for example, App.config).

    1. Başvuruları Yönet iletişim kutusunu kullanarak başvurular eklemek için Çözüm Gezgini'nde proje adına sağ tıklayın.To add references using the Manage References dialog, right-click the project name in the Solution Explorer. ' A tıklayarak Ekle, ardından başvurusu... .Then, click Add, then click Reference....

    2. Başvuruları Yönet iletişim kutusu görüntülenir.The Manage References dialog appears.

    3. .NET framework derlemeleri altındaki bulun ve System.Configuration bütünleştirilmiş koduna seçip ENTER tuşuna Tamam.Under .NET framework assemblies, find and select the System.Configuration assembly and press OK.

  6. App.config dosyasını açın ve eklemek bir appSettings dosyasına bölümü.Open the App.config file and add an appSettings section to the file. Media Services API'sine bağlanmak için gerekli değerleri ayarlayın.Set the values that are needed to connect to the Media Services API. Daha fazla bilgi için Azure AD kimlik doğrulamasıyla Azure Media Services API'sine erişim.For more information, see Access the Azure Media Services API with Azure AD authentication.

    Kullanarak bağlanmak için gerekli değerleri ayarlamak hizmet sorumlusu kimlik doğrulama yöntemi.Set the values that are needed to connect using the Service principal authentication method.

     ```csharp
             <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. Ekleme System.Configuration projenize bir başvuru.Add the System.Configuration reference to your project.

  8. Var olanın üzerine yaz kullanarak başında deyimlerini Program.cs dosyasının aşağıdaki kod ile: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;
    

    Bu noktada, Media Services uygulama geliştirmeye başlamak hazırsınız.At this point, you are ready to start developing a Media Services application.

ÖrnekExample

AMS API'ye bağlanan ve tüm kullanılabilir medya işlemcileri listeler küçük bir örnek aşağıda verilmiştir.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);
                }
        
            }

Sonraki adımlarNext steps

Artık AMS API'ye bağlanabilir ve başlangıç geliştirme.Now you can connect to the AMS API and start developing.

Media Services’i öğrenme yollarıMedia Services learning paths

Media Services v3 (en son)Media Services v3 (latest)

Azure Media Services en son sürümüne göz atın!Check out the latest version of Azure Media Services!

Media Services V2 (eski)Media Services v2 (legacy)

Geri bildirimde bulunmaProvide feedback

Geri bildirim sağlamak ve Azure Media Services’ı geliştirme hakkında önerilerde bulunmak için User Voice forumunu kullanın.Use the User Voice forum to provide feedback and make suggestions on how to improve Azure Media Services. Doğrudan aşağıdaki kategorilerden birine de gidebilirsiniz:You also can go directly to one of the following categories: