Meeting Class Methods
join()
- It is used to join a meeting.
- After meeting initialization by
initMeeting()
it returns a new instance of Meeting. However by default, it will not automatically join the meeting. Hence, to join the meeting you should calljoin()
.
Events associated with join()
:
- Local Participant will receive a
onMeetingJoined
event, when successfully joined. - Remote Participant will receive a
onParticipantJoined
event with the newly joinedParticipant
object from the event callback.
Participant having ask_join
permission inside token
If a token contains the permission
ask_join
, then the participant will not join the meeting directly after callingjoin()
, but an event will be emitted to the participant having the permissionallow_join
calledonEntryRequested
.After the decision from the remote participant, an event will be emitted to participant called
onEntryResponded
. This event will contain the decision made by the remote participant.
Participant having allow_join
permission inside token
- If a token containing the permission
allow_join
, then the participant will join the meeting directly after callingjoin()
.
Returns
void
leave()
- It is used to leave the current meeting.
Events associated with leave()
:
- Local participant will receive a
onMeetingLeft
event. - All remote participants will receive a
onParticipantLeft
event withparticipantId
.
Returns
void
end()
- It is used to end the current running session.
- By calling
end()
, all joined participants including localParticipant of that session will leave the meeting.
Events associated with end()
:
- All participants and localParticipant, will be emitted
onMeetingLeft
event.
Returns
void
enableWebcam()
- It is used to enable self camera.
onStreamEnabled
event ofParticipantEventListener
will be emitted withstream
object from the event callback.
Returns
void
disableWebcam()
- It is used to disable self camera.
onStreamDisabled
event ofParticipantEventListener
will be emitted withstream
object from the event callback.
Returns
void
unmuteMic()
- It is used to enable self microphone.
onStreamEnabled
event ofParticipantEventListener
will be emitted withstream
object from the event callback.
Returns
void
muteMic()
- It is used to disable self microphone.
onStreamDisabled
event ofParticipantEventListener
will be emitted withstream
object from the event callback.
Returns
void
enableScreenShare()
it is used to enable screen-sharing.
onStreamEnabled
event ofParticipantEventListener
will be emitted withstream
object from the event callback.onPresenterChanged()
event will be trigget to all participant withparticipantId
.
Parameters
- data: Intent
Returns
void
disableScreenShare()
It is used to disable screen-sharing.
onStreamDisabled
event ofParticipantEventListener
will be emitted withstream
object from the event callback.onPresenterChanged()
event will be trigget to all participant withnull
.
Returns
void
startRecording()
startRecording
is used to start meeting recording.webhookUrl
will be triggered when the recording is completed and stored into server. Read more about webhooks here.awsDirPath
will be the path for the your S3 bucket where you want to store recordings to. To allow us to store recording in your S3 bucket, you will need to fill this form by providing the required values. VideoSDK AWS S3 Integrationconfig: mode
is used to either record video-and-audio both or only audio. And by default it will be video-and-audio.config: quality
is only applicable to video-and-audio.
Parameters
- webhookUrl: String
- awsDirPath: String
- config:
- layout:
- type: "GRID" | "SPOTLIGHT" | "SIDEBAR"
- priority: "SPEAKER" | "PIN"
- gridSize: Number
max 4
- theme: "DARK" | "LIGHT" | "DEFAULT"
- mode: "video-and-audio" | "audio"
- quality: "low" | "med" | "high"
- orientation: "landscape" | "portrait"
- layout:
Returns
void
Events associated with startRecording()
:
- Every participant will receive a callback on
onRecordingStateChanged()
Example
- Kotlin
- Java
val webhookUrl = "https://webhook.your-api-server.com"
var config = JSONObject()
var layout = JSONObject()
JsonUtils.jsonPut(layout, "type", "SPOTLIGHT")
JsonUtils.jsonPut(layout, "priority", "PIN")
JsonUtils.jsonPut(layout, "gridSize", 9)
JsonUtils.jsonPut(config, "layout", layout)
JsonUtils.jsonPut(config, "theme", "DARK")
meeting!!.startRecording(webhookUrl,null,config)
String webhookUrl = "https://webhook.your-api-server.com";
JSONObject config = new JSONObject();
JSONObject layout = new JSONObject();
JsonUtils.jsonPut(layout, "type", "SPOTLIGHT");
JsonUtils.jsonPut(layout, "priority", "PIN");
JsonUtils.jsonPut(layout, "gridSize", 9);
JsonUtils.jsonPut(config, "layout", layout);
JsonUtils.jsonPut(config, "theme", "DARK");
meeting.startRecording(webhookUrl,null,config);
stopRecording()
- It is used to stop meeting recording.
Returns
void
Events associated with stopRecording()
:
- Every participant will receive a callback on
onRecordingStateChanged()
Example
- Kotlin
- Java
meeting!!.stopRecording()
meeting.stopRecording();
startLivestream()
startLiveStream()
is used to start meeting livestreaming.You will be able to start live stream meetings to other platforms such as Youtube, Facebook, etc. that support
RTMP
streaming.
Parameters
- outputs:
List<LivestreamOutput>
- config:
- layout:
- type: "GRID" | "SPOTLIGHT" | "SIDEBAR"
- priority: "SPEAKER" | "PIN"
- gridSize: Number
max 25
- theme: "DARK" | "LIGHT" | "DEFAULT"
- layout:
Returns
void
Events associated with startLiveStream()
:
- Every participant will receive a callback on
onLivestreamStateChanged()
Example
- Kotlin
- Java
val YOUTUBE_RTMP_URL = "rtmp://a.rtmp.youtube.com/live2"
val YOUTUBE_RTMP_STREAM_KEY = "<STREAM_KEY>"
val outputs: MutableList<LivestreamOutput> = ArrayList()
outputs.add(LivestreamOutput(YOUTUBE_RTMP_URL, YOUTUBE_RTMP_STREAM_KEY))
var config = JSONObject()
var layout = JSONObject()
JsonUtils.jsonPut(layout, "type", "SPOTLIGHT")
JsonUtils.jsonPut(layout, "priority", "PIN")
JsonUtils.jsonPut(layout, "gridSize", 9)
JsonUtils.jsonPut(config, "layout", layout)
JsonUtils.jsonPut(config, "theme", "DARK")
meeting!!.startLivestream(outputs,config)
final String YOUTUBE_RTMP_URL = "rtmp://a.rtmp.youtube.com/live2";
final String YOUTUBE_RTMP_STREAM_KEY = "<STREAM_KEY>";
List<LivestreamOutput> outputs = new ArrayList<>();
outputs.add(new LivestreamOutput(YOUTUBE_RTMP_URL, YOUTUBE_RTMP_STREAM_KEY));
JSONObject config = new JSONObject();
JSONObject layout = new JSONObject();
JsonUtils.jsonPut(layout, "type", "SPOTLIGHT");
JsonUtils.jsonPut(layout, "priority", "PIN");
JsonUtils.jsonPut(layout, "gridSize", 9);
JsonUtils.jsonPut(config, "layout", layout);
JsonUtils.jsonPut(config, "theme", "DARK");
meeting.startLivestream(outputs,config);
stopLivestream()
- It is used to stop meeting livestreaming.
Returns
void
Events associated with stopLivestream()
:
- Every participant will receive a callback on
onLivestreamStateChanged()
Example
- Kotlin
- Java
meeting!!.stopLivestream()
meeting.stopLivestream();
startHls()
startHls()
will start HLS streaming of your meeting.You will be able to start HLS and watch the live stream of meeting over HLS.
mode
is used to either start hls streaming of video-and-audio both or only audio. And by default it will be video-and-audio.quality
is only applicable to video-and-audio.
Parameters
- config:
- layout:
- type: "GRID" | "SPOTLIGHT" | "SIDEBAR"
- priority: "SPEAKER" | "PIN"
- gridSize: Number
max 25
- theme: "DARK" | "LIGHT" | "DEFAULT"
- mode: "video-and-audio" | "audio"
- quality: "low" | "med" | "high"
- layout:
Returns
void
Events associated with startHls()
:
- Every participant will receive a callback on
onHlsStateChanged()
Example
- Kotlin
- Java
var config = JSONObject()
var layout = JSONObject()
JsonUtils.jsonPut(layout, "type", "SPOTLIGHT")
JsonUtils.jsonPut(layout, "priority", "PIN")
JsonUtils.jsonPut(layout, "gridSize", 9)
JsonUtils.jsonPut(config, "layout", layout)
JsonUtils.jsonPut(config, "orientation", "portrait")
JsonUtils.jsonPut(config, "theme", "DARK")
meeting!!.startHls(config)
JSONObject config = new JSONObject();
JSONObject layout = new JSONObject();
JsonUtils.jsonPut(layout, "type", "SPOTLIGHT");
JsonUtils.jsonPut(layout, "priority", "PIN");
JsonUtils.jsonPut(layout, "gridSize", 9);
JsonUtils.jsonPut(config, "layout", layout);
JsonUtils.jsonPut(config, "orientation", "portrait");
JsonUtils.jsonPut(config, "theme", "DARK");
meeting.startHls(config);
stopHls()
stopHls()
is used to stop the HLS streaming.
Returns
void
Events associated with stopHls()
:
- Every participant will receive a callback on
onHlsStateChanged()
Example
- Kotlin
- Java
meeting!!.stopHls()
meeting.stopHls();
changeMode()
- It is used to change the mode.
- You can toggle between the
CONFERENCE
andVIEWER
mode .CONFERENCE
: Both audio and video streams will be produced and consumed in this mode.VIEWER
: Audio and video streams will not be produced or consumed in this mode.
Parameters
- mode: String
Returns
void
Events associated with changeMode()
:
- Every participant will receive a callback on
onParticipantModeChanged()
Example
- Kotlin
- Java
meeting!!.changeMode("VIEWER")
meeting.changeMode("VIEWER");
getMics()
- It will return all connected mic devices.
Returns
Set<AppRTCAudioManager.AudioDevice>
Example
- Kotlin
- Java
val mics = meeting!!.mics
var mic: String
for (i in mics.indices) {
mic = mics.toTypedArray()[i].toString()
Toast.makeText(this, "Mic : $mic", Toast.LENGTH_SHORT).show()
}
Set<AppRTCAudioManager.AudioDevice> mics = meeting.getMics();
String mic;
for (int i = 0; i < mics.size(); i++) {
mic=mics.toArray()[i].toString();
Toast.makeText(this, "Mic : " + mic, Toast.LENGTH_SHORT).show();
}
changeMic()
- It is used to change the mic device.
- If multiple mic devices are connected, by using
changeMic()
one can change the mic device.
Parameters
- device: AppRTCAudioManager.AudioDevice
Returns
void
Example
- Kotlin
- Java
meeting!!.changeMic(AppRTCAudioManager.AudioDevice.BLUETOOTH)
meeting.changeMic(AppRTCAudioManager.AudioDevice.BLUETOOTH);
changeWebcam()
- It is used to change the camera mode.
Returns
void
Example
- Kotlin
- Java
meeting!!.changeWebcam()
meeting.changeWebcam();
setAudioDeviceChangeListener()
- When a Local participant changes the Mic,
AppRTCAudioManager.AudioManagerEvents()
is triggered which can be set by usingsetAudioDeviceChangeListener()
method.
Parameters
- audioManagerEvents: AppRTCAudioManager.AudioManagerEvents
Returns
void
Example
- Kotlin
- Java
meeting!!.setAudioDeviceChangeListener(object : AudioManagerEvents {
override fun onAudioDeviceChanged(
selectedAudioDevice: AppRTCAudioManager.AudioDevice,
availableAudioDevices: Set<AppRTCAudioManager.AudioDevice>
) {
when (selectedAudioDevice) {
AppRTCAudioManager.AudioDevice.BLUETOOTH ->
Toast.makeText(this@MainActivity, "Selected AudioDevice: BLUETOOTH", Toast.LENGTH_SHORT).show()
AppRTCAudioManager.AudioDevice.WIRED_HEADSET ->
Toast.makeText(this@MainActivity, "Selected AudioDevice: WIRED_HEADSET", Toast.LENGTH_SHORT).show()
AppRTCAudioManager.AudioDevice.SPEAKER_PHONE ->
Toast.makeText(this@MainActivity, "Selected AudioDevice: SPEAKER_PHONE", Toast.LENGTH_SHORT).show()
AppRTCAudioManager.AudioDevice.EARPIECE ->
Toast.makeText(this@MainActivity, "Selected AudioDevice: EARPIECE", Toast.LENGTH_SHORT).show()
}
}
})
meeting.setAudioDeviceChangeListener(new AppRTCAudioManager.AudioManagerEvents() {
@Override
public void onAudioDeviceChanged(AppRTCAudioManager.AudioDevice selectedAudioDevice, Set<AppRTCAudioManager.AudioDevice> availableAudioDevices) {
switch (selectedAudioDevice) {
case BLUETOOTH:
Toast.makeText(MainActivity.this, "Selected AudioDevice: BLUETOOTH", Toast.LENGTH_SHORT).show();
break;
case WIRED_HEADSET:
Toast.makeText(MainActivity.this, "Selected AudioDevice: WIRED_HEADSET", Toast.LENGTH_SHORT).show();
break;
case SPEAKER_PHONE:
Toast.makeText(MainActivity.this, "Selected AudioDevice: SPEAKER_PHONE", Toast.LENGTH_SHORT).show();
break;
case EARPIECE:
Toast.makeText(MainActivity.this, "Selected AudioDevice: EARPIECE", Toast.LENGTH_SHORT).show();
break;
}
}
});
addEventListener()
Parameters
- listener: MeetingEventListener
Returns
void
removeEventListener()
Parameters
- listener: MeetingEventListener
Returns
void
removeAllListeners()
Returns
void
Got a Question? Ask us on discord