Share helper interface. More...

#include <zoom_video_sdk_share_helper_interface.h>

Public Member Functions
virtual ZoomVideoSDKErrors	startShareView (void *handle, ZoomVideoSDKShareOption option={false, false})=0
	Share a selected window, if virtual speaker is enabled, don't support share audio.

virtual bool	isShareViewValid (void *handle)=0
	Determine whether the handle being shared is valid.

virtual ZoomVideoSDKErrors	startShareScreen (const zchar_t *monitorID, ZoomVideoSDKShareOption option={ false, false })=0
	Share a selected screen, if virtual speaker is enabled, don't support share audio.

virtual IMonitorListBuilder *	getMonitorListBuilder ()=0
	Returns the monitor ID list builder object, the monitor ID list will be cleared after calling startShareMultiScreen.

virtual ZoomVideoSDKErrors	startShareMultiScreen (ZoomVideoSDKShareOption option={ false, false })=0
	Share all screens in IMonitorListBuilder, if virtual speaker is enabled, don't support share audio.

virtual ZoomVideoSDKErrors	startShareComputerAudio ()=0
	Start sharing only the computer audio.

virtual ZoomVideoSDKErrors	startSharePureAudioSource (IZoomVideoSDKShareAudioSource *pShareAudioSource, bool isPlaying=true)=0
	Starts sharing the pure external audio source.

virtual ZoomVideoSDKErrors	stopShare ()=0
	Stop share.

virtual ZoomVideoSDKErrors	pauseShare ()=0
	Pause share.

virtual ZoomVideoSDKErrors	resumeShare ()=0
	Resume share.

virtual bool	isSharingOut ()=0
	Determine whether the current user is sharing.

virtual bool	isScreenSharingOut ()=0
	Determine whether the current user is sharing the screen.

virtual bool	isOtherSharing ()=0
	Determine if other user is sharing.

virtual ZoomVideoSDKErrors	lockShare (bool lock)=0
	Lock sharing the view or screen. Only the host can call this method.

virtual bool	isShareLocked ()=0
	Determine whether sharing is locked.

virtual ZoomVideoSDKErrors	enableMultiShare (bool enable)=0
	Enable or disable participants can share simultaneously.

virtual bool	isMultiShareEnabled ()=0
	Determine whether multi share is enabled or not.

virtual ZoomVideoSDKErrors	enableShareDeviceAudio (bool enable)=0
	Enable or disable the computer sound when sharing. The SDK does not support sharing device audio, for example, when you've enabled virtual speaker.

virtual bool	isShareDeviceAudioEnabled ()=0
	Determine if the SDK has enabled share device sound. This reflects the execution status of `enableShareDeviceAudio` instead of `startShareComputerAudio`.

virtual ZoomVideoSDKErrors	enableOptimizeForSharedVideo (bool enable)=0
	Enable or disable the optimization of frame rate, you can enable it when there is video in shared content.

virtual bool	isOptimizeForSharedVideoEnabled ()=0
	Determine if optimization for shared video is enabled.

virtual ZoomVideoSDKErrors	startShare2ndCamera (const zchar_t *cameraID)=0
	Start sharing a camera feed specified by the cameraID as the second camera.

virtual ZoomVideoSDKErrors	subscribeMyShareCamera (IZoomVideoSDKRawDataPipeDelegate *data_handler)=0
	Subscribe to the raw data stream of the camera that is shared as the second camera.

virtual ZoomVideoSDKErrors	unSubscribeMyShareCamera ()=0
	Unsubscribe to the raw data stream of the camera that is shared as the second camera.

virtual ZoomVideoSDKErrors	startSharingExternalSource (IZoomVideoSDKShareSource pSource, IZoomVideoSDKShareAudioSource pAudioSource=nullptr, bool isPlaying=true)=0
	Shares an external source.

virtual bool	isAnnotationFeatureSupport ()=0
	Whether annotation is enabled or not.

virtual ZoomVideoSDKErrors	disableViewerAnnotation (bool bDisable)=0
	Disable or enable viewer's annotation by the share owner.

virtual bool	isViewerAnnotationDisabled ()=0
	Whether annotation on current sharing is disabled or not.

virtual IZoomVideoSDKAnnotationHelper *	createAnnotationHelper (void *handle)=0
	Creates annotation helper based on shared view.

virtual ZoomVideoSDKErrors	destroyAnnotationHelper (IZoomVideoSDKAnnotationHelper *helper)=0
	Destroys annotation helper.

