チュートリアル: .NET 7.0 を使用して Media Services でライブストリーミングする

[アーティクル]
07/17/2023

警告

Azure Media Services は、2024 年 6 月 30 日に廃止されます。詳細については、「 AMS 廃止ガイド」を参照してください。

Azure Media Services では、ライブイベントがライブストリーミングコンテンツの処理を受け持ちます。ライブイベントは入力エンドポイントであり、その取り込み URL をライブエンコーダーに対して指定します。ライブイベントは、RTMP/S または Smooth Streaming プロトコルを使用してライブエンコーダーから入力ストリームを受信し、1 つ以上のストリーミングエンドポイントを介したストリーミングに使用できるようにします。また、ストリームはあらかじめプレビューし、確認したうえで処理、配信しますが、ライブイベントはその際に使用するプレビューエンドポイント (プレビュー URL) も提供します。

このチュートリアルでは、.NET 7.0 を使用して パススルー ライブイベントを作成する方法について説明します。パススルーライブイベントは、オンプレミスでマルチビットレートの GOP アラインエンコードが可能なエンコーダーがある場合に便利です。クラウドコストを削減する方法です。帯域幅を減らし、マルチビットレートエンコードのために単一ビットレートストリームをクラウドに送信する場合は、720P または 1080P エンコードプリセットでトランスコーディングライブイベントを使用できます。

このチュートリアルでは、次のことについて説明します。

サンプルプロジェクトをダウンロードします。
ライブストリーミングを実行するコードを確認する。
Media Player デモサイトで Azure Media Player を使用してイベントを視聴する。
ライブイベントを監視するように Event Grid を設定します。
リソースをクリーンアップする。

前提条件

このチュートリアルを完了するには、以下のものが必要です。

Visual Studio Code for Windows/macOS/Linux または Visual Studio 2022 for Windows または Mac をインストールします。
.NET 7.0 SDK をインストールする
Media Services アカウントを作成するアカウント名、サブスクリプション ID、リソースグループ名の API Access の詳細を JSON 形式でコピーするか、Media Services アカウントへの接続に必要な値を、この appsettings.json ファイルで使用される JSON ファイル形式で格納してください。
「 Azure CLI を使用して Azure Media Services API にアクセスする」の手順に従って、詳細を保存します。このサンプルでは、アカウント名、サブスクリプション ID、リソースグループ名を使用し、ファイルに入力する appsettings.json 必要があります。

ライブストリーミングソフトウェアには、次の項目も必要です。

イベントのブロードキャストに使用するカメラまたはデバイス (ラップトップなど)。
カメラストリームをエンコードし、Real-Time メッセージングプロトコル (RTMP/S) を介して Media Services ライブストリーミングサービスに送信するオンプレミスソフトウェアエンコーダー。詳細については、「おすすめのライブストリーミングエンコーダー」を参照してください。ストリームは、RTMP/S または Smooth Streaming 形式である必要があります。このサンプルでは、Open Broadcaster Software (OBS) Studio を使用して RTMP/S を取り込みエンドポイントにブロードキャストすることを前提としています。 OBS Studio をインストールします。
または、OBS クイックスタートを試して、最初にAzure portalを使用してプロセス全体をテストすることもできます。

Event Grid と Event Hubs を使用してライブイベントを監視するには、次の操作を行います。 1. Azure portalまたは 1 を使用して、Event Grid を使用して Media Services イベントを作成および監視する方法に関するページの手順に従います。この記事の「Event Grid と Event Hubs を使用したライブイベントの監視」セクションで、このチュートリアルの終わり近くの手順に従います。

ヒント

先に進む前に、「Azure Media Services v3 を使用したライブストリーミング」を確認してください。

サンプルをダウンロードして構成する

次のコマンドを使用して、ライブストリーミングの .NET サンプルが含まれる GitHub リポジトリを自分のマシンにクローンします。

git clone https://github.com/Azure-Samples/media-services-v3-dotnet.git

