Partager via


Live Events - Update

Mises à jour paramètres sur un événement en direct existant.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?api-version=2022-11-01

Paramètres URI

Nom Dans Obligatoire Type Description
accountName
path True

string

Nom du compte Media Services.

liveEventName
path True

string

Le nom de l’événement en direct, dont la longueur maximale est 32.

Regex pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

resourceGroupName
path True

string

Nom du groupe de ressources au sein de l’abonnement Azure.

subscriptionId
path True

string

Identificateur unique d’un abonnement Microsoft Azure.

api-version
query True

string

Version de l’API à utiliser avec la demande cliente.

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement géographique où réside la ressource

properties.input True

LiveEventInput

Paramètres d’entrée d’événement en direct. Il définit la façon dont l’événement en direct reçoit l’entrée d’un encodeur de contribution.

properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

Stratégies d’accès inter site aux événements en direct.

properties.description

string

Description de l’événement en direct.

properties.encoding

LiveEventEncoding

Paramètres d’encodage de l’événement en direct. Il configure si un encodeur dynamique est utilisé pour l’événement en direct et les paramètres de l’encodeur dynamique s’il est utilisé.

properties.hostnamePrefix

string

Lorsque useStaticHostname a la valeur true, le nom d’hôtePrefix spécifie la première partie du nom d’hôte affectée à l’aperçu de l’événement en direct et aux points de terminaison d’ingestion. Le nom d’hôte final est une combinaison de ce préfixe, du nom du compte de service multimédia et d’un code court pour le centre de données Azure Media Services.

properties.preview

LiveEventPreview

Paramètres de préversion de l’événement en direct. La préversion permet aux producteurs d’événements en direct d’afficher un aperçu du contenu de streaming en direct sans créer de sortie en direct.

properties.streamOptions

StreamOptionsFlag[]

Options à utiliser pour LiveEvent. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour. Les valeurs valides pour les valeurs d’entrée de tableau sont « Default » et « LowLatency ».

properties.transcriptions

LiveEventTranscription[]

Paramètres de transcription en direct pour l’événement en direct. Consultez https://go.microsoft.com/fwlink/?linkid=2133742 pour plus d’informations sur la fonctionnalité de transcription en direct.

properties.useStaticHostname

boolean

Spécifie si un nom d’hôte statique est affecté à l’aperçu d’événement en direct et aux points de terminaison d’ingestion. Cette valeur ne peut être mise à jour que si l’événement en direct est à l’état Veille

tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

LiveEvent

OK. La demande a réussi.

202 Accepted

LiveEvent

Accepté. La demande a été acceptée pour traitement et l’opération se terminera de manière asynchrone. Consultez https://go.microsoft.com/fwlink/?linkid=2087017 pour plus d’informations sur la surveillance des opérations asynchrones Azure.

Other Status Codes

ErrorResponse

Réponse d’erreur de streaming décrivant la raison de l’échec de l’opération.

Exemples

Update a LiveEvent

Sample Request

PATCH https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveEvents/myLiveEvent1?api-version=2022-11-01

{
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2",
    "tag3": "value3"
  },
  "properties": {
    "description": "test event updated",
    "input": {
      "streamingProtocol": "FragmentedMP4",
      "keyFrameIntervalDuration": "PT6S",
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0"
            }
          ]
        }
      }
    },
    "preview": {
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0"
            }
          ]
        }
      }
    }
  }
}

Sample Response