virtual ZoomVideoSDKErrors	setAnnotationVanishingToolTime (unsigned int displayTime, unsigned int vanishingTime)=0
	Sets the vanishing tool time.

virtual ZoomVideoSDKErrors	getAnnotationVanishingToolTime (unsigned int &displayTime, unsigned int &vanishingTime)=0
	Gets the current vanishing tool time settings.

virtual ZoomVideoSDKErrors	enablePlaySharingAudioRawdata (bool isPlaying)=0
	Enable or disable local playback of shared audio raw data.

virtual ZoomVideoSDKErrors	startShareWithPreprocessing (const ZoomVideoSDKSharePreprocessParam &param, IZoomVideoSDKSharePreprocessor *preprocessor)=0
	Start share preprocessing.

virtual IZoomVideoSDKWhiteboardHelper *	getWhiteboardHelper ()=0
	Returns an instance to manage whiteboard during a video SDK session.

Detailed Description

Share helper interface.

Definition at line 408 of file zoom_video_sdk_share_helper_interface.h.

Member Function Documentation

◆ createAnnotationHelper()

virtual IZoomVideoSDKAnnotationHelper * IZoomVideoSDKShareHelper::createAnnotationHelper ( void * handle )

pure virtual

Creates annotation helper based on shared view.

Parameters

handle the shared view handle. Pass the null will return the helper for self sharing.

Returns: If the function succeeds, the return value is the IZoomVideoSDKAnnotationHelper helper object. Otherwise returns nullptr. For more details, see IZoomVideoSDKAnnotationHelper.

Warning: The view passed in this function should be subscribed share view. If the share view aspect mode is set to ZoomVideoSDKVideoAspect_Full_Filled, annotation is not supported. When the share owner not support the feature of annotate, the others should not do annotate in that case.

◆ destroyAnnotationHelper()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::destroyAnnotationHelper ( IZoomVideoSDKAnnotationHelper * helper )

pure virtual

Destroys annotation helper.

Parameters

helper IZoomVideoSDKAnnotationHelper object.

◆ disableViewerAnnotation()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::disableViewerAnnotation ( bool bDisable )

pure virtual

Disable or enable viewer's annotation by the share owner.

Parameters

bDisable true means annotation is disabled, false means it is enabled.

Warning: Only the share owner can call this function.

◆ enableMultiShare()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::enableMultiShare ( bool enable )

pure virtual

Enable or disable participants can share simultaneously.

Parameters

enable True to enable. False to disable.

Returns: If the function succeeds, the return value is ZoomVideoSDKErrors_Success. Otherwise the function fails.

Warning: When you switch multi share from enable to disable, all sharing will be stopped.

◆ enableOptimizeForSharedVideo()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::enableOptimizeForSharedVideo ( bool enable )

pure virtual

Enable or disable the optimization of frame rate, you can enable it when there is video in shared content.

Parameters

enable True indicates to enable. False disable.

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

◆ enablePlaySharingAudioRawdata()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::enablePlaySharingAudioRawdata ( bool isPlaying )

pure virtual

Enable or disable local playback of shared audio raw data.

Parameters

isPlaying true to play shared audio raw data, false not.

◆ enableShareDeviceAudio()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::enableShareDeviceAudio ( bool enable )

pure virtual

Enable or disable the computer sound when sharing. The SDK does not support sharing device audio, for example, when you've enabled virtual speaker.

Parameters

enable True to enable. False to disable.

Returns: If the function succeeds, the return value is ZoomVideoSDKErrors_Success. Otherwise the function fails.

◆ getAnnotationVanishingToolTime()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::getAnnotationVanishingToolTime	(	unsigned int &	displayTime,
		unsigned int &	vanishingTime )

pure virtual

Gets the current vanishing tool time settings.

Parameters

displayTime	[out] The time in milliseconds the tool remains visible before fading.
vanishingTime	[out] The time in milliseconds for the tool to fade out after displayTime.

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

Note: This function can only retrieve the time settings for your own share.

◆ getMonitorListBuilder()

virtual IMonitorListBuilder * IZoomVideoSDKShareHelper::getMonitorListBuilder ( )

pure virtual

Returns the monitor ID list builder object, the monitor ID list will be cleared after calling startShareMultiScreen.

Returns: If the function succeeds, the return value is the monitor ID list builder object. Otherwise returns nullptr.

◆ getWhiteboardHelper()

virtual IZoomVideoSDKWhiteboardHelper * IZoomVideoSDKShareHelper::getWhiteboardHelper ( )

