.NET を使用した Media Services 開発Media Services development with .NET

このトピックでは、.NET を使用して Media Services アプリケーションを開発する方法について説明します。This topic discusses how to start developing Media Services applications using .NET.

Azure Media Services .NET SDK ライブラリを利用すると、.NET を使用して Media Services に対するプログラミングを行うことができます。The Azure Media Services .NET SDK library enables you to program against Media Services using .NET. .NET でより簡単に開発できるようにするための Azure Media Services .NET SDK Extensions ライブラリも提供されています。To make it even easier to develop with .NET, the Azure Media Services .NET SDK Extensions library is provided. このライブラリには、.NET コードの簡素化に役立つ一連の拡張メソッドとヘルパー関数が含まれています。This library contains a set of extension methods and helper functions that simplify your .NET code. どちらのライブラリも、NuGetGitHub を通じて利用できます。Both libraries are available through NuGet and GitHub.

前提条件Prerequisites

  • 新規または既存の Azure サブスクリプションで作成した Media Services アカウント。A Media Services account in a new or existing Azure subscription. メディア サービス アカウントの作成方法」を参照してください。See the topic How to Create a Media Services Account.
  • オペレーティング システム: Windows 10、Windows 7、Windows Server 2008 R2、または Windows 8。Operating Systems: Windows 10, Windows 7, Windows 2008 R2, or Windows 8.
  • .NET Framework 4.5。.NET Framework 4.5.
  • 見ることができます。Visual Studio.

Visual Studio プロジェクトの作成と構成Create and configure a Visual Studio project

このセクションでは、Media Services 開発用に Visual Studio でプロジェクトを作成し、セットアップする方法を説明します。This section shows you how to create a project in Visual Studio and set it up for Media Services development. ここでは C# Windows コンソール アプリケーション プロジェクトを使用していますが、Media Services アプリケーション用に作成できる他の種類のプロジェクト (Windows フォーム アプリケーション、ASP.NET Web アプリケーションなど) についても、同じセットアップ手順を利用できます。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).

このセクションでは、NuGet を使用して、Media Services .NET SDK 拡張機能と、依存するその他のライブラリを追加する方法を説明します。This section shows how to use NuGet to add Media Services .NET SDK extensions and other dependent libraries.