ライブストリーミングサンプルは、 Live/LiveEventWithDVR フォルダーにあります。

ダウンロードしたプロジェクトでを開きます appsettings.json 。値をアカウント名、サブスクリプション ID、リソースグループ名に置き換えます。

重要

このサンプルでは、各リソースに一意のサフィックスを使用します。デバッグを取り消した場合、または完全に実行せずにアプリを終了した場合、アカウントに複数のライブイベントが作成されます。実行中のライブイベントを必ず停止してください。そうしないと、"料金が発生" します。

.NET SDK で Media Services API の使用を開始する

Program.csは、のオプション appsettings.jsonを使用して、Media Services アカウントリソースへの参照を作成します。

var mediaServicesResourceId = MediaServicesAccountResource.CreateResourceIdentifier(
    subscriptionId: options.AZURE_SUBSCRIPTION_ID.ToString(),
    resourceGroupName: options.AZURE_RESOURCE_GROUP,
    accountName: options.AZURE_MEDIA_SERVICES_ACCOUNT_NAME);
var credential = new DefaultAzureCredential(includeInteractiveCredentials: true);
var armClient = new ArmClient(credential);
var mediaServicesAccount = armClient.GetMediaServicesAccountResource(mediaServicesResourceId);

ライブイベントを作成する

このセクションでは、ライブイベントの パススルー 型を作成する方法を示します (LiveEventEncodingType を None に設定)。使用可能なライブイベントの種類については、「ライブイベントの種類」のセクションを参照してください。取り込み帯域幅全体を減らしたい場合、またはオンプレミスのマルチビットレートトランスコーダーがない場合は、720p または 1080p アダプティブビットレートクラウドエンコードにライブトランスコードイベントを使用できます。

ライブイベントを作成するときに、次の項目を指定したい場合もあります。

ライブイベントの取り込みプロトコル。現在、RTMPS プロトコルと Smooth Streaming プロトコルがサポートされています。ライブイベントの実行中にプロトコルオプションを変更することはできません。別のプロトコルが必要な場合は、ストリーミングプロトコルごとに別のライブイベントを作成します。
取り込みやプレビューの IP 制限。このライブイベントへのビデオの取り込みが許可される IP アドレスを定義できます。許可される IP アドレスは、これらのいずれかとして指定できます。
- 1 つの IP アドレス (10.0.0.1 や 2001:db8::1 など)
- IP アドレスとクラスレス Inter-Domain ルーティング (CIDR) サブネットマスクを使用する IP 範囲 (10.0.0.1/22 や 2001:db8::/48 など)
- IP アドレスとドット付き 10 進サブネットマスクを使用する IP 範囲 (例: 10.0.0.1 255.255.252.0)
  
  IP アドレスが指定されておらず、規則の定義もない場合は、どの IP アドレスも許可されません。任意の IP アドレスを許可するには、ルールを作成し、0.0.0.0/0 と ::/0 を設定します。 IP アドレスは、4 つの数値または CIDR アドレス範囲を持つ IPv4 または IPv6 アドレスのいずれかの形式である必要があります。詳細については、「 IP 許可リストを使用して DRM ライセンスと AES キー配信へのアクセスを制限する」を参照してください。
イベントの作成時の自動開始。自動開始が true に設定されている場合、ライブイベントは作成後に開始されます。つまり、ライブイベントの実行が開始されるとすぐに課金が開始されます。それ以上の課金を停止するには、ライブイベントリソースの Stop を明示的に呼び出す必要があります。詳細については、ライブイベントの状態と課金に関するページを参照してください。

各種のスタンバイモードも利用できます。スタンバイモードを使うと、実行中状態にすばやく移行できる低コストの "割り当て済み" 状態でライブイベントを開始できます。これは、ストリーム配信者にチャネルをすばやく配布する必要があるホットプールなどの状況に役立ちます。

静的ホスト名と一意の GUID。取り込み URL を予測可能で、ハードウェアベースのライブエンコーダーで保守しやすくするには、プロパティを useStaticHostname true に設定します。詳細については、「ライブイベントの取り込み URL」のセクションを参照してください。

var liveEvent = await mediaServicesAccount.GetMediaLiveEvents().CreateOrUpdateAsync(
    WaitUntil.Completed,
    liveEventName,
    new MediaLiveEventData(mediaServicesAccount.Get().Value.Data.Location)
    {
        Description = "Sample Live Event from the .NET SDK sample",
        UseStaticHostname = true,
        // 1) Set up the input settings for the Live event...
        Input = new LiveEventInput(streamingProtocol: LiveEventInputProtocol.Rtmp)
        {
            StreamingProtocol = LiveEventInputProtocol.Rtmp,
            AccessToken = "acf7b6ef-8a37-425f-b8fc-51c2d6a5a86a", // used to make the ingest URL unique
            KeyFrameIntervalDuration = TimeSpan.FromSeconds(2),
            IPAllowedIPs =
            {
                new IPRange
                {
                    Name = "AllowAllIpV4Addresses",
                    Address = IPAddress.Parse("0.0.0.0"),
                    SubnetPrefixLength = 0
                },
                new IPRange
                {
                    Name = "AllowAllIpV6Addresses",
                    Address = IPAddress.Parse("0::"),
                    SubnetPrefixLength = 0
                }
            }
        },
        // 2) Set the live event to use pass-through or cloud encoding modes...
        Encoding = new LiveEventEncoding()
        {
            EncodingType = LiveEventEncodingType.PassthroughBasic
        },
        // 3) Set up the Preview endpoint for monitoring
        Preview = new LiveEventPreview
        {
            IPAllowedIPs =
            {
                new IPRange()
                {
                    Name = "AllowAllIpV4Addresses",
                    Address = IPAddress.Parse("0.0.0.0"),
                    SubnetPrefixLength = 0
                },
                new IPRange()
                {
                    Name = "AllowAllIpV6Addresses",
                    Address = IPAddress.Parse("0::"),
                    SubnetPrefixLength = 0
                }
            }
        },
        // 4) Set up more advanced options on the live event. Low Latency is the most common one. Set
        //    this to Default or Low Latency. When using Low Latency mode, you must configure the Azure
        //    Media Player to use the quick start heuristic profile or you won't notice the change. In
        //    the AMP player client side JS options, set -  heuristicProfile: "Low Latency Heuristic
        //    Profile". To use low latency optimally, you should tune your encoder settings down to 1
        //    second GOP size instead of 2 seconds.
        StreamOptions =
        {
            StreamOptionsFlag.LowLatency
        },
        // 5) Optionally enable live transcriptions if desired. This is only supported on
        //    PassthroughStandard, and the transcoding live event types. It is not supported on Basic
        //    pass-through type.
        // WARNING: This is extra cost, so please check pricing before enabling.
        //Transcriptions =
        //{
        //    new LiveEventTranscription
        //    {
        //        // The value should be in BCP-47 format (e.g: 'en-US'). See https://go.microsoft.com/fwlink/?linkid=2133742
        //        Language = "en-us",
        //        TrackName = "English" // set the name you want to appear in the output manifest
        //    }
        //}
    },
    autoStart: false);

取り込み URL の取得

ライブイベントの作成後、ライブエンコーダーに提供する取り込み URL を取得できます。エンコーダーは、これらの URL を使用して、ライブストリームを入力します。

// Get the RTMP ingest URL. The endpoints is a collection of RTMP primary and secondary,
// and RTMPS primary and secondary URLs.
Console.WriteLine($"The RTMP ingest URL to enter into OBS Studio is:");
Console.WriteLine(liveEvent.Data.Input.Endpoints.First(x => x.Uri.Scheme == "rtmps").Uri);
Console.WriteLine("Make sure to enter a Stream Key into the OBS Studio settings. It can be");
Console.WriteLine("any value or you can repeat the accessToken used in the ingest URL path.");
Console.WriteLine();

