다음을 통해 공유


Media Services v3 API에 연결 - .NET

Media Services 로고 v3


경고

Azure Media Services는 2024년 6월 30일에 사용 중지됩니다. 자세한 내용은 AMS 사용 중지 가이드를 참조하세요.

이 문서에서는 서비스 사용자 로그인 메서드를 사용하여 Azure Media Services v3 .NET SDK에 연결하는 방법을 보여 줍니다.

사전 요구 사항

  • Media Services 계정 만들기 리소스 그룹 이름과 Media Services 계정 이름을 기억해 두어야 합니다.
  • .NET 개발에 사용하려는 도구를 설치합니다. 이 문서의 단계에서는 Visual Studio 2019 Community Edition을 사용하는 방법을 보여 줍니다. Visual Studio Code를 사용할 수 있습니다. C# 작업을 참조하세요. 또는 다른 코드 편집기를 사용할 수 있습니다.

중요

명명 규칙을 검토합니다.

콘솔 애플리케이션 만들기

  1. Visual Studio를 시작합니다.
  2. 파일 메뉴에서 새로 만들기>프로젝트를 클릭합니다.
  3. .NET Core 콘솔 애플리케이션을 만듭니다.

이 항목의 샘플 앱은 netcoreapp2.0을 대상으로 합니다. 이 코드에서는 C# 7.1부터 사용할 수 있는 'async main'을 사용합니다. 자세한 내용은 이 블로그를 참조하세요.

필요한 NuGet 패키지/어셈블리 추가

  1. Visual Studio에서 도구>NuGet 패키지 관리자>NuGet 관리자 콘솔을 선택합니다.
  2. 패키지 관리자 콘솔 창에서 Install-Package 명령을 사용하여 다음 NuGet 패키지를 추가합니다. Install-Package Microsoft.Azure.Management.Media)을 입력합니다.
패키지 Description
Microsoft.Azure.Management.Media Azure Media Services SDK
최신 Azure Media Services 패키지를 사용하고 있는지 확인하려면 Microsoft.Azure.Management.Media를 확인하세요.

기타 필수 어셈블리

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

앱 설정 파일 만들기 및 구성

appsettings.json 만들기

  1. 일반>텍스트 파일로 이동합니다.
  2. "appsettings.json"으로 이름을 지정합니다.
  3. .json 파일의 "출력 디렉터리로 복사" 속성을 "변경된 내용만 복사"로 설정하여 애플리케이션이 게시될 때 액세스할 수 있도록 합니다.

appsettings.json의 값 설정

액세스 API에 설명된 대로 az ams account sp create 명령을 실행합니다. 명령은 "appsettings.json"에 복사해야 하는 json을 반환합니다.

구성 파일 추가

편의상 "appsettings.json"에서 값을 읽는 구성 파일을 추가합니다.

  1. 프로젝트에 새 .cs 클래스를 추가합니다. 이름을 ConfigWrapper로 지정합니다.
  2. 이 파일에 다음 코드를 붙여넣습니다(이 예제에서는 네임스페이스가 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 클라이언트에 연결

.NET으로 Media Services API를 사용하려면 AzureMediaServicesClient 개체를 만들어야 합니다. 개체를 만들려면 Azure AD를 사용하여 클라이언트가 Azure에 연결하는 데 필요한 자격 증명을 제공해야 합니다. 아래 코드에서 GetCredentialsAsync 함수는 로컬 구성 파일에 제공된 자격 증명에 따라 ServiceClientCredentials 개체를 만듭니다.

  1. Program.cs를 엽니다.
  2. 다음 코드를 붙여 넣습니다.
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,
            };
        }

    }
}

도움말 및 지원 보기

다음 방법 중 하나로 Media Services에 질문하거나 업데이트를 따를 수 있습니다.