OMCS开发手册（02） －－ 多媒体连接器

核心提示：如果要连接的目标设备的Owner还未上线，WaitOwnerOnlineSpanInSecs属性则允许我们等它一段时间，OMCS开发手册（02） －－ 多媒体连接器(3)，在某些情况下，这可能是很有用的，所有这些连接器都实现了IMultimediaConnector接口，所以，我们来设想一下，通常基于OMCS开发的多媒

如果要连接的目标设备的Owner还未上线，WaitOwnerOnlineSpanInSecs属性则允许我们等它一段时间。在某些情况下，这可能是很有用的。我们来设想一下，通常基于OMCS开发的多媒体应用系统，除了有OMCS提供多媒体的部分，还会有其它业务逻辑，也就是说，除了有OMCS服务器存在，还会有处理业务逻辑的应用服务器存在。就像OMCS开发手册（00） －－ 概述中的那个图所示的情况：

此时，客户端将有两个连接，一个连接指向OMCS服务器，另一个连接指向应用服务器。通常，客户端应该在成功登录了应用服务器之后，才会去连接OMCS服务器，这样就可能存在一个时间间隙 -- 即应用服务器已经连接成功，而OMCS服务器还未连接。如果在这个时候，其它Guest要访问当前客户端的多媒体设备，就会返回TargetUserOffline的结果而连接失败。如果将连接器的WaitOwnerOnlineSpanInSecs设置大于0，则连接器会在这段时间内不断轮询，等待Owner连上OMCS服务器。当Owner上线的时候，再去连接其多媒体设备。当然，如果由于某些意外，导致Owner在WaitOwnerOnlineSpanInSecs时间内都还未连上OMCS服务器，则在等待时间结束时，连接器仍然返回TargetUserOffline的结果。
2.状态信息
MultimediaDeviceType 属性表示当前连接器要连接的目标多媒体设备的类型。
Connected 属性反应了当前连接器与多媒体设备之间的连接状态。
如果连接成功，OwnerID属性表示当前连接的是哪个用户的多媒体设备。
3.断开连接
我们可以调用Disconnect方法主动断开与目标多媒体设备的连接。当然，除了主动断开连接外，还有其它几种方式也会导致连接器到目标设备的连接断开。而只要连接器与目标多媒体设备之间的连接断开，就会触发Disconnected事件，事件的参数ConnectorDisconnectedType说明了连接断开的原因。
public enum ConnectorDisconnectedType
{
/// <summary>
/// Guest(连接器)掉线。
/// </summary>
GuestOffline = 0,
/// <summary>
/// Owner(设备)掉线。
/// </summary>
OwnerOffline,
/// <summary>
/// Guest(连接器)主动断开到设备的连接。
/// </summary>
GuestActiveDisconnect,
/// <summary>
/// Owner(设备)主动断开Guest(连接器)到设备连接。
/// </summary>
OwnerActiveDisconnect
}
多媒体连接器断开共有四种原因：Guest掉线、Owner掉线、Guest主动断开、Owner主动断开。
当我们在正常工作的连接器实例上调用其Disconnect方法时，触发Disconnected事件的参数就是ConnectorDisconnectedType.GuestActiveDisconnect。
还记得在介绍 OMCS开发手册（01） －－ 多媒体设备管理器 时，IMultimediaManager有重载的DisconnectGuest方法，如果Owner调用这个DisconnectGuest方法，那么在Guest这一方对应的连接器实例就会断开到目标设备的连接，而断开的原因就正是ConnectorDisconnectedType.OwnerActiveDisconnect。
二.四种多媒体连接器
OMCS提供了四种多媒体连接器：MicrophoneConnector（麦克风连接器）、CameraConnector/DynamicCameraConnector（摄像头连接器）、DesktopConnector/DynamicDesktopConnector（远程桌面连接器）、WhiteBoardConnector（电子白板连接器）。所有这些连接器都实现了IMultimediaConnector接口，所以，IMultimediaConnector定义的功能它们都是拥有的。