Media Services v3 API'sine bağlanma - .NET

Makale
01/22/2024

Uyarı

Azure Media Services 30 Haziran 2024'de kullanımdan kaldırılacak. Daha fazla bilgi için bkz. AMS Kullanımdan Kaldırma Kılavuzu.

Bu makalede hizmet sorumlusu oturum açma yöntemini kullanarak Azure Media Services v3 .NET SDK'sına nasıl bağlanabileceğiniz gösterilmektedir.

Önkoşullar

Media Services hesabı oluşturun. Kaynak grubu adını ve Media Services hesap adını anımsamaya dikkat edin
.NET geliştirmesi için kullanmak istediğiniz bir araç yükleyin. Bu makaledeki adımlarda Visual Studio 2019 Community Edition'ın nasıl kullanılacağı gösterilir. Visual Studio Code kullanabilirsiniz, bkz. C# ile çalışma. Alternatif olarak, farklı bir kod düzenleyicisi de kullanabilirsiniz.

Önemli

Adlandırma kurallarını gözden geçirin.

Konsol uygulaması oluşturma

Visual Studio’yu çalıştırın.
Dosyamenüsünden Yeni Proje'ye> tıklayın.
Bir .NET Core konsol uygulaması oluşturun.

Bu konudaki örnek uygulama hedeflemektedir netcoreapp2.0. Kod, C# 7.1'den başlayarak kullanılabilen 'async main' kullanır. Diğer ayrıntılar için bu bloga bakın.

Gerekli NuGet paketlerini/derlemelerini ekleme

Visual Studio'da Araçlar>NuGet Paket Yöneticisi NuGet Yöneticisi>Konsolu'nu seçin.
Paket Yöneticisi Konsolu penceresinde komutunu kullanarak Install-Package aşağıdaki NuGet paketlerini ekleyin. Örneğin, Install-Package Microsoft.Azure.Management.Media.

Paket	Description
`Microsoft.Azure.Management.Media`	Azure Media Services SDK'sı. En son Azure Media Services paketini kullandığınızdan emin olmak için Microsoft.Azure.Management.Media'ya bakın.

Diğer gerekli derlemeler

Azure.Storage.Blobs
Microsoft.Extensions.Configuration
Microsoft.Extensions.Configuration.EnvironmentVariables
Microsoft.Extensions.Configuration.Json
Microsoft.Rest.ClientRuntime.Azure.Authentication

Uygulama ayarları dosyasını oluşturma ve yapılandırma

appsettings.json oluşturma

Git Genel>Metin dosyası'na gidin.
"appsettings.json" olarak adlandır.
.json dosyasının "Çıkış Dizinine Kopyala" özelliğini "Daha yeniyse kopyala" olarak ayarlayın (böylece uygulama yayımlandığında bu dizine erişebilir).

appsettings.json değerleri ayarlama

az ams account sp createAccess API'lerinde açıklandığı gibi komutunu çalıştırın. komut, "appsettings.json" içine kopyalamanız gereken json kodunu döndürür.

Yapılandırma dosyasını ekleme

Kolaylık sağlamak için , "appsettings.json" değerlerini okumaktan sorumlu bir yapılandırma dosyası ekleyin.

Projenize yeni bir .cs sınıfı ekleyin. Bunu, ConfigWrapper olarak adlandırın.
Bu dosyaya aşağıdaki kodu yapıştırın (bu örnekte ad alanının olduğu varsayılır ConsoleApp1).

using System;

using Microsoft.Extensions.Configuration;

namespace ConsoleApp1
{
    public class ConfigWrapper
    {
        private readonly IConfiguration _config;

        public ConfigWrapper(IConfiguration config)
        {
            _config = config;
        }

        public string SubscriptionId
        {
            get { return _config["SubscriptionId"]; }
        }

        public string ResourceGroup
        {
            get { return _config["ResourceGroup"]; }
        }

        public string AccountName
        {
            get { return _config["AccountName"]; }
        }

        public string AadTenantId
        {
            get { return _config["AadTenantId"]; }
        }

        public string AadClientId
        {
            get { return _config["AadClientId"]; }
        }

