Event Grid ソースとしての Azure Media Services

[アーティクル]
04/11/2023

この記事では、Media Services イベント用のスキーマとプロパティについて説明します。

Media Services では、下で説明するジョブ関連イベントの種類が出力されます。 ジョブ関連イベントには 2 つのカテゴリがあります。"ジョブの状態変更の監視" と "ジョブ出力の状態変更の監視" です。

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	ジョブがエラー状態に遷移したときにイベントを取得します。これは、ジョブの出力を含む最終状態です。

次のスキーマの例を参照してください。

ジョブの出力の状態変更の監視

1 つのジョブに複数のジョブ出力が含まれている場合があります (複数のジョブ出力を含めるように変換を構成した場合)。個々のジョブ出力の詳細を追跡する場合は、ジョブ出力変更イベントをリッスンします。

各ジョブ は JobOutput よりも上位レベルになるため、ジョブ出力イベントは対応するジョブの内部で発生します。

JobFinished、JobCanceled、JobError の各エラーメッセージには、(すべてのジョブ出力が完了したときに) ジョブ出力ごとの集計結果が出力されます。一方、ジョブ出力イベントは、各タスクが完了したときに発生します。たとえば、エンコードの出力とそれに続く Video Analytics の出力が行われる場合は、2 つのイベントがジョブ出力イベントとして発生してから、最後の 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% に達することも保証されていません。さらに、時間の経過とともに一定の率で増加することも保証されていません。このイベントは、処理が完了していることを判断するために使用すべきではありません。代わりに、状態変更イベントを使用する必要があります。

イベントの種類

説明

Microsoft.Media.JobOutputProgress

このイベントは、ジョブ処理の進行状況を反映します (0 % から 100%)。進行状況の値が 5% 以上増加した場合、または前回のイベントから 30 秒以上経過した (ハートビート) 場合に、サービスによるイベントの送信が試されます。進行状況の値は、0% で始まることも 100% に達することも保証されていません。さらに、時間の経過とともに一定の率で増加することも保証されていません。このイベントは、処理が完了していることを判断するために使用すべきではありません。代わりに、状態変更イベントを使用する必要があります。

次のスキーマの例を参照してください。

ライブイベントの種類

Media Services では、以下の種類のライブ イベントも出力されます。 Live イベントには、ストリームレベルイベントとトラックレベルイベントの 2 つのカテゴリがあります。

ストリームレベルイベント

ストリームレベルイベントは、ストリームまたは接続ごとに発生します。各イベントには、接続またはストリームを識別する StreamId パラメーターがあります。各ストリームまたは接続には、さまざまな種類のトラックが少なくとも 1 つ存在します。たとえば、エンコーダーからの接続 1 つにつき、1 つのオーディオトラックと 4 つのビデオトラックが存在する場合もあります。ストリームイベントには、次の種類があります。

イベントの種類	説明
Microsoft.Media.LiveEventConnectionRejected	エンコーダーの接続試行が拒否されました。
Microsoft.Media.LiveEventEncoderConnected	エンコーダーがライブイベントとの接続を確立しました。
Microsoft.Media.LiveEventEncoderDisconnected	エンコーダーが切断されました。

次のスキーマの例を参照してください。

トラックレベルイベント

トラックレベルイベントは、トラックごとに発生します。

注意

すべてのトラックレベルイベントは、ライブエンコーダーが接続された後に発生します。

トラックレベルイベントには、次の種類があります。