pure virtual

Returns an instance to manage whiteboard during a video SDK session.

Returns: If the function succeeds, the return value is the whiteboard helper object. Otherwise returns nullptr. For more details, see IZoomVideoSDKWhiteboardHelper.

◆ isAnnotationFeatureSupport()

virtual bool IZoomVideoSDKShareHelper::isAnnotationFeatureSupport ( )

pure virtual

Whether annotation is enabled or not.

Returns: true support, false not support.

◆ isMultiShareEnabled()

virtual bool IZoomVideoSDKShareHelper::isMultiShareEnabled ( )

pure virtual

Determine whether multi share is enabled or not.

Returns: true enabled, false not enabled.

◆ isOptimizeForSharedVideoEnabled()

virtual bool IZoomVideoSDKShareHelper::isOptimizeForSharedVideoEnabled ( )

pure virtual

Determine if optimization for shared video is enabled.

Returns: True if enabled. Otherwise returns false.

◆ isOtherSharing()

virtual bool IZoomVideoSDKShareHelper::isOtherSharing ( )

pure virtual

Determine if other user is sharing.

Returns: True indicates another user is sharing, otherwise false.

◆ isScreenSharingOut()

virtual bool IZoomVideoSDKShareHelper::isScreenSharingOut ( )

pure virtual

Determine whether the current user is sharing the screen.

Returns: True indicates the current user is sharing the screen, otherwise false.

◆ isShareDeviceAudioEnabled()

virtual bool IZoomVideoSDKShareHelper::isShareDeviceAudioEnabled ( )

pure virtual

Determine if the SDK has enabled share device sound. This reflects the execution status of enableShareDeviceAudio instead of startShareComputerAudio.

Returns: True if enabled, otherwise false.

◆ isShareLocked()

virtual bool IZoomVideoSDKShareHelper::isShareLocked ( )

pure virtual

Determine whether sharing is locked.

Returns: True indicates that sharing is locked, otherwise false.

◆ isShareViewValid()

virtual bool IZoomVideoSDKShareHelper::isShareViewValid ( void * handle )

pure virtual

Determine whether the handle being shared is valid.

Returns: True indicates that the handle is valid, otherwise false.

◆ isSharingOut()

virtual bool IZoomVideoSDKShareHelper::isSharingOut ( )

pure virtual

Determine whether the current user is sharing.

Returns: True indicates the current user is sharing. Otherwise returns false.

◆ isViewerAnnotationDisabled()

virtual bool IZoomVideoSDKShareHelper::isViewerAnnotationDisabled ( )

pure virtual

Whether annotation on current sharing is disabled or not.

Returns: true disable, false not disable.

Warning: Only the share owner can call this function.

◆ lockShare()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::lockShare ( bool lock )

pure virtual

Lock sharing the view or screen. Only the host can call this method.

Parameters

lock	True to lock sharing

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

◆ pauseShare()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::pauseShare ( )

pure virtual

Pause share.

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

◆ resumeShare()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::resumeShare ( )

pure virtual

Resume share.

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

◆ setAnnotationVanishingToolTime()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::setAnnotationVanishingToolTime	(	unsigned int	displayTime,
		unsigned int	vanishingTime )

pure virtual

Sets the vanishing tool time.

Parameters

displayTime	The time in milliseconds the tool remains visible before fading.
vanishingTime	The time in milliseconds for the tool to fade out after displayTime.

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

Note: This setting only takes effect for the user's own share. The displayTime can be 0 or up to 15000 milliseconds (15 seconds), and the vanishingTime must be greater than 1000 milliseconds (1 second) and less than or equal to 15000 milliseconds (15 seconds).

◆ startShare2ndCamera()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::startShare2ndCamera ( const zchar_t * cameraID )

pure virtual

Start sharing a camera feed specified by the cameraID as the second camera.

Parameters

cameraID The camera ID.Warning: This must be a different camera than the one sending your primary video.

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

◆ startShareComputerAudio()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::startShareComputerAudio ( )

pure virtual

Start sharing only the computer audio.

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

◆ startShareMultiScreen()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::startShareMultiScreen ( ZoomVideoSDKShareOption option = { false, false } )

pure virtual

Share all screens in IMonitorListBuilder, if virtual speaker is enabled, don't support share audio.

Parameters

option See ZoomVideoSDKShareOption.

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

