Live Events - List Get Track Ingest Heartbeats

Référence

Service:: Media Services

API Version:: 2022-11-01

Obtenir le suivi des événements d’un événement en direct
Obtenir le suivi des événements d’ingestion de pulsation télémétrie d’un événement en direct.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}/getTrackIngestHeartbeats?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.

Réponses

Nom	Type	Description
200 OK	LiveEventGetTrackIngestHeartbeatsResult	OK. La demande a réussi.
202 Accepted		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. Headers Location: string Azure-AsyncOperation: string
Other Status Codes		Non modifié. L’eTag dans l’en-tête de requête est identique à l’eTag dans le conteneur de stockage.
Other Status Codes	ErrorResponse	Réponse d’erreur de streaming décrivant la raison de l’échec de l’opération.

Exemples

Get track ingest heart beats of a LiveEvent

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

/** Samples for LiveEvents ListGetTrackIngestHeartbeats. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveevent-get-track-events.json
     */
    /**
     * Sample code: Get track ingest heart beats of a LiveEvent.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void getTrackIngestHeartBeatsOfALiveEvent(
        com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .liveEvents()
            .listGetTrackIngestHeartbeats(
                "mediaresources", "slitestmedia10", "myLiveEvent1", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "value": [
    {
      "eventType": "TrackEvent/IngestHeartbeat",
      "eventTime": "2022-10-19T22:14:52.33Z",
      "data": {
        "trackName": "audio",
        "trackType": "audio",
        "bitrate": 128000,
        "incomingBitrate": 63496,
        "lastTimestamp": "1635286785",
        "timescale": "1000",
        "overlapCount": 0,
        "discontinuityCount": 0,
        "nonincreasingCount": 0,
        "unexpectedBitrate": true,
        "state": "Running",
        "healthy": null,
        "lastFragmentArrivalTime": "2022-10-19T22:14:51.80Z",
        "ingestDriftValue": "-1",
        "transcriptionState": "",
        "transcriptionLanguage": ""
      }
    },
    {
      "eventType": "TrackEvent/IngestHeartbeat",
      "eventTime": "2022-10-19T22:14:52.11Z",
      "data": {
        "trackName": "video",
        "trackType": "video",
        "bitrate": 2025000,
        "incomingBitrate": 1622016,
        "lastTimestamp": "1635286772",
        "timescale": "1000",
        "overlapCount": 0,
        "discontinuityCount": 0,
        "nonincreasingCount": 0,
        "unexpectedBitrate": null,
        "state": "Running",
        "healthy": true,
        "lastFragmentArrivalTime": "2022-10-19T22:14:51.80Z",
        "ingestDriftValue": "-1",
        "transcriptionState": "",
        "transcriptionLanguage": ""
      }
    },
    {
      "eventType": "TrackEvent/IngestHeartbeat",
      "eventTime": "2022-10-19T22:15:12.90Z",
      "data": {
        "trackName": "audio",
        "trackType": "audio",
        "bitrate": 128000,
        "incomingBitrate": 76705,
        "lastTimestamp": "1635306777",
        "timescale": "1000",
        "overlapCount": 0,
        "discontinuityCount": 0,
        "nonincreasingCount": 0,
        "unexpectedBitrate": null,
        "state": "Running",
        "healthy": true,
        "lastFragmentArrivalTime": "2022-10-19T22:15:11.77Z",
        "ingestDriftValue": "0",
        "transcriptionState": "",
        "transcriptionLanguage": ""
      }
    },
    {
      "eventType": "TrackEvent/IngestHeartbeat",
      "eventTime": "2022-10-19T22:15:12.88Z",
      "data": {
        "trackName": "video",
        "trackType": "video",
        "bitrate": 2025000,
        "incomingBitrate": 1959936,
        "lastTimestamp": "1635306772",
        "timescale": "1000",
        "overlapCount": 0,
        "discontinuityCount": 0,
        "nonincreasingCount": 0,
        "unexpectedBitrate": null,
        "state": "Running",
        "healthy": true,
        "lastFragmentArrivalTime": "2022-10-19T22:15:11.77Z",
        "ingestDriftValue": "0",
        "transcriptionState": "",
        "transcriptionLanguage": ""
      }
    },
    {
      "eventType": "TrackEvent/IngestHeartbeat",
      "eventTime": "2022-10-19T22:15:32.77Z",
      "data": {
        "trackName": "audio",
        "trackType": "audio",
        "bitrate": 128000,
        "incomingBitrate": 76736,
        "lastTimestamp": "1635326793",
        "timescale": "1000",
        "overlapCount": 0,
        "discontinuityCount": 0,
        "nonincreasingCount": 0,
        "unexpectedBitrate": null,
        "state": "Running",
        "healthy": true,
        "lastFragmentArrivalTime": "2022-10-19T22:15:31.76Z",
        "ingestDriftValue": "0",
        "transcriptionState": "",
        "transcriptionLanguage": ""
      }
    }
  ]
}

Status code:: 202

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

Status code:: 304

Définitions

Nom	Description
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
LiveEventGetTrackIngestHeartbeatsResult	Obtenez le résultat de la piste d’événements en direct de l’ingestion de battements cardiaques.
LiveEventTrackEvent	Événement de suivi des événements en direct.
LiveEventTrackEventData	Le suivi des événements en direct ingère les données d’événement de battement cardiaque.
LiveEventTrackEventTrackType	Type de la piste.
LiveEventTrackEventType	Type de l’événement track.

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.

LiveEventGetTrackIngestHeartbeatsResult

Obtenez le résultat de la piste d’événements en direct de l’ingestion de battements cardiaques.

Nom	Type	Description
value	LiveEventTrackEvent[]	Résultat des événements de suivi des événements en direct.

LiveEventTrackEvent

Événement de suivi des événements en direct.

Nom	Type	Description
data	LiveEventTrackEventData	Donnée d’événement.
eventTime	string	Événement d’heure déclenché.
eventType	LiveEventTrackEventType	Type de l’événement track.

LiveEventTrackEventData

Le suivi des événements en direct ingère les données d’événement de battement cardiaque.

Nom	Type	Description
bitrate	integer	Débit binaire de la piste.
discontinuityCount	integer	Nombre de discontinuités détectées au cours des 20 dernières secondes.
healthy	boolean	Indique si l’ingestion est saine.
incomingBitrate	integer	Débit binaire calculé et basé sur des blocs de données provenant de l’encodeur.
ingestDriftValue	string	Indique la vitesse de retard, en secondes par minute, des données audio ou vidéo entrantes au cours de la dernière minute. La valeur est supérieure à zéro si les données arrivent à l’événement en direct plus lentement que prévu au cours de la dernière minute. Elle est égale à zéro si les données sont arrivées sans retard ; et égale à « n/a » si aucune donnée audio ou vidéo n’a été reçue. Par exemple, si vous avez un encodeur de contribution qui envoie du contenu en direct, et qu’il ralentit en raison de problèmes de traitement ou d’une latence du réseau, il se peut qu’il ne soit capable de fournir que 58 secondes d’audio ou de vidéo au total sur une période d’une minute. Cela correspondrait à une dérive de 2 secondes par minute. Si l’encodeur est capable de rattraper son retard et d’envoyer l’intégralité des 60 secondes ou plus de données chaque minute, vous verrez cette valeur indiquée comme étant égale à 0. En cas de déconnexion, ou de discontinuité de l’encodeur, cette valeur peut encore afficher 0, car elle ne tient pas compte des ruptures dans les données - seulement des données qui sont retardées dans les timestamps.
lastFragmentArrivalTime	string	Dernier horodatage utc auquel un fragment est arrivé au point de terminaison d’ingestion.
lastTimestamp	string	Timestamp le plus récent reçu pour une piste dans les 20 dernières secondes.
nonincreasingCount	integer	Nombre de segments de données avec des horodatages dans le passé qui ont été reçus au cours des 20 dernières secondes.
overlapCount	integer	Nombre de blocs de données qui avaient chevauché des horodatages au cours des 20 dernières secondes.
state	string	État de l’événement en direct.
timescale	string	Échelle de temps dans laquelle les timestamps sont exprimés.
trackName	string	Nom de la piste.
trackType	LiveEventTrackEventTrackType	Type de la piste.
transcriptionLanguage	string	Code de langue (au format BCP-47) de la langue de transcription. Par exemple, « de-de » indique allemand (Allemagne). La valeur est vide pour les pulsations de piste vidéo ou quand la transcription en direct est désactivée.
transcriptionState	string	Cette valeur est « On » pour les pulsations de piste audio si la transcription en direct est activée ; sinon, vous verrez une chaîne vide. Cet état s’applique uniquement au type de piste « audio » pour la transcription en direct. Toutes les autres pistes auront une valeur vide.
unexpectedBitrate	boolean	Indique si les débits binaires attendus et réels diffèrent de plus de la valeur maximale autorisée au cours des 20 dernières secondes.

LiveEventTrackEventTrackType

Type de la piste.

Nom	Type	Description
audio	string
video	string

LiveEventTrackEventType

Type de l’événement track.

Nom	Type	Description
TrackEvent/IngestHeartbeat	string	Suivre les pulsations reçues.