How to Insert a Motion Overlay with Quicktime MOV - AWS Elemental Live

This is version 2.17 of the AWS Elemental Live documentation. This is the latest version. For prior versions, see the Previous Versions section of AWS Elemental Live and AWS Elemental Statmux Documentation.

How to Insert a Motion Overlay with Quicktime MOV

The motion overlay can be configured with a start time and to run only once or to loop until you optionally clear the insertion. The motion overlay can overlay the video at any position, as specified by number of pixels offset from the upper left corner.

Web Interface and REST API

Procedural Step Methods Available
1. Prepare the MOV file. Use a third-party process.
2. Create the event with the desired motion overlays. As part of the creation, make sure that the live_event XML file includes a motion_image tag. Also include an action_time tag and a loop tag (set to true). Use the REST API or the web interface
3. Start the event and wait for the motion overlay to start playing. Use the REST API or the web interface.
4. Set up more motion overlays as desired Use the REST API.

The following are valid web interface and REST API combinations:

  • Initial setup via web interface and run-time changes via the REST

  • Initial setup and run-time changes via the REST API.

If you use the web interface to perform the initial setup, note the following restrictions:

  • There is no mechanism for changing motion overlays at runtime via the web interface.

Runtime REST Commands Change the Event XML

When you send REST commands during an event, the event XML is permanently changed. Any data sent via the REST call goes into the XML.

For example, you might put a scoreboard overlay on your event during a sporting event. If you do not send a REST call to deactivate the overlay once the game has ended, the scoreboard will appear again at the same time the next day.

Therefore, make sure to do one of the following:

  • If you plan to run the event (event A) again with different video content but with the same graphic overlays, make sure to export your XML for re-use before starting the event. Then create a new event (event B) using the exported XML. Do not start event A again.

  • If you are running a 24/7 channel and you do not want your overlay to recur, remember to send a REST command to set <activate> to false once the overlay has run. This will delete the entire <insertable_images> element from the event XML.

    You could also specify an absolute start time for each overlay by using the ISO 8601 UTC time format to specify an absolute time and date for the overlay. The overlays will not run again the next day.