Meeting immersive controller interface. For more details on this feature, see https://support.zoom.us/hc/en-us/articles/360060220511-Immersive-View. More...

#include <customized_immersive.h>

Public Member Functions
virtual SDKError	SetEvent (ICustomImmersiveCtrlEvent *pEvent)=0
	Sets immersive object callback event handler.

virtual SDKError	isSupportImmersive (bool &bSupport)=0
	Determines if immersive is supported.

virtual SDKError	isImmersiveViewOn (bool &bOn)=0
	Determines if immersive view is active.

virtual SDKError	downloadTemplateThumbnails ()=0
	Download the template thumbnails. See /link ICustomImmersiveCtrlEvent /endlink for updates on the download.

virtual SDKError	isTemplateThumbnailsReady (bool &bReady)=0
	Determines if the thumbnails are ready.

virtual IList< ICustomImmersiveTemplate * > *	getTemplates ()=0
	Gets the list of templates.

virtual SDKError	downloadTemplate (ICustomImmersiveTemplate *immersiveTemplate)=0
	Download complete template resource.

virtual SDKError	canStartImmersiveView (ICustomImmersiveTemplate *immersiveTemplate, bool &bCan)=0
	Determines if the immersive template can be started.

virtual SDKError	startImmersiveView (ICustomImmersiveTemplate *immersiveTemplate)=0
	Starts immersive view.

virtual SDKError	changeTemplate (ICustomImmersiveTemplate *immersiveTemplate)=0
	Change template in immersive view.

virtual SDKError	endImmersiveView ()=0
	Exit immersive view.

virtual ICustomImmersiveTemplate *	getCurrentTemplate ()=0
	Gets the current template.

virtual SDKError	canUserShowInImmersiveView (unsigned int userID, bool &bCan)=0
	Determines if the user can be shown in immersive view.

virtual ICustomImmersivePreLayoutHelper *	getImmersivePreLayoutHelper ()=0
	Gets the immersive pre-layout helper pointer.

virtual IList< CustomImmersiveLayoutData > *	getLayoutData ()=0
	Gets the immersive seat layout data.

virtual SDKError	assignUser (unsigned int userID, unsigned int seatID)=0
	Put the user in the seat.

virtual SDKError	putUserToFreeSeat (unsigned int userID, RECT pos)=0
	Put the user in the free seat.

virtual SDKError	removeUser (unsigned int userID)=0
	Remove user from immersive view.

virtual SDKError	isUserInImmersiveView (unsigned int userID, bool &bIn)=0
	Determines if the user is in immersive view.

virtual SDKError	addCustomImageTemplate (const zchar_t filePath, ICustomImmersiveTemplate *immersiveTemplate)=0
	Add a template based on a custom image.

virtual SDKError	removeCustomImageTemplate (ICustomImmersiveTemplate *immersiveTemplate)=0
	Remove custom image template.

virtual SDKError	isInImmersiveShareMode (bool &bInShare)=0
	Determines if displaying sharing contents in immersive mode.

virtual SDKError	viewShare (unsigned int shareSourceID)=0
	Update the share source ID to view share, only available for host.

virtual SDKError	getViewingShareSourceID (unsigned int &shareSourceID)=0
	Query the share source ID when viewing share in immersive mode, only available for host.

virtual	~ICustomImmersiveController ()

Detailed Description

Meeting immersive controller interface. For more details on this feature, see https://support.zoom.us/hc/en-us/articles/360060220511-Immersive-View.

Definition at line 251 of file customized_immersive.h.

Constructor & Destructor Documentation

◆ ~ICustomImmersiveController()

virtual ICustomImmersiveController::~ICustomImmersiveController ( )

inlinevirtual

Definition at line 423 of file customized_immersive.h.

423{}

Member Function Documentation

◆ addCustomImageTemplate()

virtual SDKError ICustomImmersiveController::addCustomImageTemplate	(	const zchar_t *	filePath,
		ICustomImmersiveTemplate **	immersiveTemplate )

pure virtual

Add a template based on a custom image.

Parameters

	filePath	The image file path.
[out]	immersiveTemplate	The object of custom template.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ assignUser()

virtual SDKError ICustomImmersiveController::assignUser	(	unsigned int	userID,
		unsigned int	seatID )

pure virtual

Put the user in the seat.

Parameters

userID	The user ID.
seatID	The seat ID.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ canStartImmersiveView()

virtual SDKError ICustomImmersiveController::canStartImmersiveView	(	ICustomImmersiveTemplate *	immersiveTemplate,
		bool &	bCan )

pure virtual

Determines if the immersive template can be started.

Parameters

	immersiveTemplate	The selected template in immersive view.
[out]	bCan	true indicates the immersive can be started, false not.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ canUserShowInImmersiveView()

virtual SDKError ICustomImmersiveController::canUserShowInImmersiveView	(	unsigned int	userID,
		bool &	bCan )

pure virtual

Determines if the user can be shown in immersive view.

Parameters

	userID	The user ID.
[out]	bCan	true indicates the user can be shown in immersive view, false if they cannot.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ changeTemplate()

virtual SDKError ICustomImmersiveController::changeTemplate ( ICustomImmersiveTemplate * immersiveTemplate )

pure virtual

Change template in immersive view.

Parameters

immersiveTemplate The selected template in immersive view.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ downloadTemplate()

virtual SDKError ICustomImmersiveController::downloadTemplate ( ICustomImmersiveTemplate * immersiveTemplate )

pure virtual

Download complete template resource.

Parameters

immersiveTemplate The template to be downloaded.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ downloadTemplateThumbnails()

