OMCS开发手册（01） －－ 多媒体设备管理器

核心提示：P2PChannelEnabled 属性用于控制在连接某Owner的设备之前，是否先尝试与其创建P2P通道，OMCS开发手册（01） －－ 多媒体设备管理器(3)，OmcsLogPath 多媒体管理器会捕获内部产生的所有异常，并将其记录到OmcsLogPath指定的日志文件，就不再赘述，3.事件IMultimediaM

P2PChannelEnabled 属性用于控制在连接某Owner的设备之前，是否先尝试与其创建P2P通道。
OmcsLogPath 多媒体管理器会捕获内部产生的所有异常，并将其记录到OmcsLogPath指定的日志文件。其默认是运行目录下的OmcsLog.txt文件。但是，如果我们将基于OMCS的客户端程序安装在C盘，那么在win7下以普通身份运行起来后，是没有权限写运行目录的，这时，我们通常将日志路径设在“我的文档”的目录下面。
2.方法
IMultimediaManager接口中所有的方法定义如下：
/// <summary>
/// 与多媒体服务器建立连接，并初始化本地多媒体管理器。
/// </summary>
/// <param name="userID">当前登录的用户ID。</param>
/// <param name="password">当前登录的用户的密码。</param>
/// <param name="serverIP">OMCS服务器IP</param>
/// <param name="serverPort">OMCS服务器端口</param>
void Initialize(string userID,string password, string serverIP, int serverPort);

/// <summary>
/// 主动断开来访者guest到本地多媒体设备的连接。
/// </summary>
/// <param name="guestID">来访者的用户ID</param>
/// <param name="deviceType">设备类型</param>
/// <param name="notifyGuest">是否通知对方。如果通知对方，对方的连接器将触发Disconnected事件。</param>
void DisconnectGuest(string guestID, MultimediaDeviceType deviceType ,bool notifyGuest);

/// <summary>
/// 主动断开所有来访者到本地多媒体设备的连接。
/// </summary>
/// <param name="notifyGuest">是否通知对方。如果通知对方，对方的连接器将触发Disconnected事件。</param>
void DisconnectGuest(bool notifyGuest);

/// <summary>
/// 获取所有连接到当前多媒体设备的Guest列表。
/// </summary>
List<string> GetGuests(MultimediaDeviceType deviceType);

/// <summary>
/// 查询本地的某设备是否正在工作？
/// </summary>
/// <param name="deviceType">设备类型</param>
/// <returns>工作中？</returns>
bool DeviceIsWorking(MultimediaDeviceType deviceType);
Initialize方法在使用多媒体管理器之前，首先要调用Initialize方法将其进行初始化，初始化将做如下几件事情：
（1）与目标OMCS服务器建立连接。
（2）使用参数传入的帐号密码进行登录。
（3）如果登录成功，则初始化本地的多媒体设备。
注意，如果与服务器连接失败，或者帐号密码错误，则将抛出相应的异常。只有Initialize方法成功返回后，其它的方法才能被正常调用。
DisconnectGuest 方法用于Owner主动断开某个guest或所有guest到本地某设备的连接，该方法为Owner提供了一种主动性的权利。
剩下的几个方法，像DeviceIsWorking、GetGuests等，比较容易理解，就不再赘述。
3.事件
IMultimediaManager接口中所有的事件定义如下：
/// <summary>
/// 当与媒体服务器的连接断开时，触发此事件。
/// </summary>
event CbGeneric ConnectionInterrupted;