Live Events - List Get Track Ingest Heartbeats

Ссылка

Service:: Media Services

API Version:: 2022-11-01

Получение событий отслеживания одного трансляции
Получение телеметрии событий пульса приема отслеживания трансляции.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
accountName	path	True	string	Имя учетной записи Служб мультимедиа.
liveEventName	path	True	string	Имя трансляции, максимальная длина — 32. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Имя группы ресурсов в подписке Azure.
subscriptionId	path	True	string	Уникальный идентификатор подписки Microsoft Azure.
api-version	query	True	string	Версия API, которая будет использоваться с клиентским запросом.

Ответы

Имя	Тип	Описание
200 OK	LiveEventGetTrackIngestHeartbeatsResult	Все в порядке. Запрос выполнен успешно.
202 Accepted		Принято. Запрос был принят для обработки, и операция завершится асинхронно. Дополнительные сведения о мониторинге асинхронных операций Azure см https://go.microsoft.com/fwlink/?linkid=2087017 . в этой статье. Headers Location: string Azure-AsyncOperation: string
Other Status Codes		Не изменено. ETag в заголовке запроса совпадает с eTag в контейнере хранилища.
Other Status Codes	ErrorResponse	Ответ об ошибке потоковой передачи, описывающий причину сбоя операции.

Примеры

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

Определения

Имя	Описание
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Сообщение об ошибке
LiveEventGetTrackIngestHeartbeatsResult	Получение трансляции трек приема сердца бьется результат.
LiveEventTrackEvent	Событие отслеживания трансляции.
LiveEventTrackEventData	Отслеживание трансляции приема данных о событии пульса.
LiveEventTrackEventTrackType	Тип дорожки.
LiveEventTrackEventType	Тип события отслеживания.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя	Тип	Описание
error	ErrorDetail	Объект error.

LiveEventGetTrackIngestHeartbeatsResult

Получение трансляции трек приема сердца бьется результат.

Имя	Тип	Описание
value	LiveEventTrackEvent[]	Результат получения событий отслеживания трансляции.

LiveEventTrackEvent

Событие отслеживания трансляции.

Имя	Тип	Описание
data	LiveEventTrackEventData	Данные события.
eventTime	string	Возникает событие времени.
eventType	LiveEventTrackEventType	Тип события отслеживания.

LiveEventTrackEventData

Отслеживание трансляции приема данных о событии пульса.

Имя	Тип	Описание
bitrate	integer	Скорость дорожки.
discontinuityCount	integer	Количество разрывов, обнаруженных за последние 20 секунд.
healthy	boolean	Указывает, является ли прием работоспособным.
incomingBitrate	integer	Расчетная скорость на основе блоков данных, поступающих из кодировщика.
ingestDriftValue	string	Указывает скорость задержки (в секундах за минуту) входящих звуковых или видеоданных за последнюю минуту. Значение будет выше нуля, если за последнюю минуту данные прибывали на трансляцию медленнее, чем ожидалось. Нулевое значение означает, что данные прибыли без задержки, а значение “n/a” указывает, что звуковые или видеоданные не были получены. Например, если у вас есть кодировщик предоставления данных, отправляющий содержимое в реальном времени, и он замедляется из-за проблем с обработкой или сетевой задержки, он может успеть доставить только 58 секунд звука или видео за одну минуту. Это обозначается как смещение в две секунды за минуту. Если кодировщик успевает отправить все 60 секунд данных или больше каждую минуту, то будет отображаться значение 0. В случае обрыва или неоднородности соединения с кодировщиком это значение по-прежнему может составлять 0, так как оно не учитывает разрывы в данных, а только задержки данных по меткам времени.
lastFragmentArrivalTime	string	Последняя метка времени в формате UTC, когда фрагмент прибыл в конечную точку приема.
lastTimestamp	string	Последняя метка времени, полученная для дорожки за последние 20 секунд.
nonincreasingCount	integer	Количество блоков данных с метками времени в прошлом, полученных за последние 20 секунд.
overlapCount	integer	Количество блоков данных, которые перекрывали метки времени за последние 20 секунд.
state	string	Состояние события прямой трансляции.
timescale	string	Шкала времени, в которой выражены метки времени.
trackName	string	Имя дорожки.
trackType	LiveEventTrackEventTrackType	Тип дорожки.
transcriptionLanguage	string	Код языка транскрибирования (в формате BCP-47). Например, "de-de" означает немецкий (Германия). Значение будет пустым для пульсов видеодорожек или при отключенном транскрибировании в реальном времени.
transcriptionState	string	Это значение равно "On" для пульсов звуковых дорожек, если включено транскрибирование в реальном времени. В противном случае оно будет пустой строкой. Это состояние применимо только к типу дорожки "аудио" для транскрибирования в реальном времени. Для всех остальных дорожек используется пустое значение.
unexpectedBitrate	boolean	Если ожидаемые и фактические скорости отличаются более чем на допустимый предел за последние 20 секунд.

LiveEventTrackEventTrackType

Тип дорожки.

Имя	Тип	Описание
audio	string
video	string

LiveEventTrackEventType

Тип события отслеживания.

Имя	Тип	Описание
TrackEvent/IngestHeartbeat	string	Отслеживание полученного пульса.