roMediaServer

the romediaserver object waits for client requests, deals with negotiation, and ultimately generates an romediastreamer pipeline to fulfill the request for more information, see the docid\ b6e8mgh 2yp06llh1aha section the javascript equivalent is node media server this object currently supports rtsp and http requests requests from the client must take the following form protocol //ip address\ port/media streamer pipeline protocol either rtsp or http ip address\ port the ip address of the brightsign player and the port number on which the media server is running media streamer pipeline a media streamer pipeline, but without the final destination component (as the destination is implicit in the request from the client) object creation the romediaserver object is created with no parameters createobject("romediaserver") ifmediaserver getfailurereason() as string returns useful information if the start() , stop() , or terminate() methods return false start(a as string) as boolean begins a media server instance this method can be passed a string that specifies the streaming protocol and the port number of the server s = createobject("romediaserver") s start("http port=8080") a number of optional parameters can be added after the port parameter using an "&" (ampersand) trace displays a trace of messages in the negotiation with the client this parameter is useful particularly for debugging rtsp sessions for example "rtsp\ port=554\&trace" maxbitrate sets the maximum instantaneous bitrate (in kbps) of the rtp transfer initiated by rtsp this parameter has no effect for http the parameter value 80000 (i e 80mbps) has been found to work well the default behavior (also achieved by passing a zero value) is to not limit the bitrate at all for example "rtsp\ port=554\&trace\&maxbitrate=80000" threads sets the maximum number of threads the server is prepared to have running each thread handles a single client request the default value is "5" for example "http port=8080\&threads=10" stop() as boolean stops the media server this method signals all threads to stop, but does not wait for this to happen before destroying the server instance terminate() as boolean stops the media server this method waits for all threads to stop before destroying the server instance ifuserdata setuserdata(user data as object) sets the user data that will be returned when events are raised getuserdata() as object returns the user data that has previously been set via setuserdata() it will return invalid if no data has been set ifmessageport setport(port as romessageport) posts messages to the attached message port ifidentity getidentity() as integer the ifidentity interface has been deprecated we recommend using the ifuserdata interface instead