Video SDK for iOS API Reference
Loading...
Searching...
No Matches
ZoomVideoSDK Class Reference

Zoom Video SDK API manager. Main singleton object that controls the video session creation, event callbacks and other main features of video SDK. More...

#include <ZoomVideoSDK.h>

Inherits NSObject.

Instance Methods

(ZoomVideoSDKError- initialize:
 Initializes the Zoom SDK with the appropriate parameters in the ZoomVideoSDKInitParams object.
 
(ZoomVideoSDKError- cleanup
 Uninitializes the Zoom SDK.
 
(ZoomVideoSDKSession *_Nullable) - joinSession:
 Joins a session with the appropriate [ZoomVideoSDKSessionContext] parameters. When successful, the SDK will attempt to join a session. Use the callbacks in the delegate to confirm whether the SDK actually joined.
 
(ZoomVideoSDKError- leaveSession:
 Leaves a session previously joined through joinSession method call. When successful, the SDK will attempt to leave a session. Use the callbacks in the delegate to confirm whether the SDK actually left.
 
(ZoomVideoSDKSession *_Nullable) - getSession
 Gets the current session information.
 
(BOOL) - isInSession
 Determines whether there is an active session between participants.
 
(NSString *_Nullable) - getSDKVersion
 Gets the Zoom SDK internal version.
 
(NSString *_Nullable) - exportLog
 Exports a log file to local disk.
 
(ZoomVideoSDKError- cleanAllExportedLogs
 Cleans all exported logs.
 
(ZoomVideoSDKAudioHelper *_Nullable) - getAudioHelper
 Gets an instance to manage audio controls related to the current video SDK session.
 
(ZoomVideoSDKVideoHelper *_Nullable) - getVideoHelper
 Gets an instance to manage cameras and video during a video SDK session.
 
(ZoomVideoSDKUserHelper *_Nullable) - getUserHelper
 Gets an instance to manage users present in a video SDK session.
 
(ZoomVideoSDKShareHelper *_Nullable) - getShareHelper
 Gets an instance to manage screen sharing during a video SDK session.
 
(ZoomVideoSDKLiveStreamHelper *_Nullable) - getLiveStreamHelper
 Gets an instance to manage live streaming during a video SDK session.
 
(ZoomVideoSDKIncomingLiveStreamHelper *_Nullable) - getIncomingLiveStreamHelper
 Gets the incoming live stream helper object.
 
(ZoomVideoSDKChatHelper *_Nullable) - getChatHelper
 Gets an instance to send and receive chat messages within video SDK session participants.
 
(ZoomVideoSDKPhoneHelper *_Nullable) - getPhoneHelper
 Gets an instance to manage phone invitations during a video SDK session.
 
(ZoomVideoSDKCmdChannel *_Nullable) - getCmdChannel
 Gets an instance to use command channel features during a video SDK session.
 
(ZoomVideoSDKRecordingHelper *_Nullable) - getRecordingHelper
 Gets an instance to manage cloud recordings during a video SDK session.
 
(ZoomVideoSDKAudioSettingHelper *_Nullable) - getAudioSettingHelper
 Gets the audio setting helper.
 
(ZoomVideoSDKTestAudioDeviceHelper *_Nullable) - getTestAudioDeviceHelper
 Gets the test audio device helper.
 
(ZoomVideoSDKLiveTranscriptionHelper *_Nullable) - getLiveTranscriptionHelper
 Gets the live transcription helper object.
 
(ZoomVideoSDKVirtualBackgroundHelper *_Nullable) - getVirtualBackgroundHelper
 Gets the virtual background helper object.
 
(ZoomVideoSDKCRCHelper *_Nullable) - getCRCHelper
 Gets the CRC helper object.
 
(ZoomVideoSDKMaskHelper *_Nullable) - getMaskHelper
 Gets the mask helper object.
 
(ZoomVideoSDKSubSessionHelper *_Nullable) - getsubSessionHelper
 Gets the SubSession stream helper object. Only host and manager can call this interface.
 
(ZoomVideoSDKSessionType- getSessionType
 Gets the session type of this session.
 
(ZoomVideoSDKBroadcastStreamingHelper *_Nullable) - getBroadcastStreamingHelper
 Gets the broadcast streaming controller object.
 
(ZoomVideoSDKBroadcastStreamingViewerHelper *_Nullable) - getBroadcastStreamingViewerHelper
 Gets the broadcast streaming viewer object.
 
(ZoomVideoSDKWhiteboardHelper *_Nullable) - getWhiteboardHelper
 Gets the whiteboard helper object.
 
(ZoomVideoRealTimeMediaStreamsHelper *_Nullable) - getRealTimeMediaStreamsHelper
 Gets an instance to manage RTMS (Real-Time Media Streams) during a video SDK session.
 

Class Methods

(ZoomVideoSDK *_Nullable) + shareInstance
 Returns ZoomVideoSDK instance.
 

Properties

id< ZoomVideoSDKDelegate > _Nullable delegate
 The delegate of ZoomVideoSDK, a listener object that groups together all the callbacks related to a session.
 

Detailed Description

Zoom Video SDK API manager. Main singleton object that controls the video session creation, event callbacks and other main features of video SDK.

Warning
Access to the class and all the other components of the VideoSDK by merging <ZoomVideoSDK/ZoomVideoSDK.h> into source code.
The user can only obtain SDK configuration by initializing the class.

Definition at line 207 of file ZoomVideoSDK.h.

Method Documentation

◆ cleanAllExportedLogs

- (ZoomVideoSDKError) cleanAllExportedLogs

Cleans all exported logs.

Returns
If the function succeeds, it returns Errors_Success. Otherwise, this function returns an error.

◆ cleanup

- (ZoomVideoSDKError) cleanup

Uninitializes the Zoom SDK.

Returns
If the function succeeds, it returns Errors_Success. Otherwise, this function returns an error.
Warning
Only cleanup successfully after initialized.

◆ exportLog

- (NSString *_Nullable) exportLog

Exports a log file to local disk.

Returns
If the function succeeds, it returns the exported log file path. Otherwise, this function fails and returns nil.

◆ getAudioHelper

- (ZoomVideoSDKAudioHelper *_Nullable) getAudioHelper

Gets an instance to manage audio controls related to the current video SDK session.

Returns
If the function succeeds, it returns a ZoomVideoSDKAudioHelper object. Otherwise, this function fails and returns nil.

◆ getAudioSettingHelper

- (ZoomVideoSDKAudioSettingHelper *_Nullable) getAudioSettingHelper

Gets the audio setting helper.

Returns
If the function succeeds, it returns a ZoomVideoSDKAudioSettingHelper object. Otherwise, this function fails and returns nil.

◆ getBroadcastStreamingHelper

- (ZoomVideoSDKBroadcastStreamingHelper *_Nullable) getBroadcastStreamingHelper

Gets the broadcast streaming controller object.

Returns
If the function succeeds, it returns a ZoomVideoSDKBroadcastStreamingHelper object. Otherwise, this function fails and returns nil.

◆ getBroadcastStreamingViewerHelper

- (ZoomVideoSDKBroadcastStreamingViewerHelper *_Nullable) getBroadcastStreamingViewerHelper

Gets the broadcast streaming viewer object.

Returns
If the function succeeds, it returns a ZoomVideoSDKBroadcastStreamingViewerHelper object. Otherwise, this function fails and returns nil.

◆ getChatHelper

- (ZoomVideoSDKChatHelper *_Nullable) getChatHelper

Gets an instance to send and receive chat messages within video SDK session participants.

Returns
If the function succeeds, it returns a ZoomVideoSDKChatHelper object. Otherwise, this function fails and returns nil.

◆ getCmdChannel

- (ZoomVideoSDKCmdChannel *_Nullable) getCmdChannel

Gets an instance to use command channel features during a video SDK session.

Returns
If the function succeeds, it returns a ZoomVideoSDKCmdChannel object. Otherwise, this function fails and returns nil.

◆ getCRCHelper

- (ZoomVideoSDKCRCHelper *_Nullable) getCRCHelper

Gets the CRC helper object.

Returns
If the function succeeds, it returns a ZoomVideoSDKCRCHelper object. Otherwise, this function fails and returns nil.

◆ getIncomingLiveStreamHelper

- (ZoomVideoSDKIncomingLiveStreamHelper *_Nullable) getIncomingLiveStreamHelper

Gets the incoming live stream helper object.

Returns
If the function succeeds, it returns a ZoomVideoSDKIncomingLiveStreamHelper object. Otherwise, this function fails and returns nil.

◆ getLiveStreamHelper

- (ZoomVideoSDKLiveStreamHelper *_Nullable) getLiveStreamHelper

Gets an instance to manage live streaming during a video SDK session.

Returns
If the function succeeds, it returns a ZoomVideoSDKLiveStreamHelper object. Otherwise, this function fails and returns nil.

◆ getLiveTranscriptionHelper

- (ZoomVideoSDKLiveTranscriptionHelper *_Nullable) getLiveTranscriptionHelper

Gets the live transcription helper object.

Returns
If the function succeeds, it returns a ZoomVideoSDKLiveTranscriptionHelper object. Otherwise, this function fails and returns nil.

◆ getMaskHelper

- (ZoomVideoSDKMaskHelper *_Nullable) getMaskHelper

Gets the mask helper object.

Returns
If the function succeeds, it returns a ZoomVideoSDKMaskHelper object. Otherwise, this function fails and returns nil.

◆ getPhoneHelper

- (ZoomVideoSDKPhoneHelper *_Nullable) getPhoneHelper

Gets an instance to manage phone invitations during a video SDK session.

Returns
If the function succeeds, it returns a ZoomVideoSDKPhoneHelper object. Otherwise, this function fails and returns nil.

◆ getRealTimeMediaStreamsHelper

- (ZoomVideoRealTimeMediaStreamsHelper *_Nullable) getRealTimeMediaStreamsHelper

Gets an instance to manage RTMS (Real-Time Media Streams) during a video SDK session.

Returns
If the function succeeds, it returns a ZoomVideoRealTimeMediaStreamsHelper object. Otherwise, this function fails and returns nil.

◆ getRecordingHelper

- (ZoomVideoSDKRecordingHelper *_Nullable) getRecordingHelper

Gets an instance to manage cloud recordings during a video SDK session.

Returns
If the function succeeds, it returns a ZoomVideoSDKRecordingHelper object. Otherwise, this function fails and returns nil.

◆ getSDKVersion

- (NSString *_Nullable) getSDKVersion

Gets the Zoom SDK internal version.

Returns
If the function succeeds, it returns the SDK version. Otherwise, this function fails and returns nil.

◆ getSession

- (ZoomVideoSDKSession *_Nullable) getSession

Gets the current session information.

Returns
If the function succeeds, it returns a ZoomVideoSDKSession object. Otherwise, this function fails and returns nil.

◆ getSessionType

- (ZoomVideoSDKSessionType) getSessionType

Gets the session type of this session.

Returns
If the function succeeds, it returns the session type. Otherwise, this function returns an error.
Deprecated
Use getSessionType] instead.

◆ getShareHelper

- (ZoomVideoSDKShareHelper *_Nullable) getShareHelper

Gets an instance to manage screen sharing during a video SDK session.

Returns
If the function succeeds, it returns a ZoomVideoSDKShareHelper object. Otherwise, this function fails and returns nil.

◆ getsubSessionHelper

- (ZoomVideoSDKSubSessionHelper *_Nullable) getsubSessionHelper

Gets the SubSession stream helper object. Only host and manager can call this interface.

Returns
If the function succeeds, it returns a ZoomVideoSDKSubSessionHelper object. Otherwise, this function fails and returns nil.

◆ getTestAudioDeviceHelper

- (ZoomVideoSDKTestAudioDeviceHelper *_Nullable) getTestAudioDeviceHelper

Gets the test audio device helper.

Returns
If the function succeeds, it returns a ZoomVideoSDKTestAudioDeviceHelper object. Otherwise, this function fails and returns nil.

◆ getUserHelper

- (ZoomVideoSDKUserHelper *_Nullable) getUserHelper

Gets an instance to manage users present in a video SDK session.

Returns
If the function succeeds, it returns a ZoomVideoSDKUserHelper object. Otherwise, this function fails and returns nil.

◆ getVideoHelper

- (ZoomVideoSDKVideoHelper *_Nullable) getVideoHelper

Gets an instance to manage cameras and video during a video SDK session.

Returns
If the function succeeds, it returns a ZoomVideoSDKVideoHelper object. Otherwise, this function fails and returns nil.

◆ getVirtualBackgroundHelper

- (ZoomVideoSDKVirtualBackgroundHelper *_Nullable) getVirtualBackgroundHelper

Gets the virtual background helper object.

Returns
If the function succeeds, it returns a ZoomVideoSDKVirtualBackgroundHelper object. Otherwise, this function fails and returns nil.

◆ getWhiteboardHelper

- (ZoomVideoSDKWhiteboardHelper *_Nullable) getWhiteboardHelper

Gets the whiteboard helper object.

Returns
If the function succeeds, it returns a ZoomVideoSDKWhiteboardHelper object. Otherwise, this function fails and returns nil.

◆ initialize:

- (ZoomVideoSDKError) initialize: (ZoomVideoSDKInitParams *_Nonnull) context

Initializes the Zoom SDK with the appropriate parameters in the ZoomVideoSDKInitParams object.

Parameters
contextThe parameter configuration of the SDK.
Returns
If the function succeeds, it returns Errors_Success. Otherwise, this function returns an error.
Warning
Need to initialize first before doing the following steps.

◆ isInSession

- (BOOL) isInSession

Determines whether there is an active session between participants.

Returns
YES if there is an active session. Otherwise, NO.

◆ joinSession:

- (ZoomVideoSDKSession *_Nullable) joinSession: (ZoomVideoSDKSessionContext *_Nonnull) context

Joins a session with the appropriate [ZoomVideoSDKSessionContext] parameters. When successful, the SDK will attempt to join a session. Use the callbacks in the delegate to confirm whether the SDK actually joined.

Parameters
contextThe context which contains the parameters.
Returns
If the function succeeds, it returns a ZoomVideoSDKSession object. Otherwise, this function fails and returns nil.

◆ leaveSession:

- (ZoomVideoSDKError) leaveSession: (BOOL) end

Leaves a session previously joined through joinSession method call. When successful, the SDK will attempt to leave a session. Use the callbacks in the delegate to confirm whether the SDK actually left.

Parameters
endYES if the host should end the entire session, NO if the host should just leave the session.
Returns
If the function succeeds, it returns Errors_Success. Otherwise, this function returns an error.
Warning
Only host can end session. You can get the isHost information from in-Session 'userInfo'.

◆ shareInstance

+ (ZoomVideoSDK *_Nullable) shareInstance

Returns ZoomVideoSDK instance.

Property Documentation

◆ delegate

- (id<ZoomVideoSDKDelegate> _Nullable) delegate
readwritenonatomicweak

The delegate of ZoomVideoSDK, a listener object that groups together all the callbacks related to a session.

Definition at line 212 of file ZoomVideoSDK.h.