Kurz: Kódování vzdáleného souboru na základě adresy URL a streamování videa – .NET
hledáte dokumentaci k Media Services v2?
V tomto kurzu si ukážeme, jak snadné je kódovat a začít streamovat videa v široké škále prohlížečů a zařízení pomocí Azure Media Services. Vstupní obsah se dá specifikovat jako HTTPS, URL, SAS nebo cesta k souboru v úložišti objektů Blob Azure. Ukázka v tomto tématu kóduje obsah, který zpřístupníte prostřednictvím adresy URL protokolu HTTPS. Upozorňujeme, že AMS v3 v současné době nepodporuje blokového kódování přenosu prostřednictvím adresy URL HTTPS.
Na konci tohoto kurzu budete moct streamovat video.
Pokud ještě nemáte předplatné Azure,vytvořte si bezplatný účet před tím, než začnete.
Požadavky
- Nainstalujte Visual Studio Code pro Windows, macOS/Linux nebo Visual Studio 2019 pro Windows nebo Mac.
- Instalace sady .NET 5.0 SDK
- Vytvořte Media Services účet . Nezapomeňte zkopírovat podrobnosti o přístupu rozhraní API ve formátu JSON nebo uložit hodnoty potřebné pro připojení k účtu Media Services ve formátu souboru .env použitém v této ukázce.
- Postupujte podle kroků v části Přístup k rozhraní AZURE MEDIA SERVICES API pomocí Azure CLI. Nezapomeňte uložit přihlašovací údaje. Budete je muset použít pro přístup k rozhraní API v této ukázce nebo je zadat do formátu souboru .env.
Stažení a konfigurace ukázky
Pomocí následujícího příkazu naklonujte do svého počítače úložiště GitHub s ukázkou streamování .NET:
git clone https://github.com/Azure-Samples/media-services-v3-dotnet-quickstarts.git
Ukázka se nachází ve složce EncodeAndStreamFiles v části AMSV3Quickstarts.
Otevřete appsettings.jsve stažených projektech. Nahraďte hodnoty přihlašovacími údaji, které jste získali z přístupu k rozhraním API.
Poznámka
Můžete také použít formát souboru .env v kořenovém adresáři projektu a nastavit proměnné prostředí jenom jednou pro všechny projekty v úložišti ukázek .NET. Stačí zkopírovat soubor sample.env a pak vyplnit informace, které jste získali ze stránky Media Services API Access v Azure Portal nebo z Azure CLI. Přejmenujte soubor sample.env na .env a použijte ho ve všech projektech.
Soubor .gitignore je už nakonfigurovaný tak, aby se zabránilo publikování tohoto souboru do vašeho forku úložiště.
Tato ukázka provede následující akce:
- Vytvoří transformaci (nejprve zkontroluje, jestli zadaná transformace existuje).
- Vytvoří výstupní asset, který se použije jako výstup úlohy kódování.
- Vytvoří vstup úlohy, který je založený na adrese URL protokolu HTTPS.
- Odešle úlohu kódování pomocí dříve vytvořeného vstupu a výstupu.
- Zkontroluje stav úlohy.
- Vytvoří lokátor streamování.
- Vytvoří adresy URL pro streamování.
Popisy týkající jednotlivých funkcí v ukázce najdete v kódu. Můžete se také podívat na komentáře v tomto zdrojovém souboru.
Spuštění ukázkové aplikace
Když spustíte aplikaci, zobrazí se adresy URL, které můžete použít k přehrávání videa pomocí různých protokolů.
- Otevřete AMSV3Quickstarts v nástroji VSCode.
- Stisknutím kombinace kláves Ctrl+F5 spusťte aplikaci EncodeAndStreamFiles pomocí .NET. Může to trvat několik minut.
- Aplikace zobrazí tři adresy URL. Tyto adresy URL použijete k otestování streamu v dalším kroku.
Ve zdrojovém kódu ukázky můžete vidět, jak je adresa URL tvořená. Pokud ji chcete vytvořit, musíte zřetězit název hostitele koncového bodu hostování a cestu lokátoru streamování.
Testování s Azure Media Playerem
Tento článek používá k otestování streamu přehrávač Azure Media Player.
Poznámka
Pokud se přehrávač hostuje na webu HTTPS, nezapomeňte adresu URL aktualizovat tak, aby obsahovala „https“.
Otevřete webový prohlížeč a přejděte na https://aka.ms/azuremediaplayer/ .
Do pole URL: vložte jednu z hodnot adres URL pro streamování, které jste získali při spuštění aplikace.
Adresu URL můžete vložit ve formátu HLS, Dash nebo Smooth a Azure Media Player se automaticky přepne na odpovídající streamovací protokol pro přehrávání na vašem zařízení.
Stiskněte Update Player (Aktualizovat přehrávač). Tím by se měl spustit přehrávání videosouboru v úložišti.
Azure Media Player můžete použít pro účely testování, nesmí se ale používat v produkčním prostředí.
Vyčištění prostředků
Pokud už žádné prostředky ve skupině prostředků nepotřebujete, včetně účtů Media Services a účtů úložiště, které jste pro tento kurz vytvořili, odstraňte skupinu prostředků.
Spusťte následující příkaz rozhraní příkazového řádku:
az group delete --name amsResourceGroup
Kontrola kódu
Popisy týkající jednotlivých funkcí v ukázce najdete v kódu. Můžete se také podívat na komentáře v tomto zdrojovém souboru.
Kurz nahrávání, kódování a streamování souborů vám poskytne složitější příklad streamování s podrobnými vysvětlivkami.
Kódy chyb úlohy
Viz Kódy chyb.
Multithreading
Sady SDK služby Azure Media Services v3 nejsou bezpečné pro přístup z více vláken. Při práci s vícevláknovou aplikací byste měli pro každé vlákno vygenerovat nový objekt AzureMediaServicesClient.