RoomKitEQ，摄像头功能设置说明文档
2025-08-018
摄像头功能设置说明文档
一、Flip（翻转功能）
（一）功能概述
Flip模式（垂直翻转）可将图像上下颠倒。该翻转效果同时作用于本地预览画面以及传输到远端的视频画面。
（二）设备兼容性
QuadCamera、PTZ-12camera，以及BoardPro、BoardProG2、Room55Dual、Room70、Room70G2、Room70Panorama、RoomPanorama的集成摄像头，不支持此设置。
（三）当前设置
模式设为“Auto（自动）”，具体自动逻辑需结合设备及系统判定，默认按上述垂直翻转规则生效（若设备支持）。
二、FocusMode（对焦模式）
（一）功能概述
用于控制摄像头对焦方式，当前设为“Auto（自动）”，一般情况下，自动对焦模式会由摄像头及系统依据画面内容，自动调整焦距以保障成像清晰，无需手动干预对焦操作。
（二）补充说明
因界面未展开详细功能描述，实际自动对焦的算法逻辑、响应速度等，需结合具体摄像头型号及系统版本确定，不同设备自动对焦表现可能存在差异。
三、Mirror（镜像功能）
（一）功能概述
Mirror模式（水平翻转）可将屏幕上的图像进行水平镜像翻转，镜像效果同时作用于本地预览画面以及传输到远端的视频画面。当启用发言人追踪功能时，镜像功能会自动禁用。
（二）设备兼容性
仅适用于Precision60camera；不过，PTZ4Kcamera在“CamerasCamera[n]Flip”设置开启时，会自动对图像进行镜像处理。
（三）当前设置
模式设为“Auto（自动）”，自动逻辑需结合设备及系统判定，按上述水平翻转规则（若设备满足条件）生效，且受发言人追踪等功能状态影响。
四、ExcludedArea（排除区域）
（一）功能概述
当设置该参数后，可指示MultiCameraDirector忽略摄像头视野选定区域内出现的人脸。用于过滤无需识别的画面区域，比如背景中不想被人脸检测功能捕捉的部分。
（二）格式规则
整体结构：通过分号（;）分隔多个多边形区域，每个多边形用于定义一个排除区域的形状。
多边形定义：每个多边形需包含3个及以上坐标对，坐标对之间用逗号（,）分隔。
坐标体系：采用球面坐标，单位为“百分之一度”。举例而言，“0,0”代表摄像头正前方的射线方向；“100,100”代表向左偏离1度、向上偏离1度的射线方向（因100对应1度，即100×0.01°=1°）。
对于电动调节摄像头：坐标相对摄像头的“中立位置”（初始/默认位置），即便摄像头移动，坐标体系也保持不变，方便固定区域的排除设置。
多摄像头场景：每个摄像头需单独定义排除区域，不同摄像头的排除区域相互独立，互不影响。
（三）示例解析
以示例“1000,500,500,500,500,-500,1000,500;-2000,-1000,-2500,-1000,-2500,-1500,-2000,-1500”为例：
第一组多边形：“1000,500”对应水平10°（1000×0.01）、垂直5°的方向；“500,500”对应水平5°、垂直5°的方向，以此类推，这些坐标对围成的区域是从（10°,5°）到（5°,-5°）的多边形，定义一个排除区，该区域内人脸会被系统忽略。
第二组多边形：“-2000,-1000”对应水平-20°、垂直-10°的方向，围成从（-20°,-10°）到（-25°,-15°）的区域，作为第二个排除区。
五、BacklightDefaultMode（背光默认模式）
（一）功能概述
用于控制背光补偿功能的开启与关闭。当房间内人物背后光线很强时，启用背光补偿可避免远端看到的人物画面过暗；若不启用补偿，这种场景下人物在远端画面可能会显得非常暗。
（二）设备兼容性
不支持的设备：BarPro、BoardPro、BoardProG2的集成摄像头，无法使用此背光补偿设置。
有条件支持的设备：Quad摄像头，以及Room55Dual、Room70、Room70G2、Room70Panorama、RoomPanorama的集成摄像头，需满足“CamerasCameraBrightnessAlgorithm（摄像头亮度算法）设为Average（平均）”条件，才适用该背光补偿设置；若亮度算法未设为Average，这些设备也无法启用背光补偿。
（三）自动适配情况
上述受条件限制的摄像头（Quad、Room系列等），若不满足背光补偿启用条件，会根据房间光线情况自动调整自身参数，无需手动开启背光补偿，也能尽量优化画面亮度表现。
（四）当前设置
模式设为“Off（关闭）”，即当前未启用背光补偿功能，若设备及场景满足条件，可手动切换模式开启以优化逆光场景下的画面。