イベントの種類	説明
Microsoft.Media.LiveEventIncomingDataChunkDropped	データチャンクが遅すぎるか、タイムスタンプが重複している (新しいデータチャンクのタイムスタンプが前のデータチャンクの終了時間よりも古い) ため、メディアサーバーがデータチャンクをドロップしました。
Microsoft.Media.LiveEventIncomingStreamReceived	メディアサーバーが、ストリームまたは接続において、各トラックの最初のデータチャンクを受信しました。
Microsoft.Media.LiveEventIncomingStreamsOutOfSync	オーディオストリームとビデオストリームの同期がずれていることをメディアサーバーが検出しました。ユーザーエクスペリエンスへの影響はないと考えられるため、警告として使用してください。
Microsoft.Media.LiveEventIncomingVideoStreamsOutOfSync	外部エンコーダーから受信している 2 つのビデオストリームの同期がずれていることをメディアサーバーが検出しました。ユーザーエクスペリエンスへの影響はないと考えられるため、警告として使用してください。
Microsoft.Media.LiveEventIngestHeartbeat	ライブイベントの実行中、各トラックについて 20 秒ごとに発行されます。取り込みの正常性についての概要が得られます。エンコーダーが最初に接続された後、エンコーダーがまだ接続されているかどうかにかかわらず、ハートビートイベントは 20 秒ごとに出力され続けます。
Microsoft.Media.LiveEventTrackDiscontinuityDetected	メディアサーバーが受信中のトラックの途切れを検出しました。

次のスキーマの例を参照してください。

イベントスキーマの例

次の例は、JobStateChange イベントのスキーマを示しています。

[
  {
    "source": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
    "subject": "transforms/VideoAnalyzerTransform/jobs/<job-id>",
    "type": "Microsoft.Media.JobStateChange",
    "time": "2018-04-20T21:26:13.8978772",
    "id": "b9d38923-9210-4c2b-958f-0054467d4dd7",
    "data": {
      "previousState": "Processing",
      "state": "Finished"
    },
    "specversion": "1.0"
  }
]

次の例は、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"
  }
]

データオブジェクトには、次のプロパティがあります。

プロパティ	タイプ	説明
`previousState`	string	イベントの前のジョブの状態。
`state`	string	このイベントで通知されるジョブの新しい状態。例: "Scheduled:The job is ready to start" または "Finished:The job is finished"。

ジョブの状態。値は次のいずれかです。Queued、Scheduled、Processing、Finished、Error、Canceled、Canceling

Note

Queued は previousState プロパティでのみ示され、state プロパティでは示されません。

JobScheduled、JobProcessing、JobCanceling

クラウドイベントスキーマ
Event Grid イベントスキーマ

非最終ジョブの状態変更 (JobScheduled、JobProcessing、JobCanceling など) については、サンプルスキーマは次のようになります。

[{
  "source": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
  "subject": "transforms/VideoAnalyzerTransform/jobs/<job-id>",
  "type": "Microsoft.Media.JobProcessing",
  "time": "2018-10-12T16:12:18.0839935",
  "id": "a0a6efc8-f647-4fc2-be73-861fa25ba2db",
  "data": {
    "previousState": "Scheduled",
    "state": "Processing",
    "correlationData": {
      "testKey1": "testValue1",
      "testKey2": "testValue2"
    }
  },
  "specversion": "1.0"
}]

JobFinished、JobCanceled、JobErrored

最終ジョブの状態変更 (JobFinished、JobCanceled、JobErrored など) については、サンプルスキーマは次のようになります。

