Detailed Description
The Pass Thru component is used to create data channels that can be used to send data to and receive data from an external device attached to a remote Encoder.
This could be put to a variety of uses, e.g. to control an external device using RS232 or to capture raw data from a sensor.
The PassThruStream is a one-to-one link for sending data to the Encoder. However, the data that is received by the Encoder can either be multiplexed into the MediaStream so that all viewers of the Encoder can receive it (one-to-many) or it can be sent back using the PassThruStream (one-to-one).
The Pass Thru feature must be configured on the Encoder separately before the channel can be used. If the user attempts to use the PassThruStream before the feature is enabled then any data that is sent will just be ignored.
There are some important considerations that application developers must understand regarding the limitations of the Pass Thru Stream. When an Encoder is connected over a low bandwidth link such as GPRS or UMTS these links operate in practice as half-duplex. Sending significant amounts of data or sending data too frequently may compromise the underlying physical channel resulting in high packet loss or a forced disconnect. Further, the inherent channel latencies can result in round trip times that can in extreme cases be several seconds. It is imperative therefore that the application developer considers the bandwidth requirements for their data, both to and from the Encoder, and the timing on any expected acknowledgements.
Sample applications
Full sample applications are available demonstrating the capabilities of the SDK
Classes | |
| class | EdgeVisDecoderSDK::PassThruData |
| This is data that has been received at a port on the remote Encoder device and then sent back via the PassThruStream or broadcast to all viewers of the MediaStream. More... | |
| class | EdgeVisDecoderSDK::PassThruStream |
| This object sends data to a port on an Encoder. More... | |