Live Events - List Get Track Ingest Heartbeats

Riferimento

Service:: Media Services

API Version:: 2022-11-01

Ottenere eventi di traccia di un evento live
Ottenere i dati di telemetria degli eventi heartbeat di inserimento di un evento live.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string	Nome dell'account di Servizi multimediali.
liveEventName	path	True	string	Il nome dell'evento live, la lunghezza massima è 32. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Nome del gruppo di risorse all'interno della sottoscrizione di Azure.
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure.
api-version	query	True	string	Versione dell'API da usare con la richiesta client.

Risposte

Nome	Tipo	Descrizione
200 OK	LiveEventGetTrackIngestHeartbeatsResult	OK. La richiesta ha avuto esito positivo.
202 Accepted		Accettato. La richiesta è stata accettata per l'elaborazione e l'operazione verrà completata in modo asincrono. Vedere https://go.microsoft.com/fwlink/?linkid=2087017 per informazioni dettagliate sul monitoraggio delle operazioni asincrone di Azure. Headers Location: string Azure-AsyncOperation: string
Other Status Codes		Non modificato. L'eTag nell'intestazione della richiesta è uguale a eTag nel contenitore di archiviazione.
Other Status Codes	ErrorResponse	Risposta di errore di streaming che descrive il motivo per cui l'operazione non è riuscita.

Esempio

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

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
LiveEventGetTrackIngestHeartbeatsResult	Ottenere il risultato dell'inserimento del cuore per tenere traccia degli eventi live.
LiveEventTrackEvent	Evento di traccia dell'evento live.
LiveEventTrackEventData	La traccia dell'evento live inserisce i dati dell'evento heart beat.
LiveEventTrackEventTrackType	Tipo di traccia.
LiveEventTrackEventType	Tipo dell'evento track.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

LiveEventGetTrackIngestHeartbeatsResult

Ottenere il risultato dell'inserimento del cuore per tenere traccia degli eventi live.

Nome	Tipo	Descrizione
value	LiveEventTrackEvent[]	Risultato degli eventi get live event track.

LiveEventTrackEvent

Evento di traccia dell'evento live.

Nome	Tipo	Descrizione
data	LiveEventTrackEventData	Dati dell'evento.
eventTime	string	Evento di ora generato.
eventType	LiveEventTrackEventType	Tipo dell'evento track.

LiveEventTrackEventData

La traccia dell'evento live inserisce i dati dell'evento heart beat.

Nome	Tipo	Descrizione
bitrate	integer	Velocità in bit della traccia.
discontinuityCount	integer	Numero di discontinuità rilevate negli ultimi 20 secondi.
healthy	boolean	Indica se l'inserimento è integro.
incomingBitrate	integer	Velocità in bit calcolata in base ai blocchi di dati provenienti dal codificatore.
ingestDriftValue	string	Indica la velocità di ritardo, in secondi al minuto, dei dati audio o video in ingresso durante l'ultimo minuto. Il valore è maggiore di zero se i dati arrivano all'evento live più lento del previsto nell'ultimo minuto; zero se i dati sono arrivati senza ritardo; e "n/a" se non sono stati ricevuti dati audio o video. Ad esempio, se si dispone di un codificatore di contributi che invia contenuto live e si rallenta a causa di problemi di elaborazione o la latenza di rete, può essere in grado di recapitare un totale di 58 secondi di audio o video in un periodo di un minuto. Questo verrebbe segnalato come due secondi al minuto di deviazione. Se il codificatore è in grado di recuperare e inviare tutti i 60 secondi o più dati ogni minuto, questo valore verrà segnalato come 0. Se si verifica una disconnessione o una discontinuità dal codificatore, questo valore può comunque essere visualizzato come 0, in quanto non tiene conto delle interruzioni nei dati, solo i dati ritardati nei timestamp.
lastFragmentArrivalTime	string	Ultimo timestamp in formato UTC in cui un frammento è arrivato all'endpoint di inserimento.
lastTimestamp	string	Timestamp più recente ricevuto per una traccia negli ultimi 20 secondi.
nonincreasingCount	integer	Numero di blocchi di dati con timestamp nel passato ricevuti negli ultimi 20 secondi.
overlapCount	integer	Numero di blocchi di dati con timestamp sovrapposti negli ultimi 20 secondi.
state	string	Stato dell'evento live.
timescale	string	Scala cronologica in cui sono espressi i timestamp.
trackName	string	Nome della traccia.
trackType	LiveEventTrackEventTrackType	Tipo di traccia.
transcriptionLanguage	string	Codice linguistico (in formato BCP-47) del linguaggio di trascrizione. Ad esempio, "de-de" indica il tedesco (Germania). Il valore è vuoto per gli heartbeat di traccia video o quando la trascrizione dinamica è disattivata.
transcriptionState	string	Questo valore è "Attivato" per gli heartbeat di traccia audio se la trascrizione live è attivata, in caso contrario verrà visualizzata una stringa vuota. Questo stato è applicabile solo al tipo di traccia "audio" per la trascrizione live. Tutte le altre tracce avranno un valore vuoto.
unexpectedBitrate	boolean	Se la velocità in bit prevista e quella effettiva superano il limite consentito negli ultimi 20 secondi.

LiveEventTrackEventTrackType

Tipo di traccia.

Nome	Tipo	Descrizione
audio	string
video	string

LiveEventTrackEventType

Tipo dell'evento track.

Nome	Tipo	Descrizione
TrackEvent/IngestHeartbeat	string	Tenere traccia dell'heartbeat ricevuto.

Share via