Självstudie: Koda en fjärrfil baserat på URL och strömma videon – .NET
Letar du efter Media Services v2-dokumentation?
Den här självstudien visar hur enkelt det är att koda och börja strömma videor på en mängd olika webbläsare och enheter med hjälp av Azure Media Services. Ett indatainnehåll kan anges med HTTP-URL:er, SAS-URL:er eller sökvägar till filer i Azure Blob Storage. Exemplet i det här ämnet kodar innehåll som du gör tillgängligt via en HTTPS-URL. Observera att AMS v3 för närvarande inte stöder segmentvis överföringskodning över HTTPS-URL:er.
I slutet av självstudien kommer du att kunna strömma en video.
Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.
Förutsättningar
- Installera Visual Studio Code för Windows/macOS/Linux eller Visual Studio 2019 för Windows eller Mac.
- Installera .NET 5.0 SDK
- Skapa ett Media Services konto. Se till att kopiera API-åtkomstinformationen i JSON-format eller lagra de värden som behövs för att ansluta till Media Services-kontot i filformatet .env som används i det här exemplet.
- Följ stegen i Access the Azure Media Services API with the Azure CLI (Komma åt Azure Media Services-API:et med Azure CLI). Se till att spara autentiseringsuppgifterna. Du måste använda dem för att få åtkomst till API:et i det här exemplet eller ange dem i filformatet .env.
Ladda ned och konfigurera exemplet
Klona en GitHub-lagringsplats som innehåller det strömmande .NET-exemplet till din dator med följande kommando:
git clone https://github.com/Azure-Samples/media-services-v3-dotnet-quickstarts.git
Exemplet finns i mappen EncodeAndStreamFiles under AMSV3Quickstarts.
Öppna appsettings.jsi det nedladdade projektet. Ersätt värdena med autentiseringsuppgifterna som du fick från avsnittet om åtkomst till API:er.
Anteckning
Du kan också använda filformatet .env i roten av projektet för att ange dina miljövariabler bara en gång för alla projekt på lagringsplatsen för .NET-exempel. Kopiera bara filen sample.env och fyll sedan i informationen som du fick från Media Services API-åtkomstsidan i Azure Portal eller från Azure CLI. Byt namn på filen sample.env till bara .env för att använda den i alla projekt.
Filen .gitignore har redan konfigurerats för att förhindra att den här filen publiceras på den förked lagringsplatsen.
Exemplet utför följande åtgärder:
- Skapar en transformering (kontrollerar först om den angivna transformeringen finns).
- Skapar en utdatatillgång som används som kodningsjobbsutdata.
- Skapar jobbets indata som baseras på en HTTPS-URL.
- Skickar kodningsjobbet med de indata och utdata som skapades tidigare.
- Kontrollerar jobbets status.
- Skapa en positionerare för direktuppspelning.
- Skapar strömnings-URL:er.
Du kan få beskrivningar av varje funktion i exemplet, undersöka koden och titta på kommentarer i den här källfilen.
Kör exempelappen
När du kör appen visas URL:er som kan användas för uppspelning av video med olika protokoll.
- Öppna AMSV3Quickstarts i VSCode.
- Tryck på Ctrl +F5 för att köra programmet EncodeAndStreamFiles med .NET. Det kan ta några minuter.
- Appen matar ut tre URL:er. Du kommer att använda dessa URL:er för att testa dataströmmen i nästa steg.
I exemplets källkod, kan du se hur URL:en är byggd. För att skapa den, måste du sammanfoga strömningsslutpunktens värdnamn och sökvägen för strömningslokaliseraren.
Testa med Azure Media Player
I den här artikeln används Azure Media Player till att testa strömningen.
Anteckning
Om en spelare finns på en HTTPS-webbplats uppdaterar du URL:en till ”HTTPS”.
Öppna en webbläsare och gå till https://aka.ms/azuremediaplayer/ .
I rutan URL: klistrar du in ett av de strömmande URL-värden som du fick när du körde programmet.
Du kan klistra in URL:en i formatet HLS, Dash eller Smooth så växlar Azure Media Player automatiskt till ett lämpligt strömningsprotokoll för uppspelning på din enhet.
Tryck på Uppdatera spelare. Detta bör börja spela upp videofilen på lagringsplatsen.
Azure Media Player kan användas vid testning, men bör inte användas i en produktionsmiljö.
Rensa resurser
Om du inte längre behöver någon av resurserna i resursgruppen, inklusive de Media Services- och lagringskonton som du skapade för den här självstudien, tar du bort resursgruppen.
Kör följande CLI-kommando:
az group delete --name amsResourceGroup
Granska koden
Du kan få beskrivningar av varje funktion i exemplet, undersöka koden och titta på kommentarer i den här källfilen.
I självstudien för att ladda upp, koda och strömma filer får du ett mer avancerat strömningsexempel med detaljerade förklaringar.
Jobbfelkoder
Se Felkoder.
Flertrådsteknik
SDK:erna i Azure Media Services v3 är inte trådsäkra. När du arbetar med flertrådade program bör du skapa ett nytt AzureMediaServicesClient-objekt per tråd.