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

核心提示：/// <summary> /// 本地桌面的编码质量，取值0~31，OMCS开发手册（01） －－ 多媒体设备管理器(2)，取值越小，越清晰，如果该属性开启，则CameraEncodeQuality属性的设置，可以在运行时动态修改， /// </summary> int D

/// <summary>
/// 本地桌面的编码质量。取值0~31。取值越小，越清晰。可以在运行时动态修改。
/// </summary>
int DesktopEncodeQuality { get; set; }

/// <summary>
/// [从Guest的角度]在连接器连接到设备之前，是否自动先尝试创建P2P通道。默认值为true。必须在初始化前设置才有效。
/// </summary>
bool P2PChannelEnabled { get; set; }

/// <summary>
/// 记录OMCS日志的文件路径，默认值为在运行目录下的OmcsLog.txt文件。
/// </summary>
string OmcsLogPath { get; set; }

/// <summary>
/// 是否记录安全日志。默认值为false。
/// </summary>
bool SecurityLogEnabled { get; set; }
ServerIPE只读属性显示了当前多媒体管理器连接的OMCS服务器的地址。
CurrentUserID只读属性可以获取当前登录的用户的UserID。只有在多媒体管理器初始化（Initialize方法）成功之后，该属性才有效。
CameraDeviceIndex和MicrophoneDeviceIndex属性用于分别设置要使用的本地摄像头和麦克风的索引，如果当前机器接有多个摄像头或者话筒，则可以通过这两个属性来明确指定要使用哪个设备。在大多数情况下，这两个属性设为0即可，其默认值也是0。
Available 属性显示了当前多媒体管理器是否与OMCS服务器成功建立了连接并完成了初始化，而处于可用状态。只有该属性为true时，多媒体管理器才可以正常使用。
OutputAudio属性用于控制是否输出采集到的音频数据给guest。比如在视频会议中，我们可以只将当前发言人的OutputAudio设为true，而将其它成员的OutputAudio设为false，以减少带宽和避免杂音。
IMultimidiaGateway用于控制来访者Guest对本地多媒体设备的连接请求。IMultimidiaGateway接口定义如下：
public interface IMultimidiaGateway
{
/// <summary>
/// 是否允许来访者连接本地多媒体设备。该方法应尽快返回。
/// </summary>
/// <param name="guestID">来访者的UserID</param>
/// <param name="deviceType">多媒体设备的类型</param>
bool AllowConnect(string guestID, MultimediaDeviceType deviceType);
}
比如，当来访者要连接本地的多媒体设备时，OMCS首先会调用IMultimidiaGateway的AllowConnect方法，如果该方法返回true，则允许对方的此次连接；如果返回false，则拒绝对方的此次连接，对方将会得到连接失败的回复。
OMCS提供了默认的IMultimidiaGateway实现 -- DefaultMultimidiaGateway，其对于AllowConnect方法的实现总是返回true。我们可以根据应用要求的设备访问控制策略，自己实现IMultimidiaGateway，并将其注入到MultimidiaManager的MultimidiaGateway属性。 在实现IMultimidiaGateway接口时，要注意所有方法都应该尽快返回，否则，可能导致来访者请求超时（默认为30秒）。
CameraEncodeQuality以及DesktopEncodeQuality属性可以控制摄像头采集到的视频和桌面的编码质量。质量越好，视频就越清晰，所需的带宽也就越大；反之亦然。
AutoAdjustCameraEncodeQuality属性用于控制是否开启视频质量自动调节功能。OMCS内部内置了一套音频/视频优化策略，其可以根据音频反馈以及视频丢帧的情况自动调整视频编码质量，以优先保证音频的清晰与流畅。如果该属性设为true，将开启这套内置策略。如果该属性开启，则CameraEncodeQuality属性的设置，将不再有效；但是我们仍然可以通过CameraEncodeQuality属性读取到当前视频的编码质量。