AWS Elemental MediaLive
User Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Payload for an Input Switch Action

The following sections show the payload for input switch actions.

In this payload, the ScheduleActionStartSettings contains only one of FixedModeScheduleActionStartSettings, ImmediateModeScheduleActionStartSettings, or FollowModeScheduleActionStartSettings.

See the examples that follow for samples of each of these tags.

For information about the meaning and values for the fields in the following JSON, see the AWS Elemental MediaLive API Reference:

{ "ChannelId": "string", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" } } { "ImmediateModeScheduleActionStartSettings": { } } { "FollowModeScheduleActionStartSettings": { "FollowPoint": "string", "ReferenceActionName": "string" } }, } "ActionName": "string", "ScheduleActionSettings": { "InputSwitchSettings": { "InputAttachmentNameReference": "string" "UrlPath":[ "string", "string" ], "InputClippingSettings":{ "InputTimecodeSource":""string"", "StartTimecode":{ "Timecode": "string" }, "StopTimecode":{ "Timecode": "string", "LastFrameClippingBehavior":""string" } } } } ] } }

Example of a Switch to a Live Input with Fixed Start Time

This example of a request is to switch to a live input at a fixed start time. The switch action is called studio_feed and it switches to the input that is connected to the input attachment called live_studio_feed. It switches to this input at the specified UTC time.

{ "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:19.000Z" } }, "ActionName": "studio_feed", "ScheduleActionSettings": { "InputSwitchSettings": { "InputAttachmentNameReference": "live_studio_feed" } } } ] } }

Example of a Static File Switch as a Follow

This example of a request is to switch to a static file input to follow the end of the previous input. The switch action is called action_ad_003 and it switches to the input that is connected to the input attachment called zel_cafe. It switches to this input when the action called action_ad_002 ends. The file for this action is clipped so that it ends after 30 seconds and 11 frames:

{ "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" } } } } } ] } }

Example of a Switch to a Dynamic Input with Immediate Start Time

This example of a request is to switch to a dynamic file input immediately. The switch action is called action_unscheduled_standby and it switches to the input that is connected to the input attachment called dynamic_unscheduled_standby. For this usage of the dynamic input, the files to use are oceanwaves.mp4.

{ "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "action_unscheduled_slate", "ScheduleActionSettings": { "InputSwitchSettings": { "InputAttachmentNameReference": "slate" "UrlPath":[ "main/oceanwaves.mp4", "redundant/oceanwaves.mp4" ] } } } ] } }