使用Agora On-premise Recording SDK录制竖屏视频时上下被裁剪如何解决

配置调整即可解决，无需修改SDK或对接服务端 #

你遇到的裁剪问题完全由本地合流布局配置错误导致，三个问题的答案如下：

• 存在可直接解决该问题的公开配置项，不需要修改SDK源码，服务端也没有对原始流做裁剪

具体问题说明

1. 你当前将合流画布和显示区域都设置为480*480的正方形比例，和手机竖屏普遍的9:16比例不匹配，合流时超出画布的上下部分会被自动裁剪
2. 未指定渲染模式的情况下，SDK默认采用裁剪填充策略，进一步加剧了画面裁切

修改方案

调整画布宽高比匹配竖屏比例，同时给显示区域新增renderMode参数设置为等比适配模式即可：

// 调整画布为9:16竖屏比例，可按需修改分辨率
let layout = {
    "canvasWidth": 480,
    "canvasHeight": 854,
    "backgroundColor": "#eeeeee",
    "regions": []
}

// 新增renderMode参数，1为等比适配全部显示，0为默认裁剪模式
let region = {
    "x": 0,
    "y": 0,
    "width": 480,
    "height": 854,
    "zOrder": 1,
    "alpha": 1,
    "uid": uid,
    "renderMode": 1
}

其余疑问说明

• 无需修改SDK文件：所有配置都通过公开API提供，修改SDK源码会导致后续版本无法正常升级，还会引入不可预知的运行问题
• 服务端没有裁剪原始流：声网服务端会完整保留主播端推流的原始画面，裁剪仅发生在本地录制SDK的合流环节，调整配置即可恢复完整画面

内容的提问来源于stack exchange，提问作者kokucoco