Azure 媒體服務事件的 Azure 事件格線結構描述
警告
Azure 媒體服務將於 2024 年 6 月 30 日淘汰。 如需詳細資訊,請參閱 AMS淘汰指南。
本文提供媒體服務事件的結構描述和屬性。
如需範例指令碼和教學課程的清單,請參閱媒體服務事件來源。
作業相關的事件類型
媒體服務會發出如下所述的 [作業] 相關事件類型。 [作業] 相關事件有兩種類別:「監視工作狀態變更」和「監視作業輸出的狀態變更」。
您可以訂閱 JobStateChange 事件來註冊所有事件。 或者,您可以只訂閱特定事件 (例如,JobErrored、JobFinished 和 JobCanceled 等最終狀態)。
監視作業狀態變更
事件類型 | 描述 |
---|---|
Microsoft.Media.JobStateChange | 取得所有作業狀態變更的事件。 |
Microsoft.Media.JobScheduled | 取得當作業轉換成已排程狀態時的事件。 |
Microsoft.Media.JobProcessing | 取得當作業轉換成處理狀態時的事件。 |
Microsoft.Media.JobCanceling | 取得當作業轉換成取消狀態時的事件。 |
Microsoft.Media.JobFinished | 取得當作業轉換成完成狀態時的事件。 這是包含作業輸出的最終狀態。 |
Microsoft.Media.JobCanceled | 取得當作業轉換成已取消狀態時的事件。 這是包含作業輸出的最終狀態。 |
Microsoft.Media.JobErrored | 取得當作業轉換成錯誤狀態時的事件。 這是包含作業輸出的最終狀態。 |
請參閱接下來將說明的結構描述範例。
監視作業輸出狀態變更
作業可能包含多個作業輸出 (如果您將轉換設定為具有多個作業輸出。) 如果您想要追蹤個別作業輸出的詳細資料,請接聽作業輸出變更事件。
每個作業都會在高於 JobOutput 的層級,因此作業輸出事件會在對應的作業內引發。
JobFinished
、JobCanceled
、JobError
中的錯誤訊息會針對每個作業輸出來輸出彙總結果 - 當所有作業完成時。 而作業輸出事件會在每個工作完成時引發。 例如,如果您有編碼輸出,後面接著影片分析輸出,您會在最後一個 JobFinished 事件引發之前,使用彙總的資料引發兩個事件作為作業輸出事件。
事件類型 | 描述 |
---|---|
Microsoft.Media.JobOutputStateChange | 取得所有作業輸出狀態變更的事件。 |
Microsoft.Media.JobOutputScheduled | 取得當作業輸出轉換成已排程狀態時的事件。 |
Microsoft.Media.JobOutputProcessing | 取得當作業輸出轉換成處理狀態時的事件。 |
Microsoft.Media.JobOutputCanceling | 取得當作業輸出轉換成取消狀態時的事件。 |
Microsoft.Media.JobOutputFinished | 取得當作業輸出轉換成完成狀態時的事件。 |
Microsoft.Media.JobOutputCanceled | 取得當作業輸出轉換成已取消態時的事件。 |
Microsoft.Media.JobOutputErrored | 取得當作業輸出轉換成錯誤狀態時的事件。 |
請參閱接下來將說明的結構描述範例。
監視作業輸出進度
事件類型 | 描述 |
---|---|
Microsoft.Media.JobOutputProgress | 此事件反映作業處理進度 (從 0% 到 100%)。 若進度值增加超過 5%,或自上一個事件起已超過 30 秒 (活動訊號),則服務會嘗試傳送事件。 進度值不一定會從 0% 開始、不一定會達到 100%,也不會隨著時間的經過而以固定速率增加。 請勿使用此事件來判斷處理已完成 – 您應該改用狀態變更事件。 |
請參閱接下來將說明的結構描述範例。
即時事件類型
媒體服務也會發出如下所述的 [即時] 事件類型。 即時事件有兩種類別:資料流層級事件和資料軌層級事件。
串流層級事件
資料流層級事件會以每個資料流或連線為基礎來引發。 每個事件都有 StreamId
參數可識別連線或資料流。 每個資料流或連線都有一或多個不同類型的資料軌。 例如,來自編碼器的一個連線可能會有一個音訊資料軌和四個視訊資料軌。 資料流事件類型有:
事件類型 | 描述 |
---|---|
Microsoft.Media.LiveEventConnectionRejected | 編碼器的連線嘗試遭到拒絕。 |
Microsoft.Media.LiveEventEncoderConnected | 編碼器對即時事件建立連線。 |
Microsoft.Media.LiveEventEncoderDisconnected | 編碼器中斷連線。 |
請參閱接下來將說明的結構描述範例。
追蹤層級事件
資料軌層級事件會以每個資料軌為基礎來引發。
注意
所有追蹤層級事件都會在即時編碼器連線之後引發。
追蹤層級事件類型有:
事件類型 | 描述 |
---|---|
Microsoft.Media.LiveEventIncomingDataChunkDropped | 媒體伺服器卸除資料區塊,原因是其來得太晚或有重疊的時間戳記 (新資料區塊的時間戳記小於先前資料區塊的結束時間)。 |
Microsoft.Media.LiveEventIncomingStreamReceived | 媒體伺服器收到資料流或連線中每個資料軌的第一個資料區塊。 |
Microsoft.Media.LiveEventIncomingStreamsOutOfSync | 媒體伺服器偵測到音訊和視訊串流不同步。用來作為警告,因為使用者體驗可能不會受到影響。 |
Microsoft.Media.LiveEventIncomingVideoStreamsOutOfSync | 媒體伺服器偵測到來自外部編碼器的兩個視訊串流不同步。用來作為警告,因為使用者體驗可能不會受到影響。 |
Microsoft.Media.LiveEventIngestHeartbeat | 當即時事件執行時,會針對每個資料軌每 20 秒發佈一次。 提供內嵌健康情況摘要。 一開始連線編碼器之後,活動訊號事件會繼續每隔 20 秒發出一次,無論編碼器是否仍然保持連線。 |
Microsoft.Media.LiveEventTrackDiscontinuityDetected | 媒體伺服器偵測到內送的資料軌發生中斷。 |
請參閱接下來將說明的結構描述範例。
事件結構描述範例
JobStateChange
下列範例顯示 JobStateChange 事件的結構描述:
[
{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "transforms/VideoAnalyzerTransform/jobs/<job-id>",
"eventType": "Microsoft.Media.JobStateChange",
"eventTime": "2018-04-20T21:26:13.8978772",
"id": "b9d38923-9210-4c2b-958f-0054467d4dd7",
"data": {
"previousState": "Processing",
"state": "Finished"
},
"dataVersion": "1.0",
"metadataVersion": "1"
}
]
資料物件具有下列屬性:
屬性 | 類型 | Description |
---|---|---|
previousState |
字串 | 工作在該事件之前的狀態。 |
state |
字串 | 在此事件中,被通知的工作新狀態。 例如,「已排程:作業已準備好啟動」或「已完成:作業已完成」。 |
工作狀態可以是以下其中一個值:已排入佇列、已排程、處理中、已完成、錯誤、已取消、取消中
注意
「已排入佇列」 只會存在於 previousState 屬性中,但是不會在 state 屬性中。
JobScheduled、JobProcessing、JobCanceling
對於每個非最終作業狀態的變更 (例如 JobScheduled、JobProcessing、JobCanceling),範例結構描述看起來如下所示:
[{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "transforms/VideoAnalyzerTransform/jobs/<job-id>",
"eventType": "Microsoft.Media.JobProcessing",
"eventTime": "2018-10-12T16:12:18.0839935",
"id": "a0a6efc8-f647-4fc2-be73-861fa25ba2db",
"data": {
"previousState": "Scheduled",
"state": "Processing",
"correlationData": {
"testKey1": "testValue1",
"testKey2": "testValue2"
}
},
"dataVersion": "1.0",
"metadataVersion": "1"
}]
JobFinished、JobCanceled、JobErrored
對於每個最終作業狀態的變更 (例如 JobFinished、JobCanceled、JobErrored),範例結構描述看起來如下所示:
[{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "transforms/VideoAnalyzerTransform/jobs/<job-id>",
"eventType": "Microsoft.Media.JobFinished",
"eventTime": "2018-10-12T16:25:56.4115495",
"id": "9e07e83a-dd6e-466b-a62f-27521b216f2a",
"data": {
"outputs": [
{
"@odata.type": "#Microsoft.Media.JobOutputAsset",
"assetName": "output-7640689F",
"error": null,
"label": "VideoAnalyzerPreset_0",
"progress": 100,
"state": "Finished"
}
],
"previousState": "Processing",
"state": "Finished",
"correlationData": {
"testKey1": "testValue1",
"testKey2": "testValue2"
}
},
"dataVersion": "1.0",
"metadataVersion": "1"
}]
資料物件具有下列屬性:
屬性 | 類型 | Description |
---|---|---|
outputs |
Array | 取得作業輸出。 |
JobOutputStateChange
下列範例顯示 JobOutputStateChange 事件的結構描述:
[{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "transforms/VideoAnalyzerTransform/jobs/<job-id>",
"eventType": "Microsoft.Media.JobOutputStateChange",
"eventTime": "2018-10-12T16:25:56.0242854",
"id": "dde85f46-b459-4775-b5c7-befe8e32cf90",
"data": {
"previousState": "Processing",
"output": {
"@odata.type": "#Microsoft.Media.JobOutputAsset",
"assetName": "output-7640689F",
"error": null,
"label": "VideoAnalyzerPreset_0",
"progress": 100,
"state": "Finished"
},
"jobCorrelationData": {
"testKey1": "testValue1",
"testKey2": "testValue2"
}
},
"dataVersion": "1.0",
"metadataVersion": "1"
}]
JobOutputScheduled、JobOutputProcessing、JobOutputFinished、JobOutputCanceling、JobOutputCanceled、JobOutputErrored
對於每個 JobOutput 狀態變更,範例結構描述看起來如下所示:
[{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "transforms/VideoAnalyzerTransform/jobs/<job-id>",
"eventType": "Microsoft.Media.JobOutputProcessing",
"eventTime": "2018-10-12T16:12:18.0061141",
"id": "f1fd5338-1b6c-4e31-83c9-cd7c88d2aedb",
"data": {
"previousState": "Scheduled",
"output": {
"@odata.type": "#Microsoft.Media.JobOutputAsset",
"assetName": "output-7640689F",
"error": null,
"label": "VideoAnalyzerPreset_0",
"progress": 0,
"state": "Processing"
},
"jobCorrelationData": {
"testKey1": "testValue1",
"testKey2": "testValue2"
}
},
"dataVersion": "1.0",
"metadataVersion": "1"
}]
JobOutputProgress
範例結構描述看起來像下面這樣:
[{
"topic": "/subscriptions/<subscription-id>/resourceGroups/belohGroup/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "transforms/VideoAnalyzerTransform/jobs/job-5AB6DE32",
"eventType": "Microsoft.Media.JobOutputProgress",
"eventTime": "2018-12-10T18:20:12.1514867",
"id": "00000000-0000-0000-0000-000000000000",
"data": {
"jobCorrelationData": {
"TestKey1": "TestValue1",
"testKey2": "testValue2"
},
"label": "VideoAnalyzerPreset_0",
"progress": 86
},
"dataVersion": "1.0",
"metadataVersion": "1"
}]
LiveEventConnectionRejected
下列範例顯示 LiveEventConnectionRejected 事件的結構描述:
[
{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaServices/<account-name>",
"subject": "/LiveEvents/MyLiveEvent1",
"eventType": "Microsoft.Media.LiveEventConnectionRejected",
"eventTime": "2018-01-16T01:57:26.005121Z",
"id": "b303db59-d5c1-47eb-927a-3650875fded1",
"data": {
"streamId":"Mystream1",
"ingestUrl": "http://abc.ingest.isml",
"encoderIp": "118.238.251.xxx",
"encoderPort": 52859,
"resultCode": "MPE_INGEST_CODEC_NOT_SUPPORTED"
},
"dataVersion": "1.0",
"metadataVersion": "1"
}
]
資料物件具有下列屬性:
屬性 | 類型 | Description |
---|---|---|
streamId |
字串 | 資料流或連線的識別碼。 編碼器或客戶要負責在內嵌 URL 中新增此識別碼。 |
ingestUrl |
字串 | 即時事件所提供的內嵌 URL。 |
encoderIp |
字串 | 編碼器的 IP。 |
encoderPort |
字串 | 此資料流來源編碼器的連接埠。 |
resultCode |
字串 | 連線遭到拒絕的原因。 結果碼列於下表。 |
您可以在即時事件錯誤碼中找到錯誤結果碼。
LiveEventEncoderConnected
下列範例顯示 LiveEventEncoderConnected 事件的結構描述:
[
{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "liveEvent/mle1",
"eventType": "Microsoft.Media.LiveEventEncoderConnected",
"eventTime": "2018-08-07T23:08:09.1710643",
"id": "<id>",
"data": {
"ingestUrl": "http://mle1-amsts03mediaacctgndos-ts031.channel.media.azure-test.net:80/ingest.isml",
"streamId": "15864-stream0",
"encoderIp": "131.107.147.xxx",
"encoderPort": "27485"
},
"dataVersion": "1.0",
"metadataVersion": "1"
}
]
資料物件具有下列屬性:
屬性 | 類型 | Description |
---|---|---|
streamId |
字串 | 資料流或連線的識別碼。 編碼器或客戶要負責在內嵌 URL 中提供此識別碼。 |
ingestUrl |
字串 | 即時事件所提供的內嵌 URL。 |
encoderIp |
字串 | 編碼器的 IP。 |
encoderPort |
字串 | 此資料流來源編碼器的連接埠。 |
LiveEventEncoderDisconnected
下列範例顯示 LiveEventEncoderDisconnected 事件的結構描述:
[
{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "liveEvent/mle1",
"eventType": "Microsoft.Media.LiveEventEncoderDisconnected",
"eventTime": "2018-08-07T23:08:09.1710872",
"id": "<id>",
"data": {
"ingestUrl": "http://mle1-amsts03mediaacctgndos-ts031.channel.media.azure-test.net:80/ingest.isml",
"streamId": "15864-stream0",
"encoderIp": "131.107.147.xxx",
"encoderPort": "27485",
"resultCode": "S_OK"
},
"dataVersion": "1.0",
"metadataVersion": "1"
}
]
資料物件具有下列屬性:
屬性 | 類型 | Description |
---|---|---|
streamId |
字串 | 資料流或連線的識別碼。 編碼器或客戶要負責在內嵌 URL 中新增此識別碼。 |
ingestUrl |
字串 | 即時事件所提供的內嵌 URL。 |
encoderIp |
字串 | 編碼器的 IP。 |
encoderPort |
字串 | 此資料流來源編碼器的連接埠。 |
resultCode |
字串 | 編碼器中斷連線的原因。 可能是正常中斷連線或錯誤所致。 結果碼列於下表。 |
您可以在即時事件錯誤碼中找到錯誤結果碼。
正常中斷連線的結果碼如下:
結果碼 | 描述 |
---|---|
S_OK | 編碼器已成功中斷連線。 |
MPE_CLIENT_TERMINATED_SESSION | 編碼器已中斷連線 (RTMP)。 |
MPE_CLIENT_DISCONNECTED | 編碼器已中斷連線 (FMP4)。 |
MPI_REST_API_CHANNEL_RESET | 收到通道重設命令。 |
MPI_REST_API_CHANNEL_STOP | 收到通道停止命令。 |
MPI_REST_API_CHANNEL_STOP | 通道正在進行維護。 |
MPI_STREAM_HIT_EOF | 編碼器傳送了 EOF 資料流。 |
LiveEventIncomingDataChunkDropped
下列範例顯示 LiveEventIncomingDataChunkDropped 事件的結構描述:
[
{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaServices/<account-name>",
"subject": "/LiveEvents/MyLiveEvent1",
"eventType": "Microsoft.Media.LiveEventIncomingDataChunkDropped",
"eventTime": "2018-01-16T01:57:26.005121Z",
"id": "03da9c10-fde7-48e1-80d8-49936f2c3e7d",
"data": {
"trackType": "Video",
"trackName": "Video",
"bitrate": 300000,
"timestamp": "36656620000",
"timescale": "10000000",
"resultCode": "FragmentDrop_OverlapTimestamp"
},
"dataVersion": "1.0",
"metadataVersion": "1"
}
]
資料物件具有下列屬性:
屬性 | 類型 | Description |
---|---|---|
trackType |
字串 | 資料軌的類型 (音訊/視訊)。 |
trackName |
字串 | 資料軌的名稱。 |
bitrate |
整數 | 資料軌的位元速率。 |
timestamp |
字串 | 資料區塊的卸除時間戳記。 |
timescale |
字串 | 時間戳記的時幅。 |
resultCode |
字串 | 資料區塊卸除的原因。 FragmentDrop_OverlapTimestamp 或 FragmentDrop_NonIncreasingTimestamp。 |
LiveEventIncomingStreamReceived
下列範例顯示 LiveEventIncomingStreamReceived 事件的結構描述:
[
{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "liveEvent/mle1",
"eventType": "Microsoft.Media.LiveEventIncomingStreamReceived",
"eventTime": "2018-08-07T23:08:10.5069288Z",
"id": "7f939a08-320c-47e7-8250-43dcfc04ab4d",
"data": {
"ingestUrl": "http://mle1-amsts03mediaacctgndos-ts031.channel.media.azure-test.net:80/ingest.isml/Streams(15864-stream0)15864-stream0",
"trackType": "video",
"trackName": "video",
"bitrate": 2962000,
"encoderIp": "131.107.147.xxx",
"encoderPort": "27485",
"timestamp": "15336831655032322",
"duration": "20000000",
"timescale": "10000000"
},
"dataVersion": "1.0",
"metadataVersion": "1"
}
]
資料物件具有下列屬性:
屬性 | 類型 | Description |
---|---|---|
trackType |
字串 | 資料軌的類型 (音訊/視訊)。 |
trackName |
字串 | 資料軌的名稱 (由編碼器提供,在 RTMP 的案例中,伺服器會以 TrackType_Bitrate 格式產生)。 |
bitrate |
整數 | 資料軌的位元速率。 |
ingestUrl |
字串 | 即時事件所提供的內嵌 URL。 |
encoderIp |
字串 | 編碼器的 IP。 |
encoderPort |
字串 | 此資料流來源編碼器的連接埠。 |
timestamp |
字串 | 所收到資料區塊的第一個時間戳記。 |
timescale |
字串 | 用來表示時間戳記的時幅。 |
LiveEventIncomingStreamsOutOfSync
下列範例顯示 LiveEventIncomingStreamsOutOfSync 事件的結構描述:
[
{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "liveEvent/mle1",
"eventType": "Microsoft.Media.LiveEventIncomingStreamsOutOfSync",
"eventTime": "2018-08-10T02:26:20.6269183Z",
"id": "b9d38923-9210-4c2b-958f-0054467d4dd7",
"data": {
"minLastTimestamp": "319996",
"typeOfStreamWithMinLastTimestamp": "Audio",
"maxLastTimestamp": "366000",
"typeOfStreamWithMaxLastTimestamp": "Video",
"timescaleOfMinLastTimestamp": "10000000",
"timescaleOfMaxLastTimestamp": "10000000"
},
"dataVersion": "1.0",
"metadataVersion": "1"
}
]
資料物件具有下列屬性:
屬性 | 類型 | Description |
---|---|---|
minLastTimestamp |
字串 | 所有資料軌 (音訊或視訊) 最後一個時間戳記之間的最小值。 |
typeOfTrackWithMinLastTimestamp |
字串 | 最後一個時間戳記為最小值的資料軌 (音訊或視訊) 類型。 |
maxLastTimestamp |
字串 | 所有資料軌 (音訊或視訊) 的所有時間戳記之間的最大值。 |
typeOfTrackWithMaxLastTimestamp |
字串 | 最後一個時間戳記為最大值的資料軌 (音訊或視訊) 類型。 |
timescaleOfMinLastTimestamp |
字串 | 取得用來表示 "MinLastTimestamp" 的時幅。 |
timescaleOfMaxLastTimestamp |
字串 | 取得用來表示 "MaxLastTimestamp" 的時幅。 |
LiveEventIncomingVideoStreamsOutOfSync
下列範例顯示 LiveEventIncomingVideoStreamsOutOfSync 事件的結構描述:
[
{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaServices/<account-name>",
"subject": "/LiveEvents/LiveEvent1",
"eventType": "Microsoft.Media.LiveEventIncomingVideoStreamsOutOfSync",
"eventTime": "2018-01-16T01:57:26.005121Z",
"id": "6dd4d862-d442-40a0-b9f3-fc14bcf6d750",
"data": {
"firstTimestamp": "2162058216",
"firstDuration": "2000",
"secondTimestamp": "2162057216",
"secondDuration": "2000",
"timescale": "10000000"
},
"dataVersion": "1.0",
"metadataVersion": "1"
}
]
資料物件具有下列屬性:
屬性 | 類型 | Description |
---|---|---|
firstTimestamp |
字串 | 其中一個視訊類型資料軌/品質層級所收到的時間戳記。 |
firstDuration |
字串 | 具有第一個時間戳記的資料區塊持續時間。 |
secondTimestamp |
字串 | 其他某些視訊類型資料軌/品質層級所收到的時間戳記。 |
secondDuration |
字串 | 具有第二個時間戳記的資料區塊持續時間。 |
timescale |
字串 | 時間戳記和持續時間的時幅。 |
LiveEventIngestHeartbeat
下列範例顯示 LiveEventIngestHeartbeat 事件的結構描述:
[
{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "liveEvent/mle1",
"eventType": "Microsoft.Media.LiveEventIngestHeartbeat",
"eventTime": "2021-05-14T23:50:00.324",
"id": "7f450938-491f-41e1-b06f-c6cd3965d786",
"data": {
"trackType":"video",
"trackName":"video",
"bitrate":2500000,
"incomingBitrate":2462597,
"lastTimestamp":"106999",
"timescale":"1000",
"overlapCount":0,
"discontinuityCount":0,
"nonincreasingCount":0,
"unexpectedBitrate":false,
"state":"Running",
"healthy":true,
"lastFragmentArrivalTime":"2021-05-14T23:50:00.324",
"ingestDriftValue":"0",
"transcriptionState":"",
"transcriptionLanguage":""
},
"dataVersion": "1.0",
"metadataVersion": "1"
}
]
資料物件具有下列屬性:
屬性 | 類型 | Description |
---|---|---|
trackType |
字串 | 資料軌的類型 (音訊/視訊)。 |
trackName |
字串 | 資料軌的名稱 (由編碼器提供,在 RTMP 的案例中,伺服器會以 TrackType_Bitrate 格式產生)。 |
bitrate |
整數 | 資料軌的位元速率。 |
incomingBitrate |
整數 | 根據來自編碼器的資料區塊所計算出的位元速率。 |
lastTimestamp |
字串 | 資料軌在過去 20 秒所收到的最新時間戳記。 |
timescale |
字串 | 用來表示時間戳記的時幅。 |
overlapCount |
整數 | 在過去 20 秒有重疊時間戳記的資料區塊數目。 |
discontinuityCount |
整數 | 在過去 20 秒所觀察到的中斷次數。 |
nonIncreasingCount |
整數 | 在過去 20 秒所收到有過去時間戳記的資料區塊數目。 |
unexpectedBitrate |
bool | 在過去 20 秒內,預期和實際的位元速率差異是否超過允許的限制。 只有在「incomingBitrate >= 2* 位元速率」或「incomingBitrate <= 位元速率/2」或「IncomingBitrate = 0」時,才會是 true。 |
state |
字串 | 即時事件的狀態。 |
healthy |
bool | 根據計數和旗標來指出內嵌是否狀況良好。 如果 overlapCount = 0 && discontinuityCount = 0 && nonIncreasingCount = 0 && unexpectedBitrate = false,則健康情況為 true。 |
lastFragmentArrivalTime |
字串 | 片段到達擷取端點的最後一個 UTC 時間戳記。 範例日期格式為「2020-11-11 12:12:12:888999」 |
ingestDriftValue |
字串 | 指出過去一分鐘內傳入音訊或視訊資料的延遲速度,以每分鐘秒數為單位。 如果資料抵達即時活動的速度比最後一分鐘的預期還慢,則此值大於零;如果資料抵達且沒有延遲,則為零;如果未收到音訊或視訊資料,則為「n/a」。 例如,如果您有在即時內容中傳送的參與編碼器,而且因為處理問題或網路延遲而變慢,則可能只能在一分鐘內提供共 58 秒的音訊或影片。 這會回報為每分鐘漂移兩秒。 如果編碼器每分鐘能夠趕上並傳送所有 60 秒以上的資料,則您會看到此值回報為 0。 如果編碼器有中斷連線或不連續,則此值仍會顯示為 0,因為不會考慮資料中斷,只會考慮延遲時間戳記的資料。 |
transcriptionState |
字串 | 如果開啟即時謄寫,則音訊資料軌活動訊號的此值為「開啟」,否則您會看到空字串。 此狀態僅適用於即時謄寫的「音訊」tracktype。 所有其他資料軌都會有空值。 |
transcriptionLanguage |
字串 | 謄寫語言的語言代碼 (BCP-47 格式)。 例如,“de-de” 表示德國 (德國) 。 視訊播放軌活動訊號或關閉即時謄寫時,此值是空的。 |
LiveEventChannelArchiveHeartbeat
下列範例顯示 LiveEventChannelArchiveHeartbeatEvent 事件的結構描述:
[
{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "liveEvent/mle1",
"eventType": "Microsoft.Media.LiveEventChannelArchiveHeartbeat",
"eventTime": "2021-05-14T23:50:00.324",
"id": "7f450938-491f-41e1-b06f-c6cd3965d786",
"data": {
"channelLatencyMs": "10",
"latencyResultCode": "S_OK"
},
"dataVersion": "1.0",
"metadataVersion": "1"
}
]
資料物件具有下列屬性:
屬性 | 類型 | Description |
---|---|---|
channelLatencyMs |
字串 | 發佈至 HLS/DASH 資訊清單以供玩家下載之前,已擷取的影片花在即時事件管線中的時間 (毫秒)。 |
latencyResultCode |
字串 | channelLatencyMs 計算的結果碼。
S_OK 指出已收到即時事件擷取,且未發生任何問題。 其他結果碼指出導致 channelLatencyMs 具有空白值的情況。
MPE_KEY_FRAME_INTERVAL_TOO_LARGE 錯誤碼指出已擷取的影片來源具有大型 GOP (主要畫面距離),而這會對通道延遲造成負面影響。
MPE_INGEST_DISCONTINUITY 錯誤碼指出已在來源串流上偵測到不連續,而這可能會將長時間延遲新增至通道。 |
LiveEventTrackDiscontinuityDetected
下列範例顯示 LiveEventTrackDiscontinuityDetected 事件的結構描述:
[
{
"topic": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
"subject": "liveEvent/mle1",
"eventType": "Microsoft.Media.LiveEventTrackDiscontinuityDetected",
"eventTime": "2018-08-07T23:18:06.1270405Z",
"id": "5f4c510d-5be7-4bef-baf0-64b828be9c9b",
"data": {
"trackName": "video",
"previousTimestamp": "15336837615032322",
"trackType": "video",
"bitrate": 2962000,
"newTimestamp": "15336837619774273",
"discontinuityGap": "575284",
"timescale": "10000000"
},
"dataVersion": "1.0",
"metadataVersion": "1"
}
]
資料物件具有下列屬性:
屬性 | 類型 | Description |
---|---|---|
trackType |
字串 | 資料軌的類型 (音訊/視訊)。 |
trackName |
字串 | 資料軌的名稱 (由編碼器提供,在 RTMP 的案例中,伺服器會以 TrackType_Bitrate 格式產生)。 |
bitrate |
整數 | 資料軌的位元速率。 |
previousTimestamp |
字串 | 上一個片段的時間戳記。 |
newTimestamp |
字串 | 當前片段的時間戳記。 |
discontinuityGap |
字串 | 上述兩個時間戳記之間的間距。 |
timescale |
字串 | 用來表示時間戳記和中斷間距的時幅。 |
常見的事件屬性
事件具有下列的最高層級資料:
屬性 | 類型 | Description |
---|---|---|
topic |
字串 | 事件方格主題。 此屬性有媒體服務帳戶的資源識別碼。 |
subject |
字串 | 媒體服務帳戶底下媒體服務通道的資源路徑。 串連主題和主旨即可獲得作業的資源識別碼。 |
eventType |
字串 | 此事件來源已註冊的事件類型之一。 例如,"Microsoft.Media.JobStateChange"。 |
eventTime |
字串 | 事件產生的時間,以提供者之 UTC 時間為準。 |
id |
字串 | 事件的唯一識別碼。 |
data |
object | 媒體服務事件資料。 |
dataVersion |
字串 | 資料物件的結構描述版本。 發行者會定義結構描述版本。 |
metadataVersion |
字串 | 事件中繼資料的結構描述版本。 「事件方格」會定義最上層屬性的結構描述。 「事件方格」提供此值。 |