Documentation
Interactive Live Streaming Premium (Legacy)
Agora C++ API Reference for All Platforms
Index
IRtcEngine
IRtcEngineEventHandler
IChannel
IChannelEventHandler
IAudioDeviceManager
IVideoDeviceManager
Warning Codes
Error Codes
Inherits agora::rtc::IRtcEngine.
Public Member Functions | |
| virtual IChannel * | createChannel (const char *channelId)=0 |
 Public Member Functions inherited from agora::rtc::IRtcEngine | |
| virtual int | initialize (const RtcEngineContext &context)=0 |
| virtual void | release (bool sync=false)=0 |
| virtual int | setChannelProfile (CHANNEL_PROFILE_TYPE profile)=0 |
| virtual int | setClientRole (CLIENT_ROLE_TYPE role)=0 |
| virtual int | joinChannel (const char *token, const char *channelId, const char *info, uid_t uid)=0 |
| virtual int | switchChannel (const char *token, const char *channelId)=0 |
| virtual int | leaveChannel ()=0 |
| virtual int | renewToken (const char *token)=0 |
| virtual int | queryInterface (INTERFACE_ID_TYPE iid, void **inter)=0 |
| virtual int | registerLocalUserAccount (const char *appId, const char *userAccount)=0 |
| virtual int | joinChannelWithUserAccount (const char *token, const char *channelId, const char *userAccount)=0 |
| virtual int | getUserInfoByUserAccount (const char *userAccount, UserInfo *userInfo)=0 |
| virtual int | getUserInfoByUid (uid_t uid, UserInfo *userInfo)=0 |
| virtual int | startEchoTest ()=0 |
| virtual int | startEchoTest (int intervalInSeconds)=0 |
| virtual int | stopEchoTest ()=0 |
| virtual int | enableVideo ()=0 |
| virtual int | disableVideo ()=0 |
| virtual int | setVideoProfile (VIDEO_PROFILE_TYPE profile, bool swapWidthAndHeight)=0 |
| virtual int | setVideoEncoderConfiguration (const VideoEncoderConfiguration &config)=0 |
| virtual int | setCameraCapturerConfiguration (const CameraCapturerConfiguration &config)=0 |
| virtual int | setupLocalVideo (const VideoCanvas &canvas)=0 |
| virtual int | setupRemoteVideo (const VideoCanvas &canvas)=0 |
| virtual int | startPreview ()=0 |
| virtual int | setRemoteUserPriority (uid_t uid, PRIORITY_TYPE userPriority)=0 |
| virtual int | stopPreview ()=0 |
| virtual int | enableAudio ()=0 |
| virtual int | enableLocalAudio (bool enabled)=0 |
| virtual int | disableAudio ()=0 |
| virtual int | setAudioProfile (AUDIO_PROFILE_TYPE profile, AUDIO_SCENARIO_TYPE scenario)=0 |
| virtual int | muteLocalAudioStream (bool mute)=0 |
| virtual int | muteAllRemoteAudioStreams (bool mute)=0 |
| virtual int | setDefaultMuteAllRemoteAudioStreams (bool mute)=0 |
| virtual int | adjustUserPlaybackSignalVolume (unsigned int uid, int volume)=0 |
| virtual int | muteRemoteAudioStream (uid_t userId, bool mute)=0 |
| virtual int | muteLocalVideoStream (bool mute)=0 |
| virtual int | enableLocalVideo (bool enabled)=0 |
| virtual int | muteAllRemoteVideoStreams (bool mute)=0 |
| virtual int | setDefaultMuteAllRemoteVideoStreams (bool mute)=0 |
| virtual int | muteRemoteVideoStream (uid_t userId, bool mute)=0 |
| virtual int | setRemoteVideoStreamType (uid_t userId, REMOTE_VIDEO_STREAM_TYPE streamType)=0 |
| virtual int | setRemoteDefaultVideoStreamType (REMOTE_VIDEO_STREAM_TYPE streamType)=0 |
| virtual int | enableAudioVolumeIndication (int interval, int smooth, bool report_vad)=0 |
| virtual int | startAudioRecording (const char *filePath, AUDIO_RECORDING_QUALITY_TYPE quality)=0 |
| virtual int | startAudioRecording (const char *filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality)=0 |
| virtual int | stopAudioRecording ()=0 |
| virtual int | startAudioMixing (const char *filePath, bool loopback, bool replace, int cycle)=0 |
| virtual int | stopAudioMixing ()=0 |
| virtual int | pauseAudioMixing ()=0 |
| virtual int | resumeAudioMixing ()=0 |
| virtual int | setHighQualityAudioParameters (bool fullband, bool stereo, bool fullBitrate)=0 |
| virtual int | adjustAudioMixingVolume (int volume)=0 |
| virtual int | adjustAudioMixingPlayoutVolume (int volume)=0 |
| virtual int | getAudioMixingPlayoutVolume ()=0 |
| virtual int | adjustAudioMixingPublishVolume (int volume)=0 |
| virtual int | getAudioMixingPublishVolume ()=0 |
| virtual int | getAudioMixingDuration ()=0 |
| virtual int | getAudioMixingCurrentPosition ()=0 |
| virtual int | setAudioMixingPosition (int pos)=0 |
| virtual int | getEffectsVolume ()=0 |
| virtual int | setEffectsVolume (int volume)=0 |
| virtual int | setVolumeOfEffect (int soundId, int volume)=0 |
| virtual int | playEffect (int soundId, const char *filePath, int loopCount, double pitch, double pan, int gain, bool publish=false)=0 |
| virtual int | stopEffect (int soundId)=0 |
| virtual int | stopAllEffects ()=0 |
| virtual int | preloadEffect (int soundId, const char *filePath)=0 |
| virtual int | unloadEffect (int soundId)=0 |
| virtual int | pauseEffect (int soundId)=0 |
| virtual int | pauseAllEffects ()=0 |
| virtual int | resumeEffect (int soundId)=0 |
| virtual int | resumeAllEffects ()=0 |
| virtual int | enableSoundPositionIndication (bool enabled)=0 |
| virtual int | setRemoteVoicePosition (uid_t uid, double pan, double gain)=0 |
| virtual int | setLocalVoicePitch (double pitch)=0 |
| virtual int | setLocalVoiceEqualization (AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain)=0 |
| virtual int | setLocalVoiceReverb (AUDIO_REVERB_TYPE reverbKey, int value)=0 |
| virtual int | setLocalVoiceChanger (VOICE_CHANGER_PRESET voiceChanger)=0 |
| virtual int | setLocalVoiceReverbPreset (AUDIO_REVERB_PRESET reverbPreset)=0 |
| virtual int | setLogFile (const char *filePath)=0 |
| virtual int | setLogFilter (unsigned int filter)=0 |
| virtual int | setLogFileSize (unsigned int fileSizeInKBytes)=0 |
| virtual int | setLocalRenderMode (RENDER_MODE_TYPE renderMode)=0 |
| virtual int | setLocalRenderMode (RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode)=0 |
| virtual int | setRemoteRenderMode (uid_t userId, RENDER_MODE_TYPE renderMode)=0 |
| virtual int | setRemoteRenderMode (uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode)=0 |
| virtual int | setLocalVideoMirrorMode (VIDEO_MIRROR_MODE_TYPE mirrorMode)=0 |
| virtual int | enableDualStreamMode (bool enabled)=0 |
| virtual int | setExternalAudioSource (bool enabled, int sampleRate, int channels)=0 |
| virtual int | setExternalAudioSink (bool enabled, int sampleRate, int channels)=0 |
| virtual int | setRecordingAudioFrameParameters (int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall)=0 |
| virtual int | setPlaybackAudioFrameParameters (int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall)=0 |
| virtual int | setMixedAudioFrameParameters (int sampleRate, int samplesPerCall)=0 |
| virtual int | adjustRecordingSignalVolume (int volume)=0 |
| virtual int | adjustPlaybackSignalVolume (int volume)=0 |
| virtual int | enableWebSdkInteroperability (bool enabled)=0 |
| virtual int | setVideoQualityParameters (bool preferFrameRateOverImageQuality)=0 |
| virtual int | setLocalPublishFallbackOption (STREAM_FALLBACK_OPTIONS option)=0 |
| virtual int | setRemoteSubscribeFallbackOption (STREAM_FALLBACK_OPTIONS option)=0 |
| virtual int | switchCamera ()=0 |
| virtual int | setDefaultAudioRouteToSpeakerphone (bool defaultToSpeaker)=0 |
| virtual int | setEnableSpeakerphone (bool speakerOn)=0 |
| virtual int | enableInEarMonitoring (bool enabled)=0 |
| virtual int | setInEarMonitoringVolume (int volume)=0 |
| virtual bool | isSpeakerphoneEnabled ()=0 |
| virtual int | setAudioSessionOperationRestriction (AUDIO_SESSION_OPERATION_RESTRICTION restriction)=0 |
| virtual int | enableLoopbackRecording (bool enabled, const char *deviceName=NULL)=0 |
| virtual int | startScreenCaptureByDisplayId (unsigned int displayId, const Rectangle ®ionRect, const ScreenCaptureParameters &captureParams)=0 |
| virtual int | startScreenCaptureByScreenRect (const Rectangle &screenRect, const Rectangle ®ionRect, const ScreenCaptureParameters &captureParams)=0 |
| virtual int | startScreenCaptureByWindowId (view_t windowId, const Rectangle ®ionRect, const ScreenCaptureParameters &captureParams)=0 |
| virtual int | setScreenCaptureContentHint (VideoContentHint contentHint)=0 |
| virtual int | updateScreenCaptureParameters (const ScreenCaptureParameters &captureParams)=0 |
| virtual int | updateScreenCaptureRegion (const Rectangle ®ionRect)=0 |
| virtual int | stopScreenCapture ()=0 |
| virtual int | startScreenCapture (WindowIDType windowId, int captureFreq, const Rect *rect, int bitrate)=0 |
| virtual int | updateScreenCaptureRegion (const Rect *rect)=0 |
| virtual int | getCallId (agora::util::AString &callId)=0 |
| virtual int | rate (const char *callId, int rating, const char *description)=0 |
| virtual int | complain (const char *callId, const char *description)=0 |
| virtual const char * | getVersion (int *build)=0 |
| virtual int | enableLastmileTest ()=0 |
| virtual int | disableLastmileTest ()=0 |
| virtual int | startLastmileProbeTest (const LastmileProbeConfig &config)=0 |
| virtual int | stopLastmileProbeTest ()=0 |
| virtual const char * | getErrorDescription (int code)=0 |
| virtual int | setEncryptionSecret (const char *secret)=0 |
| virtual int | setEncryptionMode (const char *encryptionMode)=0 |
| virtual int | registerPacketObserver (IPacketObserver *observer)=0 |
| virtual int | createDataStream (int *streamId, bool reliable, bool ordered)=0 |
| virtual int | sendStreamMessage (int streamId, const char *data, size_t length)=0 |
| virtual int | addPublishStreamUrl (const char *url, bool transcodingEnabled)=0 |
| virtual int | removePublishStreamUrl (const char *url)=0 |
| virtual int | setLiveTranscoding (const LiveTranscoding &transcoding)=0 |
| virtual int | addVideoWatermark (const RtcImage &watermark)=0 |
| virtual int | addVideoWatermark (const char *watermarkUrl, const WatermarkOptions &options)=0 |
| virtual int | clearVideoWatermarks ()=0 |
| virtual int | setBeautyEffectOptions (bool enabled, BeautyOptions options)=0 |
| virtual int | addInjectStreamUrl (const char *url, const InjectStreamConfig &config)=0 |
| virtual int | startChannelMediaRelay (const ChannelMediaRelayConfiguration &configuration)=0 |
| virtual int | updateChannelMediaRelay (const ChannelMediaRelayConfiguration &configuration)=0 |
| virtual int | stopChannelMediaRelay ()=0 |
| virtual int | removeInjectStreamUrl (const char *url)=0 |
| virtual bool | registerEventHandler (IRtcEngineEventHandler *eventHandler)=0 |
| virtual bool | unregisterEventHandler (IRtcEngineEventHandler *eventHandler)=0 |
| virtual CONNECTION_STATE_TYPE | getConnectionState ()=0 |
| virtual int | registerMediaMetadataObserver (IMetadataObserver *observer, IMetadataObserver::METADATA_TYPE type)=0 |
| virtual int | setParameters (const char *parameters)=0 |
Additional Inherited Members | |
| Public Types inherited from agora::rtc::IRtcEngine | |
| typedef unsigned int | WindowIDType |
| typedef HWND | WindowIDType |
| Protected Member Functions inherited from agora::rtc::IRtcEngine | |
| virtual | ~IRtcEngine () |
Detailed Description
- Since
- v3.0.0
The IRtcEngine2 class.
Member Function Documentation
◆ createChannel()
|
pure virtual |
Creates and gets an IChannel object.
To join more than one channel, call this method multiple times to create as many IChannel objects as needed, and call the joinChannel method of each created IChannel object.
After joining multiple channels, you can simultaneously subscribe to streams of all the channels, but publish a stream in only one channel at one time.
- Parameters
-
channelId The unique channel name for an Agora RTC session. It must be in the string format and not exceed 64 bytes in length. Supported character scopes are: - All lowercase English letters: a to z.
- All uppercase English letters: A to Z.
- All numeric characters: 0 to 9.
- The space character.
- Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",".
- Note
- This parameter does not have a default value. You must set it.
- Do not set it as the empty string "". Otherwise, the SDK returns
ERR_REFUSED (5).
- Returns
- The
IChannelobject, if the method call succeeds. - An empty pointer NULL, if the method call fails.
ERR_REFUSED(5), if you set channelId as the empty string "".
- The
