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 參數

名稱	位於	必要	類型	Description
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 版本。

回應

名稱	類型	Description
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

定義

名稱	Description
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
LiveEventGetTrackIngestHeartbeatsResult	取得即時活動追蹤擷取活動訊號結果。
LiveEventTrackEvent	即時活動追蹤活動。
LiveEventTrackEventData	即時活動會追蹤擷取活動訊號活動數據。
LiveEventTrackEventTrackType	追蹤的類型。
LiveEventTrackEventType	追蹤事件的型別。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細資料。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

LiveEventGetTrackIngestHeartbeatsResult

取得即時活動追蹤擷取活動訊號結果。

名稱	類型	Description
value	LiveEventTrackEvent[]	取得即時活動追蹤事件的結果。

LiveEventTrackEvent

即時活動追蹤活動。

名稱	類型	Description
data	LiveEventTrackEventData	事件資料。
eventTime	string	引發的時間事件。
eventType	LiveEventTrackEventType	追蹤事件的型別。

LiveEventTrackEventData

即時活動會追蹤擷取活動訊號活動數據。

名稱	類型	Description
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	如果開啟即時謄寫，則音訊資料軌活動訊號的此值為「開啟」，否則您會看到空字串。此狀態僅適用於即時轉譯的「音訊」追蹤類型。所有其他資料軌都會有空值。
unexpectedBitrate	boolean	在過去 20 秒內，預期和實際的位元速率差異是否超過允許的限制。

LiveEventTrackEventTrackType

追蹤的類型。

名稱	類型	Description
audio	string
video	string

LiveEventTrackEventType

追蹤事件的型別。

名稱	類型	Description
TrackEvent/IngestHeartbeat	string	追蹤收到的活動訊號。

Share via