ScreenCaptureParameters
- Unity
更新时间
屏幕共享的参数配置。
public class ScreenCaptureParameters
{
public ScreenCaptureParameters()
{
dimensions = new VideoDimensions(1920, 1080);
frameRate = 5;
bitrate = (int)BITRATE.STANDARD_BITRATE;
captureMouseCursor = true;
windowFocus = false;
excludeWindowList = new view_t[0];
excludeWindowCount = 0;
highLightWidth = 0;
highLightColor = 0;
enableHighLight = false;
}
public ScreenCaptureParameters(ref VideoDimensions d, int f, int b)
{
dimensions = new VideoDimensions(d.width, d.height);
frameRate = f;
bitrate = b;
captureMouseCursor = true;
windowFocus = false;
excludeWindowList = new view_t[0];
excludeWindowCount = 0;
highLightWidth = 0;
highLightColor = 0;
enableHighLight = false;
}
public ScreenCaptureParameters(int width, int height, int f, int b)
{
dimensions = new VideoDimensions(width, height);
frameRate = f;
bitrate = b;
captureMouseCursor = true;
windowFocus = false;
excludeWindowList = new view_t[0];
excludeWindowCount = 0;
highLightWidth = 0;
highLightColor = 0;
enableHighLight = false;
}
public ScreenCaptureParameters(int width, int height, int f, int b, bool cur, bool fcs)
{
dimensions = new VideoDimensions(width, height);
frameRate = f;
bitrate = b;
captureMouseCursor = cur;
windowFocus = fcs;
excludeWindowList = new view_t[0];
excludeWindowCount = 0;
highLightWidth = 0;
highLightColor = 0;
enableHighLight = false;
}
public ScreenCaptureParameters(int width, int height, int f, int b, view_t[] ex, int cnt)
{
dimensions = new VideoDimensions(width, height);
frameRate = f;
bitrate = b;
captureMouseCursor = true;
windowFocus = false;
excludeWindowList = ex;
excludeWindowCount = cnt;
highLightWidth = 0;
highLightColor = 0;
enableHighLight = false;
}
public ScreenCaptureParameters(int width, int height, int f, int b, bool cur, bool fcs, view_t[] ex, int cnt)
{
dimensions = new VideoDimensions(width, height);
frameRate = f;
bitrate = b;
captureMouseCursor = cur;
windowFocus = fcs;
excludeWindowList = ex;
excludeWindowCount = cnt;
highLightWidth = 0;
highLightColor = 0;
enableHighLight = false;
}
public VideoDimensions dimensions { set; get; }
public int frameRate { set; get; }
public int bitrate { set; get; }
public bool captureMouseCursor { set; get; }
public bool windowFocus { set; get; }
public view_t[] excludeWindowList { set; get; }
public int excludeWindowCount { set; get; }
public int highLightWidth { set; get; }
public uint highLightColor { set; get; }
public bool enableHighLight { set; get; }
};属性
| 参数名 | 描述 |
|---|---|
dimensions | 注: 在共享文档的场景(SCREEN_SCENARIO_DOCUMENT)下设置编码分辨率时,选择以下两种方式其中之一。
屏幕共享流的视频编码分辨率。详见 VideoDimensions。默认值为 1920 × 1080,即 2073600 像素。该像素值为计费标准。当共享的屏幕分辨率宽高比与该值设置不一致时,SDK 按如下策略进行编码。假设
|
frameRate | 在 Windows 和 macOS 平台上,表示屏幕共享流的视频编码帧率。单位为 fps;默认值为 5,建议不要超过 15。 |
bitrate | 共享视频的码率。在 Windows 和 macOS 平台上,表示屏幕共享流的视频编码码率。单位为 Kbps;默认值为 0,表示 SDK 根据当前共享屏幕的分辨率计算出一个合理的值。 |
captureMouseCursor | 注: 受 macOS 系统限制,在共享屏幕时将该参数设置为 false 无效(共享窗口时无影响)。 是否采集鼠标用于屏幕共享:
|
windowFocus | 注: 由于 macOS 系统限制,设置该成员将窗口前置时,如果当前的应用存在多个窗口,只会将主窗口前置。 调用 StartScreenCaptureByWindowId 方法共享窗口时,是否将该窗口前置:
|
excludeWindowList | 待屏蔽窗口的 ID 列表。调用 StartScreenCaptureByDisplayId 开启屏幕共享时,你可以通过该参数屏蔽指定的窗口。你可以在调用 UpdateScreenCaptureParameters 更新屏幕共享的配置参数时,通过该参数动态屏蔽指定的窗口。 |
enableHighLight | 注: 当你在共享窗口或屏幕的部分区域时,如果将该参数设置为 true,SDK 会对整个窗口或屏幕进行描边。 (仅适用于 macOS 和 Windows)是否对共享的窗口或屏幕进行描边:
|
highLightColor | (仅适用于 macOS 和 Windows)
|
highLightWidth | (仅适用于 macOS 和 Windows)描边的宽度 (px)。默认值为 5,取值范围为 (0,50]。 注: 该参数仅在 |
excludeWindowCount | 待屏蔽窗口的数量。 注: 在 Windows 平台上,该参数最大值不超过 24,如果超过该值,则屏蔽窗口功能失效。 |