virtual SDKError ICustomImmersiveController::downloadTemplateThumbnails ( )

pure virtual

Download the template thumbnails. See /link ICustomImmersiveCtrlEvent /endlink for updates on the download.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ endImmersiveView()

virtual SDKError ICustomImmersiveController::endImmersiveView ( )

pure virtual

Exit immersive view.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ getCurrentTemplate()

virtual ICustomImmersiveTemplate * ICustomImmersiveController::getCurrentTemplate ( )

pure virtual

Gets the current template.

Returns: If the function succeeds, it returns the current template. Otherwise, this function fails and returns nullptr.

◆ getImmersivePreLayoutHelper()

virtual ICustomImmersivePreLayoutHelper * ICustomImmersiveController::getImmersivePreLayoutHelper ( )

pure virtual

Gets the immersive pre-layout helper pointer.

Returns: If the function succeeds, it returns the immersive layout helper pointer. Otherwise, this function fails and returns nullptr.

◆ getLayoutData()

virtual IList< CustomImmersiveLayoutData > * ICustomImmersiveController::getLayoutData ( )

pure virtual

Gets the immersive seat layout data.

Returns: The immersive seat layout data. ZERO(0) indicates that there are no users in the immersive view.

◆ getTemplates()

virtual IList< ICustomImmersiveTemplate * > * ICustomImmersiveController::getTemplates ( )

pure virtual

Gets the list of templates.

Returns: The list of templates. ZERO(0) indicates that there are no templates.

◆ getViewingShareSourceID()

virtual SDKError ICustomImmersiveController::getViewingShareSourceID ( unsigned int & shareSourceID )

pure virtual

Query the share source ID when viewing share in immersive mode, only available for host.

Parameters

[out] shareSourceID The sepecified share source ID.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ isImmersiveViewOn()

virtual SDKError ICustomImmersiveController::isImmersiveViewOn ( bool & bOn )

pure virtual

Determines if immersive view is active.

Parameters

[out] bOn true indicates the immersive view is active. Otherwise, false.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ isInImmersiveShareMode()

virtual SDKError ICustomImmersiveController::isInImmersiveShareMode ( bool & bInShare )

pure virtual

Determines if displaying sharing contents in immersive mode.

Parameters

[out] bInShare true indicates displaying sharing contents in immersive mode, false means that they are not.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ isSupportImmersive()

virtual SDKError ICustomImmersiveController::isSupportImmersive ( bool & bSupport )

pure virtual

Determines if immersive is supported.

Parameters

[out] bSupport true indicates support immersive. Otherwise, false.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ isTemplateThumbnailsReady()

virtual SDKError ICustomImmersiveController::isTemplateThumbnailsReady ( bool & bReady )

pure virtual

Determines if the thumbnails are ready.

Parameters

[out] bReady true indicates the immersive thumbnails is ready, false not.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ isUserInImmersiveView()

virtual SDKError ICustomImmersiveController::isUserInImmersiveView	(	unsigned int	userID,
		bool &	bIn )

pure virtual

Determines if the user is in immersive view.

Parameters

	userID	The user ID.
[out]	bIn	true indicates the user is in immersive view, false means that they are not.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ putUserToFreeSeat()

virtual SDKError ICustomImmersiveController::putUserToFreeSeat	(	unsigned int	userID,
		RECT	pos )

pure virtual

Put the user in the free seat.

Parameters

userID	The user ID.
pos	The position.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ removeCustomImageTemplate()

virtual SDKError ICustomImmersiveController::removeCustomImageTemplate ( ICustomImmersiveTemplate * immersiveTemplate )

pure virtual

Remove custom image template.

Parameters

immersiveTemplate The custom image template that want to remove.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ removeUser()

virtual SDKError ICustomImmersiveController::removeUser ( unsigned int userID )

pure virtual

Remove user from immersive view.

Parameters

userID The user ID.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

◆ SetEvent()

virtual SDKError ICustomImmersiveController::SetEvent ( ICustomImmersiveCtrlEvent * pEvent )

pure virtual

Sets immersive object callback event handler.

Parameters

pEvent A pointer to the ICustomImmersiveCtrlEvent that receives the immersive object events.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, this function returns an error.

◆ startImmersiveView()

virtual SDKError ICustomImmersiveController::startImmersiveView ( ICustomImmersiveTemplate * immersiveTemplate )

pure virtual

Starts immersive view.

Parameters

immersiveTemplate The selected template in immersive view.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

Note: For the host, it must be started after the immersive container is created.

◆ viewShare()

virtual SDKError ICustomImmersiveController::viewShare ( unsigned int shareSourceID )

pure virtual

Update the share source ID to view share, only available for host.

Parameters

shareSourceID The sepecified share source ID.

Returns: If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise, failed.

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~ICustomImmersiveController()

Member Function Documentation

◆ addCustomImageTemplate()

◆ assignUser()

◆ canStartImmersiveView()

◆ canUserShowInImmersiveView()

◆ changeTemplate()

◆ downloadTemplate()

◆ downloadTemplateThumbnails()

◆ endImmersiveView()

◆ getCurrentTemplate()

◆ getImmersivePreLayoutHelper()

◆ getLayoutData()

◆ getTemplates()

◆ getViewingShareSourceID()

◆ isImmersiveViewOn()

◆ isInImmersiveShareMode()

◆ isSupportImmersive()

◆ isTemplateThumbnailsReady()

◆ isUserInImmersiveView()

◆ putUserToFreeSeat()

◆ removeCustomImageTemplate()

◆ removeUser()

◆ SetEvent()

◆ startImmersiveView()

◆ viewShare()