Kanaal

Artikel
08/05/2023

In Azure Media Services (AMS) vertegenwoordigt de entiteit Channel een pijplijn voor het verwerken van live streaming-inhoud. Een kanaal ontvangt live-invoerstromen op een van de volgende twee manieren:

Een on-premises live encoder verzendt multi-bitrate RTMP of Smooth Streaming (gefragmenteerde MP4) naar het kanaal. U kunt de volgende live coderingsprogramma's gebruiken die multi-bitrate Smooth Streaming uitvoeren: MediaExcel, Imagine Communications, Ateme, Envivio, Cisco en Elemental. De volgende live coderingsprogramma's voeren RTMP uit: Adobe Flash Live Encoder, Haivision, Telestream Wirecast, Teradek- en Tricaster-coderingsprogramma's. De opgenomen stromen passeren kanalen zonder verdere verwerking. Desgevraagd levert Media Services de stream aan klanten.
Er wordt een enkele bitrate-stream (in een van de volgende indelingen: RTP (MPEG-TS), RTMP, of Smooth Streaming (gefragmenteerde MP4)) verzonden naar de Channel die is ingeschakeld voor livecodering met Media Services. De Channel voert vervolgens livecodering uit van de binnenkomende single bitrate-stream naar een multi-bitrate (adaptieve) videostream. Desgevraagd levert Media Services de stream aan klanten.

Vanaf de Release van Media Services 2.10 kunt u, wanneer u een kanaal maakt, opgeven op welke manier uw kanaal de invoerstroom moet ontvangen en of u wilt dat het kanaal de livecodering van uw stream uitvoert. U hebt hiervoor twee opties:

None – Geef deze waarde op als u van plan bent een on-premises live encoder te gebruiken die multi-bitrate stream uitvoert. In dit geval wordt de binnenkomende stroom zonder codering doorgegeven aan de uitvoer. Dit is het gedrag van een kanaal vóór release 2.10. Zie Werken met kanalen die multi-bitrate livestream ontvangen van on-premises encoders voor meer gedetailleerde informatie over het werken met kanalen van dit type.
Standard – Als u Media Services wilt gebruiken voor het coderen van uw single bitrate live stream naar multi-bitrate stream, kiest u deze waarde.

Notitie

Houd er rekening mee dat de facturering gevolgen heeft voor live codering. Houd er rekening mee dat er factureringskosten in rekening worden gebracht als u een live coderingskanaal in de status 'Actief' verlaat. Het wordt aanbevolen om uw actieve kanalen onmiddellijk te stoppen nadat uw livestreaminggebeurtenis is voltooid om extra kosten per uur te voorkomen. Zie Werken met kanalen waarmee Live Encoding kan worden uitgevoerd met Azure Media Services voor meer informatie.

Zie Leveren van live streamen met Azure Media Services voor meer informatie over live streamen en het beheren van kanalen.

Belangrijk

Bij het openen van entiteiten in Media Services moet u specifieke headervelden en -waarden instellen in uw HTTP-aanvragen.
Zie Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Verbinding maken met Media Services met de Media Services REST API) voor meer informatie.

Dit onderwerp geeft een overzicht van de Channel entiteit en laat ook zien hoe u verschillende bewerkingen uitvoert met de Media Services REST API.

Kanalen maken
Kanalen starten
Kanalen stoppen
Kanalen weergeven
Kanalen opnieuw instellen
Kanalen bijwerken
Advertentie starten
Aankondiging beëindigen
Leisteen weergeven
Leisteen verbergen
Kanalen verwijderen

Kanaalentiteit

De Channel entiteit bevat de volgende eigenschappen.

