Collaborator

Syntax

 
collaborator 
	? -audio ?audioSessionSpec? ?
	? -video ?videoSessionSpec? ?
	? -mb ?mbSessionSpec? ?
	? -xmit ?

	? -sdp sdpAnnouncement ?
	? -sdpfile sdpAnnouncementFilename ?

	? -ctg archiveCatalog ?
	? -ctgfile archiveCatalogFilename ?

	? -usemega ?sessionId? ?
	? -megactrl/-unicast spec ?
	? -startport port ?

	? -scuba ?
	? -localscuba ?

Note:

If no arguments are specified to collaborator, it assumes default arguments of -audio -video
In addition to the above options, many of the options available in the vic, vat, and mb applications are also available in collaborator but are not documented here.

Screen-shots

You can find some selected collaborator screen-shots here

Description

Collaborator is a multimedia conferencing application for remote participation in MBone sessions. It is based on an initial implementation of a similart tool, mui. Collaborator is capable of participating in live or archived MBone sessions; it can send/receive video, audio, and mediaboard data.

Command Line Arguments

-audio ?audioSessionSpec?
audioSessionSpec is of the form address/port?/ttl?. It specifies the address and port on which audio data will be received and sent. Point-to-point conferences are initiated by supplying a standard IP address, while multi-party conferences should use a Class D group address (224.0.0.2 to 239.255.255.255). Internally two ports are used, one for data and one for control. The data port is always an even number and the control port is always the data port number plus one. The number port is taken to be the value of either the data or control port depending on whether it is even or odd. If ttl is specified, then it specifies the TTL (Time-To-Live) value for IP multicast, which controls the scope of data distribution. The TTL value defaults to 31. If the audioSessionSpec is omitted, collaborator assumes a default spec of 224.2.55.44/8000/31
-video videoSessionSpec
videoSessionSpec is of the form address/port?/ttl?. It specifies the address and port on which video data will be received and sent. Point-to-point conferences are initiated by supplying a standard IP address, while multi-party conferences should use a Class D group address (224.0.0.2 to 239.255.255.255). Internally 2 ports are used, one for data and one for control. The data port is always an even number and the control port is always the data port number plus one. The number port is taken to be the value of either the data or control port depending on whether it is even or odd. If ttl is specified, then it specifies the TTL (Time-To-Live) value for IP multicast, which controls the scope of data distribution. The TTL value defaults to 31. If the videoSessionSpec is omitted, collaborator assumes a default spec of 224.2.55.22/8000/31
-mb mbSessionSpec
mbSessionSpec is of the form address/port?/ttl?. It specifies the address and port on which mediaboard data will be received and sent. Point-to-point conferences are initiated by supplying a standard IP address, while multi-party conferences should use a Class D group address (224.0.0.2 to 239.255.255.255). Internally 2 ports are used, one for data and one for control. The data port is always an even number and the control port is always the data port number plus one. The number port is taken to be the value of either the data or control port depending on whether it is even or odd. If ttl is specified, then it specifies the TTL (Time-To-Live) value for IP multicast, which controls the scope of data distribution. The TTL value defaults to 31. If the mbSessionSpec is omitted, collaborator assumes a default spec of 224.2.55.66/8000/31

-sdp sdpAnnouncement
Use sdpAnnouncement to supply the SDP announcement as a string. Collaborator will parse the announcement to determine whether the session involves audio, video, mediaboard, or any combination of these media.
-sdpFile sdpAnnouncementFilename
Use sdpAnnouncementFilename to specify a local file containing an SDP announcement. Collaborator will parse the announcement to determine whether the session involves audio, video, mediaboard, or any combination of these media.

-ctg archiveCatalog
Use archiveCatalog to supply the catalog description as a string. Collaborator will parse the description to contact the MASH archive system and launch a playback session.
-ctgfile archiveCatalogFilename
Use archiveCatalogFilename to specify a local file containing the catalog description. Collaborator will parse the description to contact the MASH archive system and launch a playback session.

-usemega ?sessionID?
Use this argument to request media gateways to transcode the session on behalf of the client. The optional sessionID field is used as a unique session descriptor in the request for media gateways.
-megactrl/-unicast spec
Use this argument to specify the multicast address of the media gateway/archive services, or the location of the unicast gateway for tunneling the service control traffic. spec defaults to 224.4.5.24/50000/31.
-startport port
Use this argument to specify the set of port numbers to use when communicating with the media gateway/archive services in unicast mode. Collaborator allocates ports starting with port. This value defaults to 10004.

-scuba/-localscuba
These arguments activate the SCUBA protocol in an end-to-end manner, or between the client and the media gateways respectively. These arguments are automatically enabled when the -usemega flag is specified.