meeting_configuration_interface.h

Go to the documentation of this file.

#ifndef _MEETING_Configuration_INTERFACE_H_
#define _MEETING_Configuration_INTERFACE_H_
#include "..\zoom_sdk_def.h"
#include "..\customized_resource_helper_interface.h"

BEGIN_ZOOM_SDK_NAMESPACE
class IMeetingPasswordAndScreenNameHandler
{
public:
    enum RequiredInfoType
    {
        REQUIRED_INFO_TYPE_NONE,
        REQUIRED_INFO_TYPE_Password, 
        REQUIRED_INFO_TYPE_Password4WrongPassword,
        REQUIRED_INFO_TYPE_PasswordAndScreenName,
        REQUIRED_INFO_TYPE_ScreenName,
        REQUIRED_INFO_TYPE_MeetingIDAndScreenName,
    };

    virtual RequiredInfoType GetRequiredInfoType() = 0;
 
    virtual bool InputMeetingPasswordAndScreenName(const wchar_t* meetingPassword, const wchar_t* screenName) = 0;

    virtual bool InputMeetingIDAndScreenName(const wchar_t* meetingID, const wchar_t* screenName) = 0;

    virtual bool InputMeetingScreenName(const wchar_t* screenName) = 0;

    virtual void Cancel() = 0;
    virtual ~IMeetingPasswordAndScreenNameHandler() {};
};

class IWebinarNeedRegisterHandler
{
public:
    enum WebinarNeedRegisterType
    {
        WebinarReg_NONE,
        WebinarReg_By_Register_Url,
        WebinarReg_By_Email_and_DisplayName,
    };

    virtual WebinarNeedRegisterType GetWebinarNeedRegisterType() = 0;
    virtual ~IWebinarNeedRegisterHandler() {};
};

class IWebinarNeedRegisterHandlerByUrl : public IWebinarNeedRegisterHandler
{
public:
    virtual const wchar_t* GetWebinarRegisterUrl() = 0;

    virtual void Release() = 0;
    virtual ~IWebinarNeedRegisterHandlerByUrl() {};
};

class IWebinarNeedRegisterHandlerByEmail : public IWebinarNeedRegisterHandler
{
public:
    virtual SDKError InputWebinarRegisterEmailAndScreenName(const wchar_t* email, const wchar_t* screenName) = 0;

    virtual void Cancel() = 0;
    virtual ~IWebinarNeedRegisterHandlerByEmail() {};
};

class IEndOtherMeetingToJoinMeetingHandler
{
public:
    virtual bool EndOtherMeeting() = 0;
    
    virtual void Cancel() = 0;
    virtual ~IEndOtherMeetingToJoinMeetingHandler() {};
};


class IFreeMeetingEndingReminderHandler
{
public:
    enum FreeMeetingEndingReminderType
    {
        FreeMeetingEndingReminder_NONE,
        FreeMeetingEndingReminder_Can_UpgradeMeeting_ToPro_Once,
        FreeMeetingEndingReminder_Can_UpgradeAccount,
        FreeMeetingEndingReminder_Reminder,
        FreeMeetingEndingReminder_UpgradeMeeting_ToPro_Failed,
        FreeMeetingEndingReminder_UpgradeMeeting_ToPro_Success,
    };

    virtual FreeMeetingEndingReminderType GetType() = 0;

    virtual SDKError UpgradeMeeting() = 0;

    virtual SDKError UpgradeAccount() = 0;

    virtual SDKError Cancel() = 0;
    virtual ~IFreeMeetingEndingReminderHandler() {};
};

enum SDKInviteDlgTabPage
{
    SDK_INVITEDLG_TAB_EMAILCONTACT = 0, 
    SDK_INVITEDLG_TAB_PHONECONTACT, 
    SDK_INVITEDLG_TAB_ROOMSYSTEM, 
};

enum SDKH323TabPage
{
    SDK_INVITEDLG_H323_DIALIN = 0, 
    SDK_INVITEDLG_H323_CALLOUT, 
};
class IMeetingConfigurationFreeMeetingEvent
{

public:
    enum FreeMeetingNeedUpgradeType
    {
        FreeMeetingNeedUpgradeType_NONE,
        FreeMeetingNeedUpgradeType_BY_ADMIN,
        FreeMeetingNeedUpgradeType_BY_GIFTURL,
    };
    virtual void onFreeMeetingRemainTime(unsigned int leftTime) = 0;
    virtual void onFreeMeetingRemainTimeStopCountDown() = 0;

    virtual void onFreeMeetingEndingReminderNotification(IFreeMeetingEndingReminderHandler* handler_) = 0;

    virtual void onFreeMeetingNeedToUpgrade(FreeMeetingNeedUpgradeType type_, const wchar_t* gift_url) =0;
    
    virtual void onFreeMeetingUpgradeToGiftFreeTrialStart() = 0;
    
    virtual void onFreeMeetingUpgradeToGiftFreeTrialStop() = 0;
    