azure-asyncoperation: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveeventoperations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
location: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/operationlocations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
{
  "name": "myLiveEvent1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
  "type": "Microsoft.Media/mediaservices/liveevents",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2",
    "tag3": "value3"
  },
  "properties": {
    "description": "test event updated",
    "resourceState": "Running",
    "provisioningState": "InProgress",
    "created": "0001-01-01T00:00:00Z",
    "lastModified": "0001-01-01T00:00:00Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0",
              "subnetPrefixLength": null
            }
          ]
        }
      },
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "c10ea3fc-587f-4daf-b2b2-fa8f647a9ed2",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0",
              "subnetPrefixLength": null
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    }
  }
}
{
  "name": "myLiveEvent1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
  "type": "Microsoft.Media/mediaservices/liveevents",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2",
    "tag3": "value3"
  },
  "properties": {
    "description": "test event updated",
    "resourceState": "Running",
    "provisioningState": "Succeeded",
    "created": "0001-01-01T00:00:00Z",
    "lastModified": "0001-01-01T00:00:00Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0",
              "subnetPrefixLength": null
            }
          ]
        }
      }
    },
    "preview": {
      "previewLocator": "c10ea3fc-587f-4daf-b2b2-fa8f647a9ed2",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0",
              "subnetPrefixLength": null
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    }
  }
}

Définitions

Nom Description
createdByType

Type d’identité qui a créé la ressource.

CrossSiteAccessPolicies

Stratégie d’accès client.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

IPAccessControl

Contrôle d’accès IP.

IPRange

Plage d’adresses IP dans le schéma CIDR.

LiveEvent

Événement en direct.

LiveEventEncoding

Spécifie le type d’événement en direct et les paramètres d’encodage facultatifs pour l’encodage des événements en direct.

LiveEventEncodingType

Type d’événement en direct. Lorsque encodingType est défini sur PassthroughBasic ou PassthroughStandard, le service passe simplement par les couches vidéo et audio entrantes vers la sortie. Lorsque encodingType est défini sur Standard ou Premium1080p, un encodeur live transcode le flux entrant en plusieurs débits ou couches. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2095101 (éventuellement en anglais) pour plus d'informations. Cette propriété ne peut pas être modifiée après la création de l’événement en direct.

LiveEventEndpoint

Point de terminaison d’événement en direct.

LiveEventInput

Entrée d’événement en direct.

LiveEventInputAccessControl

Contrôle d’accès IP pour l’entrée d’événement en direct.

LiveEventInputProtocol

Protocole d’entrée pour l’événement en direct. Il est spécifié au moment de la création et ne peut pas être mis à jour.

LiveEventInputTrackSelection

Condition de sélection de suivi. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

LiveEventOutputTranscriptionTrack

Décrit une piste de transcription dans la sortie d’un événement en direct, générée à l’aide de la transcription de reconnaissance vocale. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

LiveEventPreview

Paramètres de préversion de l’événement en direct.

LiveEventPreviewAccessControl

Contrôle d’accès IP pour le point de terminaison de préversion des événements en direct.

LiveEventResourceState

État des ressources de l’événement en direct. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2139012 (éventuellement en anglais) pour plus d'informations.

LiveEventTimedMetadataEndpoint

Point de terminaison d’insertion de métadonnées d’événement en direct.

LiveEventTranscription

Décrit les pistes de transcription dans la sortie d’un événement en direct, généré à l’aide de la transcription de la reconnaissance vocale. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

StreamOptionsFlag

Options à utiliser pour LiveEvent. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour. Les valeurs valides pour les valeurs d’entrée de tableau sont « Default » et « LowLatency ».

StretchMode

Spécifie la façon dont la vidéo d’entrée sera redimensionnée pour s’adapter à la ou les résolution(s) de sortie souhaitées. La valeur par défaut est None

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

createdByType

Type d’identité qui a créé la ressource.

Nom Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

CrossSiteAccessPolicies

Stratégie d’accès client.

Nom Type Description
clientAccessPolicy

string

Le contenu de clientaccesspolicy.xml utilisé par Silverlight.

crossDomainPolicy

string

Le contenu de crossdomain.xml utilisé par Silverlight.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d'erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

IPAccessControl

Contrôle d’accès IP.

Nom Type Description
allow

IPRange[]

Liste d’adresses IP autorisées.

IPRange