Eigenschap	Type	Beschrijving
`Id` Alleen-lezen. Ingesteld door Media Services.	Edm.String	De kanaal-id, toegewezen bij het maken. De indeling is: nb:chid:UUID:<GUID>.
`Name`	Edm.String	De kanaalnaam. 1. Moet uniek zijn binnen uw Media Services-account. 2. Maximale lengte = 32 tekens. 3. Kan geen spaties bevatten. 4. Alleen afbreekstreepjes en alfanumerieke tekens. 5. Kan niet beginnen of eindigen met een afbreekstreepje.
`Created` Alleen-lezen. Ingesteld door Media Services.	Edm.DateTime	Een UTC-datum/tijd-waarde die de tijd van het maken aangeeft.
`Description`	Edm.String	Door de gebruiker opgegeven beschrijving. De maximale lengte is 256 tekens.
`LastModified` Alleen-lezen. Ingesteld door Media Services.	Edm.DateTime	De datum en tijd van de laatste update voor het kanaal.
`State` Alleen-lezen. Ingesteld door Media Services.	Edm.String	De huidige status van het kanaal. Mogelijke waarden zijn: -Gestopt. Dit is de oorspronkelijke status van het kanaal na het maken ervan. In deze status kunnen de kanaaleigenschappen worden bijgewerkt, maar streamen is niet toegestaan. -Beginnen. Het kanaal wordt gestart. Er zijn geen updates of streaming toegestaan tijdens deze status. Als er een fout optreedt, keert het kanaal terug naar de status Gestopt . -Met. Het kanaal kan livestreams verwerken. -Stoppen. Het kanaal wordt gestopt. Er zijn geen updates of streaming toegestaan tijdens deze status. -Verwijderen. Het kanaal wordt verwijderd. Er zijn geen updates of streaming toegestaan tijdens deze status.
`Input`	ChannelInput ComplexType	Instellingen voor kanaalinvoer (opnemen).
`Output`	ChannelOutput ComplexType	Instellingen voor kanaaluitvoer.
`Preview`	ChannelPreview ComplexType	Instellingen voor kanaalvoorbeeld.
`CrossSiteAccessPolicies`	CrossSiteAccessPolicies	Toegangsbeleid voor meerdere sites.
`Programs` Alleen-lezen. Ingesteld door Media Services.	Een verzameling programma's.	Een verwijzing naar de verzameling programma's die zijn gekoppeld aan het kanaal.
`EncodingType`	Edm.String	`Optional`. Beschrijft de configuratie van het kanaal. Toegestane waarden zijn: - `None` – Dit is de standaardwaarde. Wanneer u deze waarde selecteert, wordt de binnenkomende stroom zonder codering doorgegeven aan de uitvoer (dit is het gedrag van een kanaal vóór release 2.10). - `Standard` – De inkomende single bitrate stream wordt verzonden naar het kanaal en getranscodeerd in een multi-bitrate stream met behulp van systeeminstellingen
`Encoding`	Encoding ComplexType	Instellingen voor Azure Live Encoder.
`Slate`	Leisteen	Deze instelling wordt alleen ondersteund wanneer de `Encoding Type` van het kanaal is ingesteld op `Standard`. De live-encoder in het kanaal kan worden gesignaleerd om over te schakelen naar een slate-afbeelding. Het kan ook worden gesignaleerd om een lopende lei te beëindigen. De live encoder kan worden geconfigureerd om over te schakelen naar een slate-afbeelding en het binnenkomende videosignaal in bepaalde situaties te maskeren, bijvoorbeeld tijdens een advertentie-onderbreking. Als een dergelijke slate niet is geconfigureerd, wordt de invoervideo niet gemaskeerd tijdens dat advertentie-einde.

ChannelInput ComplexType

