翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 作成アクションの JSON ペイロード
以下のセクションでは、MediaLive スケジュールのすべてのタイプの作成アクションのペイロードの構造と、ペイロードの例を示します。
**Topics**
+ [
# 入力切り替えアクション – ペイロード
](cli-schedule-fields-for-input-switch.md)
+ [
# 入力準備アクション — ペイロード
](cli-schedule-fields-for-input-prep.md)
+ [
# グローバルイメージアクションのアクティブ化 - ペイロード
](cli-schedule-fields-for-activate-image.md)
+ [
# グローバル オーバーレイ アクションを無効にする – ペイロード
](cli-schedule-fields-for-deactivate-image.md)
+ [
# 出力ごとのイメージアクションをアクティブにする - ペイロード
](cli-schedule-fields-for-activate-image-per-output.md)
+ [
# 出力ごとのオーバーレイアクションを無効にする – ペイロード
](cli-schedule-fields-for-deactivate-image-per-output.md)
+ [
# モーショングラフィックオーバーレイを有効にする — ペイロード
](cli-schedule-fields-activate-mgi.md)
+ [
# モーショングラフィックオーバーレイを無効化する — ペイロード
](cli-schedule-fields-deactivate-mgi.md)
+ [
# Splice\$1Insert メッセージ – ペイロード
](cli-schedule-fields-for-splice-insert.md)
+ [
# Time\$1Signal メッセージ – ペイロード
](cli-schedule-fields-for-time-signal.md)
+ [
# Return-to-Network メッセージ – ペイロード
](cli-schedule-fields-for-return-network.md)
+ [
# ID3 メタデータの項目 – ペイロード
](cli-schedule-fields-for-id3.md)
+ [
# ID3 セグメントタグ項目 – ペイロード
](cli-schedule-fields-id3-segment-tag.md)
+ [
# パイプラインアクションの一時停止 – ペイロード
](cli-schedule-fields-for-pause.md)
+ [
# 作成アクションの組み合わせ
](cli-example-multiple-creates.md)
# 入力切り替えアクション – ペイロード
以下のセクションでは、入力切り替えアクションのペイロードを示します。
このペイロードの 「`ScheduleActionStartSettings`」 には、「`FixedModeScheduleActionStartSettings`」、「`ImmediateModeScheduleActionStartSettings`」、「`FollowModeScheduleActionStartSettings`」 のいずれか 1 つのみが含まれます。
これらの各タグのサンプルについては、以下の例を参照してください。
次の JSON のフィールドの意味と値については、「[入力スイッチのフィールド](schedule-fields-for-ips.md)」を参照してください。
```
{
"ChannelId": "string",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"FollowModeScheduleActionStartSettings": {
"FollowPoint": "enum",
"ReferenceActionName": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"InputSwitchSettings": {
"InputAttachmentNameReference": "string",
"InputClippingSettings": {
"InputTimecodeSource": "enum",
"StartTimecode": {
"Timecode": "string"
},
"StopTimecode": {
"LastFrameClippingBehavior": "enum",
"Timecode": "string"
}
},
"UrlPath": ["string", ...]
}
}
]
}
}
```
## 開始時間が固定されたライブ入力に切り替える例
このリクエストの例は、固定された開始時刻にライブ入力に切り替えることです。スイッチアクションは 「`studio-feed`」 と呼ばれ、「`live-studio-feed`」 という入力アタッチメントに接続されている入力に切り替わります。指定された UTC 時刻にこの入力に切り替わります。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-05-21T20:42:19.000Z"
}
},
"ActionName": "studio-feed",
"ScheduleActionSettings": {
"InputSwitchSettings": {
"InputAttachmentNameReference": "live-studio-feed"
}
}
}
]
}
}
```
## フォローとしての静的ファイル切り替えの例
このリクエストの例は、静的ファイル入力に切り替えて、前の入力の末尾にフォローすることです。スイッチアクションは 「`action-ad-003`」 と呼ばれ、「`zel-cafe`」 という入力アタッチメントに接続されている入力に切り替わります。「`action-ad-002`」 と呼ばれるアクションが終了すると、この入力に切り替わります。このアクションのファイルは、30 秒と 11 フレーム後に終了するようにクリップされます。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FollowModeScheduleActionStartSettings": {
"FollowPoint": "END",
"ReferenceActionName": "action-ad-002"
}
},
"ActionName": "action-ad-003",
"ScheduleActionSettings": {
"InputSwitchSettings": {
"InputAttachmentNameReference": "zel-cafe",
"InputClippingSettings": {
"InputTimecodeSource": "ZEROBASED",
"StopTimecode":{
"Timecode": "00:00:30:11",
"LastFrameClippingBehavior": "INCLUDE_LAST_FRAME"
}
}
}
}
}
]
}
}
```
## 即時開始時刻を使用した動的入力への切り替えの例
このリクエストの例は、動的ファイル入力にすぐに切り替えることです。スイッチアクションは 「`action-unscheduled-standby`」 と呼ばれ、「`dynamic-unscheduled-standby`」 という入力アタッチメントに接続されている入力に切り替わります。動的入力のこの使用では、使用するファイルは 「`oceanwaves.mp4`」 です。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings":
{
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "action-unscheduled-slate",
"ScheduleActionSettings": {
"InputSwitchSettings": {
"InputAttachmentNameReference": "slate",
"UrlPath":[
"main/oceanwaves.mp4",
"redundant/oceanwaves.mp4"]
}
}
}
]
}
}
```
# 入力準備アクション — ペイロード
以下のセクションでは、入力切り替えアクションのペイロードを示します。
このペイロードの 「`ScheduleActionStartSettings`」 には、「`FixedModeScheduleActionStartSettings`」、「`ImmediateModeScheduleActionStartSettings`」、「`FollowModeScheduleActionStartSettings`」 のいずれか 1 つのみが含まれます。
これらの各タグのサンプルについては、以下の例を参照してください。
次の JSON のフィールドの意味と値については、「[入力スイッチのフィールド](schedule-fields-for-ips.md)」を参照してください。
```
{
"ChannelId": "string",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"FollowModeScheduleActionStartSettings": {
"FollowPoint": "enum",
"ReferenceActionName": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"InputPrepareSettings": {
"InputAttachmentNameReference": "string",
"InputClippingSettings": {
"InputTimecodeSource": "enum",
"StartTimecode": {
"Timecode": "string"
},
"StopTimecode": {
"LastFrameClippingBehavior": "enum",
"Timecode": "string"
}
},
"UrlPath": ["string", ...]
}
}
}
]
}
}
```
## 開始時刻が固定された入力準備の例
このリクエストの例は、固定された開始時刻にライブ入力に切り替えることです。スイッチアクションは 「`studio-feed`」 と呼ばれ、「`live-studio-feed`」 という入力アタッチメントに接続されている入力に切り替わります。指定された UTC 時刻にこの入力に切り替わります。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-05-21T20:42:19.000Z"
}
},
"ActionName": "studio-feed",
"ScheduleActionSettings": {
"InputSwitchSettings": {
"InputAttachmentNameReference": "live-studio-feed"
}
}
}
]
}
}
```
## 入力準備の例を以下に示します。
このリクエストの例は、静的ファイル入力に切り替えて、前の入力の末尾にフォローすることです。スイッチアクションは 「`action-ad-003`」 と呼ばれ、「`zel-cafe`」 という入力アタッチメントに接続されている入力に切り替わります。「`action-ad-002`」 と呼ばれるアクションが終了すると、この入力に切り替わります。このアクションのファイルは、30 秒と 11 フレーム後に終了するようにクリップされます。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FollowModeScheduleActionStartSettings": {
"FollowPoint": "END",
"ReferenceActionName": "action-ad-002"
}
},
"ActionName": "action-ad-003",
"ScheduleActionSettings": {
"InputSwitchSettings": {
"InputAttachmentNameReference": "zel-cafe",
"InputClippingSettings": {
"InputTimecodeSource": "ZEROBASED",
"StopTimecode":{
"Timecode": "00:00:30:11",
"LastFrameClippingBehavior": "INCLUDE_LAST_FRAME"
}
}
}
}
}
]
}
}
```
# グローバルイメージアクションのアクティブ化 - ペイロード
次の JSON のフィールドの意味と値については、「[グローバル画像オーバーレイをアクティブ化するためのフィールド](schedule-fields-for-activate-image.md)」を参照してください。
```
{
"ChannelId": "string",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"StaticImageActivateSettings": {
"Duration": integer,
"FadeIn": integer,
"FadeOut": integer,
"Height": integer,
"Image": {
"PasswordParam": "string",
"Uri": "string",
"Username": "string"
},
"ImageX": integer,
"ImageY": integer,
"Layer": integer,
"Opacity": integer,
"Width": integer
}
}
}
]
}
}
```
## 例
リクエストのこの例では、チャネル内のすべての出力グループ内のすべてのビデオ出力に挿入されるイメージオーバーレイを作成します。オーバーレイは、Amazon S3 バケットに保存されているファイルを使用します。リクエストには期間が含まれないため、フェードアウトが含まれません。代わりに、別の無効化リクエストを適切な時刻に送信することが目的です。すべての時刻はミリ秒単位で、すべての位置の値はピクセル単位です。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-05-21T20:42:19.000Z"
}
},
"ActionName": "corporate-logo-030",
"ScheduleActionSettings": {
"StaticImageActivateSettings": {
"Image": {
"PasswordParam": "corplogo!2312",
"Uri": "s3ssl://amzn-s3-demo-bucket/logos/corporate/high-res.bmp",
"Username": "medialiveoperator"
},
"Layer": 1,
"FadeIn": 1500,
"Height": 900
"Width": 800,
"ImageX": 200,
"ImageY": 300,
"Opacity": 60,
}
}
}
]
}
}
```
# グローバル オーバーレイ アクションを無効にする – ペイロード
次の JSON のフィールドの意味と値については、「[グローバル画像オーバーレイを無効にするためのフィールド](schedule-fields-for-deactivate-image.md)」を参照してください。
```
{
"ChannelId": "string",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"StaticImageDeactivateSettings": {
"FadeOut": integer,
"Layer": integer
}
}
}
]
}
```
## 例
このリクエストの例では、終了時刻に追加される 500 ミリ秒のフェードアウトを使用して 20:42:04.000 (UTC) に画像オーバーレイを削除するアクションを作成します。これは、オーバーレイが 20:42:04.500 に非表示になることを意味します。
アクションは、グローバルレイヤー 4 にあるイメージオーバーレイを削除します。つまり、グローバルアクション (StaticImageActivateSettings) を使用して挿入された*場合にのみ*、イメージを削除します。出力ごとのレイヤー 4 からオーバーレイは削除されません。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-05-21T20:42:04.000Z"
}
},
"ActionName": "stop-overlay-029",
"ScheduleActionSettings": {
"StaticImageDeactivateSettings": {
"FadeOut": 500,
"Layer": 4
}
}
}
]
}
}
```
# 出力ごとのイメージアクションをアクティブにする - ペイロード
次の JSON のフィールドの意味と値については、「[出力ごとの画像オーバーレイをアクティブにするためのフィールド](schedule-fields-activate-image-per-output.md)」を参照してください。
```
{
"ChannelId": "string",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"StaticImageOutputActivateSettings": {
"Duration": integer,
"FadeIn": integer,
"FadeOut": integer,
"Height": integer,
"Image": {
"PasswordParam": "string",
"Uri": "string",
"Username": "string"
},
"ImageX": integer,
"ImageY": integer,
"Layer": integer,
"Opacity": integer,
"OutputNames": [
{}
],
"Width": integer
}
}
}
]
}
}
```
## 例
このリクエストの例では、チャネル内の特定の出力に挿入されるイメージオーバーレイを作成します。オーバーレイは、Amazon S3 バケットに保存されているファイルを使用します。リクエストは出力 「`hls-high-res`」 と 「`mss-high-res`」 に画像を挿入します。イメージは、これらの出力のビデオ解像度に合わせて適切なサイズになります。
リクエストは常に存在することを意図しています。したがって、すぐに (チャネルが開始されるとすぐに) 開始するように設定されます。すべての時刻はミリ秒単位で、すべての位置の値はピクセル単位です。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings":
{
"ImmediateModeScheduleActionStartSettings": {
}
},
},
"ActionName": "logo-1280",
"ScheduleActionSettings": {
"StaticImageOutputActivateSettings": {
"Image": {
"PasswordParam": "corplogo!2312",
"Uri": "s3ssl://amzn-s3-demo-bucket/logos/corporate/10percent-1280.bmp",
"Username": "medialiveoperator"
},
"Layer": 0,
"outputNames": [
hls-high-res,mss-high-res
],
"ImageX": 200,
"ImageY": 300,
"FadeIn": 1500,
"Opacity": 60
}
}
}
]
}
}
```
# 出力ごとのオーバーレイアクションを無効にする – ペイロード
次の JSON のフィールドの意味と値については、「[出力ごとの画像オーバーレイを無効にするためのフィールド](schedule-fields-deactivate-image-per-output.md)」を参照してください。
```
{
"ChannelId": "string",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"StaticImageOutputDeactivateSettings": {
"FadeOut": integer,
"Layer": integer,
"OutputNames"
}
}
}
]
}
```
## 例
無効アクションは、指定された出力または出力で、指定された出力レイヤーごとにイメージを無効にします。
この例では、アクティブ化の例から続くように、 アクションは出力 hls-high-res の出力レイヤー 4 ごとに存在するすべてのイメージオーバーレイを削除します。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-05-21T20:42:04.000Z"
}
},
"ActionName": "stop-layer4-all-outputs",
"ScheduleActionSettings": {
"StaticImageOutputDeactivateSettings": {
"outputNames": [
hls-high-res
],
"FadeOut": 500,
"Layer": 4
}
}
}
]
}
}
```
# モーショングラフィックオーバーレイを有効にする — ペイロード
次の JSON のフィールドの意味と値については、「[モーショングラフィックスオーバーレイを有効化するためのフィールド](schedule-fields-for-mg.md)」を参照してください。
```
{
"ChannelId": "string",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"MotionGraphicsImageActivateSettings": {
"Duration": integer
"Url": "string"
"Username": "string",
"PasswordParam": "string"
}
}
]
}
}
```
## 例
この例では、mg\$1ticker\$1tape というモーショングラフィックス オーバーレイのアクションを作成します。モーショングラフィックアセットは http://example.com/ticker\$1tape.html に保存されます。このサーバーにはユーザー認証情報が必要です。リクエストには期間が含まれません。代わりに、別の無効化リクエストを適切な時刻に送信することが目的です。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-05-21T20:42:04.000Z"
}
},
"ActionName": "mg_ticker_tape",
"ScheduleActionSettings": {
"MotionGraphicsImageActivateSettings": {
"Url": "https://example.com/ticker_tape.html"
"Username": "medialiveoperator",
"PasswordParam": "/medialive/12345"
}
}
]
}
}
```
# モーショングラフィックオーバーレイを無効化する — ペイロード
次の JSON のフィールドの意味と値については、「[モーショングラフィックスオーバーレイを無効化するためのフィールド](schedule-fields-for-mg-deactivate.md)」を参照してください。
```
{
"ChannelId": "string",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"MotionGraphicsImageDeactivateSettings": {
}
}
}
]
}
}
```
## 例
このリクエストの例では、23:59:00 .000 (UTC) にモーショングラフィックオーバーレイを終了するアクションを作成します。 。 :
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-05-21T23:59:00.000Z"
},
"ActionName": "deactivate-ticker-tape",
"ScheduleActionSettings": {
"MotionGraphicsImageDeactivateSettings": {
}
}
}
]
}
}
```
# Splice\$1Insert メッセージ – ペイロード
次の JSON のフィールドの意味と値については、「[Splice\$1Insert メッセージのフィールド](schedule-fields-for-splice_insert.md)」を参照してください。
```
{
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"FollowModeScheduleActionStartSettings": {
"FollowPoint": "enum",
"ReferenceActionName": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"Scte35SpliceInsertSettings": {
"Duration": integer,
"SpliceEventId": integer
}
}
}
]
}
```
## 開始時間が固定されたスプライス挿入の例
このリクエストの例では、UTC 開始時刻が 20:42:04.000 である splice\$1insert のアクションを作成します。また、データベースからの広告表示を参照する可能性のある 「`ActionName`」、スプライスイベント ID の一意の整数、1,350,000 kHz ティック (15 秒) の期間もあります。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-05-21T20:42:04.000Z"
}
},
"ActionName": "adavail-3708",
"ScheduleActionSettings": {
"Scte35SpliceInsertSettings": {
"SpliceEventId": 3708,
"Duration": 1350000
}
}
}
]
}
}
```
## フォローとしてのスプライス挿入の例
このリクエストの例では、nature-doco-003 という入力スイッチが終了した後に挿入される splice\$1insert のアクションを作成します。また、アクションにはデータベースからの広告表示を参照する可能性のある 「`ActionName`」、スプライスイベント ID の一意の整数、1,350,000 kHz ティック (15 秒) の期間もあります。
SCTE 35 メッセージのフォローモードは、入力が終了するとすぐに広告を表示したいが、それがいつ起こるかわからない場合に便利です。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FollowModeScheduleActionStartSettings": {
"FollowPoint": "END",
"ReferenceActionName": "nature-doco-003"
}
},
"ActionName": "adavail-3708",
"ScheduleActionSettings": {
"Scte35SpliceInsertSettings": {
"SpliceEventId": 3708,
"Duration": 1350000
}
}
}
]
}
}
```
# Time\$1Signal メッセージ – ペイロード
次の JSON のフィールドの意味と値については、「[Time\$1Signal メッセージのフィールド](schedule-fields-for-time-signal.md)」を参照してください。
```
{
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"FollowModeScheduleActionStartSettings": {
"FollowPoint": "enum",
"ReferenceActionName": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"Scte35TimeSignalSettings": {
"Scte35Descriptors": [
{
"Scte35DescriptorSettings": {
"SegmentationDescriptorScte35DescriptorSettings": {
"DeliveryRestrictions": {
"ArchiveAllowedFlag": "enum",
"DeviceRestrictions": "enum",
"NoRegionalBlackoutFlag": "enum",
"WebDeliveryAllowedFlag": "enum"
},
"SegmentNum": integer,
"SegmentationCancelIndicator": "enum",
"SegmentationDuration": integer,
"SegmentationEventId": integer,
"SegmentationTypeId": integer,
"SegmentationUpid": "string",
"SegmentationUpidType": integer,
"SegmentsExpected": integer,
"SubSegmentNum": integer,
"SubSegmentsExpected": integer
}
}
}
]
}
}
}
]
}
```
## 例
このリクエストの例では、開始時刻が UTC 20:42:04.000 で、「`SegmentationEventId`」 が一意の整数の time\$1signal のアクションを作成します。制約フィールドの場合、「`NoRegionalBlackoutFlag`」 には制約セットがあります (リージョンのブラックアウトが設定されています)。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-05-21T20:42:04.000Z"
}
},
"ActionName": "adavail-3708",
"ScheduleActionSettings": {
"Scte35TimeSignalSettings": {
"Scte35Descriptors": [
{
"Scte35DescriptorSettings": {
"SegmentationDescriptorScte35DescriptorSettings": {
"SubSegmentsExpected": 0,
"SegmentationEventId": 7054,
"SegmentationDuration": 1350000,
"SegmentationCancelIndicator": 0,
"SubSegmentNum": 0,
"SegmentationUpidType": 12,
"SegmentNum": 0,
"SegmentationCancelIndicator": "SEGMENTATION_EVENT_NOT_CANCELED",
"DeliveryRestrictions": {
"DeviceRestrictions": "NONE",
"WebDeliveryAllowedFlag": "WEB_DELIVERY_ALLOWED",
"NoRegionalBlackoutFlag": "REGIONAL_BLACKOUT",
"ArchiveAllowedFlag": "ARCHIVE_ALLOWED"
},
"SegmentationUpid": "4a414e3136494e4155303031",
"SegmentationTypeId": 52,
"SegmentsExpected": 0
}
}
}
]
}
}
}
]
}
}
```
# Return-to-Network メッセージ – ペイロード
次の JSON のフィールドの意味と値については、「[Return-to-Network メッセージのフィールド](schedule-fields-for-return-to-network.md)」を参照してください。
```
{
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"FollowModeScheduleActionStartSettings": {
"FollowPoint": "enum",
"ReferenceActionName": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"Scte35ReturnToNetworkSettings": {
"SpliceEventId": integer
}
}
}
]
}
```
## 例
このリクエストの例では、UTC 開始時刻が 20:42:19 の return-to-network を作成します。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-05-21T20:42:19.000Z"
}
},
"ActionName": "end-adavail-3708",
"ScheduleActionSettings": {
"Scte35ReturnToNetworkSettings": {
}
}
}
]
}
}
```
# ID3 メタデータの項目 – ペイロード
次の JSON のフィールドの意味と値については、「[ID3 メタデータのフィールド](schedule-fields-for-id3-userdata.md)」を参照してください。
**HlsTimedMetadataSettings アクションのペイロード**
```
{
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"HlsTimedMetadataSettings": {
"Id3": "string"
}
}
}
]
}
```
**TimedMetadataSettings アクションのペイロード**
```
{
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"TimedMetadataSettings": {
"Id3": "string"
}
}
}
]
}
```
## 例
このリクエストの例では、 `HlsTimedMetadataSettings`アクションを使用します。13:35:59 UTC に適切な出力グループに挿入される ID3 メタデータを作成します。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2019-01-02T13:35:59Z"
}
},
"ActionName": "id3-metadata.2019-01-02T13:35:59Z",
"ScheduleActionSettings": {
"HlsTimedMetadataSettings": {
"Id3": "SUQzBAAAAAAAF1RJVDIAAAANAAADSGVsbG8gV29ybGQA"
}
}
}
]
}
}
```
# ID3 セグメントタグ項目 – ペイロード
次の JSON のフィールドの意味と値については、「[ID3 セグメントタグのフィールド](schedule-fields-for-id3-segment-tags.md)」を参照してください。
**HlsId3SegmentTaggingSettings アクションのペイロード**
```
{
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"HlsId3SegmentTaggingSettings": {
"Tag": "string"
"Id3": "string"
}
}
}
]
}
```
**Id3SegmentTaggingSettings アクションのペイロード**
```
{
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"Id3SegmentTaggingSettings": {
"Tag": "string"
"Id3": "string"
}
}
}
]
}
```
## タグプロパティの使用例
このリクエストの例では、 `HlsId3SegmentTaggingSettings`アクションを使用します。13:35:59 UTC から挿入する ID3 セグメントタグを作成します。この例では、 `Tag`プロパティ を使用します。つまり、 `value``TXXX`フィールドの の内容のみを指定します。この例では、内容はセグメントの日付、時間、番号である。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2020-01-02T13:35:59Z"
}
},
"ActionName": "id3-datetime-and-segment",
"ScheduleActionSettings": {
"HlsId3SegmentTaggingSettings": {
"Tag": "$dt$-$sn$"
}
}
}
]
}
}
```
## Id3 プロパティの使用例
このリクエスト例では、すぐに挿入されるID3セグメントタグを作成します。この例では、 `Id3`プロパティを使用します。つまり、コンテンツは base64 としてエンコードされます。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
ImmediateModeScheduleActionStartSettings
}
},
"ActionName": "id3-song309",
"ScheduleActionSettings": {
"HlsId3SegmentTaggingSettings": {
"Id3": "SUQzBAAAAAAAF1RJVDIAAAANAAADSGVsbG8gV29ybGQA"
}
}
}
]
}
}
```
# パイプラインアクションの一時停止 – ペイロード
次の JSON のフィールドの意味と値については、「[一時停止のフィールド](schedule-fields-for-pause.md)」を参照してください。
```
{
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "string"
},
"ImmediateModeScheduleActionStartSettings": {
}
},
"ActionName": "string",
"ScheduleActionSettings": {
"PauseStateSettings": {
"Pipelines": [
{
"PipelineId": "enum"
}
]
}
}
}
]
}
```
## 例 :1 つのパイプラインの一時停止
このリクエストの例では、パイプライン 0 を 20:42:19 UTC に一時停止します。MediaLive はコマンドを常に、*指定されたパイプラインを一時停止に設定し、それ以外のパイプラインを一時停止解除に設定する*ものとして読み取ります。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-05-21T20:42:19Z"
}
},
"ActionName": "pause-pipeline-0-now",
"ScheduleActionSettings": {
"PauseStateSettings": {
"Pipelines": [
{
"PipelineId": "PIPELINE_0"
}
]
}
}
}
]
}
}
```
## 例: 両方のパイプラインの一時停止解除
このリクエストの例では、現在一時停止されているすべてのパイプラインを一時停止解除します。
**注記**
MediaLive はコマンドを常に、*指定されたパイプラインを一時停止に設定し、それ以外のパイプラインを一時停止解除に設定する*ものとして読み取ります。この例では、「`Pipelines`」 配列は空です。MediaLive はこの空の配列を次のように解釈します: *すべてのパイプラインを一時停止なしに設定する*。
```
{
"ChannelId": "999999",
"Creates": {
"ScheduleActions": [
{
"ScheduleActionStartSettings": {
"ImmediateModeScheduleActionStartSettings": {}
},
"ActionName": "unpause-pipeline-0",
"ScheduleActionSettings": {
"PauseStateSettings": {
"Pipelines": [
{}
]
}
}
}
]
}
}
```
# 作成アクションの組み合わせ
`batch-update-schedule` AWS CLI コマンドの `--creates`パラメータに渡す JSON 本文の例を次に示します。これには、作成する 2 つのアクションが含まれます。この例では、両方のアクションが splice\$1inserts ですが、実際には任意の数と任意のタイプの作成アクションを組み合わせることができます。
```
{
"ScheduleActions": [
{
"ScheduleActionSettings": {
"Scte35SpliceInsertSettings": {
"Duration": 1350000,
"SpliceEventId": 3
}
},
"ActionName": "SpliceInsert-01",
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-11-05T16:10:30.000Z"
}
}
},
{
"ScheduleActionSettings": {
"Scte35SpliceInsertSettings": {
"Duration": 2700000,
"SpliceEventId": 3
}
},
"ActionName": "SpliceInsert-02",
"ScheduleActionStartSettings": {
"FixedModeScheduleActionStartSettings": {
"Time": "2018-11-05T16:30:45.000Z"
}
}
}
]
}
```