VideoCanvas

视频画布对象的属性。

Java

public class VideoCanvas {
  public static final int RENDER_MODE_HIDDEN = 1;
  public static final int RENDER_MODE_FIT = 2;
  public static final int RENDER_MODE_ADAPTIVE = 3;
  public static final int VIEW_SETUP_MODE_REPLACE = 0;
  public static final int VIEW_SETUP_MODE_ADD = 1;
  public static final int VIEW_SETUP_MODE_REMOVE = 2;
  public View view;
  public int uid;
  public int renderMode;
  public int mirrorMode;
  public int setupMode = VIEW_SETUP_MODE_REPLACE;
  public int sourceType;
  public int mediaPlayerId;
  public Rect rect;
  public int backgroundColor;
  public Constants.VideoModulePosition position =
      Constants.VideoModulePosition.VIDEO_MODULE_POSITION_POST_CAPTURER;
  public VideoCanvas(View view) {
    this.view = view;
    this.renderMode = RENDER_MODE_HIDDEN;
    this.backgroundColor = 0;
  }
  public VideoCanvas(View view, int renderMode, int uid) {
    this.view = view;
    this.renderMode = renderMode;
    this.uid = uid;
    this.backgroundColor = 0;
  }
}

view

视频显示窗口。

renderMode

• RENDER_MODE_HIDDEN (1)：优先保证视窗被填满。视频尺寸等比缩放，直至整个视窗被视频填满。如果视频长宽与显示窗口不同，多出的视频将被截掉。
  
• RENDER_MODE_FIT (2)：优先保证视频内容全部显示。视频尺寸等比缩放，直至视频窗口的一边与视窗边框对齐。如果视频长宽与显示窗口不同，视窗上未被填满的区域将被涂黑。
  
• RENDER_MODE_ADAPTIVE (3): 该模式已废弃，不推荐使用。
  

mirrorMode

• VIDEO_MIRROR_MODE_AUTO (0)：SDK 决定镜像模式。如果你使用前置摄像头，默认启动本地视图镜像模式；如果你启用后置摄像头，默认关闭本地视图镜像模式。
  
• VIDEO_MIRROR_MODE_ENABLED (1)：开启本地视图的镜像模式。
  
• VIDEO_MIRROR_MODE_DISABLED (2)：关闭本地视图的镜像模式。
  

注意：

• 本地视图镜像模式：如果你使用前置摄像头，默认启动本地视图镜像模式；如果你使用后置摄像头，默认关闭本地视图镜像模式。
  
• 远端用户视图镜像模式：默认关闭远端用户的镜像模式。
  

uid

用户 ID。

sourceType

视频源的类型，详见 VideoSourceType。

sourceId

视频源 ID。

setupMode

视图设置模式：

• VIEW_SETUP_MODE_REPLACE (0): (默认) 替换一个视图。
  
• VIEW_SETUP_MODE_ADD (1): 增加一个视图。
  
• VIEW_SETUP_MODE_REMOVE (2): 删除一个视图。
  

mediaPlayerId

媒体播放器 ID。可通过 getMediaPlayerId 获取。

rect

（可选）视频帧的展示区域。详见 Rect。其中，width 和 height 表示该区域的视频像素宽度和高度。默认值为空值 (宽或高为 0)，表示展示实际分辨率的视频帧。

backgroundColor

视频画布的背景颜色，格式为 RGBA。默认值为 0x00000000，代表完全透明的黑色。