Naam	Type	Beschrijving
`KeyFrameInterval`	Edm.Time	Deze waarde wordt genegeerd als `EncoderType` is ingesteld op `Standard`. Wanneer u een on-premises live-encoder gebruikt om een multi-bitrate stream te genereren, geeft het sleutelframeinterval gop-duur op (zoals gebruikt door die externe encoder). Zodra deze inkomende stream is ontvangen door het kanaal, kunt u uw livestream leveren aan clienttoepassingen voor afspelen in een van de volgende indelingen: Smooth Streaming, DASH en HLS. Bij live streamen wordt HLS altijd dynamisch verpakt. Standaard berekent Media Services automatisch de hls-segmentverpakkingsverhouding (fragmenten per segment) op basis van het sleutelframeinterval, ook wel Group of Pictures – GOP genoemd, dat wordt ontvangen van de live encoder.
`StreamingProtocol` Alleen-lezen.	Edm.String	Nadat u het encodertype hebt ingesteld, kunt u een opnameprotocol instellen. Als de `Encoder Type` is ingesteld op `None`, zijn geldige opties: - Multi-bitrate Gefragmenteerde MP4 (Smooth Streaming) - Multi-bitrate RTMP Wanneer uw `Encoder Type` is ingesteld op `None`, is het geldig, maar ongewenst, dat een single bitrate RTMP of Smooth Streaming live stream wordt verzonden. Het kanaal voert geen verwerking uit met de stroom, dus deze wordt doorgegeven, maar de clienttoepassingen krijgen één bitrate-stroom. Als de `Encoder Type` is ingesteld op `Standard`, zijn geldige opties: 1. Single bitrate Fragmented MP4 (Smooth Streaming) 2. Single bitrate RTMP 3. RTP (MPEG-TS): MPEG-2 Transport Stream via RTP.
`AccessControl`	ChannelInputAccessControl ComplexType	Instellingen voor toegangsbeheer voor kanaalinvoer.
`Endpoints` Alleen-lezen.	ChannelEndpoint ComplexType	Kanaalinvoereindpunten. Een kanaal biedt invoereindpunten (url's voor opnemen) die u vervolgens gebruikt om uw livestream op te nemen. Het kanaal ontvangt live-invoerstreams en maakt de uitvoerstromen beschikbaar voor streaming via een of meer streaming-eindpunten.

ChannelPreview ComplexType

Zie Overview of Channels that are enabled for Live Encoding (Overzicht van kanalen die zijn ingeschakeld voor Live Encoding) voor meer informatie over dit type en de eigenschappen ervan.

Naam	Type	Beschrijving
`AccessControl`	ChannelPreviewAccessControl ComplexType	Instellingen voor toegangsbeheer voor kanaalvoorbeeld.
`Endpoints` Alleen-lezen.	ChannelEndpoint ComplexType	Eindpunten voor kanaalvoorbeelden.

ChannelInputAccessControl ComplexType

Naam	Type	Beschrijving
`IP`	IPAccessControl	IP-adressen die verbinding mogen maken met kanaalinvoereindpunten. IP-adressen moeten een van de volgende indelingen hebben: IpV4-adres met 4 cijfers, CIDR-adresbereik.

ChannelPreviewAccessControl ComplexType

Zie Overview of Channels that are enabled for Live Encoding (Overzicht van kanalen die zijn ingeschakeld voor Live Encoding) voor meer informatie over dit type en de eigenschappen ervan.

Naam	Type	Beschrijving
`IP`	IPAccessControl	IP-adressen die verbinding mogen maken met kanaalinvoereindpunten. IP-adressen moeten een van de volgende indelingen hebben: IpV4-adres met 4 nummers, CIDR-adresbereik

IPAccessControl

Zie Overview of Channels that are enabled for Live Encoding (Overzicht van kanalen die zijn ingeschakeld voor Live Encoding) voor meer informatie over dit type en de eigenschappen ervan.

Naam	Type	Beschrijving
Toestaan	IPRange ComplexType	IP-adressen die verbinding mogen maken met kanaalinvoereindpunten. Opmerking: Als u deze waarde instelt op null, kunnen alle IP-bronadressen verbinding maken. Als u deze instelt op een lege tekenreeks ("") kan niemand verbinding maken.

IPRange ComplexType

Zie Overview of Channels that are enabled for Live Encoding (Overzicht van kanalen die zijn ingeschakeld voor Live Encoding) voor meer informatie over dit type en de eigenschappen ervan.

Naam	Type	Description
`Name`	Edm.String	Een beschrijvende naam voor dit IP-bereik.
`Address`	Edm.String	Het basis-IP-adres voor de subnetweergave (bijvoorbeeld:192.168.0.1).
`SubnetPrefixLength`	Edm.Int32	Het aantal significante bits voor het subnetmasker (bijvoorbeeld in het volgende IP-adres 192.168.0.1/24 vertegenwoordigt 24 het aantal significante bits).

ChannelEndpoint ComplexType

Naam	Type	Description
`Protocol`	Edm.String	Het eindpuntprotocol voor kanaalstreaming.
`Url`	Edm.String	De eindpunt-URL voor kanaalstreaming.

ChannelOutput ComplexType

Zie Overview of Channels that are enabled for Live Encoding (Overzicht van kanalen die zijn ingeschakeld voor Live Encoding) voor meer informatie over dit type en de eigenschappen ervan.

Naam	Type	Beschrijving
`Hls`	ChannelOutputHls ComplexType	De hls-specifieke instellingen.

ChannelOutputHls ComplexType

Zie Overzicht van kanalen die zijn ingeschakeld voor Live Encoding voor meer gedetailleerde informatie over dit type en de bijbehorende eigenschappen.

Naam	Type	Beschrijving
`FragmentsPerSegment`	Edm.Int16	Het aantal fragmenten per HLS-segment (HTTP Live Streaming).

Encoding ComplexType

Zie Overzicht van kanalen die zijn ingeschakeld voor Live Encoding voor meer gedetailleerde informatie over dit type en de bijbehorende eigenschappen.

Naam	Type	Description
`AdMarkerSource`	Edm.String	U kunt de bron voor signalen van advertentiemarkeringen opgeven. De standaardwaarde is `Api`, wat aangeeft dat de live encoder in het kanaal moet luisteren naar een asynchrone `Ad Marker API`. De andere geldige optie is `Scte35` (alleen toegestaan als het protocol voor opnamestreaming is ingesteld op `RTP (MPEG-TS).` Wanneer `Scte35` is opgegeven, parseert `SCTE-35` de encoder signalen van de invoer-RTP-stroom (MPEG-TS).
`IgnoreCea708ClosedCaptions`	Edm.bool	`Optional`. Een optionele vlag die de live encoder vertelt dat CEA 708-bijschriftgegevens die in de binnenkomende video zijn ingesloten, moet worden genegeerd. Wanneer de vlag is ingesteld op false (standaard), detecteert de encoder CEA 708-gegevens en voegt deze opnieuw in de uitvoervideostreams in.
`VideoStream`	VideoStream	`Optional`. Beschrijft de invoervideostream. Als dit veld niet is opgegeven, wordt de standaardwaarde gebruikt. Deze instelling is alleen toegestaan als het invoerstreamingprotocol is ingesteld op RTP (MPEG-TS).
`AudioStreams`	AudioStreams	`Optional`. Beschrijft de invoeraudiostreams. Als dit veld niet is opgegeven, zijn de opgegeven standaardwaarden van toepassing. Deze instelling is alleen toegestaan als het invoerstreamingprotocol is ingesteld op RTP (MPEG-TS).
`SystemPreset`	Edm.String	Hiermee geeft u de vooraf ingestelde encoder op die voor dit kanaal moet worden gebruikt. Op dit moment is `Default720p` (standaard) de enige toegestane waarde. Zie SystemPreset voor meer informatie.

SystemPreset

Default720p geeft aan om de video te coderen naar de volgende 6 lagen.

Bitrate	Breedte	Hoogte	MaxFPS	Profiel	Naam van uitvoerstroom
3500	1280	720	30	Hoog	Video_1280x720_3500kbps
2200	960	540	30	Hoog	Video_960x540_2200kbps
1350	704	396	30	Hoog	Video_704x396_1350kbps
850	512	288	30	Hoog	Video_512x288_850kbps
550	384	216	30	Hoog	Video_384x216_550kbps
200	340	192	30	Hoog	Video_340x192_200kbps

Audio wordt gecodeerd naar stereo AAC-LC met 64 kbps, een samplingfrequentie van 44,1 kHz.

Zie Overzicht van kanalen die zijn ingeschakeld voor Live Encoding voor meer gedetailleerde informatie over dit type en de bijbehorende eigenschappen.

VideoStream

Beschrijft de invoervideostream. Als dit veld niet is opgegeven, wordt de standaardwaarde gebruikt. Deze instelling is alleen toegestaan als het invoerstreamingprotocol is ingesteld op RTP (MPEG-TS).

Naam	Type	Beschrijving
`Index`	Edm.Int1	Een op nul gebaseerde index die aangeeft welke invoervideostream moet worden verwerkt door de live-encoder in het kanaal. Deze instelling is alleen van toepassing als het opnamestreamingprotocol RTP (MPEG-TS) is. De standaardwaarde is nul. Het wordt aanbevolen om een transportstroom van één programma (SPTS) te verzenden. Als de invoerstroom meerdere programma's bevat, parseert de live-encoder de Program Map Table (PMT) in de invoer, identificeert de invoer met de naam van het stroomtype MPEG-2 Video of H.264 en rangschikt deze in de volgorde die is opgegeven in de PMT. De op nul gebaseerde index wordt vervolgens gebruikt om de n-th-vermelding in die rangschikking op te halen.
`Name`	Edm.String	`Optional`. Beschrijvende tag voor deze invoervideostream.

Zie Overzicht van kanalen die zijn ingeschakeld voor Live Encoding voor meer gedetailleerde informatie over dit type en de bijbehorende eigenschappen.

AudioStreams

Beschrijft de invoeraudiostreams. Als dit veld niet is opgegeven, zijn de opgegeven standaardwaarden van toepassing. Deze instelling is alleen toegestaan als het invoerstreamingprotocol is ingesteld op RTP (MPEG-TS).

Naam	Type	Beschrijving
`Index`	Edm.Int16	Het wordt aanbevolen om een transportstroom van één programma (SPTS) te verzenden. Als de invoerstroom meerdere programma's bevat, parseert de live-encoder in het kanaal de Program Map Table (PMT) in de invoer, identificeert de invoer met een stroomtypenaam MPEG-2 AAC ADTS of AC-3 System-A of AC-3 System-B of MPEG-2 Private PES of MPEG-1 Audio of MPEG-2 Audio en rangschikt deze in de volgorde die is opgegeven in de PMT. De op nul gebaseerde index wordt vervolgens gebruikt om de n-th-vermelding in die rangschikking op te halen.
`Name`	Edm.String	`Optional`. Beschrijvende tag voor deze invoeraudiostream.
`Language`	Edm.String	`Optional`. De taal-id van de audiostream, die voldoet aan ISO 639-2, zoals ENG. Als deze niet aanwezig is, is de standaardwaarde UND (undefined). Er kunnen maximaal 8 audiostreamsets worden opgegeven als de invoer voor het kanaal MPEG-2 TS via RTP is. Er kunnen echter geen twee vermeldingen zijn met dezelfde waarde van Index.

Er kunnen maximaal 8 {Index, Name, Language} sets zijn opgegeven als de invoer voor de encoder MPEG-2 TS via RTP is. Er kunnen echter geen twee vermeldingen zijn met dezelfde waarde van Index. Als de invoer voor de encoder RTMP of HTTP (Smooth Streaming) is, kan er slechts één audiostream in de invoer zijn.

Leisteen

Deze instelling wordt alleen ondersteund wanneer de Encoding Type van het kanaal is ingesteld op Standard.

De live encoder in het kanaal kan worden gesignaleerd om over te schakelen naar een slate-afbeelding. Het kan ook worden gesignaleerd om een lopende lei te beëindigen.

De live-encoder kan worden geconfigureerd om over te schakelen naar een slate-afbeelding en het binnenkomende videosignaal in bepaalde situaties te maskeren, bijvoorbeeld tijdens een advertentie-onderbreking. Als een dergelijke slate niet is geconfigureerd, wordt invoervideo niet gemaskeerd tijdens dat advertentie-einde.

Naam	Type	Beschrijving
`InsertSlateOnAdMarker`	Edm.Bool	Als deze instelling is ingesteld op Waar, configureert u de live-encoder om een slate-afbeelding in te voegen tijdens een advertentie-einde. De standaardwaarde is waar.
`DefaultSlateAssetId`	Edm.String	`Optional`. Hiermee geeft u de asset-id van de Media Services-asset die de slate-afbeelding bevat. De standaardwaarde is null. Voordat u het kanaal maakt, moet de slate-afbeelding met een maximale resolutie van 1920 x 1080 in JPEG-indeling en maximaal 3 Mbytes worden geüpload als een toegewezen asset (er mogen geen andere bestanden in deze asset zijn). De bestandsnaam moet de extensie *.jpg hebben en dit AssetFile moet worden gemarkeerd als het primaire bestand voor die asset. Deze asset kan niet worden versleuteld met opslag. Als de standaard-id van de slate-asset niet is opgegeven en slate invoegen in de advertentiemarkering is ingesteld op true, wordt een standaardAfbeelding van Azure Media Services gebruikt om de invoerstroom te maskeren.

Zie Overzicht van kanalen die zijn ingeschakeld voor Live Encoding voor meer gedetailleerde informatie over dit type en de bijbehorende eigenschappen.

Kanalen maken

Kanalen kunnen worden gemaakt met behulp van een POST HTTP-aanvraag en het opgeven van eigenschapswaarden.

Methode	Aanvraag-URI	HTTP-versie
POST	<https:// accountnaam.restv2>.<location.media.azure.net/api/Channels>	HTTP/1.1

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de meest recente x-ms-version:versie.

Aanvraagheaders:

POST https://testrest.cloudapp.net/api/Channels HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

In de volgende aanvraagbody ziet u hoe u een kanaal maakt dat is ingeschakeld voor live codering.

{  
   "Id":null,  
   "Name":"testchannel001",     
   "Description":"",  
   "EncoderType":"Standard",  
   "Created":"0001-01-01T00:00:00",  
   "LastModified":"0001-01-01T00:00:00",  
   "State":null,  
   "Input":  
   {  
      "StreamingProtocol":"RTPMPEG2TS",  
      "AccessControl":  
      {  
         "IP":  
         {  
         "Allow":  
            [  
               {  
                  "Name":"testName1",  
                  "Address":"1.1.1.1",  
                  "SubnetPrefixLength":24  
               }  
            ]  
         }  
      },  
      "Endpoints":[]  
   },  
   "Encoding":  
   {  
      "SystemPreset":"Default720p",  
      "IgnoreCea708ClosedCaptions": false,  
      "AdMarkerSource": "Api",
      "VideoStream":  
      {  
         "Index":1,  
         "Name":"Video stream"  
      },  
      "AudioStreams":  
      [  
         {  
            "Index":0,  
            "Name":"English audio stream",  
            "Language":"ENG"  
         },  
         {  
            "Index":1,  
            "Name":"Spanish audio stream",  
            "Language":"SPA"  
         }  
      ]  
   },  
   "EncodingType": "Standard",  
   "Slate":  
   {  
      "InsertOnAdMarker":true,  
      "DefaultSlateAssetId": "nb:cid:UUID:01234567-0123-0123-0123-01234567"  
   },  
   "Preview":  
   {  
      "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":  
            [  
               {  
                  "Name":"testName1",  
                  "Address":"1.1.1.1",  
                  "SubnetPrefixLength":24  
               }  
            ]  
         }  
      },  
      "Endpoints":[]  
   }  
}