    virtual void onFreeMeetingUpgradeToProMeeting() = 0;
};

class IMeetingConfigurationEvent : public IMeetingConfigurationFreeMeetingEvent
{
public:
    virtual void onInputMeetingPasswordAndScreenNameNotification(IMeetingPasswordAndScreenNameHandler* pHandler) = 0;

    virtual void onAirPlayInstructionWndNotification(bool bShow, const wchar_t* airhostName) = 0;

    virtual void onWebinarNeedRegisterNotification(IWebinarNeedRegisterHandler* handler_) = 0;

    virtual void onEndOtherMeetingToJoinMeetingNotification(IEndOtherMeetingToJoinMeetingHandler* handler_) = 0;
};

typedef struct tagRedirectWarningMsgOption
{
    bool bRedirectBadNetwork;
    bool bRedirectWarnHighCPU;
    tagRedirectWarningMsgOption()
    {
        bRedirectBadNetwork = false;
        bRedirectWarnHighCPU = false;
    }

}RedirectWarningMsgOption;


typedef struct tagPanelistMenuItemOption
{
    bool bNotShowDowngradePanelist;
    tagPanelistMenuItemOption()
    {
        bNotShowDowngradePanelist = false;
    }

}PanelistMenuItemOption;

typedef struct tagAttendeeMenuItemOption
{
    bool bNotShowPromoteToPanelist;
    tagAttendeeMenuItemOption()
    {
        bNotShowPromoteToPanelist = false;
    }

}AttendeeMenuItemOption;

class IMeetingUIElemConfiguration
{
public:
    virtual void SetMeetingUIPos(WndPosition pos) = 0;

    virtual void SetFloatVideoPos(WndPosition pos) = 0;

    virtual void SetSharingToolbarVisibility(bool bShow) = 0;

    virtual void SetBottomFloatToolbarWndVisibility(bool bShow) = 0;

    virtual void EnableApproveRemoteControlDlg(bool bEnable) = 0;

    virtual void EnableDeclineRemoteControlResponseDlg(bool bEnable) = 0;

    virtual void EnableLeaveMeetingOptionForHost(bool bEnable) = 0;

    virtual void EnableInviteButtonOnMeetingUI(bool bEnable) = 0;

    virtual void EnableVideoButtonOnMeetingUI(bool bEnable) = 0;

    virtual void EnableAudioButtonOnMeetingUI(bool bEnable) = 0;

    virtual void EnableEnterAndExitFullScreenButtonOnMeetingUI(bool bEnable) = 0;

    virtual void EnableLButtonDBClick4SwitchFullScreenMode(bool bEnable) = 0;

    virtual void SetFloatVideoWndVisibility(bool bShow) = 0;

    virtual void RedirectClickShareBTNEvent(bool bRedirect) = 0;

    virtual void RedirectClickEndMeetingBTNEvent(bool bRedirect) = 0;

    virtual void RedirectFreeMeetingEndingReminderDlg(bool bRedirect) = 0;

    virtual void RedirectClickCustomLiveStreamMenuEvent(bool bRedirect) = 0;

    virtual void RedirectClickParticipantListBTNEvent(bool bRedirect) = 0;

    virtual void RedirectClickCCBTNEvent(bool bRedirect) = 0;

    virtual void RedirectMeetingWarningMsg(RedirectWarningMsgOption redirectOption) = 0;

    virtual void EnableToolTipsShow(bool bEnable) = 0;

     virtual void EnableAirplayInstructionWindow(bool bEnable) = 0;

    virtual void EnableClaimHostFeature(bool bEnable) = 0;

    virtual void EnableAutoHideJoinAudioDialog(bool bEnable) = 0;

    virtual void AlwaysShowIconOnTaskBar(bool bAlwaysShow) = 0;

    virtual void DisableSplitScreenModeUIElements(bool bDisable) = 0;

    virtual void SetShowAudioUseComputerSoundChkbox(bool bShow) = 0;

    virtual void SetShowVideoOptimizeChkbox(bool bShow) = 0;

    virtual void SetShowCallInTab(bool bShow) = 0;

    virtual void SetShowCallMeTab(bool bShow) = 0;
    
    virtual SDKError SetUICustomizedString(SDKCustomizedStringType customizedType, const wchar_t* customizedString) = 0;

    virtual SDKError DisableTopMostAttr4SettingDialog(bool bDisable) = 0;

    virtual SDKError EnableGrabShareWithoutReminder(bool bEnable) = 0;
    
    virtual void EnableShowShareSwitchMultiToSingleConfirmDlg(bool bEnable) = 0;

    virtual void DisableFreeMeetingRemainTimeNotify(bool bDisable) = 0;

    virtual void HideChatItemOnMeetingUI(bool bHide) = 0;

    virtual void HideRecordItemOnMeetingUI(bool bHide) = 0;

    virtual void HideUpgradeFreeMeetingButton(bool bHide) = 0;

    virtual void SetShowInviteDlgTabPage(SDKInviteDlgTabPage tabPage, bool bShow) = 0;

    virtual void SetShowH323SubTabPage(SDKH323TabPage tabPage, bool bShow) = 0;

    virtual void HideUpgradeWarningMsgForFreeUserWhenSchedule(bool bHide) = 0;

    // \brief Set the visibility of the local recording convert progress bar dialog. Default: TRUE. 
    virtual void EnableLocalRecordingConvertProgressBarDialog(bool bShow) = 0;

    // \brief Set the visibility of Switch Camera button on 2nd camera share window,Default: TRUE. 
    virtual void HideSwitchCameraButton(bool bHide) = 0;

    // \brief Set the visibility of CopyURL button on invite window, Default: TRUE. 
    virtual void HideCopyUrlOnInviteWindow(bool bHide) = 0;

    // \brief Set the visibility of CopyInvitation button on invite window, Default: TRUE. 
    virtual void HideCopyInvitationOnInviteWindow(bool bHide) = 0;

    // \brief Set the visibility of Keypad button on meeting window, Default: TRUE. 
    virtual void HideKeypadButtonOnMeetingWindow(bool bHide) = 0;

    virtual void HideRemoteControlOnMeetingUI(bool bHide) = 0;
    
    virtual void HideQAOnMeetingUI(bool bHide) = 0;

    virtual void HidePollOnMeetingUI(bool bHide) = 0;

    virtual void DisableAdvanceAudioDeivceCtrl(bool bDisable) = 0;

    virtual void RedirectClickAudioBTNEvent(bool bRedirect) = 0;

    virtual void RedirectClickAudioMenuBTNEvent(bool bRedirect) = 0;

    virtual void RedirectClickBreakoutRoomButtonEvent(bool bRedirect) = 0;

    virtual void HideReactionsOnMeetingUI(bool bHide) = 0;

    virtual void HideMeetingInfoOnMeetingUI(bool bHide) = 0;

    virtual void HideShareButtonOnMeetingUI(bool bHide) = 0;

    virtual void DisablePanelistMenuItem(PanelistMenuItemOption menuOption) = 0;

    virtual void DisableAttendeeMenuItem(AttendeeMenuItemOption menuOption) = 0;
};

class IJoinMeetingBehaviorConfiguration
{
public:
    virtual void DisablePopupMeetingWrongPSWDlg(bool bDisable) = 0;

    virtual void DisableWaitingForHostDialog(bool bDisable) = 0;

    virtual void EnableAutoEndOtherMeetingWhenStartMeeting(bool bEnable) = 0;

    virtual void EnableInputMeetingPasswordDlg(bool bEnable) = 0;

    virtual void EnableInputMeetingScreenNameDlg(bool bEnable) = 0;

    virtual void RedirectWebinarNeedRegister(bool bRedirect) = 0;

    virtual void PrePopulateWebinarRegistrationInfo(const wchar_t* email, const wchar_t* username) = 0;

    virtual void RedirectEndOtherMeeting(bool bRedirect) = 0;
    
    virtual void EnableForceAutoStartMyVideoWhenJoinMeeting(bool bEnable) = 0;

    virtual void EnableForceAutoStopMyVideoWhenJoinMeeting(bool bEnable) = 0;

    virtual void DisableAutoShowSelectJoinAudioDlgWhenJoinMeeting(bool bDisable) = 0;

    virtual void DisableShowJoinMeetingWnd(bool bDisable) = 0;
};

class IMeetingConfiguration : 
public IMeetingUIElemConfiguration, 
public IJoinMeetingBehaviorConfiguration
{
public:
    virtual void SetEvent(IMeetingConfigurationEvent* pEvent) = 0;

    virtual void Reset() = 0;

    virtual void SetDirectShareMonitorID(const wchar_t* monitorID) = 0;

    virtual void EnableAutoAdjustSpeakerVolumeWhenJoinAudio(bool bEnable) = 0;

    virtual void EnableAutoAdjustMicVolumeWhenJoinAudio(bool bEnable) = 0;

    virtual void ConfigDSCP(int dscpAudio, int dscpVideo, bool bReset) = 0;

    virtual void DisableRemoteCtrlCopyPasteFeature(bool bDisable) = 0;

    virtual void EnableHideFullPhoneNumber4PureCallinUser(bool bHide) = 0;

    virtual void EnableLengthLimitationOfMeetingNumber(bool bEnable) = 0;

    virtual void EnableShareIOSDevice(bool bEnable) = 0;

    virtual void EnableShareWhiteBoard(bool bEnable) = 0;

    virtual void ForceDisableMultiShare(bool bDisable) = 0;

    virtual void SetMaxDurationForOnlyHostInMeeting(int nDuration) = 0;

    virtual void EnableLeaveMeetingWhenScreenLocked(bool bEnable) = 0;

    virtual bool DisableConfidentialWatermark(bool bDisable) = 0;
};

END_ZOOM_SDK_NAMESPACE
#endif