Meeting SDK for macOS API Reference
Loading...
Searching...
No Matches
ZoomSDKSettingVideoEffectController.h
Go to the documentation of this file.
1
5
6#import <Foundation/Foundation.h>
7#import <AppKit/AppKit.h>
8#import <ZoomSDK/ZoomSDKErrors.h>
9
12
13NS_ASSUME_NONNULL_BEGIN
14
19@interface ZoomSDKVirtualBGImageInfo: NSObject
20
25- (BOOL)isSelected;
30- (NSString*_Nullable)getImageFilePath;
35- (NSString*_Nullable)getImageName;
40- (BOOL)isVideo;
41
47@end
48
49
54@interface ZoomSDKVideoFilterItemInfo: NSObject
55
60- (BOOL)isSelected;
61
66- (NSString*_Nullable)getImageFilePath;
67
72- (NSString*_Nullable)getImageName;
73
79
84- (int)getIndex;
85@end
86
92
98- (ZoomSDKError)startLipSyncAvatarPreview:(NSView *)lipsyncPreview;
99
105- (ZoomSDKError)stopLipSyncAvatarPreview:(NSView *)lipsyncPreview;
106@end
107
112@protocol ZoomSDKVirtualBackgroundSettingDelegate <NSObject>
113@optional
118- (void)onVBImageDidDownloaded:(NSString*)filePath;
119
124- (void)onGreenVBDidUpdateWithReplaceColor:(NSColor*)selectedColor;
125
130
136- (void)onVBVideoUploadedResult:(BOOL)success failedError:(ZoomSDKSettingVBVideoError)error;
137
142
148- (void)onVideoFilterItemDataDownloading:(ZoomSDKVideoEffectType)type index:(int)index;
149
156- (void)onVideoFilterItemDataDownloaded:(BOOL)ready type:(ZoomSDKVideoEffectType)type index:(int)index;
157@end
158
159
165{
166 id<ZoomSDKVirtualBackgroundSettingDelegate> _delegate;
167}
168@property(nonatomic, assign, nullable)id<ZoomSDKVirtualBackgroundSettingDelegate> delegate;
174
180
186
192
198
203- (ZoomSDKError)setUsingGreenScreen:(BOOL)bUse;
204
210- (ZoomSDKError)addBGImage:(NSString*)filePath;
211
217- (ZoomSDKError)addBGVideo:(NSString*)filePath;
218
224- (ZoomSDKError)removeBGItem:(ZoomSDKVirtualBGImageInfo *)virtualBGImageInfo;
225
230- (NSArray*_Nullable)getBGItemList;
231
238
243- (NSColor*_Nullable)getVBReplaceColor;
244
251
257
263
269
275
281
287
292- (NSArray*_Nullable)getVideoFilterItemList;
293
299- (ZoomSDKError)useVideoFilterItem:(ZoomSDKVideoFilterItemInfo*)imageInfo;
300@end
301
306@interface ZoomSDKFaceMakeupImageInfo : NSObject
307
311@property(nonatomic, assign, readonly)ZoomSDKFaceMakeupType faceMakeupType;
312
316@property(nonatomic, assign, readonly)BOOL isSelected;
317
321@property(nonatomic, copy, readonly)NSString *imageFilePath;
322
326@property(nonatomic, copy, readonly)NSString *imageName;
327
331@property(nonatomic, assign, readonly)int index;
332@end
333
334
339@protocol ZoomSDKFaceMakeupSettingContextDelegate <NSObject>
340
345- (void)onFaceMakeupItemThumbnailsDownloaded:(ZoomSDKFaceMakeupType)type;
346
352- (void)onFaceMakeupItemDataDownloading:(ZoomSDKFaceMakeupType)type index:(int)index;
353
360- (void)onFaceMakeupItemDataDownloaded:(BOOL)success faceMakeupType:(ZoomSDKFaceMakeupType)type index:(int)index;
361
362@end
363
364
370{
371 id<ZoomSDKFaceMakeupSettingContextDelegate> _delegate;
372}
373
377@property(nonatomic,assign, nullable)id<ZoomSDKFaceMakeupSettingContextDelegate> delegate;
378
384
390
396- (ZoomSDKError)enableFaceMakeupEffectForAllMeeting:(BOOL)enable;
397
403
409
415- (ZoomSDKError)setFaceMakeupImage:(ZoomSDKFaceMakeupImageInfo *)image;
416
422- (ZoomSDKError)setLipsFaceMakeup:(BOOL)enable;
423
430- (ZoomSDKError)setColor:(NSColor *)color type:(ZoomSDKFaceMakeupType)type;
431
438- (ZoomSDKError)setOpacity:(int)opacity type:(ZoomSDKFaceMakeupType)type;
439
450@end
451
452
457@interface ZoomSDK3DAvatarImageInfo: NSObject
458
462@property(nonatomic,assign,readonly)BOOL isSelected;
463
467@property(nonatomic,assign,readonly)BOOL isLastUsed;
468
472@property(nonatomic,copy,readonly,nullable)NSString* imageFilePath;
473
477@property(nonatomic,copy,readonly,nullable)NSString* imageName;
478
482@property(nonatomic,assign,readonly)int index;
483@end
484
490
495
499@property(nonatomic, assign, readonly)BOOL isSelected;
500
504@property(nonatomic, copy, readonly, nullable)NSString* imageFilePath;
505
509@property(nonatomic, copy, readonly, nullable)NSString* imageName;
510
511@end
512
519
524
528@property(nonatomic, retain, readonly)NSColor* color;
529
533@property(nonatomic, assign, readonly)BOOL isSelected;
534
538@property(nonatomic, copy, readonly, nullable)NSString* imageName;
539@end
540
541
546@protocol ZoomSDKCustom3DAvatarElementSettingContextDelegate <NSObject>
547
553- (void)onCustom3DAvatarElementImageModelDataDownloaded:(BOOL)isSuccess elementImage:(ZoomSDKCustom3DAvatarElementImageInfo*)imageInfo;
554@end
555
579
583@property(nonatomic, assign, nullable)id<ZoomSDKCustom3DAvatarElementSettingContextDelegate> delegate;
584
590
597- (BOOL)isCustom3DAvatarElementImageModelDataReady:(ZoomSDKCustom3DAvatarElementImageInfo*)imageInfo;
598
606- (ZoomSDKError)downloadCustom3dAvatarElementImageModelData:(ZoomSDKCustom3DAvatarElementImageInfo*)imageInfo;
607
614- (ZoomSDKError)setCustom3DAvatarElementImage:(ZoomSDKCustom3DAvatarElementImageInfo*)imageInfo;
615
621
627- (ZoomSDKError)setCustom3DAvatarElementColor:(ZoomSDKCustom3DAvatarElementColorInfo*)colorInfo;
628@end
629
634@protocol ZoomSDK3DAvatarSettingDelegate <NSObject>
635
640
645- (void)on3DAvatarItemDataDownloading:(int)index;
646
652- (void)on3DAvatarItemDataDownloaded:(BOOL)isSuccess index:(int)index;
653
659- (void)onCustom3DAvatarImageModelDataDownloaded:(BOOL)isSuccess avatarImage:(ZoomSDK3DAvatarImageInfo *)image;
660
665- (void)onCustom3DAvatarDefaultImageModelDataDownloaded:(BOOL)isSuccess;
666@end
667
672@interface ZoomSDK3DAvatarSetting : NSObject
673{
675 id<ZoomSDK3DAvatarSettingDelegate> _delegate;
676}
680@property(nonatomic,assign, nullable)id<ZoomSDK3DAvatarSettingDelegate> delegate;
681
687
693
699
705- (ZoomSDKError)set3DAvatarImage:(ZoomSDK3DAvatarImageInfo*)image;
706
712
718
724- (ZoomSDKError)enable3DAvatarEffectForAllMeeting:(BOOL)enable;
725
731
737
745
753- (BOOL)isCustom3DAvatarImageModelDataReady:(ZoomSDK3DAvatarImageInfo*)imageInfo;
754
763- (ZoomSDKError)downloadCustom3DAvatarImageModelData:(ZoomSDK3DAvatarImageInfo*)imageInfo;
764
772- (ZoomSDKError)setCustom3DAvatarImage:(ZoomSDK3DAvatarImageInfo*)imageInfo;
773
781
790
802- (ZoomSDKCustom3DAvatarElementSettingContext*_Nullable)startCreateCustom3DAvatar:(NSView*)previewView;
803
811- (ZoomSDKError)finishCreateCustom3DAvatar:(BOOL)save;
812
824- (ZoomSDKCustom3DAvatarElementSettingContext*_Nullable)startEditCustom3DAvatar:(NSView*)previewView avatarImage:(ZoomSDK3DAvatarImageInfo*)imageInfo;
825
833- (ZoomSDKError)finishEditCustom3DAvatar:(BOOL)save;
834
842- (ZoomSDKError)duplicateCustom3DAvatarImage:(ZoomSDK3DAvatarImageInfo*)imageInfo;
843
850- (ZoomSDKError)deleteCustom3DAvatarImage:(ZoomSDK3DAvatarImageInfo*)imageInfo;
851@end
852
853NS_ASSUME_NONNULL_END
854
ZoomSDKVideoEffectType
Enumeration of video effect types.
ZoomSDKSettingVBVideoError
Enumeration of virtual background video errors.
ZoomSDKFaceMakeupType
Enumeration of the types of face makeup effects.
ZoomSDKError
Enumeration of common errors of SDK.
ZoomSDKCustom3DAvatarElementImageType
Enumeration of custom 3D avatar element image types.
ZoomSDKCustom3DAvatarElementColorType
Enumeration of custom 3D avatar element color types.
Represents information of a 3D avatar image.
BOOL isSelected
Determines whether the current image is being used.
BOOL isLastUsed
Determines whether it is the most recently used image.
NSString * imageName
Gets the name of the current image.
int index
Gets the index of the current image.
NSString * imageFilePath
Gets the file path of the current image.
Interface for configuring 3D avatar settings.
NSArray< ZoomSDK3DAvatarImageInfo * > *_Nullable get3DAvatarImageList()
Gets the list of the 3D avatar images.
ZoomSDKVideoLipSyncAvatarPreviewHelper *_Nullable getLipSyncAvatarPreviewHelper()
Gets the object to preview the lip-sync avatar.
BOOL is3DAvatarSupportedByDevice()
Determines whether the 3D avatar feature is supported by the video device.
BOOL is3DAvatarEffectForAllMeetingEnabled()
Determines whether the 3D avatar is enabled when joining a meeting.
BOOL is3DAvatarEnabled()
Determines whether the 3D avatar feature is enabled.
BOOL isCustom3DAvatarEnabled()
Determines whether the custom 3D avatar feature is enabled.
NSArray< ZoomSDK3DAvatarImageInfo * > *_Nullable getCustom3DAvatarImageList()
Gets the list of available custom 3D avatar images. Each image represents a custom 3D avatar that can...
ZoomSDKVideoLipSyncAvatarPreviewHelper * lipsyncAvatarPreviewHelper
id< ZoomSDK3DAvatarSettingDelegate > _delegate
BOOL isCustom3DAvatarDefaultImageModelDataReady()
Checks whether the model data for default custom 3D avatar elements image have been fully downloaded ...
ZoomSDKSettingTestVideoDeviceHelper *_Nullable getTestVideoDeviceHelper()
Gets the object to test the video device.
ZoomSDKError downloadCustom3DAvatarDefaultImageModelData()
Downloads the model data required for a default custom 3D avatar image. Call this method if isCustom3...
id< ZoomSDK3DAvatarSettingDelegate > delegate
Gets or sets the delegate for receiving 3D avatar setting events.
Custom 3D avatar element color information interface.
BOOL isSelected
Determines whether the current element color is being used.
ZoomSDKCustom3DAvatarElementColorType custom3DAvatarElementColorType
Gets the type of the current element color.
NSString * imageName
Gets the name of the current element color.
NSColor * color
Gets the color of the current element color in RGB format.
Represents information of a custom 3D avatar element image.
BOOL isSelected
Determines whether the current element image is being used.
ZoomSDKCustom3DAvatarElementImageType custom3DAvatarElementImageType
Gets the type of the current element image.
NSString * imageName
Gets the name of the current element image.
NSString * imageFilePath
Gets the file path of the current element image.
Context interface for configuring custom 3D avatar elements during avatar creation or editing.
id< ZoomSDKCustom3DAvatarElementSettingContextDelegate > delegate
Gets or sets the delegate for receiving custom 3D avatar element setting events.
NSArray< ZoomSDKCustom3DAvatarElementImageInfo * > *_Nullable getCustom3DAvatarElementImageList()
Gets the list of available custom 3D avatar element images.
NSArray< ZoomSDKCustom3DAvatarElementColorInfo * > *_Nullable getCustom3DAvatarElementColorList()
Gets the list of the custom 3D avatar element colors.
Represents information about a face makeup image in Zoom SDK.
int index
Gets the current face makeup's index.
NSString * imageFilePath
Gets the file path of the current image.
BOOL isSelected
Determines if the current face makeup item is being used.
ZoomSDKFaceMakeupType faceMakeupType
Gets the current image's type.
NSString * imageName
Gets the current image's name.
Provides APIs to manage face makeup settings in Zoom SDK.
NSArray< ZoomSDKFaceMakeupImageInfo * > *_Nullable getFaceMakeupImageList()
Gets the list of face makeup images.
BOOL isFaceMakeupEffectForAllMeetingEnabled()
Determines if the selected face makeup effect is always used by future meetings.
ZoomSDKError resetAllFaceMakeupEffect()
Disables all the face makeup effect and reset color or opactity value to default value.
BOOL isSupportFaceMakeup()
Determines if the meeting supports the face makeup feature.
id< ZoomSDKFaceMakeupSettingContextDelegate > delegate
The delegate to receive face makeup setting events.
ZoomSDKSettingTestVideoDeviceHelper *_Nullable getTestVideoDeviceHelper()
Gets the pointer to ZoomSDKSettingTestVideoDeviceHelper for previewing the video with face makeup ima...
BOOL isFaceMakeupEnabled()
Determines if the face makeup feature is enabled.
id< ZoomSDKFaceMakeupSettingContextDelegate > _delegate
Helper class for testing video devices.
Information of a video filter (face effect) item.
NSString *_Nullable getImageName()
Gets image file name of the virtual background image.
int getIndex()
Gets the virtual background image or video item's index.
ZoomSDKVideoEffectType getType()
Gets the virtual background image or video item's type.
NSString *_Nullable getImageFilePath()
Gets file path of the virtual background image.
BOOL isSelected()
Determines if it is the selected virtual background image.
Helper class to control preview of lip-sync avatars.
Information of a virtual background image or video item.
BOOL isAllowDelete()
Determines if the virtual background item can be deleted.
NSString *_Nullable getImageFilePath()
Gets file path of the virtual background image.
NSString *_Nullable getImageName()
Gets image file name of the virtual background image.
BOOL isVideo()
Determines if the selected virtual background is video.
BOOL isSelected()
Determines if it is the selected virtual background image.
Interface for configuring virtual background and video filter settings.
NSColor *_Nullable getVBReplaceColor()
Gets the selected replace color of virtual background images.
BOOL isDeviceSupportSmartVirtualBackgroundVideo()
Determines if the machine can support the smart virtual background video feature.
BOOL isDeviceSupportSmartVirtualBG()
Determines if the machine can support the smart virtual background feature.
id< ZoomSDKVirtualBackgroundSettingDelegate > delegate
BOOL isSupportVirtualBG()
Determines if support virtual background feature.
BOOL isVideoFilterEnabled()
Determines if face makeup feature is enabled.
BOOL isSupportVirtualBackgroundVideo()
Determines if meeting supports the video virtual video background feature.
BOOL isDeviceSupportGreenVirtualBackgroundVideo()
Determines if the machine can support the green virtual background video feature.
ZoomSDKSettingTestVideoDeviceHelper *_Nullable getSettingVideoTestHelper()
Gets the object to video device test helper.
id< ZoomSDKVirtualBackgroundSettingDelegate > _delegate
BOOL isUsingGreenScreenOn()
Determines if the using green screen option is enabled.
ZoomSDKError startSelectReplaceVBColor()
Starts selected replace color of virtual background images.
BOOL isSupportVideoFilter()
Determines if support face makeup feature.
NSArray *_Nullable getVideoFilterItemList()
Gets the array of face makeup images.
NSArray *_Nullable getBGItemList()
Gets the array of virtual background video item.
BOOL isAllowRemoveVBItem()
Determines if the meeting supports the removing a new virtual background item feature.
BOOL isAllowAddNewVBItem()
Determines if the meeting supports the adding a new virtual background item feature.
void on3DAvatarItemThumbnailsDownloaded()
Callback event when all 3D avatar items' thumbnails have been downloaded.
void onVideoFilterItemThumnailsDownloaded()
Callback event of notification that the thumbnails of all video filter items have been downloaded.
void onSelectedVBImageChanged()
Notify the selected virtual background image has been changed, user can get the new selected image th...