.NET ile Media Services geliştirme

Media Services logosu


Not

Media Services v2’ye herhangi bir yeni özellik veya işlevsellik eklenmemektedir.
V3 Media Servicesen son sürüme göz atın. Ayrıca bkz. v2 'den v3 'e geçiş kılavuzu

Bu makalede, .NET kullanarak Media Services uygulamaları geliştirmeye nasıl başlayabileceği açıklanır.

Azure Media Services .NET SDK kitaplığı, .net kullanarak Media Services karşı programlama yapmanızı sağlar. .NET ile geliştirmeyi daha da kolaylaştırmak için Azure Media Services .NET SDK uzantıları kitaplığı sağlanır. Bu kitaplık, .NET kodunuzu basitleştirecek bir uzantı yöntemleri ve yardımcı işlevler kümesi içerir. Her iki kitaplık da NuGet ve GitHub aracılığıyla kullanılabilir.

Önkoşullar

  • Yeni veya mevcut bir Azure aboneliğinde bir Media Services hesabı. Media Services hesabı oluşturmamakalesine bakın.
  • İşletim sistemleri: Windows 10, Windows 7, Windows 2008 R2 veya Windows 8.
  • .NET Framework 4,5 veya üzeri.
  • Visual Studio.

Visual Studio projesi oluşturup yapılandırma

Bu bölümde, Visual Studio 'da bir proje oluşturma ve Media Services geliştirme için ayarlama gösterilmektedir. Bu durumda, proje bir C# Windows konsol uygulamasıdır, ancak burada gösterilen kurulum adımları, Media Services uygulamalar için oluşturabileceğiniz diğer proje türleri için de geçerlidir (örneğin, bir Windows Forms uygulaması veya bir ASP.NET Web uygulaması).

Bu bölümde, Media Services .NET SDK uzantıları ve diğer bağımlı kitaplıkları eklemek için NuGet 'in nasıl kullanılacağı gösterilmektedir.

Alternatif olarak, GitHub 'dan (GitHub.com/Azure/Azure-SDK-for-Media-Services veya GitHub.com/Azure/Azure-SDK-for-Media-Services-Extensions) en son Media Services .NET SDK bitlerini alabilir, çözümü oluşturabilir ve başvuruları istemci projesine ekleyebilirsiniz. Tüm gerekli bağımlılıklar otomatik olarak indirilir ve ayıklanır.

  1. Visual Studio’da yeni bir C# Konsol Uygulaması oluşturun. Ad, konum ve çözüm adını girin ve ardından Tamam ' a tıklayın.

  2. Çözümü derleyin.

  3. Azure Media Services .NET SDK uzantıları yüklemek ve eklemek için NuGet kullanın (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.

    NuGet 'in en yeni sürümünün yüklü olduğundan emin olun. Daha fazla bilgi ve yükleme yönergeleri için bkz. NuGet.

    1. Çözüm Gezgini, projenin adına sağ tıklayın ve NuGet Paketlerini Yönet' i seçin.

    2. NuGet Paketlerini Yönet iletişim kutusu görünür.

    3. Çevrimiçi galeride Azure MediaServices uzantıları için arama yapın Azure Media Services .NET SDK uzantıları ' nı (windowsazure. mediaservices. Extensions) seçin ve ardından Install düğmesine tıklayın.

    4. Proje değiştirilir ve Media Services .NET SDK uzantıları, Media Services .NET SDK ve diğer bağımlı derlemeler eklenir.

  4. Bir temizleyici geliştirme ortamını yükseltmek için, NuGet paket geri yüklemeyi etkinleştirmeyi göz önünde bulundurun. Daha fazla bilgi için bkz. NuGet paketini geri yükleme ".

  5. System.Configurlama derlemesine bir başvuru ekleyin. Bu derleme, System.Configurnu içerir. Yapılandırma dosyalarına erişmek için kullanılan (örneğin, App.config ) sınıf.

    1. Başvuruları Yönet iletişim kutusunu kullanarak başvurular eklemek için Çözüm Gezgini proje adına sağ tıklayın. Ardından Ekle' ye ve ardından başvuru... öğesine tıklayın.

    2. Başvuruları Yönet iletişim kutusu görüntülenir.

    3. .NET Framework derlemeleri altında, System.Configurlama derlemesini bulun ve seçin ve Tamam' a basın.

  6. App.config dosyasını açın ve dosyaya bir appSettings bölümü ekleyin. Media Services API 'sine bağlanmak için gereken değerleri ayarlayın. Daha fazla bilgi için bkz. Azure AD kimlik doğrulamasıyla Azure Media Services API 'Sine erişme.

    Hizmet sorumlusu kimlik doğrulama yöntemini kullanarak bağlanmak için gereken değerleri ayarlayın.

    <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. Projenize System.Configuration başvurusunu ekleyin.

  8. Program. cs dosyasının başındaki mevcut using deyimlerinin üzerine aşağıdaki kodu yazın:

    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, bir Media Services uygulaması geliştirmeye başlamaya başlayabilirsiniz.

Örnek

AMS API 'sine bağlanan ve tüm kullanılabilir medya Işlemcilerini listeleyen küçük bir örnek aşağıda verilmiştir.

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ımlar

Artık AMS API 'sine bağlanabilir ve geliştirmeyebaşlayabilirsiniz.

Media Services’i öğrenme yolları

Media Services v3 (en son)

Azure Media Services en son sürümüne göz atın!

Media Services v2 (eski)

Geribildirim gönderme

Geri bildirim sağlamak ve Azure Media Services’ı geliştirme hakkında önerilerde bulunmak için User Voice forumunu kullanın. Doğrudan aşağıdaki kategorilerden birine de gidebilirsiniz: