视频图像镜像旋转
功能介绍
本节介绍如何对本地视频画面进行镜像(左右翻转)与旋转(含上下翻转)配置。这些效果作用于本端发送的视频,远端看到的是处理后的画面。
视频效果相关接口通过 CRVideoSDKMeeting 访问:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
1. 视频效果配置
本地视频的镜像、旋转、上下翻转等通过 setVideoEffects(efs) 配置。参数 efs 为 JSON 字符串,格式参见 CRVideoEffectsObj。
此配置同时影响本地、远端的画面,常用于一些特殊设备的图像校正(如摄像头倒装在天花板)
CRVideoEffectsObj 常用字段(节选):
| 参数 | 类型 | 说明 |
|---|---|---|
| mirror | int | 视频镜像(左右翻转),0:关闭,1:开启,默认 0 |
| upsideDown | int | 视频上下翻转,0:关闭,1:开启,默认 0 |
| degree | int | 旋转角度。0、90、180、270、360;<0 表示自动,默认自动 |
示例:
// 开启镜像(左右翻转)
const char* efs = R"({"mirror":1})";
meeting.setVideoEffects(efs);
// 旋转 90 度并镜像
const char* efs2 = R"({"mirror":1,"degree":90})";
meeting.setVideoEffects(efs2);
// 恢复默认(关闭镜像与旋转)
const char* efsDefault = R"({"mirror":0,"degree":-1,"upsideDown":0})";
meeting.setVideoEffects(efsDefault);
相关 API 与结构请参考:
2. 仅本地效果处理
若只需在本地效果处理(如:本地镜像),而不改变发送给远端的内容,可在渲染前对图像帧做处理。如调用 mirrorVideoFrame(frm) 对图像进行镜像,或在UI的绘制中完成对图像的处理。
相关 API 请参考:
3. 注意
- setVideoEffects作用于本地及发送的视频画面。
- setVideoEffects会带来 CPU 开销,按需开启。