设置视频编码参数

在视频通话或视频互动直播场景下，视频画面是否清晰流畅，很大程度上决定了用户体验。 视频编码属性包含视频分辨率、帧率、码率等影响视频质量的参数设置。你可以通过设置视频编码属性，控制视频流在不同网络条件下的展示方式。 百家云 SDK 提供了 setVideoEncoderParam 方法设置视频编码属性。此方法可以在任何阶段调用（待确定）。 如果在加入房间后不需要重新设置视频编码属性，百家云建议在 startLocalPreview 前调用 setVideoEncoderParam，以加快首帧出图的时间。

相关函数接口在 android-sdk 2.8.9 及以上版本支持

分辨率、帧率和码率

视频编码属性的参数如下所示：

• width：视频编码的宽。默认值为 640。
• height：视频编码的高。默认值为 360。通常情况下，分辨率越高，视频的清晰度会越好。该参数的值不代表最终视频输出的方向。
• fps: 视频编码的帧率，即每秒钟要编码多少帧画面。默认值为 15。通常情况下，帧率越大，画面越流畅。在对视频流畅度要求较高的场景下，可以将此参数设置为 20 或 25。建议不要将 fps 设置为大于 30。
• bandWidth：视频编码码率 (kbps)。默认值为 400。 为获得高质量的视频，需要将分辨率、码率和帧率维持在相对平衡的状态。较高的分辨率需要较高的码率。在码率一定的情况下，过高的帧率会降低分辨率。

上述参数设置的均为理想情况下的最大值。当视频因网络环境等原因无法达到设置的分辨率、帧率或码率的最大值时，取值会尽量接近最大值。

BRTCDef.BRTCVideoEncParam videoEncParams = new BRTCDef.BRTCVideoEncParam();
videoEncParams.width = 640;
videoEncParams.height = 480;
videoEncParams.bandWidth = 400;
videoEncParams.fps = 15;
engine.setVideoEncoderParam(videoEncParams);

视频参数推荐值

通常来讲，视频编码参数的选择要根据产品实际情况和场景来确定。比如，在一对一教学场景下，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点； 如果是一对四场景， 老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按下列场景中的推荐值进行设置。

编码器输出方向设置

在视频旋转场景中，我们主要关注播放端的行为。setVideoEncoderRotation 设置不影响本地画面的预览方向，但会影响房间中其他用户所观看到（以及云端录制文件）的画面方向。

• 当用户将手机或 Pad 上下颠倒时，由于摄像头的采集方向没有变，所以房间中其他用户所看到的画面会变成上下颠倒的，在这种情况下，您可以通过调用该接口将 SDK 编码出的画面方向旋转180度，如此一来，房间中其他用户所看到的画面可保持正常的方向。
• 如果您希望实现上述这种友好的交互体验，我们更推荐您直接调用 setGSensorMode 实现更加智能的方向适配，无需您手动调用本接口。

engine.setVideoEncoderRotation(localRenderParams.rotation);
engine.setVideoEncoderParam(videoEncParams);

镜像模式

默认情况下，SDK 在编码时不对视频作镜像操作。你可以通过 setVideoEncoderMirror 参数来设置视频编码的镜像模式决定远端用户看到的视频画面。

• 该接口不改变本地摄像头的预览画面，但会改变另一端用户看到的（以及服务器录制的）画面效果
• 即便是在推流过程中，您也可以随时调用此接口来改变编码的镜像效果
• 该接口只针对于主画面有效。如果当前同时在推流摄像头和屏幕共享流，则只有摄像头会有镜像效果

BRTC engine = BRTC.sharedInstance(this);
engine.setVideoEncoderMirror(isPublishMirror);
engine.setVideoEncoderRotation(localRenderParams.rotation);
engine.setVideoEncoderParam(videoEncParams);

Qos策略设定

在网络带宽比较充裕的情况下，清晰和流畅是可以兼顾的，但当用户的网络并不理想时，究竟是优先保证清晰还是优先保证流畅？您可以通过指定 setNetworkQosParam 中的 BRTCDef.BRTCNetworkQosParam 参数来做出选择。