In de volgende aanvraagbody ziet u hoe u een kanaal maakt in het account dat niet is ingeschakeld voor live codering.

{  
"Id":null,  
"Name":"testchannel001",  
"Description":"",  
"Created":"0001-01-01T00:00:00",  
"LastModified":"0001-01-01T00:00:00",  
"State":null,  
"Input":  
   {  
   "KeyFrameInterval":null,  
   "StreamingProtocol":"FragmentedMP4",  
   "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":[{"Name":"testName1","Address":"1.1.1.1","SubnetPrefixLength":24}]  
         }  
      },  
   "Endpoints":[]  
   },  
"Preview":  
   {  
   "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":[{"Name":"testName1","Address":"1.1.1.1","SubnetPrefixLength":24}]  
         }  
      },  
      "Endpoints":[]  
   },  
"Output":  
   {  
   "Hls":  
      {  
         "FragmentsPerSegment":1  
      }  
   },  
"CrossSiteAccessPolicies":  
   {  
      "ClientAccessPolicy":null,  
      "CrossDomainPolicy":null  
   }  
}

Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd, samen met een weergave van de gemaakte entiteit in de antwoordtekst.

De statuscode 202 Geaccepteerd geeft een asynchrone bewerking aan. In dat geval wordt de waarde van de header operation-id ook opgegeven voor het pollen en bijhouden van de status van langlopende bewerkingen, zoals het starten of stoppen van een kanaal. Geef de waarde van de header operation-id door aan de bewerkingsentiteit om de status op te halen. Zie Handmatig polling Long-Running bewerkingen voor meer informatie.