プレビュー URL を取得する

プレビューして、エンコーダーからの入力が受信されていることを確認するには、previewEndpoint を使用します。

重要

続行する前に、ビデオがプレビュー URL に送信されていることを確認してください。

// Use the previewEndpoint to preview and verify that the input from the encoder is actually
// being received The preview endpoint URL also support the addition of various format strings
// for HLS (format=m3u8-cmaf) and DASH (format=mpd-time-cmaf) for example. The default manifest
// is Smooth.
string previewEndpoint = liveEvent.Data.Preview.Endpoints.First().Uri.ToString();
Console.WriteLine($"The preview URL is:");
Console.WriteLine(previewEndpoint);
Console.WriteLine();
Console.WriteLine($"Open the live preview in your browser and use the Azure Media Player to monitor the preview playback:");
Console.WriteLine($"https://ampdemo.azureedge.net/?url={HttpUtility.UrlEncode(previewEndpoint)}&heuristicprofile=lowlatency");
Console.WriteLine();
Console.WriteLine("Start the live stream now, sending the input to the ingest URL and verify");
Console.WriteLine("that it is arriving with the preview URL.");
Console.WriteLine("IMPORTANT: Make sure that the video is flowing to the Preview URL before continuing!");
Console.WriteLine("Press enter to continue...");
Console.ReadLine();

ライブイベントとライブ出力を作成して管理する

オンプレミスエンコーダーからのライブストリームがライブイベントにストリーミングされたら、アセット、ライブ出力、ストリーミングロケーターを作成してライブイベントを開始できます。ストリームはアーカイブされ、ストリーミングエンドポイントを介して閲覧者が利用できます。

次のセクションでは、アセットとライブ出力の作成手順を説明します。

アセットを作成する

ライブ出力で使用されるアセットを作成します。

// Create an Asset for the Live Output to use. Think of this as the "tape" that will be recorded
// to. The asset entity points to a folder/container in your Azure Storage account
Console.Write($"Creating the output Asset '{assetName}'...".PadRight(60));
var asset = (await mediaServicesAccount.GetMediaAssets().CreateOrUpdateAsync(
    WaitUntil.Completed,
    assetName,
    new MediaAssetData
    {
        Description = "My video description"
    })).Value;
Console.WriteLine("Done");

ライブ出力を作成する

ライブ出力は、作成されると開始し、削除されると停止します。ライブ出力を削除しても、アセット内の出力アセットまたはコンテンツは削除されません。記録を含む資産は、存在し、それに関連付けられているストリーミングロケーターがある限り、オンデマンドストリーミングで使用できます。

// Create the Live Output - think of this as the "tape recorder for the live event". Live
// outputs are optional, but are required if you want to archive the event to storage, use the
// asset for on-demand playback later, or if you want to enable cloud DVR time-shifting. We will
// use the asset created above for the "tape" to record to.
Console.Write($"Creating Live Output...".PadRight(60));
var liveOutput = (await liveEvent.GetMediaLiveOutputs().CreateOrUpdateAsync(
    WaitUntil.Completed,
    liveOutputName,
    new MediaLiveOutputData
    {
        AssetName = asset.Data.Name,
        // The HLS and DASH manifest file name. This is recommended to
        // set if you want a deterministic manifest path up front.
        // archive window can be set from 3 minutes to 25 hours.
        // Content that falls outside of ArchiveWindowLength is
        // continuously discarded from storage and is non-recoverable.
        // For a full event archive, set to the maximum, 25 hours.
        ManifestName = manifestName,
        ArchiveWindowLength = TimeSpan.FromHours(1)
    })).Value;
Console.WriteLine("Done");

ストリーミングロケーターを作成する

Note

Media Services アカウントの作成時に、既定のストリーミングエンドポイントが停止状態でアカウントに追加されます。コンテンツのストリーミングを開始し、ダイナミックパッケージと動的暗号化を活用するには、コンテンツのストリーミング元のストリーミングエンドポイントが実行中状態である必要があります。

ストリーミングロケーターを作成して資産を発行します。ライブイベント (DVR ウィンドウの長さまで) は、ストリーミングロケーターの有効期限または削除のいずれか早い方まで表示できます。これは、視聴者がライブおよびオンデマンドで視聴できるようにビデオを利用できるようにする方法です。ライブイベントが完了し、ライブ出力が削除されたときに、ライブイベント、DVR ウィンドウ、またはオンデマンド資産をwatchするために、同じ URL を使用できます。

var streamingLocator = (await mediaServicesAccount.GetStreamingLocators().CreateOrUpdateAsync(
    WaitUntil.Completed,
    streamingLocatorName,
    new StreamingLocatorData
    {
        AssetName = asset.Data.Name,
        StreamingPolicyName = "Predefined_ClearStreamingOnly",
        Filters =
        {
            filter.Data.Name
        }
    })).Value;

イベントの視聴

コードを実行します。出力ストリーミング URL を使用して、ライブイベントをwatchします。ストリーミングロケーターの URL をコピーします。任意のメディアプレーヤーを使用できます。 Media Player デモサイトを使用して、ストリームをテストできます。 URL フィールドに URL を入力し、[ プレーヤーの更新] を選択します。

Event Grid と Event Hubs を使用したライブイベントの監視

サンプルプロジェクトでは、Event Grid と Event Hubs を使用してライブイベントを監視できます。 Event Grid を設定して使用するには、次を使用します。

監視を有効にするには:

Azure portalを使用して Event Hubs 名前空間と Event Hubs を作成する
1. Azure portalの上部にあるテキストボックスを使用して、"Event Hubs" を検索します。
2. 一覧から [Event Hub] を選択し、指示に従って Event Hubs 名前空間を作成します。
3. Event Hubs 名前空間リソースに移動します。
4. ポータルメニューの [エンティティ] セクションから [Event Hubs] を選択します。
5. Event Hubs 名前空間に Event Hubs を作成します。
6. Event Hubs リソースに移動します。
7. [ アクセス制御 ]、[ 追加]、[ ロールの割り当ての追加] の順に選択します。
8. Azure Event Hubs Data Receiver を選択し、自分へのアクセス権を付与します。
9. [ アクセス制御 ]、[ 追加]、[ ロールの割り当ての追加] の順に選択します。
10. Azure Event Hubs データ送信者を選択し、Media Services アカウント用に作成されたマネージド ID に付与します。
Azure portalを使用して Azure Storage アカウントを作成します。
1. ストレージアカウントを作成したら、ストレージアカウントリソースに移動します。
2. [ アクセス制御 ]、[ 追加]、[ ロールの割り当ての追加] の順に選択します。
3. [ストレージ BLOB データ共同作成者] を選択し、このアクセス権を自分に付与します。
イベントサブスクリプションを作成する
1. Media Services アカウントに移動します。
2. ポータルメニューから [ イベント ] を選択します。
3. [+ イベントサブスクリプション] を選択します。
4. サブスクリプション名とシステムアーティクル名を入力します。
5. [エンドポイントの種類] を にEvent Hub設定します。
6. Event Hubs を以前に作成した Event Hubs に設定し、マネージド ID を、以前に Event Hubs への送信者アクセス権が付与された ID に設定します
appsetttings.json ファイルを更新します。
1. EVENT_HUB_NAMESPACE名前空間の完全な名前に設定します。これはに myeventhub.servicebus.windows.net似ているはずです。
2. EVENT_HUB_NAMEを設定します。
3. AZURE_STORAGE_ACCOUNT_NAMEを設定します。

サンプルをもう一度実行します。 Event Hubs 統合を有効にすると、エンコーダーがライブイベントに接続して切断したときにイベントがログに記録されます。その他のさまざまなイベントもログに記録されます。

