Agora C++ API Reference for All Platforms
agora_service_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 <memory>
10 #include <string>
11 
12 #include "AgoraRefPtr.h"
13 
14 #include "IAgoraService.h"
15 #include "IAgoraLog.h"
16 
17 #include "audio_options_i.h"
18 #include "content_inspect_i.h"
19 #include "bitrate_constraints.h"
20 #include "media_component/IAudioDeviceManager.h"
21 #include "api2/NGIAgoraAudioDeviceManager.h"
22 
23 #include <functional>
24 #include <string>
25 
26 struct event_base;
27 
28 namespace agora {
29 namespace rtc {
30 class AgoraGenericBridge;
31 class ConfigSourceAP;
32 class IDiagnosticService;
33 class ILocalUserEx;
34 class PredefineIpList;
35 class IRtcConnection;
36 struct RtcConnectionConfigurationEx;
37 class IMediaExtensionObserver;
38 class XdumpHandler;
39 } // namespace rtc
40 
41 namespace base {
42 class IAgoraServiceObserver;
43 
57 };
58 
61  const char* deviceId = nullptr;
62  const char* deviceInfo = nullptr;
63  const char* systemInfo = nullptr;
64  const char* configDir = nullptr;
65  const char* dataDir = nullptr;
66  const char* pluginDir = nullptr;
68  bool apSendRequest = true;
69 
71  bitrateConstraints.start_bitrate_bps = kDefaultStartBitrateBps;
72  bitrateConstraints.max_bitrate_bps = kDefaultMaxBitrateBps;
73  }
74 
77  bitrateConstraints.max_bitrate_bps = kDefaultMaxBitrateBps;
78  bitrateConstraints.start_bitrate_bps = kDefaultStartBitrateBps;
79  }
80 
81  private:
82  static constexpr int kDefaultMaxBitrateBps = (24 * 10 * 1000 * 95);
83  static constexpr int kDefaultStartBitrateBps = 300000;
84 };
85 
86 
87 // full feature definition of rtc engine interface
89  public:
90  virtual int initializeEx(const AgoraServiceConfigEx& context) = 0;
92  const rtc::RtcConnectionConfigurationEx& cfg) = 0;
93 
94 #ifdef CONFIG_LIBEVENT
95  // Returns a libevent event_base created by event_base_new. Also this implies
96  // the application might use this event as its main event loop.
97  virtual event_base* getWorkerEventBase() = 0;
98 #endif
99 
100  virtual int32_t setLogWriter(agora::commons::ILogWriter* logWriter) = 0;
102 
103  virtual int32_t setAudioDumpPath(const char* filePath) = 0;
104 
105  virtual agora_refptr<rtc::IRtcConnection> getOneRtcConnection(bool admBinded) const = 0;
106 
107  virtual void enableStringUid(bool enabled) = 0;
108  virtual bool useStringUid() const = 0;
109  virtual rtc::uid_t getUidByUserAccount(const std::string& app_id, const std::string& user_account) const = 0;
110 
111  // Register string user account before join channel, this would speed up join channel time.
112  virtual int registerLocalUserAccount(const char* appId, const char* userAccount) = 0;
113 
115 
118 
120  agora_refptr<rtc::IRtcConnection> rtcConnection, const char* appId, media::CONTENT_INSPECT_CLOUD_TYPE cloudType) = 0;
121 
130  virtual int startTrace(uint32_t count, uint64_t mask) = 0;
139  virtual int stopTrace(const char* file_path) = 0;
140 
160  virtual int setExternalAudioSink(bool enabled, int sampleRate, int channels) = 0;
161 
171  virtual int pullPlaybackAudioPcmData(void* payloadData, const rtc::AudioPcmDataInfo& audioFrameInfo) = 0;
172 
173  protected:
174  virtual ~IAgoraServiceEx() {}
175 };
176 
178  public:
179  virtual ~IAgoraServiceObserver() = default;
180 
181  virtual void onLocalUserRegistered(rtc::uid_t uid, const char* userAccount) = 0;
182 };
183 
185 
186 } // namespace base
187 } // namespace agora
agora::base::IAgoraServiceObserver
Definition: agora_service_i.h:177
agora::base::IAgoraService
Definition: IAgoraService.h:377
agora::base::IAgoraServiceEx::getWorkerEventBase
virtual event_base * getWorkerEventBase()=0
agora::rtc::BitrateConstraints::start_bitrate_bps
int start_bitrate_bps
Definition: bitrate_constraints.h:22
agora::commons::ILogWriter
Definition: IAgoraLog.h:49
agora::base::AgoraServiceConfigEx::pluginDir
const char * pluginDir
Definition: agora_service_i.h:66
agora::base::AgoraServiceConfigEx::AgoraServiceConfigEx
AgoraServiceConfigEx()
Definition: agora_service_i.h:70
agora::agora_refptr
Definition: AgoraRefPtr.h:44
agora::base::AgoraServiceConfiguration
Definition: IAgoraService.h:79
agora::base::AgoraServiceConfigEx::engineType
MediaEngineType engineType
Definition: agora_service_i.h:60
agora::base::AgoraServiceConfigEx::configDir
const char * configDir
Definition: agora_service_i.h:64
agora::base::GetService
IAgoraServiceEx * GetService()
agora::base::AgoraServiceConfigEx::deviceInfo
const char * deviceInfo
Definition: agora_service_i.h:62
agora::base::IAgoraServiceEx::setExternalAudioSink
virtual int setExternalAudioSink(bool enabled, int sampleRate, int channels)=0
agora::base::AgoraServiceConfigEx::deviceId
const char * deviceId
Definition: agora_service_i.h:61
agora::base::MEDIA_ENGINE_WEBRTC
@ MEDIA_ENGINE_WEBRTC
Definition: agora_service_i.h:48
agora::base::AgoraServiceConfigEx::AgoraServiceConfigEx
AgoraServiceConfigEx(const AgoraServiceConfiguration &rhs)
Definition: agora_service_i.h:75
agora::base::IAgoraServiceEx::startTrace
virtual int startTrace(uint32_t count, uint64_t mask)=0
agora::base::IAgoraServiceEx::setAudioDumpPath
virtual int32_t setAudioDumpPath(const char *filePath)=0
agora::base::IAgoraServiceEx::initializeEx
virtual int initializeEx(const AgoraServiceConfigEx &context)=0
agora::base::AgoraServiceConfigEx
Definition: agora_service_i.h:59
agora
Definition: AgoraAtomicOps.h:21
agora::base::IAgoraServiceObserver::onLocalUserRegistered
virtual void onLocalUserRegistered(rtc::uid_t uid, const char *userAccount)=0
agora::base::IAgoraServiceObserver::~IAgoraServiceObserver
virtual ~IAgoraServiceObserver()=default
agora::base::IAgoraServiceEx::stopTrace
virtual int stopTrace(const char *file_path)=0
agora::base::IAgoraServiceEx::~IAgoraServiceEx
virtual ~IAgoraServiceEx()
Definition: agora_service_i.h:174
agora::rtc::RtcConnectionConfigurationEx
Definition: rtc_connection_i.h:104
agora::base::AgoraServiceConfigEx::systemInfo
const char * systemInfo
Definition: agora_service_i.h:63
agora::rtc::IDiagnosticService
Definition: diagnostic_service_i.h:35
agora::base::IAgoraServiceEx::pullPlaybackAudioPcmData
virtual int pullPlaybackAudioPcmData(void *payloadData, const rtc::AudioPcmDataInfo &audioFrameInfo)=0
agora::base::IAgoraServiceEx::setLogWriter
virtual int32_t setLogWriter(agora::commons::ILogWriter *logWriter)=0
agora::base::IAgoraServiceEx::useStringUid
virtual bool useStringUid() const =0
agora::base::MEDIA_ENGINE_EMPTY
@ MEDIA_ENGINE_EMPTY
Definition: agora_service_i.h:52
agora::base::IAgoraServiceEx
Definition: agora_service_i.h:88
agora::base::IAgoraServiceEx::getDiagnosticService
virtual rtc::IDiagnosticService * getDiagnosticService() const =0
agora::base::IAgoraServiceEx::unregisterAgoraServiceObserver
virtual int unregisterAgoraServiceObserver(IAgoraServiceObserver *observer)=0
agora::base::MediaEngineType
MediaEngineType
Definition: agora_service_i.h:44
agora::rtc::BitrateConstraints
Definition: bitrate_constraints.h:20
agora::rtc::BitrateConstraints::max_bitrate_bps
int max_bitrate_bps
Definition: bitrate_constraints.h:23
agora::rtc::AudioPcmDataInfo
Definition: AgoraBase.h:1463
agora::base::IAgoraServiceEx::releaseLogWriter
virtual agora::commons::ILogWriter * releaseLogWriter()=0
agora::base::AgoraServiceConfigEx::dataDir
const char * dataDir
Definition: agora_service_i.h:65
agora::base::IAgoraServiceEx::createRtcConnectionEx
virtual agora_refptr< rtc::IRtcConnection > createRtcConnectionEx(const rtc::RtcConnectionConfigurationEx &cfg)=0
agora::base::IAgoraServiceEx::registerLocalUserAccount
virtual int registerLocalUserAccount(const char *appId, const char *userAccount)=0
agora::base::IAgoraServiceEx::getOneRtcConnection
virtual agora_refptr< rtc::IRtcConnection > getOneRtcConnection(bool admBinded) const =0
agora::base::IAgoraServiceEx::enableStringUid
virtual void enableStringUid(bool enabled)=0
agora::base::MEDIA_ENGINE_UNKNOWN
@ MEDIA_ENGINE_UNKNOWN
Definition: agora_service_i.h:56
agora::media::CONTENT_INSPECT_CLOUD_TYPE
CONTENT_INSPECT_CLOUD_TYPE
Definition: content_inspect_i.h:35
agora::base::IAgoraServiceEx::getUidByUserAccount
virtual rtc::uid_t getUidByUserAccount(const std::string &app_id, const std::string &user_account) const =0
agora::rtc::uid_t
unsigned int uid_t
Definition: AgoraMediaBase.h:29
agora::base::AgoraServiceConfigEx::bitrateConstraints
rtc::BitrateConstraints bitrateConstraints
Definition: agora_service_i.h:67
agora::base::AgoraServiceConfigEx::apSendRequest
bool apSendRequest
Definition: agora_service_i.h:68
rtc
Definition: video_node_i.h:26
agora::base::IAgoraServiceEx::registerAgoraServiceObserver
virtual int registerAgoraServiceObserver(IAgoraServiceObserver *observer)=0
agora::base::IAgoraServiceEx::createFileUploadServiceEx
virtual agora_refptr< rtc::IFileUploaderService > createFileUploadServiceEx(agora_refptr< rtc::IRtcConnection > rtcConnection, const char *appId, media::CONTENT_INSPECT_CLOUD_TYPE cloudType)=0