Live Events - List Get Stream Events

參考

Service:: Media Services

API Version:: 2022-11-01

取得一個即時活動的串流事件
取得即時活動的串流事件遙測。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}/getStreamEvents?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	LiveEventGetStreamEventsResult	正常。要求已成功。
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 stream events of a LiveEvent

POST https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveEvents/myLiveEvent1/getStreamEvents?api-version=2022-11-01

/** Samples for LiveEvents ListGetStreamEvents. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveevent-get-stream-events.json
     */
    /**
     * Sample code: Get stream events of a LiveEvent.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void getStreamEventsOfALiveEvent(
        com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .liveEvents()
            .listGetStreamEvents("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": "StreamEvent/BeginIngest",
      "eventTime": "2022-10-19T22:13:59.33Z",
      "eventLevel": "Information",
      "data": {
        "trackName": null,
        "streamId": null,
        "trackId": null,
        "mediaType": null,
        "bitrate": null,
        "mediaTimestamp": null,
        "timescale": null,
        "previousFragmentTimestamp": null,
        "previousFragmentDuration": null,
        "currentFragmentTimestamp": null,
        "fragmentOneTimestamp": null,
        "fragmentOneDuration": null,
        "fragmentTwoTimestamp": null,
        "fragmentTwoDuration": null,
        "fragmentDropReason": null,
        "discontinuityGap": null,
        "streamName": "myStream",
        "resultCode": "S_OK",
        "resultMessage": "{flashVer=Wirecast/FM 1.0 FMLE/3.0 (compatible; FMSc/1.0), cryptProtocol=TLS1.2}",
        "duration": null,
        "resolution": null,
        "minTime": null,
        "minTimeMediaType": null,
        "maxTime": null,
        "maxTimeMediaType": null,
        "timescaleOfMinTime": null,
        "timescaleOfMaxTime": null,
        "remoteIp": "131.107.8.xxx",
        "remotePort": "26919"
      }
    },
    {
      "eventType": "StreamEvent/FirstChunkReceived",
      "eventTime": "2022-10-19T22:14:04.45Z",
      "eventLevel": "Information",
      "data": {
        "trackName": "audio_128000",
        "streamId": null,
        "trackId": null,
        "mediaType": "audio",
        "bitrate": 128000,
        "mediaTimestamp": "1635238395",
        "timescale": "1000",
        "previousFragmentTimestamp": null,
        "previousFragmentDuration": null,
        "currentFragmentTimestamp": null,
        "fragmentOneTimestamp": null,
        "fragmentOneDuration": null,
        "fragmentTwoTimestamp": null,
        "fragmentTwoDuration": null,
        "fragmentDropReason": null,
        "discontinuityGap": null,
        "streamName": null,
        "resultCode": "S_OK",
        "resultMessage": null,
        "duration": "2391",
        "resolution": null,
        "minTime": null,
        "minTimeMediaType": null,
        "maxTime": null,
        "maxTimeMediaType": null,
        "timescaleOfMinTime": null,
        "timescaleOfMaxTime": null,
        "remoteIp": "131.107.8.xxx",
        "remotePort": "26919"
      }
    },
    {
      "eventType": "StreamEvent/FirstChunkReceived",
      "eventTime": "2022-10-19T22:14:04.78Z",
      "eventLevel": "Information",
      "data": {
        "trackName": "video_2025000",
        "streamId": null,
        "trackId": null,
        "mediaType": "video",
        "bitrate": 2025000,
        "mediaTimestamp": "1635238372",
        "timescale": "1000",
        "previousFragmentTimestamp": null,
        "previousFragmentDuration": null,
        "currentFragmentTimestamp": null,
        "fragmentOneTimestamp": null,
        "fragmentOneDuration": null,
        "fragmentTwoTimestamp": null,
        "fragmentTwoDuration": null,
        "fragmentDropReason": null,
        "discontinuityGap": null,
        "streamName": null,
        "resultCode": "S_OK",
        "resultMessage": null,
        "duration": "2400",
        "resolution": "1280x720",
        "minTime": null,
        "minTimeMediaType": null,
        "maxTime": null,
        "maxTimeMediaType": null,
        "timescaleOfMinTime": null,
        "timescaleOfMaxTime": null,
        "remoteIp": "131.107.8.xxx",
        "remotePort": "26919"
      }
    },
    {
      "eventType": "StreamEvent/EndIngest",
      "eventTime": "2022-10-19T22:20:36.45Z",
      "eventLevel": "Information",
      "data": {
        "trackName": null,
        "streamId": null,
        "trackId": null,
        "mediaType": null,
        "bitrate": null,
        "mediaTimestamp": null,
        "timescale": null,
        "previousFragmentTimestamp": null,
        "previousFragmentDuration": null,
        "currentFragmentTimestamp": null,
        "fragmentOneTimestamp": null,
        "fragmentOneDuration": null,
        "fragmentTwoTimestamp": null,
        "fragmentTwoDuration": null,
        "fragmentDropReason": null,
        "discontinuityGap": null,
        "streamName": "myStream",
        "resultCode": "MPE_CLIENT_TERMINATED_SESSION",
        "resultMessage": "{connection=1, receivedBytes=104758568, acknowledgement=103917434}",
        "duration": null,
        "resolution": null,
        "minTime": null,
        "minTimeMediaType": null,
        "maxTime": null,
        "maxTimeMediaType": null,
        "timescaleOfMinTime": null,
        "timescaleOfMaxTime": null,
        "remoteIp": "131.107.8.xxx",
        "remotePort": "26919"
      }
    }
  ]
}

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	錯誤回應
LiveEventGetStreamEventsResult	取得即時事件串流事件結果。
LiveEventStreamEvent	即時活動串流活動。
LiveEventStreamEventData	即時事件串流事件數據。
LiveEventStreamEventLevel	事件層級。
LiveEventStreamEventMaxTimeMediaType	比較兩個片段較大時間戳的媒體類型。
LiveEventStreamEventMediaType	追蹤的類型。
LiveEventStreamEventMinTimeMediaType	比較兩個片段之較小時間戳的媒體類型。
LiveEventStreamEventType	數據流事件的型別。格式：StreamEvent/{eventType}

ErrorAdditionalInfo

資源管理錯誤其他資訊。

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

ErrorDetail

錯誤詳細數據。

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

ErrorResponse

錯誤回應

名稱	類型	Description
error	ErrorDetail	錯誤物件。

LiveEventGetStreamEventsResult

取得即時事件串流事件結果。

名稱	類型	Description
value	LiveEventStreamEvent[]	取得即時事件串流事件的結果。

LiveEventStreamEvent

即時活動串流活動。

名稱	類型	Description
data	LiveEventStreamEventData	根據事件類型的事件數據。
eventLevel	LiveEventStreamEventLevel	事件層級。
eventTime	string	引發的時間事件。
eventType	LiveEventStreamEventType	數據流事件的型別。格式：StreamEvent/{eventType}

LiveEventStreamEventData

即時事件串流事件數據。

名稱	類型	Description
bitrate	integer	資料軌的位元速率。
currentFragmentTimestamp	string	時幅中的目前片段時間戳。
discontinuityGap	integer	時幅中不連續間距的長度。
duration	string	片段持續時間。
fragmentDropReason	string	卸除片段的原因。
fragmentOneDuration	string	用來進行時幅比較的第一個片段持續時間。
fragmentOneTimestamp	string	用來進行時幅比較之第一個片段的時間戳。
fragmentTwoDuration	string	用來進行時幅比較的第二個片段持續時間。
fragmentTwoTimestamp	string	用來進行時幅比較之第二個片段的時間戳。
maxTime	string	比較兩個片段的較大時間戳。
maxTimeMediaType	LiveEventStreamEventMaxTimeMediaType	比較兩個片段較大時間戳的媒體類型。
mediaTimestamp	string	時幅中的片段時間戳。
mediaType	LiveEventStreamEventMediaType	追蹤的類型。
minTime	string	比較兩個片段的較小時間戳。
minTimeMediaType	LiveEventStreamEventMinTimeMediaType	比較兩個片段之較小時間戳的媒體類型。
previousFragmentDuration	string	前一個時幅片段持續時間。
previousFragmentTimestamp	string	時幅中的前一個片段時間戳。
remoteIp	string	編碼器的截斷IP。
remotePort	string	編碼器的埠。
resolution	string	視訊寬度 x Height，否則為 null。
resultCode	string	結果碼。
resultMessage	string	結果訊息。
streamId	string	格式為「trackName_bitrate」的數據流標識碼
streamName	string	資料流或連線的識別碼。編碼器或客戶要負責在內嵌 URL 中新增此識別碼。
timescale	string	用來表示時間戳記的時幅。
timescaleOfMaxTime	string	具有較大時間戳之片段的時幅。
timescaleOfMinTime	string	具有較小時間戳之片段的時幅。
trackId	integer	追蹤索引。
trackName	string	資料軌的名稱。

LiveEventStreamEventLevel

事件層級。

名稱	類型	Description
Critical	string
Error	string
Information	string
Warning	string

LiveEventStreamEventMaxTimeMediaType

比較兩個片段較大時間戳的媒體類型。

名稱	類型	Description
Audio	string
Video	string

LiveEventStreamEventMediaType

追蹤的類型。

名稱	類型	Description
audio	string
video	string

LiveEventStreamEventMinTimeMediaType

比較兩個片段之較小時間戳的媒體類型。

名稱	類型	Description
Audio	string
Video	string

LiveEventStreamEventType

數據流事件的型別。格式：StreamEvent/{eventType}

名稱	類型	Description
StreamEvent/BeginIngest	string	擷取會話開始。
StreamEvent/ChunkDropped	string	片段已捨棄。
StreamEvent/Discontinuity	string	偵測到時間戳不連續性。
StreamEvent/EndIngest	string	擷取會話結束。
StreamEvent/FirstChunkReceived	string	擷取媒體播放軌上收到的第一個片段。
StreamEvent/InvalidConnection	string	擷取會話遭拒。
StreamEvent/UnalignedKeyFrames	string	偵測到未對齊的視訊主要畫面格。
StreamEvent/UnalignedPresentation	string	偵測到未對齊的簡報，這表示兩個品質層級的兩個片段沒有時間對齊。

Share via