また、GitHub (github.com/Azure/azure-sdk-for-media-services または github.com/Azure/azure-sdk-for-media-services-extensions) から最新の Media Services .NET SDK bits を取得してソリューションをビルドし、クライアント プロジェクトに参照を追加できます。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. 必要な依存関係はすべて自動的にダウンロードされ抽出されます。All the necessary dependencies get downloaded and extracted automatically.

  1. Visual Studio で、新しい C# コンソール アプリケーションを作成します。Create a new C# Console Application in Visual Studio. 名前場所ソリューション名 を入力し、OKをクリックします。Enter the Name, Location, and Solution name, and then click OK.
  2. ソリューションをビルドします。Build the solution.
  3. NuGet を使用して、Azure Media Services .NET SDK Extensions (windowsazure.mediaservices.extensions) をインストールして追加します。Use NuGet to install and add Azure Media Services .NET SDK Extensions (windowsazure.mediaservices.extensions). このパッケージをインストールすると、 Media Services .NET SDK が一緒にインストールされるほか、必要な依存関係がすべて追加されます。Installing this package, also installs Media Services .NET SDK and adds all other required dependencies.

    最新バージョンの NuGet がインストールされていることをご確認ください。Ensure that you have the newest version of NuGet installed. 詳しい情報とインストール手順については、 NuGetをご覧ください。For more information and installation instructions, see NuGet.

    1. ソリューション エクスプローラーでプロジェクトの名前を右クリックし、[NuGet パッケージの管理] を選択します。In Solution Explorer, right-click the name of the project and choose Manage NuGet Packages.

    2. [NuGet パッケージの管理] ダイアログ ボックスが表示されます。The Manage NuGet Packages dialog box appears.

    3. オンライン ギャラリーで、Azure Media Services Extensions を検索し、[Azure Media Services .NET SDK Extensions](windowsazure.mediaservices.extensions) を選択し、[インストール] ボタンをクリックします。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. プロジェクトが変更され、Media Services .NET SDK Extensions、Media Services .NET SDK、その他の依存アセンブリへの参照が追加されます。The project is modified and references to the Media Services .NET SDK Extensions, Media Services .NET SDK, and other dependent assemblies are added.

  4. よりクリーンな開発環境を実現するために、NuGet パッケージの復元を有効にすることを検討してください。To promote a cleaner development environment, consider enabling NuGet Package Restore. 詳細については、「 NuGet Package Restore (NuGet パッケージの復元)」をご覧ください。For more information, see NuGet Package Restore".
  5. System.Configuration アセンブリへの参照を追加します。Add a reference to System.Configuration assembly. このアセンブリには、構成ファイル (App.config など) にアクセスするための System.Configuration.ConfigurationManager クラスが含まれています。This assembly contains the System.Configuration.ConfigurationManager class that is used to access configuration files (for example, App.config).

    1. [Manage References (参照の管理)] ダイアログを使用して参照を追加するには、ソリューション エクスプローラーでプロジェクト名を右クリックします。To add references using the Manage References dialog, right-click the project name in the Solution Explorer. [追加][参照] の順にクリックします。Then, click Add, then click Reference....

    2. [参照の管理] ダイアログが表示されます。The Manage References dialog appears.

    3. .NET Framework アセンブリで、System.Configuration アセンブリを探して選択し、[OK] をクリックします。Under .NET framework assemblies, find and select the System.Configuration assembly and press OK.
  6. App.config ファイルを開き、appSettings セクションをファイルに追加します。Open the App.config file and add an appSettings section to the file.

    Media Services API に接続するために必要な値を設定します。Set the values that are needed to connect to the Media Services API. 詳細については、「Azure AD Authentication を使用した Azure Media Services API へのアクセス」を参照してください。For more information, see Access the Azure Media Services API with Azure AD authentication.

    ユーザー認証を使用している場合、構成ファイルには、おそらく、Azure AD テナントのドメインおよび AMS REST API エンドポイントに対する値が含まれています。If you are using user authentication your config file will probably have values for your Azure AD tenant domain and the AMS REST API endpoint.

    重要

    Azure Media Services のドキュメント セットのコード サンプルのほとんどで、AMS API への接続に対する認証の種類としてユーザー (対話型) が使用されます。Most code samples in the Azure Media Services documentation set, use a user (interactive) type of authentication to connect to the AMS API. この認証方法は、ネイティブ アプリ (例: モバイル アプリ、Windows アプリ、コンソール アプリケーション) の管理や監視に適しています。This authentication method will work well for management or monitoring native apps: mobile apps, Windows apps, and Console applications. この認証方法は、サーバー、Web サービス、API という種類のアプリケーションには適していません。This authentication method is not suitable for server, web services, APIs type of applications. 詳細については、「Azure AD Authentication を使用した AMS API へのアクセス」を参照してください。For more information, see Access the AMS API with Azure AD authentication.

     <configuration>
     ...
         <appSettings>
           <add key="AADTenantDomain" value="YourAADTenantDomain" />
           <add key="MediaServiceRESTAPIEndpoint" value="YourRESTAPIEndpoint" />
         </appSettings>
    
     </configuration>
    
  7. Program.cs ファイルの先頭にある既存の using ステートメントを次のコードで上書きします。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;
    

これで、Media Services アプリケーションの開発準備が整いました。At this point, you are ready to start developing a Media Services application.

Example

この小さい例では、AMS API に接続し、すべての使用可能なメディア プロセッサを一覧表示します。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["AADTenantDomain"];
    private static readonly string _RESTAPIEndpoint =
        ConfigurationManager.AppSettings["MediaServiceRESTAPIEndpoint"];

    private static CloudMediaContext _context = null;
    static void Main(string[] args)
    {
        var tokenCredentials = new AzureAdTokenCredentials(_AADTenantDomain, 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);
        }

    }

次のステップNext steps

このあとは、AMS API に接続したり、開発を開始したりできます。Now you can connect to the AMS API and start developing.

Media Services のラーニング パスMedia Services learning paths

Azure Media Services のラーニング パスについて読む。Read about the Azure Media Services learning paths:

フィードバックの提供Provide feedback

フィードバック フォーラムでは、Azure Media Services の改善方法について、フィードバックの提供や提案を行うことができます。Use the User Voice forum to provide feedback and make suggestions on how to improve Azure Media Services. また、次のカテゴリのいずれかをクリックすると、そのカテゴリのフォーラムに直接アクセスすることもできます。You also can go directly to one of the following categories: