Agora C++ API Reference for All Platforms

Public Member Functions | Public Attributes | List of all members
agora::rtc::ScreenCaptureConfiguration Struct Reference

## Public Member Functions
| ScreenCaptureConfiguration ()

## Public Attributes
bool | isCaptureWindow
int64_t | displayId
Rectangle | screenRect
int64_t | windowId
ScreenCaptureParameters | params
Rectangle | regionRect

## Detailed Description

The configuration of the captured screen.

## Constructor & Destructor Documentation

## ◆ ScreenCaptureConfiguration()

agora::rtc::ScreenCaptureConfiguration::ScreenCaptureConfiguration | ( |  | ) |
| inline

## Member Data Documentation

## ◆ isCaptureWindow

bool agora::rtc::ScreenCaptureConfiguration::isCaptureWindow

Whether to capture the window on the screen:

- `true`: Capture the window.
- `false`: (Default) Capture the screen, not the window.

## ◆ displayId

int64_t agora::rtc::ScreenCaptureConfiguration::displayId

(macOS only) The display ID of the screen.

## ◆ screenRect

Rectangle agora::rtc::ScreenCaptureConfiguration::screenRect

(Windows only) The relative position of the shared screen to the virtual screen.

Note
  This parameter takes effect only when you want to capture the screen on Windows.

## ◆ windowId

int64_t agora::rtc::ScreenCaptureConfiguration::windowId

(For Windows and macOS only) The window ID.

Note
  This parameter takes effect only when you want to capture the window.

## ◆ params

ScreenCaptureParameters agora::rtc::ScreenCaptureConfiguration::params

(For Windows and macOS only) The screen capture configuration. For details, see ScreenCaptureParameters.

## ◆ regionRect

Rectangle agora::rtc::ScreenCaptureConfiguration::regionRect

(For Windows and macOS only) The relative position of the shared region to the whole screen. For details, see Rectangle.

If you do not set this parameter, the SDK shares the whole screen. If the region you set exceeds the boundary of the screen, only the region within in the screen is shared. If you set width or height in Rectangle as 0, the whole screen is shared.