Get current time
You can obtain the timecode of the frame that is currently being processed in the specified event. Refer to the following tables.
HTTP URL
POST <IP address of Live node>/live_events/<ID of event>/cue_point
Body of HTTP
The XML body contains one cue_point element containing the following
tag:
| Tag | Type | Value |
|---|---|---|
| get_current_time | Integer | Always 1 |
Response
The body of the response contains one response element containing the following tags:
| Tag | Sub-tag | Type | Value |
|---|---|---|---|
| tag | integer | A unique ID that could be used in the event_id in a new request to insert a splice_insert. See the explanation below this table. | |
| splice_time | hours | integer | The time (and frame) associated with the event at the moment that the API request was processed. Time is in 24-hour format. For general information about timecodes in events, see About timecode configuration and timers. |
| minutes | integer | ||
| seconds | integer | ||
| frames | integer | ||
| message | string | A description of the time: the presentation timestamp (PTS) of the time and the time in NTP. | |
| splice_offset | Always 0. See the explanation below this table. | ||
| value | string | Always “cue_point.” |
The response is provided in this format so that you could take the entire response, clean it up a bit (for example, changing the “tag” tag to “event_id”), and use it as the body of a request to insert a spliceinsert (see Insert a new splice insert message.
Get current time example
The following shows a request for the current timecode in the event that has the ID 15:
POST 10.4.136.95/live_events/15/cue_point ----------------------------------- <cue_point> <get_current_time>1</get_current_time> </cue_point>
The following shows an example response for the request:
<?xml version="1.0" encoding="UTF-8"?> <response> <tag>1</tag> <splice_time> <hours>0</hours> <minutes>0</minutes> <seconds>2</seconds> <frames>23</frames> </splice_time> <message>PTS[00:00:02.969]. Current NTP [16:21:23.573].</message> <splice_offset>0</splice_offset> <value>cue_point</value> </response>
