Share via

2.2.1.1.1 OpenMedia (request)

  • Article

The callingConvention parameter in the Dispatch Request tag MUST be dslrRequest (0x00000001). The function handle for the Dispatch Request tag for OpenMedia MUST be 0x00000000.

This message is used to open a streaming media session on an extender device.

Request payload (input parameters):


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Length of URL

URL (variable)

...

Surface ID

Time Out

Length of URL (4 bytes): An unsigned 32-bit integer. This is length of the URL.

URL (variable): A byte array of UTF-8 string data of size equal to the length of the URL. It is a URL of the streaming media server. It can be either a local media file URL or a remote URL. If it is a local media file, then the URL will start with "rtsp:" so the URL will play using RTSP streaming. If the URL is web-based, then it will start with "http:" and will play using HTTP streaming.

Surface ID (4 bytes): An unsigned 32-bit integer. It is used to select a rendering surface if the extender device supports simultaneous streams by maintaining an array of Video Producers with each one tied to a different dynamic surface ID.

Time Out (4 bytes): An unsigned 32-bit integer. This is the time that the extender device waits for an RTSP or HTTP response. It MUST be greater than 5 seconds. It is 30 seconds for local streams and 45 second for online streams.