zoom_video_sdk_user_helper_interface.h

Go to the documentation of this file.

 
#ifndef _ZOOM_VIDEO_SDK_USER_HELPER_INTERFACE_H_
#define _ZOOM_VIDEO_SDK_USER_HELPER_INTERFACE_H_
#include "zoom_video_sdk_def.h"
#include "zoom_video_sdk_vector_interface.h"
 
BEGIN_ZOOM_VIDEO_SDK_NAMESPACE
struct ZoomVideoSDKVideoStatus
{
    bool isHasVideoDevice;  
    bool isOn;  
 
    ZoomVideoSDKVideoStatus()
    {
        isHasVideoDevice = false;
        isOn = false;
    }
};
 
typedef enum
{
    ZoomVideoSDKNetwork_None,
    ZoomVideoSDKNetwork_Bad,
    ZoomVideoSDKNetwork_Normal,
    ZoomVideoSDKNetwork_Good,
}ZoomVideoSDKNetworkStatus;
 
typedef enum {
    ZoomVideoSDKAudioType_VOIP,
    ZoomVideoSDKAudioType_TELEPHONY,
    ZoomVideoSDKAudioType_None,
}ZoomVideoSDKAudioType;
 
struct ZoomVideoSDKAudioStatus
{
    ZoomVideoSDKAudioType audioType;
    bool isMuted;
    bool isTalking;
 
    ZoomVideoSDKAudioStatus()
    {
        audioType = ZoomVideoSDKAudioType_None;
        isMuted = false;
        isTalking = false;
    }
};
 
struct ZoomVideoSDKVideoStatisticInfo
{
    int width;
    int height;
    int fps;
    int bpf;
    ZoomVideoSDKNetworkStatus videoNetworkStatus;
 
    ZoomVideoSDKVideoStatisticInfo()
    {
        width = 0;
        height = 0;
        fps = 0;
        bpf = 0;
        videoNetworkStatus = ZoomVideoSDKNetwork_None;
    }
};
 
struct ZoomVideoSDKShareStatisticInfo
{
    int width;
    int height;
    int fps;
    int bpf;
    ZoomVideoSDKNetworkStatus shareNetworkStatus;
 
    ZoomVideoSDKShareStatisticInfo()
    {
        width = 0;
        height = 0;
        fps = 0;
        bpf = 0;
        shareNetworkStatus = ZoomVideoSDKNetwork_None;
    }
};
 
struct ZoomVideoSDKShareCursorData
{
    unsigned int source_id;
    int x;
    int y;
 
    ZoomVideoSDKShareCursorData()
    {
        source_id = 0;
        x = 0;
        y = 0;
    }
};
 
typedef enum
{
    ZoomVideoSDKResolution_90P = 0,
    ZoomVideoSDKResolution_180P,
    ZoomVideoSDKResolution_360P,
    ZoomVideoSDKResolution_720P,
    ZoomVideoSDKResolution_1080P,
    ZoomVideoSDKResolution_Auto = 100, 
}ZoomVideoSDKResolution;
 
typedef enum 
{
    RawData_On,
    RawData_Off,
}RawDataStatus;
 
class IZoomVideoSDKRawDataPipeDelegate
{
public:
    virtual void onRawDataFrameReceived(YUVRawDataI420* data_) = 0;
    
    virtual void onRawDataStatusChanged(RawDataStatus status) = 0;
    
    virtual void onShareCursorDataReceived(ZoomVideoSDKShareCursorData info) = 0;
 
    virtual ~IZoomVideoSDKRawDataPipeDelegate() {};
};
 
class IZoomVideoSDKRawDataPipe
{
public:
    virtual ZoomVideoSDKErrors subscribe(ZoomVideoSDKResolution resolution, IZoomVideoSDKRawDataPipeDelegate* listener) = 0;
    
    virtual ZoomVideoSDKErrors unSubscribe(IZoomVideoSDKRawDataPipeDelegate* listener) = 0;
    
    virtual ZoomVideoSDKRawDataType getRawdataType() = 0;
    
    virtual ZoomVideoSDKVideoStatus getVideoStatus() = 0;
    
    virtual const zchar_t* getVideoDeviceName() = 0;
    
    virtual ZoomVideoSDKShareStatus getShareStatus() = 0;
    
    virtual ZoomVideoSDKShareCapturePauseReason getShareCapturePauseReason() = 0;
    
    virtual ZoomVideoSDKShareType getShareType() = 0;
    
    virtual ZoomVideoSDKVideoStatisticInfo getVideoStatisticInfo() = 0;
};
 
class IZoomVideoSDKCameraControlRequestHandler
{
public:
    virtual ~IZoomVideoSDKCameraControlRequestHandler() {}
    virtual ZoomVideoSDKErrors approve() = 0;
    
    virtual ZoomVideoSDKErrors decline() = 0;
};
 
class IZoomVideoSDKRemoteCameraControlHelper
{
public:
    virtual ~IZoomVideoSDKRemoteCameraControlHelper() {}
    virtual ZoomVideoSDKErrors requestControlRemoteCamera() = 0;
    
    virtual ZoomVideoSDKErrors giveUpControlRemoteCamera() = 0;
    
    virtual ZoomVideoSDKErrors turnLeft(unsigned int range = 50) = 0;
    
    virtual ZoomVideoSDKErrors turnRight(unsigned int range = 50) = 0;
    
    virtual ZoomVideoSDKErrors turnUp(unsigned int range = 50) = 0;
    
    virtual ZoomVideoSDKErrors turnDown(unsigned int range = 50) = 0;
    
    virtual ZoomVideoSDKErrors zoomIn(unsigned int range = 50) = 0;
    