        public string AadSecret
        {
            get { return _config["AadSecret"]; }
        }

        public Uri ArmAadAudience
        {
            get { return new Uri(_config["ArmAadAudience"]); }
        }

        public Uri AadEndpoint
        {
            get { return new Uri(_config["AadEndpoint"]); }
        }

        public Uri ArmEndpoint
        {
            get { return new Uri(_config["ArmEndpoint"]); }
        }

        public string Location
        {
            get { return _config["Location"]; }
        }
    }
}

.NET istemcisine bağlanma

.NET ile Media Services API’lerini kullanmaya başlamak için bir AzureMediaServicesClient nesnesi oluşturmanız gerekir. Nesneyi oluşturmak için, Azure AD kullanarak Azure’a bağlanmak üzere istemcinin ihtiyaç duyduğu kimlik bilgilerini sağlamanız gerekir. Aşağıdaki kodda GetCredentialsAsync işlevi, yerel yapılandırma dosyasında sağlanan kimlik bilgilerine göre ServiceClientCredentials nesnesini oluşturur.

Program.cs dosyasını açın.
Aşağıdaki kodu yapıştırın:

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Threading.Tasks;

using Microsoft.Azure.Management.Media;
using Microsoft.Azure.Management.Media.Models;
using Microsoft.Extensions.Configuration;
using Microsoft.IdentityModel.Clients.ActiveDirectory;
using Microsoft.Rest;
using Microsoft.Rest.Azure.Authentication;

namespace ConsoleApp1
{
    class Program
    {
        public static async Task Main(string[] args)
        {

            ConfigWrapper config = new ConfigWrapper(new ConfigurationBuilder()
                .SetBasePath(Directory.GetCurrentDirectory())
                .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
                .AddEnvironmentVariables()
                .Build());

            try
            {
                IAzureMediaServicesClient client = await CreateMediaServicesClientAsync(config);
                Console.WriteLine("connected");
            }
            catch (Exception exception)
            {
                if (exception.Source.Contains("ActiveDirectory"))
                {
                    Console.Error.WriteLine("TIP: Make sure that you have filled out the appsettings.json file before running this sample.");
                }

                Console.Error.WriteLine($"{exception.Message}");


                if (exception.GetBaseException() is ErrorResponseException apiException)
                {
                    Console.Error.WriteLine(
                        $"ERROR: API call failed with error code '{apiException.Body.Error.Code}' and message '{apiException.Body.Error.Message}'.");
                }
            }

            Console.WriteLine("Press Enter to continue.");
            Console.ReadLine();
        }

        private static async Task<ServiceClientCredentials> GetCredentialsAsync(ConfigWrapper config)
        {
            // Use ApplicationTokenProvider.LoginSilentWithCertificateAsync or UserTokenProvider.LoginSilentAsync to get a token using service principal with certificate
            //// ClientAssertionCertificate
            //// ApplicationTokenProvider.LoginSilentWithCertificateAsync

            // Use ApplicationTokenProvider.LoginSilentAsync to get a token using a service principal with symmetric key
            ClientCredential clientCredential = new ClientCredential(config.AadClientId, config.AadSecret);
            return await ApplicationTokenProvider.LoginSilentAsync(config.AadTenantId, clientCredential, ActiveDirectoryServiceSettings.Azure);
        }

        private static async Task<IAzureMediaServicesClient> CreateMediaServicesClientAsync(ConfigWrapper config)
        {
            var credentials = await GetCredentialsAsync(config);

            return new AzureMediaServicesClient(config.ArmEndpoint, credentials)
            {
                SubscriptionId = config.SubscriptionId,
            };
        }

    }
}

Yardım ve destek alma

Sorularınız için Media Services ile iletişime geçebilir veya aşağıdaki yöntemlerden birini kullanarak güncelleştirmelerimizi izleyebilirsiniz:

Q & A
Stack Overflow. ile soruları etiketleme azure-media-services.
Destek istemek için @AzureSupport @MSFTAzureMedia veya kullanın.
Azure portal üzerinden bir destek bileti açın.

Aracılığıyla paylaş