Plage d’adresses IP dans le schéma CIDR.

Nom Type Description
address

string

Adresse IP.

name

string

Nom convivial de la plage d’adresses IP.

subnetPrefixLength

integer

Longueur du préfixe du masque de sous-réseau (voir notation CIDR).

LiveEvent

Événement en direct.

Nom Type Description
id

string

ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Emplacement géographique où réside la ressource

name

string

nom de la ressource.

properties.created

string

Heure de création de l’événement en direct

properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

Stratégies d’accès inter site aux événements en direct.

properties.description

string

Description de l’événement en direct.

properties.encoding

LiveEventEncoding

Paramètres d’encodage de l’événement en direct. Il configure si un encodeur dynamique est utilisé pour l’événement en direct et les paramètres de l’encodeur dynamique s’il est utilisé.

properties.hostnamePrefix

string

Lorsque useStaticHostname a la valeur true, le nom d’hôtePrefix spécifie la première partie du nom d’hôte affectée à l’aperçu de l’événement en direct et aux points de terminaison d’ingestion. Le nom d’hôte final est une combinaison de ce préfixe, du nom du compte de service multimédia et d’un code court pour le centre de données Azure Media Services.

properties.input

LiveEventInput

Paramètres d’entrée d’événement en direct. Il définit la façon dont l’événement en direct reçoit l’entrée d’un encodeur de contribution.

properties.lastModified

string

Heure de la dernière modification de l’événement en direct.

properties.preview

LiveEventPreview

Paramètres de préversion de l’événement en direct. La préversion permet aux producteurs d’événements en direct d’afficher un aperçu du contenu de streaming en direct sans créer de sortie en direct.

properties.provisioningState

string

État d’approvisionnement de l’événement en direct.

properties.resourceState

LiveEventResourceState

État des ressources de l’événement en direct. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2139012 (éventuellement en anglais) pour plus d'informations.

properties.streamOptions

StreamOptionsFlag[]

Options à utiliser pour LiveEvent. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour. Les valeurs valides pour les valeurs d’entrée de tableau sont « Default » et « LowLatency ».

properties.transcriptions

LiveEventTranscription[]

Paramètres de transcription en direct pour l’événement en direct. Consultez https://go.microsoft.com/fwlink/?linkid=2133742 pour plus d’informations sur la fonctionnalité de transcription en direct.

properties.useStaticHostname

boolean

Spécifie si un nom d’hôte statique est affecté à l’aperçu d’événement en direct et aux points de terminaison d’ingestion. Cette valeur ne peut être mise à jour que si l’événement en direct est à l’état Veille

systemData

systemData

Métadonnées système relatives à cette ressource.

tags

object

Balises de ressource.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

LiveEventEncoding

Spécifie le type d’événement en direct et les paramètres d’encodage facultatifs pour l’encodage des événements en direct.

Nom Type Description
encodingType

LiveEventEncodingType

Type d’événement en direct. Lorsque encodingType est défini sur PassthroughBasic ou PassthroughStandard, le service passe simplement par les couches vidéo et audio entrantes vers la sortie. Lorsque encodingType est défini sur Standard ou Premium1080p, un encodeur live transcode le flux entrant en plusieurs débits ou couches. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2095101 (éventuellement en anglais) pour plus d'informations. Cette propriété ne peut pas être modifiée après la création de l’événement en direct.

keyFrameInterval

string

Utilisez une valeur de temps ISO 8601 comprise entre 0,5 et 20 secondes pour spécifier la longueur des fragments de sortie pour les pistes vidéo et audio d’un événement en direct d’encodage. Par exemple, utilisez PT2S pour indiquer 2 secondes. Pour la piste vidéo, il définit également l’intervalle d’images clés ou la longueur d’un goP (groupe d’images). Si cette valeur n’est pas définie pour un événement en direct d’encodage, la durée du fragment est par défaut de 2 secondes. La valeur ne peut pas être définie pour les événements en direct pass-through.

