Media Services-livegebeurtenissen

  • Artikel

Media Services-logo v3

Waarschuwing

Azure Media Services wordt op 30 juni 2024 buiten gebruik gesteld. Zie de Handleiding voor buitengebruikstelling van AMS voor meer informatie.

Met Azure Media Services kunt u livegebeurtenissen leveren aan uw klanten in de Azure-cloud.

Tip

Als u migreert vanuit Media Services v2-API's, vervangt de entiteit voor livegebeurtenishet kanaal in v2 en de live-uitvoer vervangt het programma.

Livegebeurtenissen

Livegebeurtenissen opnemen en verwerken live videofeeds. Wanneer u een livegebeurtenis maakt, wordt er een opname-eindpunt gemaakt. Het opname-eindpunt verbruikt een livesignaal van een externe encoder. De externe live encoder verzendt de feed naar het invoereindpunt met behulp van het invoerprotocol RTMP of Smooth Streaming (fragmented-MP4). Voor het RTMP-opnameprotocol kan de inhoud worden verzonden in de duidelijke (rtmp://) of veilig worden versleuteld op de wire(rtmps://). Voor het Smooth Streaming-opnameprotocol zijn http:// de ondersteunde URL-schema's of https://.

De standaardtoewijzing is 5 livegebeurtenissen per Media Services-account. Als u deze limiet wilt verhogen, kunt u een ondersteuningsticket indienen in de Azure Portal.

Typen livegebeurtenissen

Een livegebeurtenis kan worden ingesteld op een eenvoudige of standaard passthrough- of livecodering. De typen worden ingesteld tijdens het maken met behulp van het coderingstype voor livegebeurtenissen.

  • Basispassthrough: een on-premises live encoder verzendt een stream met meerdere bitrates. De basispassthrough is beperkt tot een piek van het inkomend verkeer van 5 Mbps, een DVR-venster van 8 uur en livetranscriptie wordt niet ondersteund.
  • Passthrough-standaard: een on-premises live encoder verzendt een stream met meerdere bitrates. De standaardpassthrough heeft hogere opnamelimieten, een DVR-venster van 25 uur en ondersteuning voor livetranscripties.
  • Standaard: een on-premises live encoder verzendt een enkele bitrate stream naar de livegebeurtenis en Media Services maakt meerdere bitrate streams. Als de bijdragefeed een resolutie van 720p of hoger heeft, codeert de standaardinstelling720p een set van 6 resolutie-/bitratesparen.
  • Premium 1080p: Een on-premises live encoder verzendt een enkele bitrate stream naar de livegebeurtenis en Media Services maakt meerdere bitrate streams. De standaardinstelling1080p geeft de uitvoerset van resolutie-/bitratesparen op.

Notitie

De maximale framesnelheid is 30 fps voor zowel Standard- als Premium-codering.

Passthrough-livegebeurtenis

Wanneer u de eenvoudige of standaard passthrough-livegebeurtenis gebruikt, gebruikt u uw on-premises live-encoder om een videostream met meerdere bitrates te genereren en deze naar de livegebeurtenis te verzenden (met behulp van RTMP of gefragmenteerd MP4-protocol). De livegebeurtenis voert vervolgens de binnenkomende videostreams door zonder verdere verwerking. Een passthrough-livegebeurtenis is geoptimaliseerd voor langlopende livegebeurtenissen of 24x365 lineair live streamen. Wanneer u dit type livegebeurtenis maakt, geeft u passthrough 'basic' of 'standard' op.

U kunt de feed verzenden met resoluties tot 4K en met een framesnelheid van 60 frames per seconde, met videocodecs H.264/AVC of H.265/HEVC (alleen vloeiend opnemen) en AAC-audiocodec (AAC-LC, HE-AACv1 of HE-AACv2). Zie Vergelijking van livegebeurtenistypen voor meer informatie.

Notitie

Het gebruik van een passthrough-methode is de voordeligste manier om live streamen uit te voeren wanneer u meerdere gebeurtenissen gedurende een lange periode uitvoert en u al hebt geïnvesteerd in on-premises encoders. Zie Prijsinformatie .

Live-coderingsgebeurtenis

Wanneer u livecodering gebruikt, configureert u uw on-premises live encoder om één bitrate video naar de livegebeurtenis te verzenden (met behulp van RTMP of Fragmented-Mp4-protocol). Vervolgens stelt u een livegebeurtenis zo in dat deze de binnenkomende single bitrate-stream codeert voor een videostream met meerdere bitrates. Hierdoor wordt de uitvoer beschikbaar voor levering om apparaten af te spelen via protocollen zoals MPEG-DASH, HLS en Smooth Streaming.

In dit geval kunt u de bijdragefeed alleen verzenden met resoluties tot een resolutie van maximaal 1080p bij een framesnelheid van 30 frames per seconde, met H.264/AVC-videocodec en AAC-audiocodec (AAC-LC, HE-AACv1 of HE-AACv2). Zie Vergelijking van livegebeurtenistypen voor meer informatie.

Hls- en DASH-streamingopties met lage latentie

Zie de hls-opties voor lage latentie (LL-HLS) en DASH-streaming en de best practices voor live streamen voor meer informatie over het bereiken van een lage latentie met livegebeurteniscodering.

Uitvoerresolutie en bitrates voor livecodering

De resoluties en bitrates in de resulterende uitvoer van de live encoder worden bepaald door de voorinstelling:

  • Wanneer u de standard live encoder gebruikt, geeft de standaardinstelling720p een set van zes resolutie-/bitsnelheidparen op, van 720p bij 3,5 Mbps omlaag tot 192p bij 200 kbps.
  • Wanneer u een Premium1080p live encoder gebruikt, geeft de standaardinstelling1080p een set van zes resolutie-/bitsnelheidsparen op, van 1080p bij 3,5 Mbps omlaag tot 180p bij 200 kbps.

Zie Systeemwaarden voor meer informatie.

Notitie

Als u de vooraf ingestelde livecodering wilt aanpassen, opent u een ondersteuningsticket via Azure Portal. U moet de gewenste tabel met videoresolutie/bitrates en audiobitrates opgeven. Controleer voor video of er slechts één laag is met 720p en maximaal 6 lagen voor video. Voor audio kunt u aanpassen met de volgende afzonderlijke AAC-audiobitrates (96k, 112k, 128k, 160k, 192k, 224k, 256k, 320k, 384k, 448k, 512k). Meerdere audiosporen met verschillende bitrates zijn toegestaan en kunnen worden opgenomen in de aangepaste voorinstelling. Geef ook op dat u een aangepaste voorinstelling aanvraagt in het ondersteuningsticket.

Zie de REST API voor LiveEventEncodingType of de .Net-, Node.JS - of Python SDK's. U kunt ook de voorbeeldcode van de livegebeurtenis proberen.

Opties voor livegebeurtenissen

Wanneer u een livegebeurtenis maakt, kunt u de volgende opties opgeven:

  • Naam en beschrijving.
  • Voor Standard- en Premium-codering kunt u de stretch-modus van de gecodeerde video kiezen:
    • Geen: respecteert strikt de uitvoerresolutie die is opgegeven in de coderingsinstelling zonder rekening te houden met de hoogte-breedteverhouding van de pixel of weergaveverhouding van de invoervideo.
    • AutoSize: overschrijft de uitvoerresolutie en wijzigt deze zodat deze overeenkomt met de hoogte-breedteverhouding van de invoer, zonder opvulling. Als de invoer bijvoorbeeld 1920x1080 is en de voorinstelling voor codering vraagt om 1280x1280, wordt de waarde in de voorinstelling overschreven en is de uitvoer 1280x720, waardoor de hoogte-breedteverhouding van de invoer 16:9 behouden blijft.
    • AutoAanpassen: de uitvoer (met letterbox of pilaarvak) wordt aangepast aan de uitvoerresolutie, terwijl het actieve videogebied in de uitvoer dezelfde hoogte-breedteverhouding heeft als de invoer. Als de invoer bijvoorbeeld 1920x1080 is en de vooraf ingestelde codering vraagt om 1280x1280, is de uitvoer 1280x1280, die een binnenste rechthoek van 1280x720 met een hoogte-breedteverhouding van 16:9, met kolomvakgebieden van 280 pixels breed aan de linkerkant en rechts.
  • Streaming-protocol RTMP of Smooth Streaming. Opmerking: u kunt de protocoloptie niet wijzigen terwijl de livegebeurtenis of de bijbehorende live-uitvoer wordt uitgevoerd. Als u verschillende protocollen nodig hebt, maakt u een afzonderlijke livegebeurtenis voor elk streamingprotocol.
  • Invoer-id , een wereldwijd unieke id voor de invoerstroom van livegebeurtenissen.
  • Statisch hostnaamvoorvoegsel dat geen bevat (in dat geval wordt een willekeurige 128-bits hexenreeks gebruikt), Naam van livegebeurtenis gebruiken of Aangepaste naam gebruiken. Wanneer u ervoor kiest om een klantnaam te gebruiken, is deze waarde het voorvoegsel Aangepaste hostnaam.
  • Interval van invoersleutelframe, de duur (in seconden) van elk mediasegment in de HLS-uitvoer. De waarde moet een geheel getal zijn dat niet nul is in het bereik van 0,5 tot 20 seconden. De waarde wordt standaard ingesteld op 2 seconden als geen van de intervallen van het invoer- of uitvoersleutelframe is ingesteld. Het sleutelframeinterval is alleen toegestaan voor passthrough-gebeurtenissen.
  • Autostart. Wanneer autostart is ingesteld op true, wordt de livegebeurtenis gestart nadat deze is gemaakt. De facturering wordt gestart zodra de livegebeurtenis wordt uitgevoerd. U moet de livegebeurtenis expliciet stoppen om verdere facturering te stoppen. U kunt de gebeurtenis ook starten wanneer u klaar bent om te beginnen met streamen.
  • IP-beperkingen voor de opname en preview. U kunt de IP-adressen definiëren die een video voor deze livegebeurtenis mogen opnemen. Toegestane IP-adressen kunnen worden opgegeven als één IP-adres (bijvoorbeeld 10.0.0.1), een IP-adresbereik met een IP-adres en een CIDR-subnetmasker (bijvoorbeeld 10.0.0.1/22) of een IP-adresbereik met een IP-adres en een decimaal subnetmasker met punten (bijvoorbeeld , ' 10.0.0.1(255.255.252.0)').
    • Als geen IP-adressen zijn opgegeven en er geen regeldefinitie bestaat, zijn er geen IP-adressen toegestaan. Als u IP-adres(sen) wilt toestaan, maakt u een regel en stelt u 0.0.0.0/0 in. De IP-adressen moeten een van de volgende indelingen hebben: IpV4- of IPv6-adressen met vier getallen of CIDR-adresbereik. Zie De toegang tot DRM-licentie en levering van AES-sleutels beperken met behulp van IP-acceptatielijsten voor meer informatie over het gebruik van IPv4 of IPv6.
    • Als u bepaalde IP-adressen op uw eigen firewalls wilt inschakelen of de invoer van uw livegebeurtenissen wilt beperken tot Azure IP-adressen, downloadt u een JSON-bestand uit IP-adresbereiken van Azure Datacenter. Selecteer de sectie Details op de pagina voor meer informatie over dit bestand.
  • Livetranscriptie die standaard is uitgeschakeld. Lees Livetranscriptie voor meer informatie over livetranscriptie.

StandBy-modus

Wanneer u een livegebeurtenis maakt, kunt u deze instellen op stand-bymodus. Terwijl de gebeurtenis zich in de stand-by-modus bevindt, kunt u de beschrijving en het voorvoegsel van de statische hostnaam bewerken en de instellingen voor invoer en preview-toegang beperken. De StandBy-modus is nog steeds een factureerbare modus, maar is anders geprijsd dan wanneer u een livestream start.

Zie Statussen van livegebeurtenissen en facturering voor meer informatie.

Live-uitvoer

Nadat u een stream van een on-premises encoder naar een livegebeurtenis hebt ingesteld, kunt u de streaminggebeurtenis starten door een asset, live-uitvoer en streaming-locator te maken. Live-uitvoer archiveert de stream en maakt deze beschikbaar voor kijkers via het streaming-eindpunt.

Vragen over uitvoer van livegebeurtenissen

Bekijk de vragen over livegebeurtenissen in de veelgestelde vragen. Zie quota en limieten voor meer informatie over quota voor livegebeurtenissen

Meer informatie over het instellen van livegebeurtenissen

Naamgevingsregels

  • De maximale naam van de livegebeurtenis is 32 tekens.
  • De naam moet dit regex-patroon volgen: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$.

Zie ook Naamconventies voor streaming-eindpunten.

Tip

Om de uniekheid van de naam van uw livegebeurtenis te garanderen, kunt u een GUID genereren en vervolgens alle afbreekstreepjes en accolades (indien aanwezig) verwijderen. De tekenreeks is uniek voor alle livegebeurtenissen en de lengte ervan is gegarandeerd 32.

URL's voor opnemen van livegebeurtenissen

Wanneer de livegebeurtenis is gemaakt, kunt u URL's voor opnemen ophalen die u aan de on-premises live-encoder levert. De live-encoder gebruikt deze URL's voor het invoeren van een live-stream. Zie Aanbevolen on-premises live encoders voor meer informatie.

Notitie

Vanaf de API-release 2020-05-01 worden 'vanity'-URL's statische hostnamen genoemd (useStaticHostname: true)

Notitie

Als u wilt dat een opname-URL statisch en voorspelbaar is voor gebruik in de configuratie van een hardware-encoder, stelt u de eigenschap useStaticHostname in op true en stelt u de eigenschap accessToken in op dezelfde GUID bij elke aanmaak.

  • Niet-statische hostnaam

    Een niet-statische hostnaam is de standaardmodus in Media Services v3 bij het maken van een LiveEvent. U kunt de livegebeurtenis iets sneller toegewezen krijgen, maar de opname-URL die u nodig hebt voor uw live coderingshardware of -software wordt willekeurig weergegeven. De URL wordt gewijzigd als u de livegebeurtenis stopt/start. Niet-statische hostnamen zijn alleen nuttig in scenario's waarin een eindgebruiker wil streamen met behulp van een app die zeer snel een livegebeurtenis moet ophalen en het hebben van een dynamische opname-URL geen probleem is.

    Als een client-app geen opname-URL vooraf hoeft te genereren voordat de livegebeurtenis wordt gemaakt, laat u media services het toegangstoken automatisch genereren voor de livegebeurtenis.

  • Statische hostnamen

    De statische hostnaammodus heeft de voorkeur van de meeste operators die hun live coderingshardware of -software vooraf willen configureren met een RTMP-opname-URL die nooit verandert bij het maken of stoppen/starten van een specifieke livegebeurtenis. Deze operators willen een voorspellende URL voor RTMP-opname die na verloop van tijd niet verandert. Dit is ook erg handig wanneer u een statische URL voor RTMP-opname moet pushen naar de configuratie-instellingen van een hardwarecoderingsapparaat zoals de BlackMagic Atem Mini Pro, of vergelijkbare hardwarecoderings- en productiehulpprogramma's.

    Notitie

    In de Azure Portal heet de URL van de statische hostnaam 'Statisch hostnaamvoorvoegsel'.

    Als u deze modus wilt opgeven in de API, stelt u in useStaticHostNametrue op tijdens het maken (de standaardwaarde is false). Wanneer useStaticHostname is ingesteld op true, geeft de hostnamePrefix het eerste deel van de hostnaam aan die is toegewezen aan de voorbeeldweergave van de livegebeurtenis en opname-eindpunten. De uiteindelijke hostnaam is een combinatie van dit voorvoegsel, de naam van het mediaserviceaccount en een korte code voor het Azure Media Services-datacenter.

    Om een willekeurig token in de URL te voorkomen, moet u ook uw eigen toegangstoken (LiveEventInput.accessToken) doorgeven tijdens het maken. Het toegangstoken moet een geldige GUID-tekenreeks zijn (met of zonder de afbreekstreepjes). Zodra de modus is ingesteld, kan deze niet meer worden bijgewerkt.

    Het toegangstoken moet uniek zijn voor de Azure-regio en voor het Media Services-account. Als uw app een statische url voor opname van hostnamen moet gebruiken, wordt u aangeraden altijd een nieuw GUID-exemplaar te maken voor gebruik met een specifieke combinatie van regio, Media Services-account en livegebeurtenis.

    Gebruik de volgende API's om de statische hostnaam-URL in te schakelen en het toegangstoken in te stellen op een geldige GUID (bijvoorbeeld "accessToken": "1fce2e4b-fb15-4718-8adc-68c6eb4c26a7").

    Taal Url voor statische hostnaam inschakelen Toegangstoken instellen
    REST properties.useStaticHostname LiveEventInput.useStaticHostname
    CLI --use-static-hostname --access-token
    .NET LiveEvent.useStaticHostname LiveEventInput.AccessToken

Naamgevingsregels voor LIVE-opname-URL's

  • De willekeurige tekenreeks hieronder is een 128-bits hexadecimaal getal (bestaande uit 32 tekens, van 0-9 en a-f).
  • uw toegangstoken: de geldige GUID-tekenreeks die u instelt wanneer u de instelling voor de statische hostnaam gebruikt. Bijvoorbeeld "1fce2e4b-fb15-4718-8adc-68c6eb4c26a7".
  • streamnaam: geeft de streamnaam voor een specifieke verbinding aan. De waarde van de streamnaam wordt meestal toegevoegd door de live coderingsprogramma die u gebruikt. U kunt de live encoder configureren om elke naam te gebruiken om de verbinding te beschrijven, bijvoorbeeld: 'video1_audio1', 'video2_audio1', 'stream'.

Waarschuwing

Als u speciale tekens of spaties gebruikt in de naam van uw stream, mislukt de liveopname. Zie Naamconventies voor Media Services-resources in het overzicht van ontwikkelaarsconcepten.

Url voor opname van niet-statische hostnaam

RTMP

rtmp://<random 128bit hex string>.channel.media.azure.net:1935/live/<auto-generated access token>/<stream name>
rtmp://<random 128bit hex string>.channel.media.azure.net:1936/live/<auto-generated access token>/<stream name>
rtmps://<random 128bit hex string>.channel.media.azure.net:2935/live/<auto-generated access token>/<stream name>
rtmps://<random 128bit hex string>.channel.media.azure.net:2936/live/<auto-generated access token>/<stream name>

Vloeiend streamen

http://<random 128bit hex string>.channel.media.azure.net/<auto-generated access token>/ingest.isml/streams(<stream name>)
https://<random 128bit hex string>.channel.media.azure.net/<auto-generated access token>/ingest.isml/streams(<stream name>)

Url voor opname van statische hostnaam

In de volgende paden <live-event-name> betekent dit de naam die aan de gebeurtenis is gegeven of de aangepaste naam die wordt gebruikt bij het maken van de livegebeurtenis.

RTMP

rtmp://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net:1935/live/<your access token>/<stream name>
rtmp://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net:1936/live/<your access token>/<stream name>
rtmps://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net:2935/live/<your access token>/<stream name>
rtmps://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net:2936/live/<your access token>/<stream name>

Vloeiend streamen

http://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net/<your access token>/ingest.isml/streams(<stream name>)
https://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net/<your access token>/ingest.isml/streams(<stream name>)

URL voor livegebeurtenisvoorbeeld

Zodra de livegebeurtenis de bijdragefeed begint te ontvangen, kunt u het preview-eindpunt gebruiken om een voorbeeld te bekijken en te controleren of u de livestream ontvangt voordat u verder publiceert. Nadat u hebt gecontroleerd of de preview-stream goed is, kunt u de livegebeurtenis gebruiken om de livestream beschikbaar te maken voor levering via een of meer (vooraf gemaakte) streaming-eindpunten. Maak hiervoor een nieuwe live-uitvoer voor de livegebeurtenis.

Belangrijk

Zorg ervoor dat de video naar de voorbeeld-URL stroomt voordat u doorgaat.

Langlopende bewerkingen voor livegebeurtenissen

Zie Langlopende bewerkingen voor meer informatie.

Help en ondersteuning

U kunt contact opnemen met Media Services met vragen of onze updates op een van de volgende manieren volgen: