音视频通话

视频图像镜像旋转

功能介绍

本节介绍如何对本地视频画面进行镜像(左右翻转)与旋转(含上下翻转)配置。这些效果作用于本端发送的视频,远端看到的是处理后的画面。

视频效果相关接口通过 CRVideoSDKMeeting 访问:

RTCMeeting *meeting = [RTCMeeting shareInstance];

1. 视频效果配置

本地视频的镜像、旋转、上下翻转等通过 setVideoEffects(efs) 配置。参数 efs 为 JSON 字符串,格式参见 VideoEffects。
此配置同时影响本地、远端的画面,常用于一些特殊设备的图像校正(如摄像头倒装在天花板)

CRVideoEffectsObj 常用字段(节选):

参数 类型 说明
mirror int 视频镜像(左右翻转),0:关闭,1:开启,默认 0
upsideDown int 视频上下翻转,0:关闭,1:开启,默认 0
degree int 旋转角度。0、90、180、270、360;<0 表示自动,默认自动

示例:

RTCMeeting *meeting = [RTCMeeting shareInstance];

// 开启镜像(左右翻转)
VideoEffects *effects = [[VideoEffects alloc] init];
effects.mirror = 1;  // 1 表示开启镜像
[meeting setVideoEffects:effects];

// 旋转 90 度并镜像
VideoEffects *effects2 = [[VideoEffects alloc] init];
effects2.mirror = 1;   // 开启镜像
effects2.degree = 90;  // 旋转 90 度
[meeting setVideoEffects:effects2];

// 恢复默认(关闭镜像与旋转)
VideoEffects *defaultEffects = [[VideoEffects alloc] init];
defaultEffects.mirror = 0;       // 关闭镜像
defaultEffects.degree = -1;      // -1 表示不旋转
defaultEffects.upsideDown = 0;   // 关闭上下翻转
[meeting setVideoEffects:defaultEffects];

相关 API 与结构请参考:

3. 注意