Live Events - List Get Track Ingest Heartbeats

Referenz

Dienst:: Media Services

API-Version:: 2022-11-01

Abrufen von Nachverfolgereignissen eines Liveereignisses
Abrufen von Telemetriedaten zu Taktereignissen für die Erfassung eines Liveereignisses.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountName	path	True	string	Der Name des Media Services-Kontos.
liveEventName	path	True	string	Der Name des Liveereignisses, die maximale Länge beträgt 32. RegEx-Muster: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Der Name der Ressourcengruppe innerhalb des Azure-Abonnements.
subscriptionId	path	True	string	Der eindeutige Bezeichner für ein Microsoft Azure-Abonnement.
api-version	query	True	string	Die Version der API, die mit der Clientanforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	LiveEventGetTrackIngestHeartbeatsResult	OK. Die Anforderung wurde erfolgreich durchgeführt.
202 Accepted		Akzeptiert: Die Anforderung wurde für die Verarbeitung akzeptiert, und der Vorgang wird asynchron abgeschlossen. Weitere Informationen zur Überwachung asynchroner Azure-Vorgänge finden Sie https://go.microsoft.com/fwlink/?linkid=2087017 unter. Header Location: string Azure-AsyncOperation: string
Other Status Codes		Nicht geändert. Das eTag im Anforderungsheader ist identisch mit dem eTag im Speichercontainer.
Other Status Codes	ErrorResponse	Die Streamingfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

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

Beispiel für eine Antwort

Statuscode:: 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": ""
      }
    }
  ]
}

Statuscode:: 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

Statuscode:: 304

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
LiveEventGetTrackIngestHeartbeatsResult	Erhalten Sie das Ergebnis von Herzschlägen im Liveereignisverlauf.
LiveEventTrackEvent	Das Liveereignis für die Ereignisverfolgung.
LiveEventTrackEventData	Die Liveereignisverfolgung erfasst Herzschlagereignisdaten.
LiveEventTrackEventTrackType	Typ des Titels.
LiveEventTrackEventType	Der Typ des Spurereignisses.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

LiveEventGetTrackIngestHeartbeatsResult

Erhalten Sie das Ergebnis von Herzschlägen im Liveereignisverlauf.

Name	Typ	Beschreibung
value	LiveEventTrackEvent[]	Das Ergebnis der Liveereignisverfolgungsereignisse.

LiveEventTrackEvent

Das Liveereignis für die Ereignisverfolgung.

Name	Typ	Beschreibung
data	LiveEventTrackEventData	Ereignisdaten.
eventTime	string	Das ausgelöste Zeitereignis.
eventType	LiveEventTrackEventType	Der Typ des Spurereignisses.

LiveEventTrackEventData

Die Liveereignisverfolgung erfasst Herzschlagereignisdaten.

Name	Typ	Beschreibung
bitrate	integer	Bitrate der Spur
discontinuityCount	integer	Anzahl der in den letzten 20 Sekunden erkannten Diskontinuitäten.
healthy	boolean	Gibt an, ob die Erfassung fehlerfrei ist.
incomingBitrate	integer	Berechnete Bitrate basierend auf den Datenblöcken vom Encoder.
ingestDriftValue	string	Gibt die Geschwindigkeit der Verzögerung der eingehenden Audio- oder Videodaten während der letzten Minute in Sekunden pro Minute an. Der Wert ist größer als null, wenn Daten in der letzten Minute langsamer als erwartet beim Liveereignis eintreffen. null, wenn Daten ohne Verzögerung eingetroffen sind; und „n/a“ (n/v), wenn keine Audio- oder Videodaten empfangen wurden. Wenn Sie beispielsweise über einen Beitragsencoder verfügen, der Liveinhalte sendet und aufgrund von Verarbeitungsproblemen oder Netzwerklatenz verlangsamt wird, kann er möglicherweise nur insgesamt 58 Sekunden Audio oder Video in einem Zeitraum von einer Minute liefern. Dies wird als Abweichung von zwei Sekunden pro Minute gemeldet. Wenn der Encoder aufholen und alle 60 Sekunden oder mehr Daten pro Minute und senden kann, wird dieser Wert als 0 gemeldet. Wenn eine Trennung oder Diskontinuität vom Encoder vorgelegen hat, wird dieser Wert möglicherweise trotzdem als 0 angezeigt, da er keine Unterbrechungen der Daten berücksichtigt, sondern nur Daten, die in Zeitstempeln verzögert sind.
lastFragmentArrivalTime	string	Der letzte Zeitstempel in UTC, der ein Fragment am Erfassungsendpunkt eintraf.
lastTimestamp	string	Neuester Zeitstempel, der für eine Spur in den letzten 20 Sekunden empfangen wurde.
nonincreasingCount	integer	Anzahl der Datenblöcke mit Zeitstempeln in der Vergangenheit, die in den letzten 20 Sekunden empfangen wurden.
overlapCount	integer	Anzahl der Datenblöcke mit überlappenden Zeitstempeln in den letzten 20 Sekunden.
state	string	Zustand des Liveereignisses.
timescale	string	Zeitskala für die Darstellung der Zeitstempel.
trackName	string	Name der Spur
trackType	LiveEventTrackEventTrackType	Typ des Titels.
transcriptionLanguage	string	Der Sprachcode (im BCP-47-Format) der Transkriptionssprache. Beispielsweise steht "de-de" für Deutsch (Deutschland). Der Wert ist für die Videospurheartbeats oder bei deaktivierter Livetranskription leer.
transcriptionState	string	Dieser Wert ist für Audiospurheartbeats aktiviert, wenn Livetranskription aktiviert ist. Andernfalls wird eine leere Zeichenfolge verwendet. Dieser Zustand gilt nur für den Nachverfolgungstyp "Audio" für die Livetranskription. Alle anderen Spuren haben einen leeren Wert.
unexpectedBitrate	boolean	Die erwarteten und tatsächlichen Bitraten in den letzten 20 Sekunden unterscheiden sich um mehr als das maximal zulässige Limit.

LiveEventTrackEventTrackType

Typ des Titels.

Name	Typ	Beschreibung
audio	string
video	string

LiveEventTrackEventType

Der Typ des Spurereignisses.

Name	Typ	Beschreibung
TrackEvent/IngestHeartbeat	string	Nachverfolgen des empfangenen Takts.

Freigeben über