Loading ...
Loading ...
Loading ...
Informationen für Entwickler (Englisch)
Blackmagic Web Presenter Ethernet Protocol
v1.0
Overview
The Blackmagic Web Presenter Ethernet Protocol is a line-oriented, text-based protocol to control a
Web Presenter. The Blackmagic Web Presenter Ethernet Protocol is available for Blackmagic Web
Presenter HD. Lines from the Web Presenter server will be separated by an ASCII LF sequence.
Messages from the user may be separated by LF or CR LF.
Connection
The Web Presenter server is accessed by connecting to TCP port 9977 on a Web Presenter.
Connection Response
Upon connection, the Web Presenter server sends a dump of the device’s state. The Web Presenter
server sends information in blocks, with each having an identifying header followed by a colon. A
block spans multiple lines and is terminated by a blank line. Each line in the protocol is terminated by
a newline character.
Following the header, a block contains either a single multi-line string or a sequence of key/value
pairs arranged one per line. The first colon on a line is used to delimit the key and the value. A value
may be a comma separated list. In this case, values in the list must have the “,” and “\” characters
escaped with a “\” character.
To be resilient to future protocol changes, clients should ignore blocks they do not recognize, up to
the trailing blank line. Within recognized blocks, clients should ignore keys they do not recognize.
The protocol preamble block is always the first block sent by the Web Presenter server:
PROTOCOL PREAMBLE:
↵
Legend
↵
End of line
... and so on
Orange Text Client Generated
Grey Text Server Generated
Version: 1.0
↵
↵
The version field indicates the protocol version. When the protocol is changed in a compatible way,
the minor version number will be updated. If incompatible changes are made, the major version
number will be updated.
The initial status dump is concluded by the end prelude block:
END PR ELU DE:
↵
↵
139Informationen für Entwickler (Englisch)
Loading ...
Loading ...
Loading ...