Inherits RefCountInterface.
The IScreenCapturer class, which provides access to the screen capturer.
◆ ~IScreenCapturer()
◆ initWithWindowId()
virtual int initWithWindowId |
( |
view_t |
windowId, |
|
|
const Rectangle & |
regionRect |
|
) |
| |
|
pure virtual |
Initializes the screen capturer by specifying a window ID.
This method shares a whole or part of a window specified by the window ID.
- Note
- This method applies to Windows and macOS only.
- Parameters
-
windowId | The ID of the window to be shared. This parameter specifies which window you want to share. |
regionRect | The reference to the relative location of the region to the window. See agora::rtc::Rectangle ®ionRect "regionRect".
- If the specified region overruns the window, only the region within the screen will be captured.
- If you set
width or height as 0, the whole window will be captured. Note that the coordinates of rectangle are relative to the window and follows system specifications.
|
- Returns
- 0: Success.
- < 0: Failure.
◆ setContentHint()
Sets the content hint for screen sharing.
A content hint suggests the type of the content being shared, so that the SDK applies different optimization algorithms to different types of content.
- Parameters
-
- Returns
- 0: Success.
- < 0: Failure.
- ERR_NOT_READY: No screen or window is being shared.
◆ updateScreenCaptureRegion()
virtual int updateScreenCaptureRegion |
( |
const Rectangle & |
regionRect | ) |
|
|
pure virtual |
Updates the screen capture region.
- Parameters
-
regionRect | The reference to the relative location of the region to the screen or window. See Rectangle.
- If the specified region overruns the screen or window, the screen capturer captures only the region within it.
- If you set
width or height as 0, the SDK shares the whole screen or window.
|
- Returns
- 0: Success.
- < 0: Failure.
- No screen or window is being shared.
◆ setScreenOrientation()
Set orientation of the captured screen image
- Parameters
-
VIDEO_ORIENTATION | orientaion of the device 0(by default), 90, 180, 270 |
◆ setFrameRate()
virtual void setFrameRate |
( |
int |
rate | ) |
|
|
pure virtual |
Set frame rate of the screen capture source
- Parameters
-
◆ AddRef()
virtual void AddRef |
( |
| ) |
const |
|
pure virtualinherited |
◆ Release()
◆ HasOneRef()
virtual bool HasOneRef |
( |
| ) |
const |
|
pure virtualinherited |