Windows SDK API Reference
Loading...
Searching...
No Matches
meeting_breakout_rooms_interface_v2.h
Go to the documentation of this file.
1
56#ifndef _MEETING_BREAKOUT_ROOMS_INTERFACE2_H_
57#define _MEETING_BREAKOUT_ROOMS_INTERFACE2_H_
58#include "zoom_sdk_def.h"
59
61
62typedef enum
63{
69
70typedef enum
71{
77
81{
82public:
83 virtual ~IBOMeeting() {}
84
86 virtual const wchar_t* GetBOID() = 0;
87
89 virtual const wchar_t* GetBOName() = 0;
90
94};
95
100{
101public:
102 virtual ~IBOCreatorEvent() {}
103
106 virtual void onBOCreateSuccess(const wchar_t* strBOID) = 0;
107};
108
111{
118};
119
122{
129 unsigned int nTimerDuration;
130
132 {
137 IsBOTimerEnabled = false;
139 nTimerDuration = 0;
140 }
141};
142
146{
147public:
153
159 virtual bool AddNewBoToList(const wchar_t* strNewBOName) = 0;
160
166};
167
171{
172public:
173
174 virtual void SetEvent(IBOCreatorEvent* pEvent) = 0;
175
179 virtual const wchar_t* CreateBO(const wchar_t* strBOName) = 0;
180
185 virtual bool UpdateBOName(const wchar_t* strBOID, const wchar_t* strNewBOName) = 0;
186
190 virtual bool RemoveBO(const wchar_t* strBOID) = 0;
191
196 virtual bool AssignUserToBO(const wchar_t* strUserID, const wchar_t* strBOID) = 0;
197
202 virtual bool RemoveUserFromBO(const wchar_t* strUserID, const wchar_t* strBOID) = 0;
203
207 virtual bool SetBOOption(const BOOption& option) = 0;
208
212 virtual bool GetBOOption(BOOption& option) = 0;
213
217};
218
221{
231
235{
236public:
237
238 virtual ~IBOAdminEvent() {}
239
242 virtual void onHelpRequestReceived(const wchar_t* strUserID) = 0;
243
246 virtual void onStartBOError(BOControllerError errCode) = 0;
247
250 virtual void onBOEndTimerUpdated(int remaining, bool isTimesUpNotice) = 0;
251};
252
256{
257public:
260 virtual bool StartBO() = 0;
261
264 virtual bool StopBO() = 0;
265
268 virtual bool AssignNewUserToRunningBO(const wchar_t* strUserID, const wchar_t* strBOID) = 0;
269
272 virtual bool SwitchAssignedUserToRunningBO(const wchar_t* strUserID, const wchar_t* strBOID) = 0;
273
276 virtual bool CanStartBO() = 0;
277
280 virtual void SetEvent(IBOAdminEvent* pEvent) = 0;
281
284 virtual bool JoinBOByUserRequest(const wchar_t* strUserID) = 0;
285
288 virtual bool IgnoreUserHelpRequest(const wchar_t* strUserID) = 0;
289
292 virtual bool BroadcastMessage(const wchar_t* strMsg) = 0;
293
296 virtual bool InviteBOUserReturnToMainSession(const wchar_t* strUserID) = 0;
297};
298
300
304{
305public:
308 virtual bool JoinBO(const wchar_t* strBOID) = 0;
309
312 virtual bool LeaveBO() = 0;
313};
314
316
320{
321public:
322
323 virtual ~IBOAttendeeEvent() {}
324
328
330 virtual void onHostJoinedThisBOMeeting() = 0;
331
333 virtual void onHostLeaveThisBOMeeting() = 0;
334};
338{
339public:
342 virtual bool JoinBo() = 0;
343
346 virtual bool LeaveBo() = 0;
347
349 virtual const wchar_t* GetBoName() = 0;
350
353 virtual void SetEvent(IBOAttendeeEvent* pEvent) = 0;
354
357 virtual bool RequestForHelp() = 0;
358
361 virtual bool IsHostInThisBO() = 0;
362
365 virtual bool IsCanReturnMainSession() = 0;
366};
367
369
373{
374public:
375 virtual ~IBODataEvent() {}
376
379 virtual void onBOInfoUpdated(const wchar_t* strBOID) = 0;
380
383 virtual void onUnAssignedUserUpdated() = 0;
384
388 virtual void OnBOListInfoUpdated() = 0;
389};
393{
394public:
397 virtual void SetEvent(IBODataEvent* pEvent) = 0;
398
403
408
411 virtual const wchar_t* GetBOUserName(const wchar_t* strUserID) = 0;
412
415 virtual BO_CTRL_USER_STATUS GetBOUserStatus(const wchar_t* strUserID) = 0;
416
419 virtual bool IsBOUserMyself(const wchar_t* strUserID) = 0;
420
424 virtual IBOMeeting* GetBOMeetingByID(const wchar_t* strBOID) = 0;
425
428 virtual const wchar_t* GetCurrentBoName() = 0;
429};
430
432
435{
440 BO_STATUS_ENDED = 4
442
446{
447public:
449
452 virtual bool ReturnToMainSession() = 0;
453
455 virtual void Ignore() = 0;
456};
457
461{
462public:
464
467 virtual void onHasCreatorRightsNotification(IBOCreator* pCreatorObj) = 0;
468
471 virtual void onHasAdminRightsNotification(IBOAdmin* pAdminObj) = 0;
472
475 virtual void onHasAssistantRightsNotification(IBOAssistant* pAssistantObj) = 0;
476
479 virtual void onHasAttendeeRightsNotification(IBOAttendee* pAttendeeObj) = 0;
480
483 virtual void onHasDataHelperRightsNotification(IBOData* pDataHelperObj) = 0;
484
487
490
493
496
499
503 virtual void onNewBroadcastMessageReceived(const wchar_t* strMsg, unsigned int nSenderID) = 0;
504
507 virtual void onBOStopCountDown(unsigned int nSeconds) = 0;
508
511 virtual void onHostInviteReturnToMainSession(const wchar_t* strName, IReturnToMainSessionHandler* handler) = 0;
512
515 virtual void onBOStatusChanged(BO_STATUS eStatus) = 0;
516
520 virtual void onBOSwitchRequestReceived(const wchar_t* strNewBOName, const wchar_t* strNewBOID) = 0;
521};
522
526{
527public:
531 virtual bool SetEvent(IMeetingBOControllerEvent* event) = 0;
532
537
542
547
552
556 virtual IBOData* GetBODataHelper() = 0;
557
560 virtual bool IsBOStarted() = 0;
561
564 virtual bool IsBOEnabled() = 0;
565
568 virtual bool IsInBOMeeting() = 0;
569
572 virtual BO_STATUS GetBOStatus() = 0;
573};
574
576#endif
BO admin callback handler.
virtual void onStartBOError(BOControllerError errCode)=0
when StartBO fail, you will receive the event.
virtual void onHelpRequestReceived(const wchar_t *strUserID)=0
when someone send the request help, notify it.
virtual void onBOEndTimerUpdated(int remaining, bool isTimesUpNotice)=0
if it's timer BO, after start BO, you will receive the event.
virtual bool SwitchAssignedUserToRunningBO(const wchar_t *strUserID, const wchar_t *strBOID)=0
To Switch user to other BO, when BO is started.
virtual bool JoinBOByUserRequest(const wchar_t *strUserID)=0
To join the BO which request help is from.
virtual bool StartBO()=0
start BO.
virtual bool IgnoreUserHelpRequest(const wchar_t *strUserID)=0
To ignore the request help.
virtual bool BroadcastMessage(const wchar_t *strMsg)=0
To send the broadcast message.
virtual bool StopBO()=0
stop BO.
virtual bool CanStartBO()=0
Determine if can start BO.
virtual void SetEvent(IBOAdminEvent *pEvent)=0
Set admin callback handler.
virtual bool InviteBOUserReturnToMainSession(const wchar_t *strUserID)=0
Host invite user return to main session, When BO is started and user is in BO.
virtual bool AssignNewUserToRunningBO(const wchar_t *strUserID, const wchar_t *strBOID)=0
To set a unassigned user to a BO, when BO is started.
virtual bool JoinBO(const wchar_t *strBOID)=0
Join BO by BO ID.
virtual bool LeaveBO()=0
leave BO
attendee callback handler.
virtual void onHelpRequestHandleResultReceived(ATTENDEE_REQUEST_FOR_HELP_RESULT eResult)=0
To notify the status of request help.
virtual void onHostLeaveThisBOMeeting()=0
To notify if host has leaved the BO.
virtual void onHostJoinedThisBOMeeting()=0
To notify if host has joined the BO.
virtual bool LeaveBo()=0
Leave BO for attendee which is in a BO.
virtual void SetEvent(IBOAttendeeEvent *pEvent)=0
Set attendee callback handler.
virtual bool IsCanReturnMainSession()=0
Determine if participant can return to main session.
virtual const wchar_t * GetBoName()=0
Get name of the BO that attendee is assigned to.
virtual bool IsHostInThisBO()=0
Determine if host is in the BO which attendee is assigned to.
virtual bool RequestForHelp()=0
Request help for attendee.
virtual bool JoinBo()=0
Join BO for attendee which is assigned to a BO.
BO creator callback handler.
virtual void onBOCreateSuccess(const wchar_t *strBOID)=0
If CreateBO successfully, you will receive the event. Make sure you receive the event before start bo...
virtual bool RemoveUserFromBO(const wchar_t *strUserID, const wchar_t *strBOID)=0
Remove some user from a BO.
virtual IBatchCreateBOHelper * GetBatchCreateBOHelper()=0
Get the Batch create bo controller.
virtual bool SetBOOption(const BOOption &option)=0
Set BO option.
virtual bool GetBOOption(BOOption &option)=0
Get BO option.
virtual bool AssignUserToBO(const wchar_t *strUserID, const wchar_t *strBOID)=0
Assign a user to a BO.
virtual bool RemoveBO(const wchar_t *strBOID)=0
Remove a BO.
virtual void SetEvent(IBOCreatorEvent *pEvent)=0
virtual const wchar_t * CreateBO(const wchar_t *strBOName)=0
Create a BO.
virtual bool UpdateBOName(const wchar_t *strBOID, const wchar_t *strNewBOName)=0
Update BO name.
BO data callback handler.
virtual void onUnAssignedUserUpdated()=0
To notify if unassigned user join/leave master conference or name is modified. once you receive the c...
virtual void OnBOListInfoUpdated()=0
Host/CoHost both can edit BO, Host edit BO->start BO->stop BO, then CoHost edit BO->start BO,...
virtual void onBOInfoUpdated(const wchar_t *strBOID)=0
To notify if some BO information is changed(user join/leave BO or BO name is modified)
virtual IBOMeeting * GetBOMeetingByID(const wchar_t *strBOID)=0
Get BO object by BO ID.
virtual bool IsBOUserMyself(const wchar_t *strUserID)=0
Determine if strUserID is myself.
virtual const wchar_t * GetCurrentBoName()=0
Get current BO name if you in a BO.
virtual IList< const wchar_t * > * GetUnassginedUserList()=0
Get the id list of all unassigned users.
virtual IList< const wchar_t * > * GetBOMeetingIDList()=0
Get the id list of all BOs.
virtual const wchar_t * GetBOUserName(const wchar_t *strUserID)=0
Get user name by user ID.
virtual BO_CTRL_USER_STATUS GetBOUserStatus(const wchar_t *strUserID)=0
Get user status by user ID.
virtual void SetEvent(IBODataEvent *pEvent)=0
Set BO data callback handler.
virtual IList< const wchar_t * > * GetBOUserList()=0
Get user ID list in the BO.
virtual const wchar_t * GetBOName()=0
Get BO name.
virtual const wchar_t * GetBOID()=0
Get BO ID.
Batch Creater BO helper interface.
virtual SDKError CreateBoTransactionCommit()=0
Batch create BO rooms according to the prepare list.
virtual bool AddNewBoToList(const wchar_t *strNewBOName)=0
Add the BO name to a prepared list.
virtual SDKError CreateBOTransactionBegin()=0
Prepare to batch create BO rooms.
BO controller callback event handler.
virtual void onHasCreatorRightsNotification(IBOCreator *pCreatorObj)=0
To notify that you has creator right.
virtual void onHasDataHelperRightsNotification(IBOData *pDataHelperObj)=0
To notify that you has data right.
virtual void onNewBroadcastMessageReceived(const wchar_t *strMsg, unsigned int nSenderID)=0
To notify that you receive a broadcast message.
virtual void onLostDataHelperRightsNotification()=0
To notify that you lost data right.
virtual void onLostAttendeeRightsNotification()=0
To notify that you lost attendee right.
virtual void onLostCreatorRightsNotification()=0
To notify that you lost creator right.
virtual void onBOStatusChanged(BO_STATUS eStatus)=0
When host change the BO status, all users receive the event.
virtual void onBOSwitchRequestReceived(const wchar_t *strNewBOName, const wchar_t *strNewBOID)=0
Whenever the host switches you to another BO while you are assigned but haven't joined the BO,...
virtual void onHostInviteReturnToMainSession(const wchar_t *strName, IReturnToMainSessionHandler *handler)=0
When you are in BO, host invite you return to main session, you will receive the event.
virtual void onBOStopCountDown(unsigned int nSeconds)=0
When BOOption.countdown_seconds != BO_STOP_NOT_COUNTDOWN, host stop BO and all users receive the even...
virtual void onHasAssistantRightsNotification(IBOAssistant *pAssistantObj)=0
To notify that you has assistant right.
virtual void onLostAdminRightsNotification()=0
To notify that you lost admin right.
virtual void onLostAssistantRightsNotification()=0
To notify that you lost assistant right.
virtual void onHasAttendeeRightsNotification(IBOAttendee *pAttendeeObj)=0
To notify that you has attendee right.
virtual void onHasAdminRightsNotification(IBOAdmin *pAdminObj)=0
To notify that you has admin right.
Meeting breakout rooms controller interface.
virtual IBOAssistant * GetBOAssistantHelper()=0
Get the pointer of BO assistant object.
virtual IBOAdmin * GetBOAdminHelper()=0
Get the pointer of BO administrator object.
virtual IBOCreator * GetBOCreatorHelper()=0
Get the pointer of BO creator object.
virtual IBOAttendee * GetBOAttedeeHelper()=0
Get the pointer of BO attendee object.
virtual BO_STATUS GetBOStatus()=0
Get current BO status.
virtual bool IsInBOMeeting()=0
Determine if myself is in BO meeting.
virtual bool IsBOStarted()=0
Determine if the BO is started or not.
virtual IBOData * GetBODataHelper()=0
Get the pointer of BO data object.
virtual bool SetEvent(IMeetingBOControllerEvent *event)=0
Set breakout room callback event handler.
virtual bool IsBOEnabled()=0
Determine if the BO feature is enabled in current meeting.
handler for return to main session.
virtual bool ReturnToMainSession()=0
return to main session.
virtual void Ignore()=0
Ignore the return invitation, after call 'Ignore()', please don't use the handler unless you receive ...
@ ATTENDEE_REQUEST_FOR_HELP_RESULT_HOST_ALREADY_IN_BO
host already in your BO meeting
@ ATTENDEE_REQUEST_FOR_HELP_RESULT_IDLE
host receive the help request and there is no other one currently requesting for help
@ ATTENDEE_REQUEST_FOR_HELP_RESULT_IGNORE
host click "later" button or close the request dialog directly
@ ATTENDEE_REQUEST_FOR_HELP_RESULT_BUSY
host is handling other's request with the request dialog
@ BO_CTRL_USER_STATUS_UNASSIGNED
User is in main conference, not assigned to BO.
@ BO_CTRL_USER_STATUS_UNKNOWN
Unknown status.
@ BO_CTRL_USER_STATUS_IN_BO
User is already in BO.
@ BO_CTRL_USER_STATUS_ASSIGNED_NOT_JOIN
User is assigned to BO, but not join.
BO_STOP_COUNTDOWN
enum for BO stop countdown
BO_STATUS
enum for BO status
@ BO_STATUS_EDIT
edit & assign
@ BO_STATUS_STARTED
BO is started.
@ BO_STATUS_STOPPING
stopping BO
@ BO_STATUS_ENDED
BO is ended.
@ BOControllerError_NO_ONE_HAS_BEEN_ASSIGNED
bool IsTimerAutoStopBOEnabled
true: if time is up, will stop BO auto. false: don't auto stop.
bool IsAutoMoveAllAssignedParticipantsEnabled
Enable/Disable that auto move all assigned participants to breakout room.
BO_STOP_COUNTDOWN countdown_seconds
Set the countdown after closing breakout room.
unsigned int nTimerDuration
seconds of BO timer duration, NOTE: when nTimerDuration is 0, it means that the BO duration is 30*60 ...
bool IsParticipantCanReturnToMainSessionAtAnyTime
Enable/Disable that participant can return to main session at any time.
bool IsParticipantCanChooseBO
Enable/Disable that participant can choose breakout room.
bool IsBOTimerEnabled
true: it's timer BO false: not timer BO
ZOOM windows SDK Common Definition File.
#define END_ZOOM_SDK_NAMESPACE
Definition: zoom_sdk_def.h:21
#define BEGIN_ZOOM_SDK_NAMESPACE
Definition: zoom_sdk_def.h:20
SDKError
SDK error types. Here are more detailed structural descriptions.
Definition: zoom_sdk_def.h:30