Localisateurs de diffusion en continuStreaming Locators

Pour rendre les vidéos dans la ressource de sortie disponibles en lecture pour les clients, vous devez créer un localisateur de diffusion en continu , puis générer des URL de diffusion en continu.To make videos in the output Asset available to clients for playback, you have to create a Streaming Locator and then build streaming URLs. Pour générer une URL, vous devez concaténer le nom d’hôte du point de terminaison de streaming et le chemin du localisateur de streaming.To build a URL, you need to concatenate the Streaming Endpoint host name and the Streaming Locator path. Pour un exemple .NET, consultez Obtenir un localisateur de diffusion en continu.For .NET sample, see Get a Streaming Locator.

Le processus de création d’un localisateur de streaming est appelée « publication ».The process of creating a Streaming Locator is called publishing. Par défaut, le localisateur de streaming est valide immédiatement après avoir effectué les appels d’API et dure jusqu’à ce qu’il soit supprimé, sauf si vous configurez les durées de début et de fin optionnelles.By default, the Streaming Locator is valid immediately after you make the API calls, and lasts until it is deleted, unless you configure the optional start and end times.

Lors de la création d’un Localisateur de streaming, vous devez spécifier un nom Ressource et un nom Stratégie de streaming.When creating a Streaming Locator, you must specify an Asset name and a Streaming Policy name. Pour plus d'informations, voir les rubriques suivantes :For more information, see the following topics:

Vous pouvez également spécifier l’heure de début et de fin de votre localisateur de streaming pour permettre à votre utilisateur de lire ce contenu précis (par exemple, entre le 5/1/2019 et le 5/5/2019).You can also specify the start and end time on your Streaming Locator, which will only let your user play the content between these times (for example, between 5/1/2019 to 5/5/2019).

ConsidérationsConsiderations

  • Les localisateurs de streaming ne peuvent pas être mis à jour.Streaming Locators are not updatable.
  • Les propriétés des localisateurs de diffusion en continu de type DateHeure sont toujours au format UTC.Properties of Streaming Locators that are of the Datetime type are always in UTC format.
  • Vous devez concevoir un ensemble limité de stratégies pour votre compte Media Services et les réutiliser pour vos éléments localisateurs de diffusion en continu chaque fois que les mêmes options sont nécessaires.You should design a limited set of policies for your Media Service account and reuse them for your Streaming Locators whenever the same options are needed. Pour plus d’informations, consultez Quotas et limitations.For more information, see Quotas and limitations.

Créer des localisateurs de streamingCreate Streaming Locators

Non chiffréNot encrypted

Si vous souhaitez diffuser votre fichier en clair (sans chiffrement), configurez la stratégie de diffusion en continu en clair prédéfinie : « Predefined_ClearStreamingOnly » (dans .NET, vous pouvez utiliser l'enum PredefinedStreamingPolicy.ClearStreamingOnly).If you want to stream your file in-the-clear (non-encrypted), set the predefined clear streaming policy: to 'Predefined_ClearStreamingOnly' (in .NET, you can use the PredefinedStreamingPolicy.ClearStreamingOnly enum).

StreamingLocator locator = await client.StreamingLocators.CreateAsync(
    resourceGroup,
    accountName,
    locatorName,
    new StreamingLocator
    {
        AssetName = assetName,
        StreamingPolicyName = PredefinedStreamingPolicy.ClearStreamingOnly
    });

ChiffréEncrypted

Si vous devez chiffrer votre contenu avec le chiffrement CENC, définissez votre stratégie sur « Predefined_MultiDrmCencStreaming ».If you need to encrypt your content with the CENC encryption, set your policy to 'Predefined_MultiDrmCencStreaming'. Le chiffrement Widevine est appliqué à un flux de données DASH et PlayReady à Smooth.The Widevine encryption will be applied to a DASH stream and PlayReady to Smooth. La clé est envoyée à un client de lecture en fonction des licences DRM configurées.The key will be delivered to a playback client based on the configured DRM licenses.

StreamingLocator locator = await client.StreamingLocators.CreateAsync(
    resourceGroup,
    accountName,
    locatorName,
    new StreamingLocator
    {
        AssetName = assetName,
        StreamingPolicyName = "Predefined_MultiDrmCencStreaming",
        DefaultContentKeyPolicyName = contentPolicyName
    });

Si vous souhaitez également chiffrer votre flux HLS avec CBCS (FairPlay), utilisez la stratégie « Predefined_MultiDrmStreaming ».If you also want to encrypt your HLS stream with CBCS (FairPlay), use 'Predefined_MultiDrmStreaming'.

Notes

Widevine est un service fourni par Google Inc. soumis aux conditions de service et à la politique de confidentialité de Google, Inc.Widevine is a service provided by Google Inc. and subject to the terms of service and Privacy Policy of Google, Inc.

Associer des filtres à des localisateurs de streamingAssociate filters with Streaming Locators

Consultez Associer des filtres à des localisateurs de streaming.See Filters: associate with Streaming Locators.

Filtre, trier et paginer les entités du localisateur de streamingFilter, order, page Streaming Locator entities

Consultez Filtrage, tri et pagination des entités Media Services.See Filtering, ordering, paging of Media Services entities.

Lister les localisateurs de streaming par nom de ressourceList Streaming Locators by Asset name

Pour obtenir des localisateurs de streaming en fonction du nom de ressource associé, utilisez les opérations suivantes :To get Streaming Locators based on the associated Asset name, use the following operations:

LangageLanguage APIAPI
RESTREST liststreaminglocatorsliststreaminglocators
Interface de ligne de commandeCLI az ams asset list-streaming-locatorsaz ams asset list-streaming-locators
.NET.NET ListStreamingLocatorsListStreamingLocators
JavaJava AssetStreamingLocatorAssetStreamingLocator
Node.jsNode.js listStreamingLocatorslistStreamingLocators

Voir aussiAlso see

Étapes suivantesNext steps

Tutoriel : Charger, encoder et diffuser en streaming des vidéos à l’aide de .NETTutorial: Upload, encode, and stream videos using .NET