◆ startSharePureAudioSource()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::startSharePureAudioSource	(	IZoomVideoSDKShareAudioSource *	pShareAudioSource,
		bool	isPlaying = true )

pure virtual

Starts sharing the pure external audio source.

Parameters

pShareAudioSource	the pointer of external audio source object.
isPlaying	true means audio raw data is played locally at the same time, false not.

Returns: If the function succeeds, the return value is ZoomVideoSDKErrors_Success. Otherwise this function fails.

Note: The feature is similar to share computer audio, except that the shared content is user-defined.

◆ startShareScreen()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::startShareScreen	(	const zchar_t *	monitorID,
		ZoomVideoSDKShareOption	option = { false, false } )

pure virtual

Share a selected screen, if virtual speaker is enabled, don't support share audio.

Parameters

monitorID	The screen name that will to be share.
option	See ZoomVideoSDKShareOption.

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

◆ startShareView()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::startShareView	(	void *	handle,
		ZoomVideoSDKShareOption	option = {false, false} )

pure virtual

Share a selected window, if virtual speaker is enabled, don't support share audio.

Parameters

handle	The window handle that will to be share.
option	See ZoomVideoSDKShareOption.

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

◆ startShareWithPreprocessing()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::startShareWithPreprocessing	(	const ZoomVideoSDKSharePreprocessParam &	param,
		IZoomVideoSDKSharePreprocessor *	preprocessor )

pure virtual

Start share preprocessing.

Parameters

param	The share preprocessing parameters.
preprocessor	Object that handles preprocessing events.

Returns: If the function succeeds, the return value is ZoomVideoSDKErrors_Success. Otherwise this function fails.

◆ startSharingExternalSource()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::startSharingExternalSource	(	IZoomVideoSDKShareSource *	pSource,
		IZoomVideoSDKShareAudioSource *	pAudioSource = nullptr,
		bool	isPlaying = true )

pure virtual

Shares an external source.

Parameters

pSource	External share source, IZoomVideoSDKShareSource.
pAudioSource	external share audio source.
isPlaying	true means audio raw data is played locally at the same time, false not.

Returns: If the function succeeds, the return value is ZoomVideoSDKErrors_Success. Otherwise this function fails.

Note: If pAudioSource is non-null, it means share user-defined audio at the same time.

◆ stopShare()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::stopShare ( )

pure virtual

Stop share.

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

◆ subscribeMyShareCamera()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::subscribeMyShareCamera ( IZoomVideoSDKRawDataPipeDelegate * data_handler )

pure virtual

Subscribe to the raw data stream of the camera that is shared as the second camera.

Parameters

data_handler Data handler object.

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

Deprecated: This interface will be marked as deprecated, then it will be instead by IZoomVideoSDKRawDataPipe->subscribe, please stop using it.

◆ unSubscribeMyShareCamera()

virtual ZoomVideoSDKErrors IZoomVideoSDKShareHelper::unSubscribeMyShareCamera ( )

pure virtual

Unsubscribe to the raw data stream of the camera that is shared as the second camera.

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

Deprecated: This interface will be marked as deprecated, then it will be instead by IZoomVideoSDKRawDataPipe->unSubscribe, please stop using it.

Public Member Functions

Detailed Description

Member Function Documentation

◆ createAnnotationHelper()

◆ destroyAnnotationHelper()

◆ disableViewerAnnotation()

◆ enableMultiShare()

◆ enableOptimizeForSharedVideo()

◆ enablePlaySharingAudioRawdata()

◆ enableShareDeviceAudio()

◆ getAnnotationVanishingToolTime()

◆ getMonitorListBuilder()

◆ getWhiteboardHelper()

◆ isAnnotationFeatureSupport()

◆ isMultiShareEnabled()

◆ isOptimizeForSharedVideoEnabled()

◆ isOtherSharing()

◆ isScreenSharingOut()

◆ isShareDeviceAudioEnabled()

◆ isShareLocked()

◆ isShareViewValid()

◆ isSharingOut()

◆ isViewerAnnotationDisabled()

◆ lockShare()

◆ pauseShare()

◆ resumeShare()

◆ setAnnotationVanishingToolTime()

◆ startShare2ndCamera()

◆ startShareComputerAudio()

◆ startShareMultiScreen()

◆ startSharePureAudioSource()

◆ startShareScreen()

◆ startShareView()

◆ startShareWithPreprocessing()

◆ startSharingExternalSource()

◆ stopShare()

◆ subscribeMyShareCamera()

◆ unSubscribeMyShareCamera()