presetName

string

Nom de présélection d’encodage facultatif, utilisé lorsque encodingType n’est pas None. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour. Si encodingType est défini sur Standard, le nom prédéfini par défaut est « Default720p ». Sinon, si encodingType est défini sur Premium1080p, la présélection par défaut est « Default1080p ».

stretchMode

StretchMode

Spécifie la façon dont la vidéo d’entrée sera redimensionnée pour s’adapter à la ou les résolution(s) de sortie souhaitées. La valeur par défaut est None

LiveEventEncodingType

Type d’événement en direct. Lorsque encodingType est défini sur PassthroughBasic ou PassthroughStandard, le service passe simplement par les couches vidéo et audio entrantes vers la sortie. Lorsque encodingType est défini sur Standard ou Premium1080p, un encodeur live transcode le flux entrant en plusieurs débits ou couches. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2095101 (éventuellement en anglais) pour plus d'informations. Cette propriété ne peut pas être modifiée après la création de l’événement en direct.

Nom Type Description
None

string

Il s’agit de la même chose que PassthroughStandard. Consultez la description ci-dessous. Cette valeur d’énumération est dépréciée.

PassthroughBasic

string

Le flux ingéré passe par l’événement en direct de l’encodeur de contribution sans traitement supplémentaire. En mode PassthroughBasic, l’ingestion est limitée à 5 Mbits/s et une seule sortie dynamique simultanée est autorisée. La transcription en direct n’est pas disponible.

PassthroughStandard

string

Le flux ingéré passe par l’événement en direct de l’encodeur de contribution sans traitement supplémentaire. La transcription en direct est disponible. Les limites de débit d’ingestion sont beaucoup plus élevées et jusqu’à 3 sorties actives simultanées sont autorisées.

Premium1080p

string

Un encodeur live de contribution envoie un flux de débit unique à l’événement en direct et Media Services crée plusieurs flux à débit binaire. La résolution de la sortie ne peut pas dépasser 1 080p.

Standard

string

Un encodeur live de contribution envoie un flux de débit unique à l’événement en direct et Media Services crée plusieurs flux à débit binaire. La résolution de la sortie ne peut pas dépasser 720p.

LiveEventEndpoint

Point de terminaison d’événement en direct.

Nom Type Description
protocol

string

Protocole de point de terminaison.

url

string

URL du point de terminaison.

LiveEventInput

Entrée d’événement en direct.

Nom Type Description
accessControl

LiveEventInputAccessControl

Contrôle d’accès pour l’entrée d’événement en direct.

accessToken

string

Un UUID sous forme de chaîne pour identifier de manière unique le flux. Il peut être spécifié au moment de la création, mais ne peut pas être mis à jour. En cas d’omission, le service génère une valeur unique.

endpoints

LiveEventEndpoint[]

Points de terminaison d’entrée pour l’événement en direct.

keyFrameIntervalDuration

string

Durée ISO 8601 de la durée de l’intervalle de trame clé de l’entrée. Cette valeur définit la propriété EXT-X-TARGETDURATION dans la sortie HLS. Par exemple, utilisez PT2S pour indiquer 2 secondes. Laissez la valeur vide pour l’encodage des événements en direct.

streamingProtocol

LiveEventInputProtocol

Protocole d’entrée pour l’événement en direct. Il est spécifié au moment de la création et ne peut pas être mis à jour.

timedMetadataEndpoints

LiveEventTimedMetadataEndpoint[]

Points de terminaison de métadonnées pour l’événement en direct.

LiveEventInputAccessControl

Contrôle d’accès IP pour l’entrée d’événement en direct.

Nom Type Description
ip

IPAccessControl

Propriétés du contrôle d’accès IP.

LiveEventInputProtocol

Protocole d’entrée pour l’événement en direct. Il est spécifié au moment de la création et ne peut pas être mis à jour.