Kanalen starten

Methode	Aanvraag-URI	HTTP-versie
POST	<https:// accountnaam.restv2>.<location.media.azure.net/api/Channels>('channelid')/Start	HTTP/1.1

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de meest recente x-ms-version:versie.

Aanvraagheaders:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Start HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd. De statuscode 202 Geaccepteerd geeft een asynchrone bewerking aan. In dat geval wordt de waarde van de header operation-id ook opgegeven voor het pollen en bijhouden van de status van langlopende bewerkingen, zoals het starten of stoppen van een kanaal. Geef de waarde van de header operation-id door aan de bewerkingsentiteit om de status op te halen. Zie Handmatig polling Long-Running bewerkingen voor meer informatie.

Kanalen stoppen

Een kanaal kan alleen worden gestopt wanneer het de status Actief heeft en alle programma's op het kanaal zijn gestopt.

Methode	Aanvraag-URI	HTTP-versie
POST	<https:// accountnaam.restv2>.<location.media.azure.net/api/Channels>('channelid')/Stop	HTTP/1.1

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de meest recente x-ms-version:versie.

Aanvraagheaders:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Stop HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Kanalen weergeven

Kanalen kunnen worden opgehaald met behulp van een GET HTTP-aanvraag.

Methode	Aanvraag-URI	HTTP-versie
GET	Alle kanalen ophalen: <https:// accountnaam.restv2>.<location.media.azure.net/api/Channels> Haal een opgegeven kanaal op. <https:// accountnaam.restv2>.<location.media.azure.net/api/Channels>('channelid')	HTTP/1.1

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de nieuwste x-ms-version:versie.

