Video SDK for MacOS API Reference
Loading...
Searching...
No Matches
ZMVideoSDKUserHelper.h
Go to the documentation of this file.
1
5
6#import <Foundation/Foundation.h>
7#import <ZMVideoSDK/ZMVideoSDKDef.h>
8#import <ZMVideoSDK/ZMVideoSDKVideoCanvas.h>
9
11
12NS_ASSUME_NONNULL_BEGIN
17@interface ZMVideoSDKVideoStatus : NSObject
18
22@property (nonatomic, assign, readonly) BOOL isHasVideoDevice;
23
27@property (nonatomic, assign, readonly) BOOL isOn;
28@end
29
34@interface ZMVideoSDKAudioStatus : NSObject
35
39@property (nonatomic, assign, readonly) ZMVideoSDKAudioType audioType;
40
44@property (nonatomic, assign, readonly) BOOL isMuted;
45
49@property (nonatomic, assign, readonly) BOOL isTalking;
50@end
51
56@interface ZMVideoSDKVideoStatisticInfo : NSObject
57
61@property (nonatomic, assign, readonly) int width;
62
66@property (nonatomic, assign, readonly) int height;
67
71@property (nonatomic, assign, readonly) int fps;
72
76@property (nonatomic, assign, readonly) int bpf;
77
81@property (nonatomic, assign, readonly) ZMVideoSDKNetworkStatus videoNetworkStatus;
82@end
83
88@interface ZMVideoSDKShareStatisticInfo : NSObject
89
93@property (nonatomic, assign, readonly) int width;
94
98@property (nonatomic, assign, readonly) int height;
99
103@property (nonatomic, assign, readonly) int fps;
104
108@property (nonatomic, assign, readonly) int bpf;
109
113@property (nonatomic, assign, readonly) ZMVideoSDKNetworkStatus shareNetworkStatus;
114@end
115
120@interface ZMVideoSDKYUVRawDataI420 : NSObject
121
125@property (nonatomic, assign, readonly) char* _Nullable yBuffer;
126
130@property (nonatomic, assign, readonly) char* _Nullable uBuffer;
131
135@property (nonatomic, assign, readonly) char* _Nullable vBuffer;
136
140@property (nonatomic, assign, readonly) char* _Nullable buffer;
141
145@property (nonatomic, assign, readonly, nullable) char* alphaBuffer;
146
150@property (nonatomic, assign, readonly) unsigned int bufferLen;
151
155@property (nonatomic, assign, readonly) unsigned int alphaBufferLen;
156
160@property (nonatomic, assign, readonly) BOOL isLimitedI420;
161
165@property (nonatomic, assign, readonly) unsigned int streamWidth;
166
170@property (nonatomic, assign, readonly) unsigned int streamHeight;
171
175@property (nonatomic, assign, readonly) unsigned int rotation;
176
180@property (nonatomic, assign, readonly) unsigned int resourceID;
181
185@property (nonatomic, assign, readonly) long long timeStamp;
190- (BOOL)canAddRef;
191
197- (BOOL)addRef;
198
204@end
205
206
211@interface ZMVideoSDKShareCursorData : NSObject
212
216@property (nonatomic, assign, readonly) unsigned int sourceID;
217
221@property (nonatomic, assign, readonly) int x;
222
226@property (nonatomic, assign, readonly) int y;
227@end
228
233@protocol ZMVideoSDKRawDataPipeDelegate <NSObject>
234@optional
235
240- (void)onRawDataFrameReceived:(ZMVideoSDKYUVRawDataI420*)data;
241
246- (void)onRawDataStatusChanged:(ZMVideoSDKRawDataStatus)status;
247
252- (void)onShareCursorDataReceived:(ZMVideoSDKShareCursorData *)info;
253@end
254
259@interface ZMVideoSDKRawDataPipe : NSObject
260
267- (ZMVideoSDKErrors)subscribe:(ZMVideoSDKResolution)resolution listener:(id<ZMVideoSDKRawDataPipeDelegate>)listener;
268
274- (ZMVideoSDKErrors)unSubscribe:(id<ZMVideoSDKRawDataPipeDelegate>)listener;
275
281
287
292- (NSString* _Nullable)getVideoDeviceName;
293
299
306
312
318@end
319
325
331
337@end
338
344
350
356
362- (ZMVideoSDKErrors)turnLeft:(unsigned int)range;
363
369- (ZMVideoSDKErrors)turnRight:(unsigned int)range;
370
376- (ZMVideoSDKErrors)turnUp:(unsigned int)range;
377
383- (ZMVideoSDKErrors)turnDown:(unsigned int)range;
384
390- (ZMVideoSDKErrors)zoomIn:(unsigned int)range;
391
397- (ZMVideoSDKErrors)zoomOut:(unsigned int)range;
398@end
399
400
405@interface ZMVideoSDKUser : NSObject
410- (NSString* _Nullable)getUserID;
411
417- (NSString* _Nullable)getCustomIdentity DEPRECATED_MSG_ATTRIBUTE("Use -getUserKey instead");
418
423- (NSString* _Nullable)getUserKey;
424
429- (NSString* _Nullable)getUserName;
430
434- (NSString* _Nullable)getUserReference;
435
441
446- (BOOL)isHost;
447
452- (BOOL)isManager;
453
459
465
471
477
483
489
495
503- (BOOL)setUserVolume:(float)volume isSharingAudio:(BOOL)isSharingAudio DEPRECATED_MSG_ATTRIBUTE("Use -setUserPlaybackVolume:isSharingAudio: instead");
504
512- (BOOL)getUserVolume:(float*)volume isSharingAudio:(BOOL)isSharingAudio DEPRECATED_MSG_ATTRIBUTE("Use -getUserPlaybackVolume:isSharingAudio: instead");
513
520- (BOOL)canSetUserVolume:(BOOL)isShareAudio DEPRECATED_MSG_ATTRIBUTE("Use -canSetUserPlaybackVolume: instead");
521
528- (BOOL)setUserPlaybackVolume:(float)volume isSharingAudio:(BOOL)isSharingAudio;
529
536- (BOOL)getUserPlaybackVolume:(float*)volume isSharingAudio:(BOOL)isSharingAudio;
537
543- (BOOL)canSetUserPlaybackVolume:(BOOL)isShareAudio;
544
549- (unsigned int)getAudioLevel;
550
556
562- (ZMVideoSDKErrors)transferFile:(NSString *)filePath;
563
569
575
581
587
594
600@end
601
606@interface ZMVideoSDKUserHelper: NSObject
607
614- (BOOL)changeName:(NSString*)name user:(ZMVideoSDKUser*)user;
615
621- (BOOL)makeHost:(ZMVideoSDKUser*)user;
622
628- (BOOL)makeManager:(ZMVideoSDKUser*)user;
629
635- (ZMVideoSDKErrors)revokeManager:(ZMVideoSDKUser*)user;
636
642- (BOOL)removeUser:(ZMVideoSDKUser*)user;
643
649@end
650
651NS_ASSUME_NONNULL_END
652
ZMVideoSDKResolution
Enumeration of render resolution.
ZMVideoSDKRawDataType
Enumeration of raw data types.
ZMVideoSDKDataType
Enumeration of the data type for network quality monitoring.
ZMVideoSDKShareCapturePauseReason
Enumeration of reasons why screen sharing capture is paused in the Zoom Video SDK.
ZMVideoSDKShareType
Enumerates the types of content available for sharing in a session.
ZMVideoSDKErrors
Enumerates all errors in the VideoSDK.
ZMVideoSDKWhiteboardStatus
Enumeration of the status of whiteboard sharing.
ZMVideoSDKRawDataStatus
Enumeration the statuses of raw data.
ZMVideoSDKNetworkStatus
Enumerates the network statuses.
ZMVideoSDKShareStatus
Enumerates the status of sharing.
ZMVideoSDKAudioType
Enumerates the types of audio.
Audio status interface.
BOOL isTalking
Determines whether the user is talking.
BOOL isMuted
Determines whether the audio is muted.
ZMVideoSDKAudioType audioType
Gets audio type: VOIP (Voice over IP), Telephony, or None.
Camera control request handler object interface.
ZMVideoSDKErrors approve()
Approve the remote camera control request.
ZMVideoSDKErrors decline()
Decline the remote camera control request.
Video or share raw data pipe interface.
ZMVideoSDKRawDataType getRawdataType()
Gets the raw data data type.
ZMVideoSDKVideoStatisticInfo *_Nullable getVideoStatisticInfo()
Gets video statistic information.
ZMVideoSDKShareType getShareType()
Gets share type.
ZMVideoSDKVideoStatus *_Nullable getVideoStatus()
Gets video status.
ZMVideoSDKShareCapturePauseReason getShareCapturePauseReason()
Gets the reason why the share capture is paused.
NSString *_Nullable getVideoDeviceName()
Gets video device name.
ZMVideoSDKShareStatus getShareStatus()
Gets share status.
Remote camera control helper object interface.
ZMVideoSDKErrors requestControlRemoteCamera()
Requests to control remote camera.
ZMVideoSDKErrors giveUpControlRemoteCamera()
Give up control of the remote camera.
Represents the state and control interfaces of a share action in a Zoom session.
Represents the cursor position data during screen sharing.
unsigned int sourceID
The source id of the share cursor.
int y
The y value of the coordinate.
int x
The x value of the coordinate.
Share statistic infomation interface.
int width
Gets the width of share data size.
ZMVideoSDKNetworkStatus shareNetworkStatus
Gets share network status.
int height
Gets the height of share data size.
User control interface.
BOOL reclaimHost()
Reclaim host permission. Allow the user whose role_type = 1 to reclaim the host role.
Zoom Video SDK user information.
unsigned int getAudioLevel()
Gets the current audio level of a remote user.
BOOL isIncomingLiveStreamUser()
Determines whether the user is incoming live stream user.
NSArray< ZMVideoSDKRawDataPipe * > *_Nullable getMultiCameraStreamList()
Gets the user's multi-camera stream list.
NSArray< ZMVideoSDKShareAction * > *_Nullable getShareActionList()
Gets the user's share-action list.
BOOL isInSubSession()
Determines whether the user is in a subsession.
BOOL isHost()
Determines whether the user is the host.
ZMVideoSDKWhiteboardStatus getWhiteboardStatus()
Gets the user's whiteboard sharing status.
BOOL isManager()
Determines whether the user is the manager.
NSString *_Nullable getUserKey()
Gets the user's key.
NSString *_Nullable getUserReference()
Gets the user's reference.
ZMVideoSDKRemoteCameraControlHelper *_Nullable getRemoteCameraControlHelper()
Gets the helper class instance to access the remote camera control.
ZMVideoSDKShareStatisticInfo *_Nullable getShareStatisticInfo()
Gets the user's share statistic information.
ZMVideoSDKVideoCanvas *_Nullable getVideoCanvas()
Gets the user's video canvas.
ZMVideoSDKVideoStatisticInfo *_Nullable getVideoStatisticInfo()
Gets the user's video statistic information.
NSString *_Nullable getCustomIdentity()
Gets the user's custom identity.
BOOL hasIndividualRecordingConsent()
Determines whether I agree to individual video recording.
NSString *_Nullable getUserName()
Gets the user's name in the session.
NSString *_Nullable getUserID()
Gets the user's ID.
ZMVideoSDKAudioStatus *_Nullable getAudioStatus()
Gets the user's audio status.
ZMVideoSDKRawDataPipe *_Nullable getVideoPipe()
Gets the user's video pipe.
ZMVideoSDKNetworkStatus getOverallNetworkLevel()
Gets the user's overall network quality level.
BOOL isVideoSpotLighted()
Check if user is spotlighted.
Manages the rendering of video or screen share content in the Zoom Video SDK.
Video statistic information interface.
int width
Gets the width of video data size.
ZMVideoSDKNetworkStatus videoNetworkStatus
Gets video network status.
int height
Gets the height of video data size.
ZMVideoSDKVideoStatus provides information on the user's video device (the detected compatible video ...
BOOL isHasVideoDevice
Query if the user's device has a compatible camera. YES : compatible camera detected,...
BOOL isOn
Query if the camera is turned on. YES : camera turned on, NO : camera turned off.
YUV raw data 420 infomation interface.
BOOL canAddRef()
Determines if adding a reference to the raw data buffer is supported.
char *_Nullable yBuffer
Gets the YUVI420 Y buffer. The Y component represents the luma or brightness values.
unsigned int bufferLen
The buffer length of this data.
unsigned int resourceID
Gets the source_id of current YUV raw data.
char *_Nullable vBuffer
Gets the YUVI420 V buffer. The V component represents the chroma values.
BOOL isLimitedI420
Gets if this data is limited I420 format.
char *_Nullable buffer
The buffer data.
unsigned int streamWidth
Query stream width.
char *_Nullable uBuffer
Gets the YUVI420 U buffer. The U component represents the chroma values.
unsigned int rotation
Query the video raw data rotation.
unsigned int streamHeight
Gets the stream height.
unsigned int alphaBufferLen
Gets the alpha buffer length.
BOOL addRef()
Increase reference count by 1. Adding a reference ensures that the raw data buffer nots be released.
char * alphaBuffer
Gets video alpha mask data buffer.
int releaseRef()
Decrease reference count by 1. When finished using the raw data buffer, call releaseRef.
long long timeStamp
Millisecond timestamp.