Nom Type Description
FragmentedMP4

string

L’entrée Smooth Streaming sera envoyée par l’encodeur de contribution à l’événement en direct.

RTMP

string

L’entrée RTMP sera envoyée par l’encodeur de contribution à l’événement en direct.

LiveEventInputTrackSelection

Condition de sélection de suivi. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

Nom Type Description
operation

string

Opération de comparaison. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

property

string

Nom de la propriété à sélectionner. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

value

string

Valeur de propriété à sélectionner. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

LiveEventOutputTranscriptionTrack

Décrit une piste de transcription dans la sortie d’un événement en direct, générée à l’aide de la transcription de reconnaissance vocale. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

Nom Type Description
trackName

string

Nom de la piste de sortie. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

LiveEventPreview

Paramètres de préversion de l’événement en direct.

Nom Type Description
accessControl

LiveEventPreviewAccessControl

Contrôle d’accès pour la préversion des événements en direct.

alternativeMediaId

string

Autre identificateur multimédia associé au localisateur de streaming créé pour la préversion. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour. L’identificateur peut être utilisé dans le CustomLicenseAcquisitionUrlTemplate ou le CustomKeyAcquisitionUrlTemplate de streamingPolicy spécifié dans le champ StreamingPolicyName.

endpoints

LiveEventEndpoint[]

Points de terminaison pour la préversion. Ne partagez pas l’URL de préversion avec le public de l’événement en direct.

previewLocator

string

Identificateur du localisateur d’aperçu au format GUID. Cette spécification au moment de la création permet à l’appelant de connaître l’URL du localisateur d’aperçu avant la création de l’événement. En cas d’omission, le service génère un identificateur aléatoire. Cette valeur ne peut pas être mise à jour une fois l’événement en direct créé.

streamingPolicyName

string

Nom de la stratégie de diffusion en continu utilisée pour la préversion de l’événement en direct. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour.

LiveEventPreviewAccessControl

Contrôle d’accès IP pour le point de terminaison de préversion des événements en direct.

Nom Type Description
ip

IPAccessControl

Propriétés du contrôle d’accès IP.

LiveEventResourceState

État des ressources de l’événement en direct. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2139012 (éventuellement en anglais) pour plus d'informations.

Nom Type Description
Allocating

string

L’action d’allocation a été appelée sur l’événement en direct et les ressources sont en cours d’approvisionnement pour cet événement en direct. Une fois l’allocation terminée, l’événement en direct passe à l’état StandBy.

Deleting

string

L’événement en direct est en cours de suppression. Aucune facturation ne survient dans cet état de transition. Les mises à jour et diffusions en continu ne sont pas autorisées pendant cet état.

Running

string

Les ressources de l’événement en direct ont été allouées, des URL de réception et d’aperçu ont été générées, et l’événement peut recevoir des flux temps réel. À ce stade, la facturation est active. Vous devez appeler explicitement la commande Stop sur la ressource de l’événement en direct pour arrêter toute facturation supplémentaire.

StandBy

string

Les ressources d’événement en direct ont été approvisionnées et sont prêtes à démarrer. La facturation intervient dans cet état. La plupart des propriétés peuvent toujours être mises à jour, mais ni l’ingestion ni la diffusion en continu ne sont autorisées dans cet état.

Starting

string

L’événement en direct démarre et les ressources sont allouées. Aucune facturation ne survient dans cet état. Les mises à jour et diffusions en continu ne sont pas autorisées pendant cet état. Si une erreur se produit, l’événement en direct retourne à l’état Arrêté.

Stopped

string

C’est l’état initial de l’événement en direct après sa création (sauf si le démarrage automatique a été défini sur true). Aucune facturation ne survient dans cet état. Dans cet état, les propriétés de l’événement en direct peuvent être mises à jour, mais la diffusion en continu n’est pas autorisée.

