Live Events - List Get Track Ingest Heartbeats

Referência

Service:: Media Services

API Version:: 2022-11-01

Obter eventos de controle de um evento ao vivo
Obter telemetria de eventos de pulsação de ingestão de controle de um evento ao vivo.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
accountName	path	True	string	O nome da conta dos Serviços de Mídia.
liveEventName	path	True	string	O nome do evento ao vivo, o comprimento máximo é 32. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	O nome do grupo de recursos na assinatura do Azure.
subscriptionId	path	True	string	O identificador exclusivo para uma assinatura do Microsoft Azure.
api-version	query	True	string	A versão da API a ser usada com a solicitação do cliente.

Respostas

Nome	Tipo	Description
200 OK	LiveEventGetTrackIngestHeartbeatsResult	OK. A solicitação foi bem-sucedida.
202 Accepted		Aceita. A solicitação foi aceita para processamento e a operação será concluída de forma assíncrona. Consulte https://go.microsoft.com/fwlink/?linkid=2087017 para obter detalhes sobre o monitoramento de operações assíncronas do Azure. Headers Location: string Azure-AsyncOperation: string
Other Status Codes		Não modificado. A eTag no cabeçalho da solicitação é a mesma que a eTag no contêiner de armazenamento.
Other Status Codes	ErrorResponse	A resposta de erro de streaming que descreve por que a operação falhou.

Exemplos

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

Definições

Nome	Description
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
LiveEventGetTrackIngestHeartbeatsResult	Obter resultado da ingestão de pulsações cardíacas da faixa de eventos ao vivo.
LiveEventTrackEvent	O evento de faixa de eventos ao vivo.
LiveEventTrackEventData	A faixa de eventos ao vivo ingere dados de evento de pulsação cardíaca.
LiveEventTrackEventTrackType	Tipo da faixa.
LiveEventTrackEventType	O tipo do evento de faixa.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

LiveEventGetTrackIngestHeartbeatsResult

Obter resultado da ingestão de pulsações cardíacas da faixa de eventos ao vivo.

Nome	Tipo	Description
value	LiveEventTrackEvent[]	O resultado dos eventos da faixa de eventos get ao vivo.

LiveEventTrackEvent

O evento de faixa de eventos ao vivo.

Nome	Tipo	Description
data	LiveEventTrackEventData	Dados do evento.
eventTime	string	O evento de hora gerado.
eventType	LiveEventTrackEventType	O tipo do evento de faixa.

LiveEventTrackEventData

A faixa de eventos ao vivo ingere dados de evento de pulsação cardíaca.

Nome	Tipo	Description
bitrate	integer	Taxa de bits da faixa.
discontinuityCount	integer	Número de descontinuidades detectadas nos últimos 20 segundos.
healthy	boolean	Indica se a ingestão está íntegra.
incomingBitrate	integer	Taxa de bits calculada com base nas partes de dados provenientes do codificador.
ingestDriftValue	string	Indica a velocidade do atraso, em segundos por minuto, dos dados de áudio ou vídeo de entrada durante o último minuto. O valor será maior do que zero se os dados chegarem ao evento ao vivo mais lentos do que o esperado no último minuto; zero se os dados chegaram sem atraso; e "n/a" se nenhum dado de áudio ou vídeo foi recebido. Por exemplo, se você tiver um codificador de contribuição enviando conteúdo ao vivo e ele estiver ficando lento devido a problemas de processamento ou latência de rede, ele poderá ser capaz de entregar um total de 58 segundos de áudio ou vídeo em um período de um minuto. Isso seria relatado como descompasso de dois segundos por minuto. Se o codificador for capaz de acompanhar e enviar todos os 60 segundos ou mais de dados a cada minuto, você verá esse valor relatado como 0. Se houver uma desconexão ou descontinuidade do codificador, esse valor ainda pode ser exibido como 0, pois ele não levará em conta as quebras nos dados, mas somente os dados atrasados em carimbos de data/hora.
lastFragmentArrivalTime	string	O último carimbo de data/hora em UTC em que um fragmento chegou ao ponto de extremidade de ingestão.
lastTimestamp	string	Carimbo de data/hora mais recente recebido para uma faixa nos últimos 20 segundos.
nonincreasingCount	integer	Número de partes de dados com carimbos de data/hora no passado que foram recebidos nos últimos 20 segundos.
overlapCount	integer	Número de partes de dados que tiveram carimbos de data/hora sobrepostos nos últimos 20 segundos.
state	string	Estado do evento ao vivo.
timescale	string	Escala de tempo na qual os carimbos de data/hora são expressos.
trackName	string	Nome da faixa.
trackType	LiveEventTrackEventTrackType	Tipo da faixa.
transcriptionLanguage	string	O código de idioma (no formato BCP-47) da linguagem de transcrição. Por exemplo, "de-de" indica alemão (Alemanha). O valor está vazio para as pulsações de faixa de vídeo ou quando a transcrição dinâmica está desativada.
transcriptionState	string	Esse valor será "ativado" para pulsações de faixa de áudio se a transcrição dinâmica estiver ativada, caso contrário, você verá uma cadeia de caracteres vazia. Esse estado só é aplicável ao tipo de controle de "áudio" para transcrição ao vivo. Todas as outras faixas terão um valor vazio.
unexpectedBitrate	boolean	Se as taxas de bits esperadas e reais apresentarem diferença superior ao limite permitido nos últimos 20 segundos.

LiveEventTrackEventTrackType

Tipo da faixa.

Nome	Tipo	Description
audio	string
video	string

LiveEventTrackEventType

O tipo do evento de faixa.

Nome	Tipo	Description
TrackEvent/IngestHeartbeat	string	Controlar a pulsação recebida.

Share via