Aanvraagheaders:

GET https://testrest.cloudapp.net/api/Channels HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Als dit lukt, retourneert deze bewerking een 200 OK-statuscode en een lijst met alle kanalen die in uw Media Services-account zijn gemaakt.

Kanalen opnieuw instellen

Hiermee wordt de status van het runtimekanaal opnieuw ingesteld tijdens het streamen van een livepresentatie en kan een kanaal opnieuw worden gebruikt in het geval van opnieuw instellen van de presentatie of het opnieuw configureren van de encoder. Stop alle programma's voordat u Opnieuw instellen aanroept. Opnieuw instellen kan worden aangeroepen op een kanaal dat actief is.

Methode	Aanvraag-URI	HTTP-versie
POST	<https:// accountnaam.restv2>.<location.media.azure.net/api/Channels>('channelid')/Reset	HTTP/1.1

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de nieuwste x-ms-version:versie.

Aanvraagheaders:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Reset HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd. De statuscode 202 Geaccepteerd geeft een asynchrone bewerking aan. In dat geval wordt de waarde van de bewerkings-id-header ook opgegeven voor het pollen en bijhouden van de status van langlopende bewerkingen, zoals het starten of stoppen van een kanaal. Geef de waarde van de operation-id-header door aan de bewerkingsentiteit om de status op te halen. Zie Handmatig polling Long-Running-bewerkingen voor meer informatie.

Kanalen bijwerken

Updates eigenschappen op een bestaand kanaal. Het kanaal moet de status Gestopt hebben.

