This sample demonstrates how to create and use Live Events and Live Outputs in the v3 Media Services API. It performs the following tasks:

1. Creates a "standard" pass-through Live Event.
2. Starts monitoring the Live Event using Event Grid and Event Hub.
3. Creates an Asset and an AssetFilter with 5 minutes sliding window and 30 seconds seek back time.
4. Creates a Live Output with 1 hour archive window.
5. Creates a Streaming Locator and associate the Asset Filter with it.
6. Prints URLs for the Live Event.
7. Prints playback URLs for the event archive after the Live Event stops.

This sample shows how to create a "standard" pass-through live event. There are several types of live events available at different pricing points. This is the cheapest option, and takes the source video without transcoding it any further and just packages it for HLS and DASH delivery. You can also choose "basic" pass-through, or from the two cloud transcoding live events for 720P and 1080P adaptive bitrate output. For details on the various types of live events see the article Live events and live outputs in Media Services.

Required Assemblies:

• Azure.Identity
• Azure.ResourceManager.EventGrid
• Azure.ResourceManager.Media
• Azure.ResourceManager.Storage
• Azure.Storage.Blobs
• Azure.Messaging.EventGrid
• Azure.Messaging.EventHubs.Processor
• Microsoft.Extensions.Hosting
• System.Linq.Async

Also required:

• A camera connected to your computer.
• A media encoder. For a recommended encoder, please visit Recommended encoders.
• An Azure Media Services account. See the steps described in Create a Media Services account.

Update the settings in appsettings.json in the root folder of the repository. For more information, see Access APIs.

Then build and run the sample in Visual Studio or Visual Studio Code.

The settings for your account can be retrieved using the following Azure CLI command in the Media Services module. The following bash shell script creates a service principal for the account and returns the json settings.

    #!/bin/bash

    resourceGroup= <your resource group>
    amsAccountName= <your ams account name>
    amsSPName= <your AAD application>

    #Create a service principal with password and configure its access to an Azure Media Services account.
    az ams account sp create
    --account-name $amsAccountName` \\
    --name $amsSPName` \\
    --resource-group $resourceGroup` \\
    --role Owner` \\
    --years 2`

• The following steps should be used if you want to test Event Grid for monitoring. Please note, there are costs for using Event Hub. For more details, refer to Event Hubs overview and Event Hubs pricing.

az provider register --namespace Microsoft.EventGrid

namespace=<unique-namespace-name>
hubname=<event-hub-name>
az eventhubs namespace create --name $namespace --resource-group <resource-group>
az eventhubs eventhub create --name $hubname --namespace-name $namespace --resource-group <resource-group>

hubid=$(az eventhubs eventhub show --name $hubname --namespace-name $namespace --resource-group <resource-group> --query id --output tsv)\
  
amsResourceId=$(az ams account show --name <ams-account> --resource-group <resource-group> --query id --output tsv)\
  
az eventgrid event-subscription create --source-resource-id $amsResourceId --name <event-subscription-name> --endpoint-type eventhub --endpoint $hubid

• Create a storage account and container for Event Processor Host if you don't have one - see Create a Storage account for event processor host

• Update appsettings.json with your Event Hub and Storage information

  • AZURE_STORAGE_ACCOUNT_NAME: The name of your storage account.
  • AZURE_BLOB_CONTAINER_NAME: The name of your container. Click Blobs in your storage account, find you container and copy the name.
  • EVENT_HUB_NAMESPACE: The Event Hub namespace, for example myeventhub.servicebus.windows.net.
  • EVENT_HUB_NAME: The Event Hub instance name. <your namespace> -> Event Hubs.
  • EVENT_HUB_CONSUMER_GROUP_NAME: The name of the consumer group for the event hub processor.

• Dynamic packaging
• Streaming Policies

• Live Event states and billing
• Azure Media Services pricing
• Azure Media Services v3 Documentation