Agora C++ API Reference for All Platforms
screen_capture_i.h
1 //
2 // Agora Media SDK
3 //
4 // Created by Sting Feng in 2015-05.
5 // Copyright (c) 2015 Agora IO. All rights reserved.
6 //
7 #pragma once
8 
9 #include "NGIAgoraScreenCapturer.h"
10 #include "api/video/video_frame.h"
11 #include "api/video/video_sink_interface.h"
12 #include "modules/desktop_capture/desktop_capturer.h"
13 
14 namespace agora {
15 namespace rtc {
16 
17 class IScreenCaptureObserver;
18 
20 public:
24  };
25  public:
26  virtual ~IScreenCapturerEx() {}
27  virtual int StartCapture() = 0;
28  virtual int StopCapture() = 0;
30  std::weak_ptr<::rtc::VideoSinkInterface<webrtc::VideoFrame>> dataCallback) = 0;
31  virtual int CaptureMouseCursor(bool capture) = 0;
32  virtual int GetScreenDimensions(VideoDimensions& dimension) = 0;
33  virtual bool FocusOnSelectedSource() = 0;
34 #if defined(WEBRTC_MAC) && !defined(WEBRTC_IOS)
35  virtual void SetHighLight(bool isHighLight, unsigned int color, int width) {}
36 #endif
37 #if defined(_WIN32)
38  virtual int InitUsingLastRegionSetting() { return -ERR_NOT_SUPPORTED; }
39  virtual void SetCaptureSource(bool allow_magnification_api, bool allow_directx_capturer) {}
40  virtual void GetCaptureSource(bool& allow_magnification_api, bool& allow_directx_capturer) {}
41 #endif // _WIN32
42 
43 #if defined(_WIN32) || (defined(WEBRTC_MAC) && !defined(WEBRTC_IOS))
44  virtual void ForcedUsingScreenCapture(bool using_screen_capture) {}
45 
46  virtual void SetExcludeWindowList(const std::vector<void *>& window_list) = 0;
47  virtual webrtc::DesktopCapturer::SourceId GetSourceId() = 0;
48  virtual int GetCaptureType() = 0;
49 #endif // _WIN32 || (WEBRTC_MAC&&!WEBRTC_IOS)
51  return -ERR_NOT_SUPPORTED;
52  }
54  return -ERR_NOT_SUPPORTED;
55  }
56  virtual void* getScreenCaptureSources(int thumb_cx, int thumb_cy, int icon_cx, int icon_cy,
57  bool include_screen) {
58  return nullptr;
59  }
60  virtual void deinit() {};
61 };
62 
64 public:
66  (void) state;
67  }
68 protected:
70 };
71 
72 #if defined(__ANDROID__) || (defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE)
73 class AudioPcmDataSinkInterface;
75  public:
76  virtual int startVideoCapture() = 0;
77  virtual int stopVideoCapture() = 0;
78  virtual int startAudioCapture() = 0;
79  virtual int stopAudioCapture() = 0;
80  virtual void addPcmDataSink(AudioPcmDataSinkInterface* sink) = 0;
81  virtual void removePcmDataSink(AudioPcmDataSinkInterface* sink) = 0;
82  virtual void deinit() {};
83 };
84 #endif
85 
86 } // namespace rtc
87 } // namespace agora
agora::rtc::IScreenCapturerEx::InitUsingLastRegionSetting
virtual int InitUsingLastRegionSetting()
Definition: screen_capture_i.h:38
agora::rtc::IScreenCapturerEx::GetCaptureType
virtual int GetCaptureType()=0
agora::rtc::IScreenCapturerEx::ForcedUsingScreenCapture
virtual void ForcedUsingScreenCapture(bool using_screen_capture)
Definition: screen_capture_i.h:44
agora::rtc::IScreenCaptureObserver
Definition: screen_capture_i.h:63
agora::rtc::IScreenCaptureObserver::onScreenCaptureStateChanged
virtual void onScreenCaptureStateChanged(IScreenCapturerEx::SCREEN_CAPTURER_STATE state)
Definition: screen_capture_i.h:65
agora::rtc::IScreenCapturerEx::SetHighLight
virtual void SetHighLight(bool isHighLight, unsigned int color, int width)
Definition: screen_capture_i.h:35
agora::rtc::IScreenCapturerEx::SCREEN_CAPTURER_STATE
SCREEN_CAPTURER_STATE
Definition: screen_capture_i.h:21
agora::rtc::IScreenCapturerEx::SCREEN_CAPTURER_STOPPED
@ SCREEN_CAPTURER_STOPPED
Definition: screen_capture_i.h:23
agora::rtc::IScreenCapturerEx::SetExcludeWindowList
virtual void SetExcludeWindowList(const std::vector< void * > &window_list)=0
agora::rtc::IScreenCapturerEx::RegisterCaptureDataCallback
virtual void RegisterCaptureDataCallback(std::weak_ptr<::rtc::VideoSinkInterface< webrtc::VideoFrame >> dataCallback)=0
agora::rtc::IScreenCapturerEx::unregisterScreenCaptureObserver
virtual int unregisterScreenCaptureObserver(IScreenCaptureObserver *observer)
Definition: screen_capture_i.h:53
agora::rtc::IScreenCapturerEx::deinit
virtual void deinit()
Definition: screen_capture_i.h:60
agora::rtc::IScreenCapturerEx::FocusOnSelectedSource
virtual bool FocusOnSelectedSource()=0
agora::rtc::IScreenCapturerEx::registerScreenCaptureObserver
virtual int registerScreenCaptureObserver(IScreenCaptureObserver *observer)
Definition: screen_capture_i.h:50
agora
Definition: AgoraAtomicOps.h:21
agora::rtc::IScreenCapturerEx::getScreenCaptureSources
virtual void * getScreenCaptureSources(int thumb_cx, int thumb_cy, int icon_cx, int icon_cy, bool include_screen)
Definition: screen_capture_i.h:56
agora::rtc::IScreenCapturer
Definition: NGIAgoraScreenCapturer.h:18
agora::rtc::IScreenCaptureObserver::~IScreenCaptureObserver
virtual ~IScreenCaptureObserver()
Definition: screen_capture_i.h:69
agora::rtc::IScreenCapturerEx::CaptureMouseCursor
virtual int CaptureMouseCursor(bool capture)=0
agora::rtc::IScreenCapturerEx2::removePcmDataSink
virtual void removePcmDataSink(AudioPcmDataSinkInterface *sink)=0
agora::rtc::IScreenCapturerEx::StopCapture
virtual int StopCapture()=0
agora::rtc::IScreenCapturerEx::GetCaptureSource
virtual void GetCaptureSource(bool &allow_magnification_api, bool &allow_directx_capturer)
Definition: screen_capture_i.h:40
agora::rtc::IScreenCapturerEx::SetCaptureSource
virtual void SetCaptureSource(bool allow_magnification_api, bool allow_directx_capturer)
Definition: screen_capture_i.h:39
agora::rtc::IScreenCapturerEx2::startAudioCapture
virtual int startAudioCapture()=0
agora::rtc::IScreenCapturer2
Definition: NGIAgoraScreenCapturer.h:145
agora::ERR_NOT_SUPPORTED
@ ERR_NOT_SUPPORTED
Definition: AgoraBase.h:485
agora::rtc::IScreenCapturerEx2::deinit
virtual void deinit()
Definition: screen_capture_i.h:82
agora::rtc::IScreenCapturerEx::GetScreenDimensions
virtual int GetScreenDimensions(VideoDimensions &dimension)=0
agora::rtc::IScreenCapturerEx2::stopAudioCapture
virtual int stopAudioCapture()=0
agora::rtc::IScreenCapturerEx2
Definition: screen_capture_i.h:74
agora::rtc::IScreenCapturerEx::GetSourceId
virtual webrtc::DesktopCapturer::SourceId GetSourceId()=0
agora::rtc::IScreenCapturerEx2::stopVideoCapture
virtual int stopVideoCapture()=0
agora::rtc::IScreenCapturerEx::SCREEN_CAPTURER_STARTED
@ SCREEN_CAPTURER_STARTED
Definition: screen_capture_i.h:22
agora::rtc::IScreenCapturerEx
Definition: screen_capture_i.h:19
agora::rtc::IScreenCapturerEx::~IScreenCapturerEx
virtual ~IScreenCapturerEx()
Definition: screen_capture_i.h:26
agora::rtc::VideoDimensions
Definition: AgoraBase.h:1053
agora::rtc::IScreenCapturerEx2::addPcmDataSink
virtual void addPcmDataSink(AudioPcmDataSinkInterface *sink)=0
rtc::VideoSinkInterface
Definition: video_node_i.h:29
agora::rtc::IScreenCapturerEx2::startVideoCapture
virtual int startVideoCapture()=0
rtc
Definition: video_node_i.h:25
agora::rtc::IScreenCapturerEx::StartCapture
virtual int StartCapture()=0