    virtual ZoomVideoSDKErrors zoomOut(unsigned int range = 50) = 0;
};
 
 
typedef enum
{
    ZoomVideoSDKVideoAspect_Original, 
    ZoomVideoSDKVideoAspect_Full_Filled, 
    ZoomVideoSDKVideoAspect_LetterBox, 
    ZoomVideoSDKVideoAspect_PanAndScan, 
}ZoomVideoSDKVideoAspect;
 
typedef enum
{
    ZoomVideoSDKSubscribeFailReason_None = 0,
    ZoomVideoSDKSubscribeFailReason_HasSubscribe1080POr720P,
    ZoomVideoSDKSubscribeFailReason_HasSubscribeTwo720P,
    ZoomVideoSDKSubscribeFailReason_HasSubscribeExceededLimit,
    ZoomVideoSDKSubscribeFailReason_HasSubscribeTwoShare,
    ZoomVideoSDKSubscribeFailReason_HasSubscribeVideo1080POr720PAndOneShare,
    ZoomVideoSDKSubscribeFailReason_TooFrequentCall,
#if defined ANDROID || defined __IOS__
    ZoomVideoSDKSubscribeFailReason_HasSubscribeOneShare,
#endif
}ZoomVideoSDKSubscribeFailReason;
 
typedef enum
{   
    ZoomVideoSDKCanvasType_VideoData = 1, 
    ZoomVideoSDKCanvasType_ShareData, 
}ZoomVideoSDKCanvasType;
 
#if !defined __linux && !defined ANDROID
class IZoomVideoSDKCanvas
{
public:
    virtual ~IZoomVideoSDKCanvas() {}
    virtual ZoomVideoSDKErrors subscribeWithView(void* handle, ZoomVideoSDKVideoAspect videoAspect, ZoomVideoSDKResolution resolution = ZoomVideoSDKResolution_Auto) = 0;
    
    virtual ZoomVideoSDKErrors unSubscribeWithView(void* handle) = 0;
    
    virtual ZoomVideoSDKErrors setAspectMode(void* handle, ZoomVideoSDKVideoAspect aspect) = 0;
    
    virtual ZoomVideoSDKErrors setResolution(void* handle, ZoomVideoSDKResolution resolution) = 0;
    
    virtual ZoomVideoSDKCanvasType canvasType() = 0;
};
#endif 
class IZoomVideoSDKShareAction;
class IZoomVideoSDKUser
{
public:
    virtual ~IZoomVideoSDKUser(){}
    virtual const zchar_t* getCustomIdentity() = 0;
    
    virtual const zchar_t* getUserName() = 0;
    
    virtual const zchar_t* getUserID() = 0;
    
    virtual ZoomVideoSDKAudioStatus getAudioStatus() = 0;
    
    virtual const zchar_t* getUserReference() = 0;
    
    virtual bool isHost() = 0;
    
    virtual bool isManager() = 0;
    
    virtual bool isVideoSpotLighted() = 0;
    
    virtual ZoomVideoSDKVideoStatisticInfo getVideoStatisticInfo() = 0;
    
    virtual ZoomVideoSDKShareStatisticInfo getShareStatisticInfo() = 0;
    
    virtual IZoomVideoSDKRawDataPipe* GetVideoPipe() = 0;
 
#if !defined __linux && !defined ANDROID
    virtual IZoomVideoSDKCanvas* GetVideoCanvas() = 0;
#endif
    virtual IVideoSDKVector<IZoomVideoSDKShareAction*>* getShareActionList() = 0;
    
    virtual IZoomVideoSDKRemoteCameraControlHelper* getRemoteCameraControlHelper() = 0;
    
    virtual IVideoSDKVector<IZoomVideoSDKRawDataPipe*>* getMultiCameraStreamList() = 0;
 
    virtual unsigned int getAudioLevel() = 0;
    
    virtual bool getUserVolume(float& volume, bool isShareAudio = false) = 0;
 
    virtual bool canSetUserVolume(bool isShareAudio = false) = 0;
    
    virtual bool hasIndividualRecordingConsent() = 0;
 
    virtual bool setUserVolume(float volume, bool isShareAudio = false) = 0;
    
    virtual bool getUserPlaybackVolume(float& volume, bool isShareAudio = false) = 0;
    
    virtual bool canSetUserPlaybackVolume(bool isShareAudio = false) = 0;
    
    virtual bool setUserPlaybackVolume(float volume, bool isShareAudio = false) = 0;
    
    virtual ZoomVideoSDKErrors transferFile(const zchar_t* filePath) = 0;
    
 
    virtual bool isIncomingLiveStreamUser() = 0;
    
    virtual bool isInSubSession() = 0;
 
#if !defined (__linux) || defined ANDROID
    virtual ZoomVideoSDKWhiteboardStatus getWhiteboardStatus() = 0;
#endif
    
    virtual ZoomVideoSDKNetworkStatus getNetworkLevel(ZoomVideoSDKDataType type) = 0;
    
    virtual ZoomVideoSDKNetworkStatus getOverallNetworkLevel() = 0;
};
class IZoomVideoSDKUserHelper
{
public:
    virtual bool changeName(const zchar_t* name, IZoomVideoSDKUser* pUser) = 0;
    
    virtual bool makeHost(IZoomVideoSDKUser* pUser) = 0;
    
    virtual bool makeManager(IZoomVideoSDKUser* pUser) = 0;
    
    virtual ZoomVideoSDKErrors revokeManager(IZoomVideoSDKUser* pUser) = 0;
 
    virtual bool removeUser(IZoomVideoSDKUser* pUser) = 0;
    
    virtual bool reclaimHost() = 0;
};
END_ZOOM_VIDEO_SDK_NAMESPACE
#endif