Methode	Aanvraag-URI	HTTP-versie
PATCH/PUT/MERGE Zie PATCH/PUT/MERGE voor meer informatie over deze bewerkingen.	<https:// accountnaam.restv2>.<location.media.azure.net/api/Channels>('channelid')	HTTP/1.1

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de nieuwste x-ms-version:versie.

Aanvraagheaders:

PATCH https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393') HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Aanvraagtekst:

"Encoding":{"IgnoreCea708ClosedCaptions": true}

Als de update synchroon wordt voltooid, wordt de statuscode 204 Geen inhoud geretourneerd. Anders wordt de statuscode 202 Geaccepteerd geretourneerd. De statuscode 202 Geaccepteerd geeft een asynchrone bewerking aan. In dat geval wordt de waarde van de bewerkings-id-header ook opgegeven voor het pollen en bijhouden van de status van langlopende bewerkingen, zoals het starten of stoppen van een kanaal. Geef de waarde van de operation-id-header door aan de bewerkingsentiteit om de status op te halen. Zie Handmatig polling Long-Running-bewerkingen voor meer informatie.

Start-advertentie

De live encoder kan worden gesignaleerd om een advertentie of commerciële onderbreking te starten met behulp van een POST HTTP-aanvraag en het opgeven van eigenschapswaarden van de in de entiteit StartAdvertisement Entity in de hoofdtekst van de aanvraag.

Methode	Aanvraag-URI	HTTP-versie
POST	<https:// accountnaam.restv2>.<location.media.azure.net/api/Channels>('channeled')/StartAdvertisement	HTTP/1.1

Zie Overzicht van kanalen die zijn ingeschakeld voor Live Encoding voor meer informatie.

StartAdvertisement-entiteit

Deze entiteit vertegenwoordigt de start-of-advertisement-API. Het is een asynchrone aanroep naar de live-encoder om een advertentie of commerciële onderbrekingen in de uitvoerstroom in te voegen.

Zie Overzicht van kanalen die zijn ingeschakeld voor Live Encoding voor meer informatie.

Naam	Type	Beschrijving
`duration`	Edm.Duration	De duur, in seconden, van de commerciële onderbreking. Dit moet een niet-nul positieve waarde zijn om de commerciële onderbreking te starten. Wanneer een commerciële onderbreking wordt uitgevoerd en de duur is ingesteld op nul en de CueId overeenkomt met de lopende commerciële onderbreking, wordt die onderbreking geannuleerd.
`cueId`	Edm.Int	Unieke id voor de commerciële onderbreking, die door de downstreamtoepassing moet worden gebruikt om de juiste actie(en) te ondernemen. Moet een positief geheel getal zijn.
`showSlate`	Edm.Bool	`Optional`. Geeft aan de live-encoder in het kanaal aan dat deze tijdens de commerciële onderbreking moet overschakelen naar de standaard slate-afbeelding (en de binnenkomende videofeed maskeren). De standaardinstelling is onwaar. De gebruikte installatiekopieën zijn de installatiekopieën die zijn opgegeven via de standaardasset-id-eigenschap slate op het moment dat het kanaal wordt gemaakt.

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de nieuwste x-ms-version:versie.

Aanvraagheaders:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/StartAdvertisement HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Hoofdtekst

{  
   "duration":"PT45S",  
   "cueId":"67520935",  
   "showSlate":"true"  
}

Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd.

Einde advertentie

De live encoder kan worden gesignaleerd om een voortdurende advertentie of commerciële onderbreking te beëindigen met behulp van een POST HTTP-aanvraag.

Methode	Aanvraag-URI	HTTP-versie
POST	<https:// accountnaam.restv2>.<location.media.azure.net/api/Channels>('channeled')/EndAdvertisement	HTTP/1.1

Deze aanroep mag alleen worden aangeroepen wanneer er een voortdurende advertentie is.

Zie Overzicht van kanalen die zijn ingeschakeld voor Live Encoding voor meer informatie.

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de nieuwste x-ms-version:versie.

Aanvraagheaders:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/EndAdvertisement HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd.

Leisteen weergeven

Geeft aan de live-encoder in het kanaal aan dat deze tijdens de commerciële onderbreking moet overschakelen naar de standaard slate-afbeelding (en de binnenkomende videofeed maskeren). De standaardinstelling is onwaar. De gebruikte installatiekopieën zijn de installatiekopieën die zijn opgegeven via de standaardasset-id-eigenschap slate op het moment dat het kanaal wordt gemaakt.

Gebruik eigenschappen van De entiteit ShowSlate in de hoofdtekst van de HTTP-aanvraag.

Methode	Aanvraag-URI	HTTP-versie
POST	<https:// accountnaam.restv2>.<location.media.azure.net/api/Channels>('channeled')/ShowSlate	HTTP/1.1