[{
  "source": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
  "subject": "transforms/VideoAnalyzerTransform/jobs/<job-id>",
  "type": "Microsoft.Media.JobFinished",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

非最終ジョブの状態変更 (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"
}]

データオブジェクトには、次のプロパティがあります。

プロパティ	タイプ	説明
`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"
  }
]

データオブジェクトには、次のプロパティがあります。

プロパティ	タイプ	説明
`streamId`	string	ストリームまたは接続の識別子。この ID は、エンコーダーまたはカスタマーが取り込み URL に追加します。
`ingestUrl`	string	ライブイベントから提供される取り込み URL。
`encoderIp`	string	エンコーダーの IP。
`encoderPort`	string	このストリームの送信元であるエンコーダーのポート。
`resultCode`	string	接続が拒否された理由。結果コードについては、以下の表をご覧ください。

エラーの結果コードは、ライブイベントのエラーコードで確認できます。

LiveEventEncoderConnected

クラウドイベントスキーマ
Event Grid イベントスキーマ

次の例は、LiveEventEncoderConnected イベントのスキーマを示しています。

[
  {
    "source": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
    "subject": "liveEvent/mle1",
    "type": "Microsoft.Media.LiveEventEncoderConnected",
    "time": "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"
    },
    "specversion": "1.0"
  }
]

次の例は、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"
  }
]

データオブジェクトには、次のプロパティがあります。

プロパティ	タイプ	説明
`streamId`	string	ストリームまたは接続の識別子。この ID は、エンコーダーまたはカスタマーが取り込み URL に指定します。
`ingestUrl`	string	ライブイベントから提供される取り込み URL。
`encoderIp`	string	エンコーダーの IP。
`encoderPort`	string	このストリームの送信元であるエンコーダーのポート。

LiveEventEncoderDisconnected

クラウドイベントスキーマ
Event Grid イベントスキーマ

次の例は、LiveEventEncoderDisconnected イベントのスキーマを示しています。

[
  {
    "source": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
    "subject": "liveEvent/mle1",
    "type": "Microsoft.Media.LiveEventEncoderDisconnected",
    "time": "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"
    },
    "specversion": "1.0"
  }
]

次の例は、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"
  }
]

データオブジェクトには、次のプロパティがあります。

プロパティ	タイプ	説明
`streamId`	string	ストリームまたは接続の識別子。この ID は、エンコーダーまたはカスタマーが取り込み URL に追加します。
`ingestUrl`	string	ライブイベントから提供される取り込み URL。
`encoderIp`	string	エンコーダーの IP。
`encoderPort`	string	このストリームの送信元であるエンコーダーのポート。
`resultCode`	string	エンコーダーの切断の理由。正常な切断とエラーによる切断とがあります。結果コードについては、以下の表をご覧ください。

エラーの結果コードは、ライブイベントのエラーコードで確認できます。

正常な切断の結果コードは次のとおりです。

結果コード	説明
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

クラウドイベントスキーマ
Event Grid イベントスキーマ

次の例は、LiveEventIncomingDataChunkDropped イベントのスキーマを示しています。

[
  {
    "source": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaServices/<account-name>",
    "subject": "/LiveEvents/MyLiveEvent1",
    "type": "Microsoft.Media.LiveEventIncomingDataChunkDropped",
    "time": "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"
    },
    "specversion": "1.0"
  }
]

次の例は、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"
  }
]

データオブジェクトには、次のプロパティがあります。

プロパティ	タイプ	説明
`trackType`	string	追跡のタイプ (オーディオ/ビデオ)。
`trackName`	string	トラックの名前。
`bitrate`	整数 (integer)	トラックのビットレート。
`timestamp`	string	ドロップされたデータチャンクのタイムスタンプ。
`timescale`	string	タイムスタンプのタイムスケール。
`resultCode`	string	データチャンクがドロップされた理由。 FragmentDrop_OverlapTimestamp または FragmentDrop_NonIncreasingTimestamp。

LiveEventIncomingStreamReceived

クラウドイベントスキーマ
Event Grid イベントスキーマ

次の例は、LiveEventIncomingStreamReceived イベントのスキーマを示しています。

[
  {
    "source": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
    "subject": "liveEvent/mle1",
    "type": "Microsoft.Media.LiveEventIncomingStreamReceived",
    "time": "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"
    },
    "specversion": "1.0"
  }
]

次の例は、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"
  }
]

データオブジェクトには、次のプロパティがあります。

プロパティ	タイプ	説明
`trackType`	string	追跡のタイプ (オーディオ/ビデオ)。
`trackName`	string	トラックの名前。エンコーダーによって指定されるか、または RTMP の場合は、TrackType_Bitrate 形式でサーバーによって生成されます。
`bitrate`	整数 (integer)	トラックのビットレート。
`ingestUrl`	string	ライブイベントから提供される取り込み URL。
`encoderIp`	string	エンコーダーの IP。
`encoderPort`	string	このストリームの送信元であるエンコーダーのポート。
`timestamp`	string	受信したデータチャンクの最初のタイムスタンプ。
`timescale`	string	タイムスタンプの表示に使用されるタイムスケール。

LiveEventIncomingStreamsOutOfSync

クラウドイベントスキーマ
Event Grid イベントスキーマ

次の例は、LiveEventIncomingStreamsOutOfSync イベントのスキーマを示しています。

[
  {
    "source": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
    "subject": "liveEvent/mle1",
    "type": "Microsoft.Media.LiveEventIncomingStreamsOutOfSync",
    "time": "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"
    },
    "specversion": "1.0"
  }
]

次の例は、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"
  }
]

データオブジェクトには、次のプロパティがあります。

プロパティ	タイプ	説明
`minLastTimestamp`	string	全トラック (オーディオまたはビデオ) における最後のタイムスタンプの最小値。
`typeOfTrackWithMinLastTimestamp`	string	最後のタイムスタンプが最も小さいトラックの種類 (オーディオまたはビデオ)。
`maxLastTimestamp`	string	全トラック (オーディオまたはビデオ) におけるすべてのタイムスタンプの最大値。
`typeOfTrackWithMaxLastTimestamp`	string	最後のタイムスタンプが最も大きいトラックの種類 (オーディオまたはビデオ)。
`timescaleOfMinLastTimestamp`	string	"MinLastTimestamp" の表示に使用されるタイムスケールを取得します。
`timescaleOfMaxLastTimestamp`	string	"MaxLastTimestamp" の表示に使用されるタイムスケールを取得します。

LiveEventIncomingVideoStreamsOutOfSync

クラウドイベントスキーマ
Event Grid イベントスキーマ

次の例は、LiveEventIncomingVideoStreamsOutOfSync イベントのスキーマを示しています。

[
  {
    "source": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaServices/<account-name>",
    "subject": "/LiveEvents/LiveEvent1",
    "type": "Microsoft.Media.LiveEventIncomingVideoStreamsOutOfSync",
    "time": "2018-01-16T01:57:26.005121Z",
    "id": "6dd4d862-d442-40a0-b9f3-fc14bcf6d750",
    "data": {
      "firstTimestamp": "2162058216",
      "firstDuration": "2000",
      "secondTimestamp": "2162057216",
      "secondDuration": "2000",
      "timescale": "10000000"
    },
    "specversion": "1.0"
  }
]

次の例は、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"
  }
]

データオブジェクトには、次のプロパティがあります。

プロパティ	タイプ	説明
`firstTimestamp`	string	種類がビデオであるいずれかのトラック/品質レベルについて受信したタイムスタンプ。
`firstDuration`	string	1 つ目のタイムスタンプを持つデータチャンクの期間。
`secondTimestamp`	string	種類がビデオである他の何らかのトラック/品質レベルについて受信したタイムスタンプ。
`secondDuration`	string	2 つ目のタイムスタンプを持つデータチャンクの期間。
`timescale`	string	タイムスタンプと時間のタイムスケール。

LiveEventIngestHeartbeat

クラウドイベントスキーマ
Event Grid イベントスキーマ

次の例は、LiveEventIngestHeartbeat イベントのスキーマを示しています。

[
  {
    "source": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
    "subject": "liveEvent/mle1",
    "type": "Microsoft.Media.LiveEventIngestHeartbeat",
    "time": "2018-08-07T23:17:57.4610506",
    "id": "7f450938-491f-41e1-b06f-c6cd3965d786",
    "data": {
      "trackType": "audio",
      "trackName": "audio",
      "bitrate": 160000,
      "incomingBitrate": 155903,
      "lastTimestamp": "15336837535253637",
      "timescale": "10000000",
      "overlapCount": 0,
      "discontinuityCount": 0,
      "nonincreasingCount": 0,
      "unexpectedBitrate": false,
      "state": "Running",
      "healthy": true
    },
    "specversion": "1.0"
  }
]

次の例は、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"
  }
]

データオブジェクトには、次のプロパティがあります。

プロパティ	タイプ	説明
`trackType`	string	追跡のタイプ (オーディオ/ビデオ)。
`trackName`	string	トラックの名前。エンコーダーによって指定されるか、または RTMP の場合は、TrackType_Bitrate 形式でサーバーによって生成されます。
`bitrate`	整数 (integer)	トラックのビットレート。
`incomingBitrate`	整数 (integer)	エンコーダーから送信されるデータチャンクに基づいて計算されたビットレート。
`lastTimestamp`	string	トラックに関して直近 20 秒に受信した最新のタイムスタンプ。
`timescale`	string	タイムスタンプの表示に使用されるタイムスケール。
`overlapCount`	整数 (integer)	直近 20 秒にタイムスタンプが重複したデータチャンクの数。
`discontinuityCount`	整数 (integer)	直近 20 秒に観察された途切れの数。
`nonIncreasingCount`	整数 (integer)	直近 20 秒に過去のタイムスタンプを受信したデータチャンクの数。
`unexpectedBitrate`	[bool]	直近 20 秒における予想ビットレートと実ビットレートの差が、許容されている上限を超えているかどうか。 incomingBitrate がビットレートの 2 倍以上または incomingBitrate がビットレートの 1/2 以下または incomingBitrate が 0 のとき、かつそのときに限り true。
`state`	string	ライブイベントの状態。
`healthy`	[bool]	カウントとフラグに基づき、取り込みが正常であるかどうかを示します。 overlapCount = 0 && discontinuityCount = 0 && nonIncreasingCount = 0 && unexpectedBitrate = false の場合、Healthy は true になります。
`lastFragmentArrivalTime`	string	フラグメントがインジェストエンドポイントに到達した最後のタイムスタンプ (UTC)。日付形式の例: "2020-11-11 12:12:12:888999"
`ingestDriftValue`	string	直前の 1 分間に受信したオーディオまたはビデオのデータの遅延速度 (1 分あたりの秒数) を示します。直前の 1 分間にデータが期待よりも遅くライブイベントに到着している場合、値は 0 より大きくなります。データが遅延なしで到着した場合は 0 になります。オーディオまたはビデオのデータが受信されなかった場合は "n/a" になります。たとえば、ライブコンテンツを送信しているコントリビューションエンコーダーがあり、それが処理の問題またはネットワーク待ち時間が原因で低速になっている場合は、1 分間に合計 58 秒のオーディオまたはビデオしか配信できないことがあります。これは、1 分あたり 2 秒のドリフトとして報告されます。エンコーダーが追いついて、毎分 60 秒間すべてまたはそれ以上のデータを送信できる場合、この値は 0 と報告されます。エンコーダーとの間で切断または不連続性が発生した場合でも、この値が 0 と表示されることがあります。これは、タイムスタンプで遅延しているデータのみが考慮され、データの中断は考慮されないためです。
`transcriptionState`	string	ライブ文字起こしが有効になっている場合、オーディオトラックのハートビートに対するこの値は "On" になります。それ以外の場合は、空の文字列が表示されます。この状態は、ライブ文字起こしの `tracktype` が `audio` である場合にのみ適用されます。他のすべてのトラックの値は空になります。
`transcriptionLanguage`	string	文字起こし言語の言語コード (BCP-47 形式)。たとえば、"de-de" はドイツ語 (ドイツ) を示します。ビデオトラックのハートビートの場合、またはライブ文字起こしが無効になっている場合、値は空です。

LiveEventTrackDiscontinuityDetected

クラウドイベントスキーマ
Event Grid イベントスキーマ

次の例は、LiveEventTrackDiscontinuityDetected イベントのスキーマを示しています。

[
  {
    "source": "/subscriptions/<subscription-id>/resourceGroups/<rg-name>/providers/Microsoft.Media/mediaservices/<account-name>",
    "subject": "liveEvent/mle1",
    "type": "Microsoft.Media.LiveEventTrackDiscontinuityDetected",
    "time": "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"
    },
    "specversion": "1.0"
  }
]

次の例は、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"
  }
]

データオブジェクトには、次のプロパティがあります。

プロパティ	タイプ	説明
`trackType`	string	追跡のタイプ (オーディオ/ビデオ)。
`trackName`	string	トラックの名前。エンコーダーによって指定されるか、または RTMP の場合は、TrackType_Bitrate 形式でサーバーによって生成されます。
`bitrate`	整数 (integer)	トラックのビットレート。
`previousTimestamp`	string	前のフラグメントのタイムスタンプ。
`newTimestamp`	string	現在のフラグメントのタイムスタンプ。
`discontinuityGap`	string	2 つのタイムスタンプの差。
`timescale`	string	タイムスタンプと不連続性の両方について、差を表すときに使用されるタイムスケール。

共通のイベントプロパティ

クラウドイベントスキーマ
Event Grid イベントスキーマ

イベントのトップレベルのデータを次に示します。

プロパティ	タイプ	説明
`source`	string	Event Grid のトピック。このプロパティは、Media Services アカウントのリソース ID を保持します。
`subject`	string	Media Services アカウント下の Media Services チャンネルのリソースパス。トピックとサブジェクトを連結することで、ジョブのリソース ID が得られます。
`type`	string	このイベントソース用に登録されたイベントの種類のいずれか。例: "Microsoft.Media.JobStateChange"
`time`	string	プロバイダーの UTC 時刻に基づくイベントの生成時刻。
`id`	string	イベントの一意識別子。
`data`	object	Media Services イベントデータ。
`specversion`	string	CloudEvents スキーマ仕様バージョン。

イベントのトップレベルのデータを次に示します。

プロパティ	タイプ	説明
`topic`	string	Event Grid のトピック。このプロパティは、Media Services アカウントのリソース ID を保持します。
`subject`	string	Media Services アカウント下の Media Services チャンネルのリソースパス。トピックとサブジェクトを連結することで、ジョブのリソース ID が得られます。
`eventType`	string	このイベントソース用に登録されたイベントの種類のいずれか。例: "Microsoft.Media.JobStateChange"
`eventTime`	string	プロバイダーの UTC 時刻に基づくイベントの生成時刻。
`id`	string	イベントの一意識別子。
`data`	object	Media Services イベントデータ。
`dataVersion`	string	データオブジェクトのスキーマバージョン。スキーマバージョンは発行元によって定義されます。
`metadataVersion`	string	イベントメタデータのスキーマバージョン。最上位プロパティのスキーマは Event Grid によって定義されます。この値は Event Grid によって指定されます。

次のステップ

「ジョブ状態変更イベントを登録する」を参照してください。

次の方法で共有

Event Grid ソースとしての Azure Media Services

ジョブの状態変更の監視

ジョブの出力の状態変更の監視

ジョブ出力の進行状況の監視

ライブイベントの種類

ストリームレベルイベント

トラックレベルイベント

イベントスキーマの例

JobStateChange

JobScheduled、JobProcessing、JobCanceling

JobFinished、JobCanceled、JobErrored

JobFinished、JobCanceled、JobErrored

JobOutputStateChange

JobOutputScheduled、JobOutputProcessing、JobOutputFinished、JobOutputCanceling、JobOutputCanceled、JobOutputErrored

JobOutputProgress

LiveEventConnectionRejected

LiveEventEncoderConnected

LiveEventEncoderDisconnected

LiveEventIncomingDataChunkDropped

LiveEventIncomingStreamReceived

LiveEventIncomingStreamsOutOfSync

LiveEventIncomingVideoStreamsOutOfSync

LiveEventIngestHeartbeat

LiveEventTrackDiscontinuityDetected

共通のイベントプロパティ

次のステップ

関連項目

フィードバック

その他のリソース

次の方法で共有

Event Grid ソースとしての Azure Media Services

ジョブ関連イベントの種類

ジョブの状態変更の監視

ジョブの出力の状態変更の監視

ジョブ出力の進行状況の監視

ライブ イベントの種類

ストリーム レベル イベント

トラック レベル イベント

イベント スキーマの例

JobStateChange

JobScheduled、JobProcessing、JobCanceling

JobFinished、JobCanceled、JobErrored

JobOutputStateChange

JobOutputScheduled、JobOutputProcessing、JobOutputFinished、JobOutputCanceling、JobOutputCanceled、JobOutputErrored

JobOutputProgress

LiveEventConnectionRejected

LiveEventEncoderConnected

LiveEventEncoderDisconnected

LiveEventIncomingDataChunkDropped

LiveEventIncomingStreamReceived

LiveEventIncomingStreamsOutOfSync

LiveEventIncomingVideoStreamsOutOfSync

LiveEventIngestHeartbeat

LiveEventTrackDiscontinuityDetected

共通のイベント プロパティ

次のステップ

関連項目

フィードバック

その他のリソース

ライブイベントの種類

ストリームレベルイベント

トラックレベルイベント

イベントスキーマの例

共通のイベントプロパティ