Stopping

string

L’événement en direct est en cours d’arrêt et les ressources sont déprovisionnées. Aucune facturation ne survient dans cet état de transition. Les mises à jour et diffusions en continu ne sont pas autorisées pendant cet état.

LiveEventTimedMetadataEndpoint

Point de terminaison d’insertion de métadonnées d’événement en direct.

Nom Type Description
url

string

URL du point de terminaison de métadonnées.

LiveEventTranscription

Décrit les pistes de transcription dans la sortie d’un événement en direct, généré à l’aide de la transcription de la reconnaissance vocale. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

Nom Type Description
inputTrackSelection

LiveEventInputTrackSelection[]

Fournit un mécanisme permettant de sélectionner la piste audio dans le flux en direct d’entrée, auquel la transcription de la parole en texte est appliquée. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

language

string

Spécifie la langue (paramètres régionaux) à utiliser pour la transcription de la reconnaissance vocale . Elle doit correspondre à la langue parlée dans la piste audio. La valeur doit être au format BCP-47 (par exemple , « en-US »). Consultez https://go.microsoft.com/fwlink/?linkid=2133742 pour plus d’informations sur la fonctionnalité de transcription en direct et la liste des langues prises en charge.

outputTranscriptionTrack

LiveEventOutputTranscriptionTrack

Décrit une piste de transcription dans la sortie d’un événement en direct, générée à l’aide de la transcription de reconnaissance vocale. Cette propriété est réservée à une utilisation ultérieure, toute valeur définie sur cette propriété sera ignorée.

StreamOptionsFlag

Options à utiliser pour LiveEvent. Cette valeur est spécifiée au moment de la création et ne peut pas être mise à jour. Les valeurs valides pour les valeurs d’entrée de tableau sont « Default » et « LowLatency ».

Nom Type Description
Default

string

Streaming en direct sans optimisations de latence spéciales.

LowLatency

string

L’événement en direct fournit une latence de bout en bout inférieure en réduisant ses mémoires tampons internes.

LowLatencyV2

string

L’événement en direct est optimisé pour la latence de bout en bout. Cette option n’est disponible que pour l’encodage d’événements en direct avec une entrée RTMP. Les sorties peuvent être diffusées en continu à l’aide des formats HLS ou DASH. La durée d’archivage ou de rembobinage DVR des sorties est limitée à 6 heures. Utilisez l’option de flux « LowLatency » pour tous les autres scénarios.

StretchMode

Spécifie la façon dont la vidéo d’entrée sera redimensionnée pour s’adapter à la ou les résolution(s) de sortie souhaitées. La valeur par défaut est None

Nom Type Description
AutoFit

string

Padez la sortie (avec la boîte aux lettres ou la zone de pilier) pour respecter la résolution de sortie, tout en vous assurant que la région vidéo active dans la sortie a le même rapport d’aspect que l’entrée. Par exemple, si l’entrée est 1920x1080 et que la présélection d’encodage demande 1280x1280, la sortie sera à 1280x1280, qui contient un rectangle interne de 1280x720 au rapport d’aspect de 16 :9, et les zones de piliers de 280 pixels de large à gauche et à droite.

AutoSize

string

Remplacez la résolution de sortie et modifiez-la pour qu’elle corresponde au rapport d’affichage de l’entrée, sans remplissage. Par exemple, si l’entrée est 1920x1080 et la présélection d’encodage demande 1280x1280, la valeur dans la présélection est remplacée, et la sortie sera à 1280x720, qui conserve les proportions d’entrée en 16:9.

None

string

Respecte strictement la résolution de sortie spécifiée dans la présélection d’encodage sans tenir compte du rapport d’aspect en pixels ou de l’affichage de la vidéo d’entrée.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string

Horodatage de la dernière modification de la ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la dernière ressource.

lastModifiedByType

createdByType

Type d’identité qui a modifié la dernière ressource.