Zie Overzicht van kanalen die zijn ingeschakeld voor Live Encoding voor meer informatie.

ShowSlate-entiteit

Zie Overzicht van kanalen die zijn ingeschakeld voor Live Encoding voor meer informatie.

Naam	Type	Beschrijving
`duration`	Edm.Duration	De duur, in seconden, van de lei. Dit moet een niet-nul positieve waarde zijn om de slate te starten. Als er een lopende lei is en de duur van nul is opgegeven, wordt die lopende lei beëindigd.
`assetId`	Edm.String	Hiermee geeft u de asset-id van de Media Services-asset die de slate-afbeelding bevat. Voordat u het kanaal maakt, moet de leisteenafbeelding, met een resolutie van 1920 x 1080, in JPEG-indeling en maximaal 3 Mbytes groot, worden geüpload als een toegewezen asset (er mogen geen andere bestanden in deze asset zijn). De encoder kan worden gesignaleerd om over te schakelen naar een willekeurige slate-installatiekopie (en niet alleen de afbeelding die is opgegeven via de eigenschap DefaultSlateAssetId op het moment van het maken van het kanaal).

Als de DefaultSlateAssetId eigenschap is opgegeven en AssetId niet is opgegeven, wordt de DefaultSlateAssetId afbeelding gebruikt om de invoerstroom te maskeren. Zie Slate voor meer informatie.

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de nieuwste x-ms-version:versie.

Aanvraagheaders:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/ShowSlate HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Hoofdtekst

{  
   "duration":"PT45S",  
   "assetId":"nb:cid:UUID:01234567-ABCD-ABCD-EFEF-01234567"  
}

Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd.

Leisteen verbergen

De live encoder kan worden gesignaleerd om een lopende slate te beëindigen met behulp van een POST HTTP-aanvraag.

Methode	Aanvraag-URI	HTTP-versie
POST	<https:// accountnaam.restv2>.<location.media.azure.net/api/Channels>('channelid')/HideSlate	HTTP/1.1

Deze aanroep mag alleen worden aangeroepen wanneer er een lopende slate is.

Zie Overzicht van kanalen die zijn ingeschakeld voor Live Encoding voor meer informatie.

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de nieuwste x-ms-version:versie.

Aanvraagheaders:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/HideSlate HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd. De statuscode 202 Geaccepteerd geeft een asynchrone bewerking aan. In dat geval wordt de waarde van de bewerkings-id-header ook opgegeven voor het pollen en bijhouden van de status van langlopende bewerkingen, zoals het starten of stoppen van een kanaal. Geef de waarde van de operation-id-header door aan de bewerkingsentiteit om de status op te halen. Zie Handmatig polling Long-Running-bewerkingen voor meer informatie.

Kanalen verwijderen

Een kanaal verwijderen.

Methode	Aanvraag-URI	HTTP-versie
DELETE	<https:// accountnaam.restv2>.<location.media.azure.net/api/Channels>('channelid')	HTTP/1.1

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de nieuwste x-ms-version:versie.

Aanvraagheaders:

DELETE https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393') HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd. De statuscode 202 Geaccepteerd geeft een asynchrone bewerking aan. In dat geval wordt de waarde van de bewerkings-id-header ook opgegeven voor het pollen en bijhouden van de status van langlopende bewerkingen, zoals het starten of stoppen van een kanaal. Geef de waarde van de operation-id-header door aan de bewerkingsentiteit om de status op te halen. Zie Handmatig polling Long-Running-bewerkingen voor meer informatie.

Zie ook

Live streamen met Azure Media Services
Programma

Delen via

Kanaal

Kanaalentiteit

ChannelInput ComplexType

ChannelPreview ComplexType

ChannelInputAccessControl ComplexType

ChannelPreviewAccessControl ComplexType

IPAccessControl

IPRange ComplexType

ChannelEndpoint ComplexType

ChannelOutput ComplexType

ChannelOutputHls ComplexType

Encoding ComplexType

SystemPreset

VideoStream

AudioStreams

Leisteen

Kanalen maken

Voorbeeldaanvraag

Kanalen starten

Voorbeeldaanvraag

Kanalen stoppen

Voorbeeldaanvraag

Kanalen weergeven

Voorbeeldaanvraag

Kanalen opnieuw instellen

Voorbeeldaanvraag

Kanalen bijwerken

Voorbeeldaanvraag

Start-advertentie

StartAdvertisement-entiteit

Voorbeeldaanvraag

Einde advertentie

Voorbeeldaanvraag

Leisteen weergeven

ShowSlate-entiteit

Voorbeeldaanvraag

Leisteen verbergen

Voorbeeldaanvraag

Kanalen verwijderen

Voorbeeldaanvraag

Zie ook

Aanvullende resources