Zelfstudie: Extern bestand coderen op basis van URL en video streamen - .NET
Zoekt u Media Services v2-documentatie?
Deze zelfstudie laat zien hoe u met Azure Media Services eenvoudig video's kunt coderen en streamen naar allerlei verschillende browsers en apparaten. De invoerinhoud kan worden opgegeven met HTTPS-URL's, SAS-URL's of paden naar bestanden in Azure Blob-opslag. Met het voorbeeld in dit onderwerp wordt inhoud gecodeerd die u toegankelijk maakt via een HTTPS-URL. Op dit moment biedt AMS v3 geen ondersteuning voor gesegmenteerde overdrachtscodering via HTTPS-URL's.
Als u deze zelfstudie hebt voltooid, weet u hoe u een video kunt streamen.
Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
Vereisten
- Installeer Visual Studio Code voor Windows/macOS/Linux of Visual Studio 2019 voor Windows of Mac.
- .NET 5.0 SDK installeren
- Een Azure Media Services-account maken. Kopieer de API-toegangsgegevens in JSON-indeling of sla de waarden op die nodig zijn om verbinding te maken met het Media Services-account in de .env-bestandsindeling die in dit voorbeeld wordt gebruikt.
- Volg de stappen in Toegang tot Azure Media Services API met de Azure CLI. Sla de referenties op. U moet ze gebruiken voor toegang tot de API in dit voorbeeld of ze invoeren in de bestandsindeling .env.
Het voorbeeld downloaden en configureren
Gebruik de volgende opdracht om een GitHub-opslagplaats te klonen op uw computer die het .NET-voorbeeld voor het streamen van video bevat:
git clone https://github.com/Azure-Samples/media-services-v3-dotnet-quickstarts.git
Het voorbeeld bevindt zich in de map EncodeAndStreamFiles onder AMSV3Quickstarts.
Open appsettings.json in het project dat u hebt gedownload. Vervang de waarden door referenties die u hebt verkregen via toegang tot API's.
Notitie
U kunt ook de bestandsindeling .env in de hoofdmap van het project gebruiken om uw omgevingsvariabelen slechts één keer in te stellen voor alle projecten in de opslagplaats met .NET-voorbeelden. Kopieer het bestand sample.env en vul vervolgens de gegevens in die u hebt ontvangen van de Media Services API-toegangspagina in het Azure Portal of de Azure CLI. Wijzig de naam van het bestand sample.env in alleen .env om het in alle projecten te gebruiken.
Het bestand .gitignore is al geconfigureerd om te voorkomen dat dit bestand naar uw gevorkte opslagplaats wordt gepubliceerd.
In het voorbeeld worden de volgende acties uitgevoerd:
- Er wordt een transformatie gemaakt (eerst wordt gecontroleerd of de opgegeven transformatie bestaat).
- Er wordt een uitvoer asset gemaakt die wordt gebruikt als uitvoer van de coderings taak.
- De invoer van de taak wordt gemaakt en is gebaseerd op een HTTPS-URL.
- De coderings taak wordt met behulp van de eerder gemaakte invoer en uitvoer verzonden.
- De status van de taak wordt gecontroleerd.
- Er wordt een streaming-locator gemaakt.
- Er worden streaming-URL's samengesteld.
Als u meer wilt weten over de werking van de functies in het voorbeeld, bekijkt u de code en leest u de opmerkingen in dit bronbestand.
De voorbeeld-app uitvoeren
Wanneer u de app uitvoert, worden URL's weergegeven die kunnen worden gebruikt om de video met verschillende protocollen af te spelen.
- Open AMSV3Quickstarts in VSCode.
- Druk op Ctrl+F5 om de toepassing EncodeAndStreamFiles uit te voeren met .NET. Dit kan enkele minuten duren.
- De app geeft drie URL's weer. U gebruikt deze URL's om de stream in de volgende stap te testen.
In de broncode van het voorbeeld kunt u zien hoe de URL is samengesteld. Als u de URL wilt samenstellen, moet u de hostnaam van het streaming-eindpunt en het pad van de streaming-locator samenvoegen.
Testen met Azure Media Player
In dit artikel gebruiken we Azure Media Player om de stream te testen.
Notitie
Als een speler wordt gehost op een https-site, moet u de URL bijwerken naar 'https'.
Open een browser en ga naar https://aka.ms/azuremediaplayer/.
Plak in het vak URL: een van de streaming URL's die u hebt verkregen door het uitvoeren van de toepassing.
U kunt de URL plakken in de HLS-, Dash-, of Smooth-indeling. Azure Media Player schakelt over op naar een geschikt streaming-protocol zodat de stream automatisch op uw apparaat wordt afgespeeld.
Klik op Update Player. Hiermee wordt het videobestand in de opslagplaats afgespeeld.
Azure Media Player kan worden gebruikt voor testdoeleinden, maar mag niet worden gebruikt in een productieomgeving.
Resources opschonen
Als u de resources in de resourcegroep niet meer nodig hebt, met inbegrip van het Media Services-account en de opslagaccounts die u hebt gemaakt voor deze zelfstudie, verwijdert u de resourcegroep.
Voer de volgende CLI-opdracht uit:
az group delete --name amsResourceGroup
De code controleren
Als u meer wilt weten over de werking van de functies in het voorbeeld, bekijkt u de code en leest u de opmerkingen in dit bronbestand.
De zelfstudie Bestanden uploaden, coderen en streamen bevat een geavanceerder voorbeeld voor het streamen van bestanden, met een meer gedetailleerde uitleg.
Foutcodes in taak
Zie Foutcodes.
Multithreading
De SDK's van Azure Media Services v3 zijn niet thread-safe. Als u werkt met een multi-threaded toepassing, moet u per thread een nieuw AzureMediaServicesClient-object genereren.