• 流畅优先（BRTCVideoQosPreferenceSmooth） 在用户遭遇弱网环境时，画面会变得模糊，且会有较多马赛克，但可以保持流畅或轻微卡顿。默认值
• 清晰优先（BRTCVideoQosPreferenceClear） 在用户遭遇弱网环境时，画面会尽可能保持清晰，但可能会更容易出现卡顿。 默认值

BRTC engine = BRTC.sharedInstance(this);
engine.setNetworkQosParam(new BRTCDef.BRTCNetworkQosParam(BRTCVideoQosPreference.BRTCVideoQosPreferenceClear, 1));

重力感应模式

考虑到画面旋转牵扯到录制和 CDN 旁路直播的各种适配问题， 百家云 SDK 仅提供了一种简单的重力感应自适应功能，您可以通过 BRTC 的 setGSensorMode 接口来开启。

• 当用户将手机或 Pad 上下颠倒时，由于摄像头的采集方向没有变，所以房间中其他用户所看到的画面会变成上下颠倒的。
• 在这种情况下，您可以通过调用该接口让 SDK 根据设备陀螺仪的朝向自动调整本地画面和编码器输出画面的旋转方向，以使远端观众可以看到正常朝向的画面。

BRTC engine = BRTC.sharedInstance(this);
engine.enterRoom(BRTCParams);
engine.setGSensorMode(BRTCDef.BRTCGSensorMode.BRTC_GSENSOR_MODE_UIFIXLAYOUT);
engine.setVideoEncoderParam(videoEncParams);
engine.muteLocalVideo(false);

大小流编码

本功能需要在推流前设定，独立设置小流的分辨率、帧率和码率等信息。

• 开启该模式后，当前用户会同时编码输出【高清大画面】和【低清小画面】两个规格的视频画面（但只有一路音频流）
• 对于开启该模式的当前用户，会占用更多的网络带宽，并且会消耗更多的 CPU 计算资源
• 对于同一房间的远程观众而言：
  • 如果下行网络很好，或者显示区域较大，可以选择观看【高清大画面】
  • 如果下行网络较差，或者显示区域较小，可以选择观看【低清小画面】
• 考虑到同时编码两个规格的视频画面，需要更多的计算资源，在硬件设备较差的系统上请谨慎开启此功能

在拉流端，使用函数 setRemoteVideoStreamType 选定远端用户的大小画面。

• 在不通过此接口进行设置的情况下，默认订阅的视频画面为大画面
• 该接口在 startRemoteView 之前和之后调用均可以

BRTCDef.BRTCVideoEncParam smallParam = new BRTCDef.BRTCVideoEncParam();
smallParam.width = 320;
smallParam.height = 180;
smallParam.bandWidth = 100;
smallParam.fps = 15;
//开启推送小流功能
engine.enableEncSmallVideoStream(true, smallParam);

//在开始拉流远端音视频流前，指定大流
engine.muteRemoteAudio(userID, false);
engine.muteRemoteVideoStream(userID, false);
engine.setRemoteVideoStreamType(userID, BRTCDef.BRTCVideoStreamType.BRTCVideoStreamTypeBig);
engine.startRemoteView(userID, BRTCDef.BRTCVideoStreamType.BRTCVideoStreamTypeBig, playCanvas);

视频自动回退机制

设置弱网条件下流是否开启自适应回退机制。 当开启时，网络不理想的环境下，自动大流关闭保留小流，如果网络条件还不好就关闭视频，只留音频。如果网络变好，会从只留音频变成恢复推小流，如果网络还很宽裕，再恢复成推大小流。

当视频流自动关闭和恢复时，您会通过此回调 onLocalVideoFallback 收到通知。

BRTCListener brtcListener = new BRTCBaseListener() {
  @Override
  public void onLocalVideoFallback(boolean isFallback) {
    if (isFallback) {
        Log.d(TAG, "fallback to publish audio only");
    } else {
        Log.d(TAG, "recover to publish video data");
    }
  }
  //...
};
BRTC engine = BRTC.sharedInstance(VideoForMultipleUsersLogin.this);
engine.setListener(brtcListener);
engine.setVideoFallbackEnable(true);