サンプルを実行した後、Event Hubs とストレージアカウントが不要になった場合は削除します。

Media Services アカウント内のリソースをクリーンアップする

ストリーミングイベントが完了し、以前にプロビジョニングされたリソースをクリーンアップする場合は、次の手順を使用します。

エンコーダーからのストリーミングを停止します。
ライブイベントを停止します。ライブイベントが停止した後は、いかなる課金も発生しません。もう一度開始する必要がある場合は、エンコーダーを再構成する必要がないように、同じ取り込み URL を使用できます。
ライブイベントのアーカイブをオンデマンドストリームとして提供し続ける場合を除き、ストリーミングエンドポイントを停止します。ライブイベントが停止状態の場合は、料金は発生しません。

if (liveOutput != null)
{
    Console.Write("Deleting the Live Output...".PadRight(60));
    await liveOutput.DeleteAsync(WaitUntil.Completed);
    Console.WriteLine("Done");
}

if (liveEvent?.Data.ResourceState == LiveEventResourceState.Running)
{
    Console.Write("Stopping the Live Event...".PadRight(60));
    await liveEvent.StopAsync(WaitUntil.Completed, new LiveEventActionContent() { RemoveOutputsOnStop = true });
    Console.WriteLine("Done");
}

if (liveEvent != null)
{
    Console.Write("Deleting the Live Event...".PadRight(60));
    await liveEvent.DeleteAsync(WaitUntil.Completed);
    Console.WriteLine("Done");
}

if (streamingLocator != null)
{
    Console.Write("Deleting the Streaming Locator...".PadRight(60));
    await streamingLocator.DeleteAsync(WaitUntil.Completed);
    Console.WriteLine("Done");
}

if (asset != null)
{
    Console.Write("Deleting the Asset...".PadRight(60));
    await asset.DeleteAsync(WaitUntil.Completed);
    Console.WriteLine("Done");
}

残りのリソースをクリーンアップする

このチュートリアルで作成した Media Services とストレージアカウントが不要になった場合は、前に作成したリソースグループを削除します。

次の CLI コマンドを実行します。


az group delete --name amsResourceGroup

ヘルプとサポート

Media Services に質問がある場合は、次のいずれかの方法で更新プログラムに従ってください。

Q & A
Stack Overflow。質問にタグを付け、を使用します azure-media-services。
@MSFTAzureMedia するか、@AzureSupport を使用してサポートを要求します。
Azure portalからサポートチケットを開きます。

次の方法で共有

チュートリアル: .NET 7.0 を使用して Media Services でライブストリーミングする

前提条件

サンプルをダウンロードして構成する

.NET SDK で Media Services API の使用を開始する

ライブイベントを作成する

取り込み URL の取得

プレビュー URL を取得する

ライブイベントとライブ出力を作成して管理する

アセットを作成する

ライブ出力を作成する

ストリーミングロケーターを作成する

イベントの視聴

Event Grid と Event Hubs を使用したライブイベントの監視

Media Services アカウント内のリソースをクリーンアップする

残りのリソースをクリーンアップする

ヘルプとサポート

その他のリソース

次の方法で共有

チュートリアル: .NET 7.0 を使用して Media Services でライブストリーミングする

前提条件

サンプルをダウンロードして構成する

.NET SDK で Media Services API の使用を開始する

ライブ イベントを作成する

取り込み URL の取得

プレビュー URL を取得する

ライブ イベントとライブ出力を作成して管理する

アセットを作成する

ライブ出力を作成する

ストリーミング ロケーターを作成する

イベントの視聴

Event Grid と Event Hubs を使用したライブ イベントの監視

Media Services アカウント内のリソースをクリーンアップする

残りのリソースをクリーンアップする

ヘルプとサポート

その他のリソース

ライブイベントを作成する

ライブイベントとライブ出力を作成して管理する

ストリーミングロケーターを作成する

Event Grid と Event Hubs を使用したライブイベントの監視