Blackmagicdesign HyperDeck - Page 73

Changing timeline position
The "goto" command instructs the deck to switch to playback mode and change its position within the
timeline.
To go to the start of a specific clip:
goto: clip id: {Clip ID}↵
To move forward/back {count} clips from the current clip on the current timeline:
goto: clip id: +/-{count}↵
Note that if the resultant clip id goes beyond the first or last clip on timeline, it will be clamp at the first or
last clip.
To go to the start or end of the current clip:
goto: clip: {“start”, “end”}↵
To go to the start of the first clip or the end of the last clip:
goto: timeline: {“start”, “end”}↵
To go to a specified timecode:
goto: timecode: {timecode}↵
To move forward or back a specified duration in timecode:
goto: timecode: {“+”, “-”}{duration in timecode}↵
To specify between slot 1 and slot 2:
goto: slot id: {Slot ID}↵
Note that only one parameter/value pair is allowed for each goto command.
Enumerating supported commands and parameters
The "commands" command returns the supported commands:
commands↵
The command list is returned in a computer readable XML format:
212 commands:
<commands>↵
<command name="…"><parameter name="…"/>…</command>↵
<command name="…"><parameter name="…"/>…</command>↵
…
</commands>↵
↵
More XML tokens and parameters may be added in later releases.
Controlling asynchronous notifications
The “notify” command may be used to enable or disable asynchronous notifications from the server.
To enable or disable transport notifications:
notify: transport: {“true”, “false”}↵
To enable or disable slot notifications:
notify: slot: {“true”, “false”}↵
To enable or disable remote notifications:
notify: remote: {“true”, “false”}↵
To enable or disable configuration notifications:
notify: configuration: {“true”, “false”}↵
Multiple parameters may be specified. If no parameters are specified, the server returns the current state of
all notifications:
209 notify:↵
transport: {“true”, “false”}↵
slot: {“true”, “false”}↵
remote: {“true”, “false”}↵
configuration: {“true”, “false”}↵
↵
73Developer Information