logo
On this page

Class

2026-01-23
IZegoSuperBoardManagerListenerZegoCreateFileConfig
ZegoCreateWhiteboardConfigZegoSuperBoardCursorAttribute
ZegoSuperBoardCursorTitleStyleZegoSuperBoardInitConfig
ZegoSuperBoardManagerZegoSuperBoardSubView
ZegoSuperBoardSubViewModelZegoSuperBoardView
ZegoUploadCustomH5Config

IZegoSuperBoardManagerListener

Monitoring the status of the whiteboard

Details

Monitoring the status of the whiteboard, including the creation, deletion, switching of subViews, changes in operating permissions and other errors in use, etc.For the monitoring of a single subView, please refer to IZegoSuperBoardViewListener

  • Available since: v2.0.0

Declared in IZegoSuperBoardManagerListener.java

Methods

onError

onError
public void onError(int errorCode)
Error callback in the process of using whiteboard,Error code see ZegoSuperBoardError.
Declared in IZegoSuperBoardManagerListener.java

Parameters

NameTypeDescription
errorCodeintDescription: error code.
  • When to call /Trigger: Error callback in the process of using whiteboard
  • Available since: v2.0.0.

onRemoteSuperBoardSubViewAdded

onRemoteSuperBoardSubViewAdded
public void onRemoteSuperBoardSubViewAdded(ZegoSuperBoardSubViewModel subViewModel)
Notification of new whiteboard
Declared in IZegoSuperBoardManagerListener.java

Parameters

NameTypeDescription
subViewModelZegoSuperBoardSubViewModelDescription: New model
  • When to call /Trigger: After other users in the same room successfully create a whiteboard (call [createWhiteboardView]), the local end will receive this notification.
  • Available since: v2.0.0 .

onRemoteSuperBoardSubViewRemoved

onRemoteSuperBoardSubViewRemoved
public void onRemoteSuperBoardSubViewRemoved(ZegoSuperBoardSubViewModel subViewModel)
Notice of the whiteboard being deleted
Declared in IZegoSuperBoardManagerListener.java

Parameters

NameTypeDescription
subViewModelZegoSuperBoardSubViewModelDescription: Deleted model.
  • When to call /Trigger: After other members in the same room successfully destroy the whiteboard (call [destroySuperBoardSubView]), the local end will receive this notification.
  • Available since: v2.0.0

onRemoteSuperBoardSubViewSwitched

onRemoteSuperBoardSubViewSwitched
public void onRemoteSuperBoardSubViewSwitched(String uniqueID)
Notification of whiteboard switching
Declared in IZegoSuperBoardManagerListener.java

Parameters

NameTypeDescription
uniqueIDString
  • When to call /Trigger: After other members in the same room have successfully switched the whiteboard (calling [switchSubView]), the local end will receive this notification.
  • Available since: v2.0.0

onRemoteSuperBoardSubViewExcelSwitched

onRemoteSuperBoardSubViewExcelSwitched
public void onRemoteSuperBoardSubViewExcelSwitched(String uniqueID, int sheetIndex)
Notice of Excel whiteboard switching sheet
Declared in IZegoSuperBoardManagerListener.java

Parameters

NameTypeDescription
uniqueIDStringDescription:
sheetIndexintDescription:
  • Available since: v2.0.0.

onRemoteSuperBoardAuthChanged

onRemoteSuperBoardAuthChanged
public void onRemoteSuperBoardAuthChanged(HashMap<String,Integer> authInfo)
Whiteboard operation permission change callback
Declared in IZegoSuperBoardManagerListener.java

Parameters

NameTypeDescription
authInfoHashMap<String,Integer>Description: Contains "scale" and "scroll" 2 keys, the value is 0 or 1 (0 represents the corresponding permission is closed, 1 represents the corresponding permission is open)

Details

The whiteboard operation permission change callback is used to control the operation of the whiteboard, including zooming and scrolling.

  • When to call /Trigger: Received the permission change notification in the background.
  • Available since: v2.0.0

onRemoteSuperBoardGraphicAuthChanged

onRemoteSuperBoardGraphicAuthChanged
public void onRemoteSuperBoardGraphicAuthChanged(HashMap<String,Integer> authInfo)
Callback for change of primitive operation permission
Declared in IZegoSuperBoardManagerListener.java

Parameters

NameTypeDescription
authInfoHashMap<String,Integer>Description: Contains 5 keys: "create", "delete", "move", "update", and "clear". The value is 0 or 1 (0 represents the corresponding permission is closed, and 1 represents the corresponding permission is open).

Details

The primitive operation permissions include creating, deleting, moving, updating, and clearing all primitives.

  • When to call /Trigger: Received the permission change notification in the background.
  • Available since: v2.0.0

ZegoCreateFileConfig

Details

The interface parameters are used to construct the class, passing in the parameters needed to create the file.

  • Use cases: The createFileView interface is needed in the call.

Declared in ZegoCreateFileConfig.java

Properties

fileID

fileID
public String fileID

ID of the file

Required or not: Mandatory

  • Available since: v2.0.0

ZegoCreateWhiteboardConfig

Details

The interface parameters are used to construct the class with the parameters that are passed in to create the whiteboard.

  • Use cases: In the call to createWhiteboardView the interface is passed in.

Declared in ZegoCreateWhiteboardConfig.java

Properties

name

name
public String name

Create whiteboard Is the name of the whiteboard to be set.

Required or not: Mandatory

Value range value can contain 128 bytes and can be in Both Chinese and English.

  • Available since: v2.0.0

perPageWidth

perPageWidth
public int perPageWidth

Width of each whiteboard page.

Required or not: Mandatory

  • Value range: Positive integer greater than 0.
  • Available since: 2.0.0及以上

perPageHeight

perPageHeight
public int perPageHeight

Height of each whiteboard page.

Required or not: Mandatory

  • Value range: Positive integer greater than 0.
  • Available since: v2.0.0

pageCount

pageCount
public int pageCount

Total number of pages。

Required or not: Mandatory

  • Value range: Greater than 0.
  • Available since: v2.0.0

ZegoSuperBoardCursorAttribute

Details

Detailed description: The interface parameter construction class uses the parameters required by the incoming cursor style.

Business scenario: It needs to be passed when calling the [setCustomCursorAttribute:cursorAttribute:complete:] interface.

Declared in ZegoSuperBoardCursorAttribute.java

Properties

url

url
public String url
  • Default value: Supported version: v2.4.0

pox_x

pox_x
public int pox_x
  • Default value: 0 Supported version: v2.4.0

pox_y

pox_y
public int pox_y
  • Default value: 18 Supported version: v2.4.0

titleStyle

titleStyle
  • Default value: Refer to ZegoSuperBoardCursorTitleStyle class Supported version: v2.4.0

ZegoSuperBoardCursorTitleStyle

Cursor custom text information

Details

Cursor custom text information Business scenario: Available when you need to display cursor custom text

Declared in ZegoSuperBoardCursorTitlePosition.java

Properties

title

title
public String title

Cursor custom text content

  • Required: no
  • Default value: ""
  • Recommended value: User login name display
  • Value range: 15 characters or less

bold

bold
public boolean bold

Whether the cursor custom text is bold

  • Required: no
  • Default value: false

italic

italic
public boolean italic

Whether the cursor custom text is italic

  • Required: no
  • Default value: false

size

size
public int size

Cursor custom text font size

  • Required: 否
  • Default value: 16
  • Value range: 12-20

color

color
public int color

Cursor custom text font color

  • Required: no
  • Default value: white

backgroundColor

backgroundColor
public int backgroundColor

Cursor custom text font background color

  • Required: no

position

position

Customize the position of the text relative to the cursor

  • Required: no

ZegoSuperBoardInitConfig

Details

The interface parameters are used to construct the class, and the parameters needed to initialize the SDK are initialized with the constructs.

  • Use cases: The init SDK interface initWithConfig needs to be passed in.

Declared in ZegoSuperBoardInitConfig.java

Properties

appID

appID
public long appID

ZEGO application ID for developers, please apply from ZEGO management console.

Required or not: Mandatory

Reference range: 0-4294967295.

token

token
public String token

The login verification token is obtained by registering the project in the instant console to obtain the key plus the specified algorithm. The test phase can be obtained through the interface provided by ZEGO, and the formal environment must be implemented by the user.

parentDomID

parentDomID
public String parentDomID

display the ID of the parent container of the target view of the subView

  • Required: yes
  • Caution: When adding subView to the view, you must confirm that the parent container positioning method needs to be relative positioning and the physical size is not 0

userID

userID
public String userID

User ID, please do not fill in sensitive user information in this field, including but not limited to mobile phone number, ID number, passport number, real name, etc.

appSign

appSign
public String appSign
  • Value range: Detailed description: Value range: '0' ~ '9', 'a' ~ 'z'. Example: "9dc9a25bh2f2137446897071c8c033fa33b91c3dd2a85e0c000ae82c0dad3". Version 2.3.0 and above appSign allows to pass blank or no pass. If it is empty or not passed, you can pass the token for initialization.please refer to Using Token Authentication.

cacheFolder

cacheFolder
public String cacheFolder

cache directory

logFolder

logFolder
public String logFolder

log directory

ZegoSuperBoardManager

Details

Interface class, SDK initialization, global function Settings in the room, create files or pure whiteboard, etc.

  • Use cases: It is used to initialize the SDK, set some whiteboard tools, zoom synchronization, and brush effects, obtain boardView, and create pure whiteboard and files when the boardView mode is enabled.
  • Platform differences: There is no

Declared in ZegoSuperBoardManager.java

Properties

enableCustomCursor

enableCustomCursor
public boolean enableCustomCursor

Detailed description: Set whether to enable custom cursor, set to true to display the cursor. The default is true

Business scenario: the cursor function is displayed during the graffiti process.

Timing of calling: After initializing the SDK.

Supported version: v2.2.0

enableRemoteCursorVisible

enableRemoteCursorVisible
public boolean enableRemoteCursorVisible

Detailed description: Set whether to display the remote cursor or not, set to true to display the remote cursor. The default is true.

Business scenario: display the remote cursor function during the graffiti process.

Timing of calling: After initializing the SDK.

Supported version: v2.2.0

superBoardMaxScaleFactor

superBoardMaxScaleFactor
~ ~ superBoardMaxScaleFactor

Method description: Set the maximum zoom factor of Super Whiteboard (file and whiteboard), which is 3x by default. The range that can be set is [1,10] Call timing: After initialization, before creating the file/whiteboard, and after unInit expires.

Methods

setSuperBoardMaxScaleFactor

setSuperBoardMaxScaleFactor
public void setSuperBoardMaxScaleFactor(Float scaleFactor)
Set the maximum zoom factor of Super Whiteboard (file and whiteboard), which is 3x by default. The range that can be set is [1,10]
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
scaleFactorFloatDescription
maximum zoom factor of Super Whiteboard (file and whiteboard)

Details

Set the maximum zoom factor of Super Whiteboard (file and whiteboard), which is 3x by default. The range that can be set is [1,10]

  • When to call /Trigger: After initialization, before creating the file/whiteboard, and after unInit expires.
  • Available since: 2.3.7

renewToken

renewToken
public void renewToken(String token)
update token
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
tokenStringA token to be updated.
  • Default value: None

Call time: after initializing the SDK, with the help of the upcoming expiration callback [tokenwillexpire] interface of zego SDK, receive the upcoming expiration callback of the token, and actively update the file service token of the super whiteboard.

Scope of influence: the expiration time contained in the token will trigger the [tokenwillexpire] callback 30s before expiration

Related callback: [tokenwillexpire]

Related interfaces: None

  • Platform differences: None

enableCustomCursor

enableCustomCursor
void enableCustomCursor(boolean enable)
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
enablebooleanWhether to open

Details

Supported version: 2.2.0 and above.

Detailed description: Set whether to use a custom cursor for whiteboard graffiti, set it to true to set the cursor to a custom picture.

Required or not: Yes.

Call timing: After the SDK is initialized.

enableRemoteCursorVisible

enableRemoteCursorVisible
void enableRemoteCursorVisible(boolean enable)
Set whether to enable the display of remote custom cursor
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
enablebooleanWhether to open

Details

Supported version: 2.2.0 and above.

Required or not: Yes.

Call timing: After the SDK is initialized.

getCustomText

getCustomText
String getCustomText()
Get the default value of the text teaching aid
Declared in ZegoSuperBoardManager.java

Get the default value of the text teaching aid

  • Default value: text
  • When to call /Trigger: After initializing the SDK
  • Available since: 2.0.0

Default Values for Text Aids

getInstance

getInstance
ZegoSuperBoardManager getInstance()
Get ZegoSuperBoardManager instance object
Declared in ZegoSuperBoardManager.java
  • When to call /Trigger: After integrating ZegoSuperBoard SDK, before initializing ZegoSuperBoard SDK.
  • Available since: v2.0.0

Detailed description: Get the ZegoSuperBoardManager instance object to call the interface method in ZegoSuperBoardManager.

ZegoSuperBoardManager instance object

getSuperBoardSubViewModelList

getSuperBoardSubViewModelList
List<ZegoSuperBoardSubViewModel> getSuperBoardSubViewModelList()
Get the information of superBoardSubView saved by the SDK
Declared in ZegoSuperBoardManager.java

Through superBoardSubViewModelList, access to the current existing superBoardSubView room number and superBoardSubView information.

  • Use cases: After entering the room, you need to obtain the superBoardSubView list in the room for display, and switch the current superBoardSubView in the list.
  • When to call /Trigger: After initializing ZegoSuperboard SDK.
  • Available since: v2.0.0

Information of superBoardSubView saved by the SDK

isCustomCursorEnabled

isCustomCursorEnabled
boolean isCustomCursorEnabled()
Whether to turn on the cursor display
Declared in ZegoSuperBoardManager.java

Supported version: 2.2.0 and above.

Detailed description: Whether to turn on the cursor display

Calling time: After initializing the SDK.

Whether to turn on the cursor display

isEnableResponseScale

isEnableResponseScale
boolean isEnableResponseScale()
Get whether it will respond to the zoom factor synchronized by other users
Declared in ZegoSuperBoardManager.java

Get whether it will respond to the zoom factor synchronized by other users

  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0.

whether it will respond to the zoom factor synchronized by other users

isEnableSyncScale

isEnableSyncScale
boolean isEnableSyncScale()
Get whether the current zoom factor will be synchronized to others
Declared in ZegoSuperBoardManager.java

Get whether the current zoom factor will be synchronized to others

  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0.

whether the current zoom factor will be synchronized to others

isRemoteCursorVisibleEnabled

isRemoteCursorVisibleEnabled
boolean isRemoteCursorVisibleEnabled()
Whether the remote cursor is on
Declared in ZegoSuperBoardManager.java

Supported version: 2.2.0 and above.

Detailed description: Whether the remote cursor is on

Required or not: Yes.

Calling time: After initializing the SDK.

Whether the remote cursor is on

setCustomText

setCustomText
void setCustomText(String text)
Default text for custom text teaching aids
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
textStringDefault text for custom text teaching aids

Details

Default text for custom text teaching aids

  • Default value: text
  • When to call /Trigger: After initializing the SDK, before using the text
  • Available since: 2.0.0

setManagerListener

setManagerListener
void setManagerListener(IZegoSuperBoardManagerListener listener)
set callback for SDK
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
listenerIZegoSuperBoardManagerListenerMonitor whiteboard callback information
  • When to call /Trigger: after init
  • Available since: v2.0.0

uploadFile

uploadFile
int uploadFile(String filePath, ZegoSuperBoardRenderType renderType, IZegoSuperBoardUploadFileListener listener)
Upload files to the ZegoSuperBoard service
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
filePathStringThe absolute path of the files to be uploaded can be PPT, PDF, XLS, JPG, JPEG, PNG, BMP, and TXT files. For details, please refer to File specifications.
renderTypeZegoSuperBoardRenderTypeAfter the upload file transcoding rendering mode type, suggest set to VectorAndIMG, see ZegoSuperBoardRenderType.
listenerIZegoSuperBoardUploadFileListenerThe upload progress and result callback. In the process of uploading files, you will receive multiple calls. For details, please refer to the introduction of IZegoSuperBoardUploadFileListener

Details

During the upload process, the SDK will format the file according to the passed [renderType]. After the format conversion, the rendering mode of the file depends on the passed [renderType]. The progress information of the upload can be obtained in the result callback

  • Use cases: Upload files to the ZegoDocs service.
  • Caution: There will be multiple callbacks during the upload phase, please refer to the definition of ZegoSuperBoardUploadState for details

When to call

ZegSuperBoard SDK is initialized.

  • Available since: v2.0.0

Return

Return the request seq to upload the file

cancelUploadFile

cancelUploadFile
void cancelUploadFile(int seq, IZegoSuperBoardApiCalledCallback listener)
Cancel the upload action during file upload
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
seqintUpload seq returned when uploadFile is called.
listenerIZegoSuperBoardApiCalledCallbackCancel upload file result callback.

Details

To cancel the file upload operation, the seQ of the corresponding upload task must be passed.

  • Use cases: File uploading to the ZegoDocs service is interrupted during the process.

When to call

when the uploadFile interface is in the process of uploading a file.

cacheFile

cacheFile
int cacheFile(String fileID, IZegoSuperBoardCacheFileListener listener)
Cache files to local storage
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
fileIDStringThe fileID to be cached.
listenerIZegoSuperBoardCacheFileListenerThe callback that contains the progress and result of file download operation

Details

You can save the corresponding file to the local.

  • Use cases: Save the file to the local directory. You do not need to request the network to open the file next time, which improves the opening speed.
  • When to call: You need to call it after initWithConfig.
  • Available since: v2.0.0

Return

The sequence number of caching operation

cancelCacheFile

cancelCacheFile
public void cancelCacheFile(int seq, IZegoSuperBoardApiCalledCallback listener)
Cancel the cache action in the process of caching files
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
seqintThe sequence number of caching operation.
listenerIZegoSuperBoardApiCalledCallbackCallback when cancelling finishes.

Details

You can cancel the operation that is caching the file. You need to pass in the seQ corresponding to the operation of caching the file. After canceling the operation, the file will not be cached locally.

  • Use cases: The cancelCacheFile method can be called to cancel the operation that needs to be interrupted during the execution of the cache file.
  • When to call: You need to call it after init.
  • Related APIs: cacheFile.
  • Available since: v2.0.0

Return

Operation results

queryFileCached

queryFileCached
public void queryFileCached(String fileID, IZegoDocsViewQueryCachedListener listener)
Check if the file cache exists
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
fileIDStringThe ID of the file to be queried.
listenerIZegoDocsViewQueryCachedListenerCallback when query operation finishes.

Details

The ID of the corresponding file can be used to check whether the file has been cached locally.

  • Use cases: None Example Query whether the file cache exists.
  • When to call: You need to call it after init.
  • Related APIs: cancelCacheFile.
  • Available since: v2.0.0

uploadH5File

uploadH5File
int uploadH5File(String file, ZegoUploadCustomH5Config config, IZegoSuperBoardUploadFileListener listener)
Upload custom H5 courseware
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
fileStringLocal path for custom courseware
configZegoUploadCustomH5ConfigConfiguration of H5 courseware customization
listenerIZegoSuperBoardUploadFileListenerThe upload progress callback. In the process of uploading files, you will receive multiple callbacks. For details, please refer to the introduction of IZegoSuperBoardUploadFileListener.

Details

During the upload process, SDK will convert the format of the file according to the incoming [config]. After the format conversion, the width and height of the page number of the file and whether the thumbnail is included depend on the incoming [config]. The progress information of the upload can be obtained in the result callback.

  • Use cases: Upload custom H5 courseware.
  • When to call: You need to call it after the initialization is successful.
  • Available since: v2.0.0

Return

Return the result seq of uploadH5File method

setCustomFontFromAsset

setCustomFontFromAsset
void setCustomFontFromAsset(String regularAssetPath, String boldAssetPath)
Set custom font source file path
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
regularAssetPathStringFont name of regular font. Please contact technical support to obtain the font.
boldAssetPathStringFont name of the bold font. Please contact technical support to obtain the font.

Details

You need to set a new custom font style for the text tool on the whiteboard.

  • Use cases: Set custom new fonts.
  • When to call: This is called after the whiteboard or file has been created.
  • Caution: Only specific fonts are supported, and the font files provided by us need to be built into the project, please contact technical support to obtain the font file and the corresponding font name.
  • Available since: v2.0.0

init

init
void init(Application application, ZegoSuperBoardInitConfig initConfig, IZegoSuperBoardInitCallback callback)
Initialize the ZegoSuperBoard SDK
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
applicationApplicationapp's appcalition
initConfigZegoSuperBoardInitConfigConfiguration information required for SDK initialization
callbackIZegoSuperBoardInitCallbackInitialization result callback

Details

Method to initialize the ZegoSuperBoard SDK.

  • Use cases: Initialize the ZegoSuperBoard SDK.
  • When to call: Before calling the ZegoExpressEngine SDK's loginRoom interface
  • Related APIs: unInit.
  • Available since: v2.0.0

setCustomizedConfig

setCustomizedConfig
void setCustomizedConfig(String key, String value)
Setting initialization parameters is optional<br/>For example:<br/>The key value is logPath, which is the directory where the SDK records logs.<br/>The key value is cachePath, the address of the directory cached by the SDK.
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
keyStringkey
valueStringvalue
  • When to call: Called after initializing the Superboard SDK
  • Available since: v2.0.0

Return

Whether the setting is successful

enableSuperBoardView

enableSuperBoardView
void enableSuperBoardView(boolean enable)
Set whether to use SuperBoardView
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
enablebooleanYES: SuperBoardView is used. NO: SuperBoardView is not used,The default is YES

Details

Set whether to use SuperBoardView.

When to call : Before initializing the SDK.

Open by default

  • Available since: v2.0.0

createWhiteboardView

createWhiteboardView
void createWhiteboardView(ZegoCreateWhiteboardConfig config, IZegoSuperBoardCreateCallback callback)
Creating a pure whiteboard
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
configZegoCreateWhiteboardConfigPure Whiteboard configuration parameters
callbackIZegoSuperBoardCreateCallbackCreates a result callback for a pure whiteboard

Details

After the creation is successful, the corresponding SubView will be saved internally and its subViewModel data will be returned.

  • When to call: After initializing the ZegoSuperboard SDK, calling [loginRoom] to log in to the room, when you need to create a pure whiteboard.

createFileView

createFileView
void createFileView(ZegoCreateFileConfig config, IZegoSuperBoardCreateCallback callback)
Create a file
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
configZegoCreateFileConfigThe configuration parameters required to create the file
callbackIZegoSuperBoardCreateCallbackCreate the result callback for the file

Details

After the creation is successful, the corresponding SubView will be saved internally and its subViewModel data will be returned.

When to Call: Initialize the ZegoSuperboard SDK and call [loginRoom] to login to the room when the file needs to be created.

destroySuperBoardSubView

destroySuperBoardSubView
void destroySuperBoardSubView(String uniqueID, IZegoSuperBoardDestroyCallback callback)
Destroys the specified SuperBoardSubView view
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
uniqueIDStringUnique identifier of the ZegoSuperBoardSubView object
callbackIZegoSuperBoardDestroyCallbackDestroys the result callback for the specified SuperBoardSubView

Details

Available Since: v2.0.0

When to call

the call querySuperBoardSubViewList pull to list or superBoardSubViewModelList get called when the model number greater than zero.

querySuperBoardSubViewList

querySuperBoardSubViewList
void querySuperBoardSubViewList(IZegoSuperBoardQueryListCallback callback)
Query the server for the list of SuperBoardSubView that currently exists
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
callbackIZegoSuperBoardQueryListCallbackGets the resulting callback for the SuperBoardSubView list

Details

Pull down the whiteboard in the current room at one time, SDK internal will be associated with the file in the whiteboard file also loaded down, these whiteboard and file SDK internal processing mapping added to the ZegoSuperBoardSubView, external only need to use ZegoSuperBoardView.

When to call

the SDK and call it after logging in to the room.

  • Available since: v2.0.0

getSuperBoardSubView

getSuperBoardSubView
ZegoSuperBoardSubView getSuperBoardSubView(String uniqueID)
Gets the specified SuperBoardSubView
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
uniqueIDStringUnique identifier of the ZegoSuperBoardSubView object
  • When to call: Initialize the SDK, enter the room successfully, get the SuperBoardSubView list after the call.

Limited to scenarios where SuperBoardView is not used (set by enableSuperBoardView

  • Available since: v2.0.0

clearCache

clearCache
void clearCache()
Clear cache resources related to files and whiteboards
Declared in ZegoSuperBoardManager.java
  • Available since: v2.0.0

Calling time: Initialization, after entering the room, the SDK needs to call it actively before exiting the room to clean up the resources in the room.

clear

clear
void clear()
Empty resources in the room called upon checkout
Declared in ZegoSuperBoardManager.java

When checking out, you need to clear the cache information in the room and stop media playback.

  • When to call: You need to call it before you check out.
  • Available since: v2.0.0

unInit

unInit
void unInit()
Uninitialize the SDK
Declared in ZegoSuperBoardManager.java
  • When to call: When you need to reinitialize the SDK, you must first call unInit.
  • Available since: v2.0.0

getSDKVersion

getSDKVersion
String getSDKVersion()
Obtain the SDK version number
Declared in ZegoSuperBoardManager.java

Obtain the SDK version number.

  • Use cases:
  1. When the SDK is running, if the developer finds the discrepancy with the expected situation, the developer can submit the problem and related logs to the ZEGO technical personnel for locating the problem. The ZEGO technical personnel may need the SDK version information to assist locating the problem.
  2. Developers can also collect this information as the VERSION information of the SDK used by the App, so as to make statistics of the SDK corresponding to each version of the App online.
  • When to call: It can be called at any time.
  • Available since: v2.0.0

Version number of the SDK

getCustomizedConfig

getCustomizedConfig
String getCustomizedConfig(String key)
Get the value of the set configuration item
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
keyString

Details

Get the value of the set configuration item.

  • When to call: After initializing the Superboard SDK, after calling setCustomizedConfig.
  • Available since: 2.0.0

getSuperBoardView

getSuperBoardView
ZegoSuperBoardView getSuperBoardView()
Get SuperBoardView object
Declared in ZegoSuperBoardManager.java

Open the SuperBoardView mode to get the object.

  • Use cases: SuperBoardView mode is turned on, use the method on the object to switch the whiteboard on the A side, and the B side will automatically synchronize.
  • Default value: Get the object by default
  • When to call: After initializing ZegoSuperboard SDK.
  • Caution: If you use the enableSuperBoardView interface and set it to false, you cannot get the SuperBoardView object.
  • Available since: 2.0.0

BoardView object

enableSyncScale

enableSyncScale
void enableSyncScale(boolean enable)
Set whether to synchronize the zoom to other members in the room
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
enableboolean

Details

After enabling, you can send out the zoom of the local end. Whether the peer end wants to accept it, you need to enable the peer end to accept the zoom.

  • Use cases: Synchronize the zooming of the whiteboard on the operating end and the receiving end.
  • Default value: When this interface is not called to set the scene, the default configuration is false.
  • When to call: After ZegSuperboard SDK is initialized.
  • Caution: To achieve dual-ended zoom synchronization, you need to set enableSyncScale and enableResponseScale at the same time
  • Related callbacks: scaling changes occur on the peer end, and the receiving end can monitor the changed parameters through remoteSuperBoardScaleChanged.
  • Available since: 2.0.0

enableResponseScale

enableResponseScale
void enableResponseScale()
Whether to respond to the zoom of other members in the room
Declared in ZegoSuperBoardManager.java

After it is turned on, it can respond to the zooming of other members in the room, provided that the peer end synchronizes the zooming to other members in the room.

  • Use cases: Synchronize the zooming of the whiteboard on the operating end and the receiving end.
  • Default value: When this interface is not called to set the scene, the default configuration is false.
  • When to call: After ZegSuperboard SDK is initialized.
  • Caution: To achieve dual-ended zoom synchronization, you need to set enableSyncScale and enableResponseScale at the same time
  • Related callbacks: scaling changes occur on the peer end, and the receiving end can monitor the changed parameters through remoteSuperBoardScaleChanged.
  • Available since: 2.0.0

enableHandwriting

enableHandwriting
void enableHandwriting(boolean enable)
Set whether to open the pen sharp
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
enablebooleanWhether to enable handwirting effect

Details

Set whether the whiteboard graffiti has a pen sharp effect. If set to true, the graffiti will have a pen sharp effect.

  • Use cases: Adjust the thickness and shape of the strokes according to the speed of the graffiti drawing process to enhance the writing experience.
  • Default value: false.
  • When to call /Trigger: Initialize the SDK, after rendering the whiteboard.
  • Available since: 2.0.0

isHandwritingEnabled

isHandwritingEnabled
boolean isHandwritingEnabled()
Get whether to turn on the stroke effect
Declared in ZegoSuperBoardManager.java

When the currently used tool type is brush, call isHandwritingEnabled to get whether to enable the stroke effect.

  • When to call: After ZegSuperBoard SDK is initialized.
  • Available since: 2.0.0

Whether to turn on the stroke effect

setToolType

setToolType
void setToolType(ZegoSuperBoardTool tool)
Set the whiteboard tool type
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
toolZegoSuperBoardToolThe board tool type.

Details

Set the tool type to make the mouse have different functions and effects.

  • Default value: The default value is 1, and the default tool is pen
  • When to call: After ZegSuperBoard SDK is initialized.
  • Available since: 2.0.0

getToolType

getToolType
ZegoSuperBoardTool getToolType()
Get the type of whiteboard tool being used.
Declared in ZegoSuperBoardManager.java

Get the type of whiteboard tool being used

  • When to call: After initializing ZegoSuperBoard SDK.
  • Available since: 2.0.0

return the type of tool in use

setFontBold

setFontBold
void setFontBold(boolean bold)
Set text bold
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
boldbooleanWhether to set the text bold

Details

After selecting the type of text tool, calling setFontBold and setting it to true, the newly added text on the whiteboard is all bold.

  • Default value: false
  • When to call: After ZegSuperBoard SDK is initialized.
  • Caution: Only the newly-added text after setting the text bold will have the bold effect. For example, the existing text on the whiteboard will not be changed to the bold effect.
  • Available since: 2.0.0

Return

Set result

isFontBold

isFontBold
boolean isFontBold()
Get whether the text is bold
Declared in ZegoSuperBoardManager.java

When the currently used tool type is text, call isFontBold to get whether to set the bold effect.

  • When to call: After ZegSuperBoard SDK is initialized.
  • Available since: 2.0.0

Whether it is a bold effect

setFontItalic

setFontItalic
boolean setFontItalic(boolean italic)
Set whether the text of the text tool is italicized.
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
italicboolean

Details

Set whether the text of the text tool is italicized.

  • Default value: false
  • When to call: After ZegSuperBoard SDK is initialized.
  • Caution: Only the new text after calling will take effect. For example, the existing text on the whiteboard will not be changed.
  • Available since: v2.0.0.

Return

Set result

isFontItalic

isFontItalic
boolean isFontItalic()
Get whether the text is italic effect
Declared in ZegoSuperBoardManager.java

When the currently used tool type is text, call isFontItalic to get whether to set the italic effect

  • When to call: After ZegSuperBoard SDK is initialized.
  • Available since: 2.0.0

Returns whether to set italics

setFontSize

setFontSize
boolean setFontSize(number fontSize)
Set text size
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
fontSizenumberfont size

Details

Select the type of text tool, call setFontSize to set, the new text on the whiteboard is the size after setting.

  • Default value: 24, the maximum value shall not exceed 100
  • When to call: After ZegSuperBoard SDK is initialized.
  • Caution: Only the new text after calling setFontSize will take effect. For example, the existing text on the whiteboard will not be changed to the font size.
  • Available since: 2.0.0

Return

Set result

getFontSize

getFontSize
number getFontSize()
Get text size
Declared in ZegoSuperBoardManager.java

When the currently used tool type is text, call getFontSize to get the font size of the current text tool.

  • When to call: After ZegSuperBoard SDK is initialized.
  • Available since: v2.0.0

Font size

setBrushSize

setBrushSize
boolean setBrushSize(number size)
Set the brush thickness
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
sizenumberBrush thickness

Details

Select the brush tool type, call setBrushSize to set the value, and the new graffiti thickness on the whiteboard is the set value.

  • Default value: 6
  • When to call: After ZegSuperBoard SDK is initialized.
  • Caution: The newly added graffiti after only setting the brush thickness has a new thickness effect. For example, the graffiti on the whiteboard will not be changed to the thickness.
  • Available since: 2.0.0

Return

Set result

getBrushSize

getBrushSize
number getBrushSize()
Get brush thickness
Declared in ZegoSuperBoardManager.java

When the currently used tool type is text, call getBrushSize to get the brush thickness.

  • When to call: After ZegSuperBoard SDK is initialized.
  • Available since: 2.0.0

Brush thickness

setBrushColor

setBrushColor
boolean setBrushColor(String color)
Set pen color
Declared in ZegoSuperBoardManager.java

Parameters

NameTypeDescription
colorStringcolor

Details

After selecting the brush tool type and calling setBrushColor, the new graffiti color on the whiteboard will take effect.

  • Default value: #f54326
  • When to call: After ZegSuperBoard SDK is initialized.
  • Caution: Only the new graffiti after setting the pen color will take effect. If the graffiti already exists on the whiteboard before, it will not be changed to the color.
  • Available since: v2.0.0

Return

Set result

getBrushColor

getBrushColor
String getBrushColor()
Get the brush color
Declared in ZegoSuperBoardManager.java

When the currently used tool type is brush, call getBrushColor to get the current brush color.

  • When to call: After ZegSuperBoard SDK is initialized.
  • Available since: 2.0.0

Pen color, hexadecimal RGBA

ZegoSuperBoardSubView

Details

Interface class used to describe a pure whiteboard or file whiteboard.

  • Use cases: The whiteboard is used to operate and set the status and operation of the whiteboard.
  • Caution: You need to log in room first. Check whether it is empty before using it.

Declared in ZegoSuperBoardSubView.java

Methods

setCustomCursorAttribute

setCustomCursorAttribute
Customize the local custom cursor
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
typeZegoSuperBoardViewCursorTypeSet the tool type, currently only supports setting the brush style
attributeZegoSuperBoardCursorAttributecursor attribute
listenerIZegoSuperBoardApiCalledCallbackcallback

Details

Supported version: 2.2.0 and above.

Detailed description: Set the pointer icon of the local custom cursor and the hot spot of the pointer (that is, the actual click position of the custom icon)

Required or not: Yes.

To set the hot spot of the pointer, two unitless non-negative numbers less than 32 are recommended.

Calling time: after opening the local custom cursor.

getExcelSheetNameList

getExcelSheetNameList
ArrayList<String> getExcelSheetNameList()
Get the list of Excel sheet names
Declared in ZegoSuperBoardSubView.java

Get the names of all sheet tables in this excel file.

  • Use cases: When you need to display the sheet table of the excel file, use this method to get the names of all the sheet tables of the excel file.
  • Caution: Return an empty list for non-excel file types.
  • When to call: After createFile succeeds or the pull list succeeds.
  • Available since: v2.0.0

List of Sheet names of Excel files

getThumbnailUrlList

getThumbnailUrlList
ArrayList<String> getThumbnailUrlList()
Get the current file thumbnail list, only supports PDF, PPT, dynamic PPT, H5 file format
Declared in ZegoSuperBoardSubView.java

If you need to display the preview screen of the file, you can get the corresponding preview image through this interface, and then click the preview image to turn the page

  • Use cases: Display the preview screen of each page of the document
  • When to call /Trigger: Called after the file is loaded, otherwise it returns an empty list.
  • Available since: v2.0.0
  • Restrictions: Only support PDF, PPT, dynamic PPT, H5 file format, other types return an empty list.

List of URL addresses of thumbnails of each page of the file

getPPTNotes

getPPTNotes
String getPPTNotes(int page)
Get the notes of the specified page number of the PPT
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
pageintThe specified page number, starting from 1

Details

Get the notes of the specified page number of the PPT.

  • Use cases: Get the notes of the specified page number of the PPT.
  • When to call: After the loadFile succeeds.
  • Available since: v2.0.0
  • Restrictions: Only support PPT, dynamic PPT file format, other types returns null.

Return

Notes on this page, if there are no notes, null will be returned

getModel

getModel
Get the model data corresponding to the whiteboard
Declared in ZegoSuperBoardSubView.java

Get the ZegoSuperBoardSubViewModel data corresponding to the whiteboard

  • Use cases: Get the ZegoSuperBoardSubViewModel data corresponding to the whiteboard, such as the whiteboard ID, name, associated file ID, current zoom factor, etc.

When to call

ZegSuperBoard SDK is initialized.

  • Available since: v2.0.0

the ZegoSuperBoardSubViewModel data corresponding to the whiteboard

inputText

inputText
void inputText(IZegoSuperBoardApiCalledCallback callback)
Add text to the whiteboard View, and an input box will pop up from the bottom of the whiteboard after calling.
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
callbackIZegoSuperBoardApiCalledCallbackOperation result callback, if you have the permission to create primitives, it will succeed, otherwise it will fail

Details

Add text to the whiteboard View, and an input box will pop up from the bottom of the whiteboard after calling.

  • Use cases: Add text to the whiteboard View, and an input box will pop up from the bottom of the whiteboard after calling.
  • Default value: The default content of the input box is "text", you can set the default text through [ZegoSuperBoardManager.setCustomText], the default display position is the middle of the current whiteboard range
  • Related callbacks: IZegoSuperBoardApiCalledCallback
  • Related APIs: ZegoSuperBoardManager.setCustomText
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0

addText

addText
void addText(String text, int positionX, int positionY, IZegoSuperBoardApiCalledCallback callback)
Add custom text to the whiteboard
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
textStringThe string content of the text primitive to be added
positionXintThe horizontal offset relative to the upper left corner of the viewport, such as 10, where the viewport refers to the writable area
positionYintThe vertical offset relative to the upper left corner of the viewport, such as 10, where the viewport refers to the writable area
callbackIZegoSuperBoardApiCalledCallbackOperation result callback, if you have the permission to create primitives, it will succeed, otherwise it will fail

Details

Add text in the whiteboard view, you can specify the location of the addition, and the keyboard input box will not pop up.

  • Use cases: Adding text at the specified position of the whiteboard view will create a new text primitive.
  • Related callbacks: IZegoSuperBoardApiCalledCallback.
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0.

undo

undo
void undo()
Undo the last operation of the whiteboard
Declared in ZegoSuperBoardSubView.java

Undo the last operation of the whiteboard.

  • Use cases: Whiteboard related operations.
  • Related APIs: redo.
  • When to call: when currentSuperBoardSubView exists.
  • Available since: v2.0.0.

redo

redo
void redo()
Restore the undone operation on the whiteboard
Declared in ZegoSuperBoardSubView.java

Restore the undone operation on the whiteboard.

  • Use cases: Whiteboard related operations.
  • Related APIs: undo.
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0.

clearCurrentPage

clearCurrentPage
void clearCurrentPage(IZegoSuperBoardApiCalledCallback callback)
Clear the primitives on the current page of the whiteboard
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
callbackIZegoSuperBoardApiCalledCallbackOperation result callback. If deleting the primitives of the current page is successful, it will return success, otherwise it will fail

Details

Clear the primitives on the current page of the whiteboard.

  • Use cases: Whiteboard related operations.
  • Related APIs: clearAllPage.
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0

clearAllPage

clearAllPage
void clearAllPage(IZegoSuperBoardApiCalledCallback callback)
Clear the primitives on all page of the whiteboard
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
callbackIZegoSuperBoardApiCalledCallbackOperation result callback. If you have the permission to delete primitives, it will return success, otherwise it will fail

Details

Clear the primitives on all page of the whiteboard.

  • Use cases: Whiteboard related operations.
  • Related APIs: clearCurrentPage.
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0

setOperationMode

setOperationMode
void setOperationMode(int mode)
Set the operating mode of the current whiteboard
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
modeintOperation mode, see ZegoSuperBoardOperationMode for details.

Details

Set the operation mode of the current whiteboard, such as prohibiting the client's gesture operation on the whiteboard.Get through the getMode method, such as int mode = ZegoSuperBoardOperationMode.Draw.getMode() | ZegoSuperBoardOperationMode.Zoom.getMode().

  • Use cases: Normally, there is no need to call this method. When the toolType is set, the SDK will call this method to process the whiteboard. If you need to prohibit the client's gesture operation on the whiteboard, you can use this method to set it to None mode.
  • Default value: Draw/zoom mode.
  • Impacts on other APIs: When set to scroll mode, gestures will be recognized as scrolling, and when set to drawing mode, gestures will be recognized as drawing-related operations at this time.
  • Caution: It can be called only when the currentSuperBoardSubView exists. You can use the getCurrentSuperBoardSubView() method to determine whether the currentSuperBoardSubView exists, otherwise it will not have any effect.
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0

flipToPage

flipToPage
void flipToPage(int targetPage, IZegoSuperBoardApiCalledCallback callback)
Jump to the specified page
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
targetPageintThe page number of the target page, starting from 1
callbackIZegoSuperBoardApiCalledCallbackOperation result callback

Details

Jump to the specified page .

  • Use cases: Specify a page number to jump.
  • Caution: If it is a dynamic ppt or H5 file, the jump page may need to download pictures and animation resources, so frequent calls may cause it to take a long time to complete.
  • Related callbacks: IZegoSuperBoardApiCalledCallback.
  • Related APIs: flipToPrePage,flipToNextPage
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0

flipToPrePage

flipToPrePage
void flipToPrePage(IZegoSuperBoardApiCalledCallback callback)
Jump to the previous page
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
callbackIZegoSuperBoardApiCalledCallbackOperation result callback

Details

Jump to the previous page.

  • Caution: If it is a dynamic ppt or H5 file, the jump page may need to download pictures and animation resources, so frequent calls may cause it to take a long time to complete.
  • Related callbacks: IZegoSuperBoardApiCalledCallback.
  • Related APIs: flipToPage,flipToNextPage
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0

flipToNextPage

flipToNextPage
void flipToNextPage(IZegoSuperBoardApiCalledCallback callback)
Jump to the next page
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
callbackIZegoSuperBoardApiCalledCallbackOperation result callback

Details

Jump to the next page.

  • Caution: If it is a dynamic ppt or H5 file, the jump page may need to download pictures and animation resources, so frequent calls may cause it to take a long time to complete.
  • Related callbacks: IZegoSuperBoardApiCalledCallback.
  • Related APIs: flipToPage,flipToPrePage
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0

preStep

preStep
void preStep(IZegoSuperBoardApiCalledCallback callback)
Jump to the previous step animation
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
callbackIZegoSuperBoardApiCalledCallbackOperation result callback

Details

Jump to the previous step animation

  • Caution: Only for dynamic ppt or H5 files, otherwise it will not have any effect.
  • Related callbacks: IZegoSuperBoardApiCalledCallback.
  • Related APIs: nextStep.
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0.

getCurrentPage

getCurrentPage
int getCurrentPage()
Get the page number of the currently displayed content
Declared in ZegoSuperBoardSubView.java

Get the page number of the currently displayed content

  • When to call: When using ZegoSuperBoardView, this is called when currentSuperBoardSubView exists. When not in use ZegoSuperBoardView, when superBoardSubViewModelList existence SuperBoardSubViewModel can be invoked.
  • Available since: v2.0.0.

page number of the currently displayed content

nextStep

nextStep
void nextStep(IZegoSuperBoardApiCalledCallback callback)
Jump to the next step animation
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
callbackIZegoSuperBoardApiCalledCallbackOperation result callback

Details

Jump to the next step animation

  • Caution: Only for dynamic ppt or H5 files, otherwise it will not have any effect.
  • Related callbacks: IZegoSuperBoardApiCalledCallback.
  • Related APIs: preStep.
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0.

getPageCount

getPageCount
int getPageCount()
Get the total number of pages
Declared in ZegoSuperBoardSubView.java

Get the page number of the currently displayed content

  • When to call: When using ZegoSuperBoardView, this is called when currentSuperBoardSubView exists. When not in use ZegoSuperBoardView, when superBoardSubViewModel superBoardSubViewModelList existence can be invoked.
  • Available since: v2.0.0.

total number of pages

switchExcelSheet

switchExcelSheet
void switchExcelSheet(int sheetIndex, IZegoSuperBoardSwitchCallback switchCallback)
Switch the excel file to the specified sheet page
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
sheetIndexintThe index of the target sheet of the excel file
switchCallbackIZegoSuperBoardSwitchCallbackOperation result callback

Details

Switch the excel file to the specified sheet page.

  • Use cases: When opening an excel file, the default is the 0th sheet page.
  • Related callbacks: IZegoSuperBoardSwitchCallback.
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0.

getVisibleSize

getVisibleSize
Size getVisibleSize()
Get the size of the visible area of the file
Declared in ZegoSuperBoardSubView.java

Get the size of the visible area of the file. For example, use a size of 1000x1000 to load a 64x64 picture. At this time, the size of the visible area is 64x64.

  • Caution: If it is not a file whiteboard, 0 will be returned.
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0.

The size of the visible area

getCurrentSheetName

getCurrentSheetName
String getCurrentSheetName()
Get the name of the currently displayed sheet
Declared in ZegoSuperBoardSubView.java

Get the name of the currently displayed sheet, if it is not excel, return null.

  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0.

name of the currently displayed sheet

addImage

addImage
void addImage(ZegoSuperBoardViewImageType type , String address, int positionX, int positionY, IZegoSuperBoardApiCalledCallback callback)
Insert picture to whiteboard
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
typeZegoSuperBoardViewImageTypePicture type, currently supports normal pictures and custom graphics
addressStringPicture address, supports local picture address and network picture address, local picture will be uploaded to CDN storage first. Currently, custom graphics only support network picture addresses. (Only https is supported for network pictures) Example: "xxxxxxxxxx.png", "".
positionXintThe starting point of the image insertion position, relative to the horizontal offset of the upper left corner of the viewport, such as 10, where the viewport refers to the writable area. Just pass 0 to the custom graphics directly.
positionYintThe starting point of the image insertion position, relative to the vertical offset of the upper left corner of the viewport, such as 10, where the viewport refers to the writable area. Just pass 0 to the custom graphics directly.
callbackIZegoSuperBoardApiCalledCallbackAdd picture result callback

Details

Insert pictures into the whiteboard, directly insert into the whiteboard display or set custom graphics.

  • Use cases: After setting the custom graphics, when the whiteboard tool is selected as the custom graphics, touching the whiteboard will draw the custom graphics passed in here.
  • Caution: Supported image types: png/jpg/jpeg, when the type is ZegoWhiteboardViewImageGraphic, it supports local images and network images, and the image size limit is 10M. When the type is ZegoWhiteboardViewImageCustom, only network images are supported, and the image size limit is 500KB.
  • When to call: this is called when currentSuperBoardSubView exists.
  • Available since: v2.0.0 .

clearSelected

clearSelected
void clearSelected(IZegoSuperBoardApiCalledCallback callback)
Delete the selected element
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
callbackIZegoSuperBoardApiCalledCallbackOperation result callback

Details

Select some primitives through the selection tool of the whiteboard, and call this method to delete the selected primitives.

  • Related callbacks: IZegoSuperBoardApiCalledCallback
  • When to call: After getting the SuperBoardSubView list.
  • Available since: v2.0.0.

setBackgroundImage

setBackgroundImage
void setBackgroundImage(String address, ZegoSuperBoardViewImageFitMode mode, IZegoSuperBoardApiCalledCallback callback)
Set the background image to the whiteboard
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
addressStringThe background image path, local path or network path can be used (network image only supports https). Example: "xxxxxxxxxx.png", "".
modeZegoSuperBoardViewImageFitModeBackground image fill mode
callbackIZegoSuperBoardApiCalledCallbackCallback when the background image is set

Details

Set a background image to the whiteboard, support local path or network path, this background image will be synchronized to other users in the room.

  • Related callbacks: IZegoSuperBoardApiCalledCallback.
  • When to call: After Get the SuperBoardSubView list.
  • Available since: v2.0.0.

clearBackgroundImage

clearBackgroundImage
void clearBackgroundImage(IZegoSuperBoardApiCalledCallback callback)
Clear the background image of the whiteboard
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
callbackIZegoSuperBoardApiCalledCallbackClear background completion callback

Details

Clear the background image of the whiteboard, this action will be synchronized to other users in the room.

  • Related callbacks: IZegoSuperBoardApiCalledCallback.
  • When to call: Get the SuperBoardSubView list.
  • Available since: v2.0.0.

stopPlayPPTVideo

stopPlayPPTVideo
void stopPlayPPTVideo()
Stop the video being played on the current dynamic ppt page
Declared in ZegoSuperBoardSubView.java

Stop the video currently being played on the dynamic ppt page, generally used to stop the audio and video playback of the dynamic PPT file when switching files.

  • When to call: Called during audio and video playback after the file has been successfully loaded.
  • Available since: v2.0.0.

setWhiteboardBackgroundColor

setWhiteboardBackgroundColor
void setWhiteboardBackgroundColor(String color)
Set the background color of the whiteboard
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
colorStringBackground color

Details

Set the background color of the whiteboard, for example, set the pure whiteboard to gray. If it is a file whiteboard, the setting will not take effect because it will be overwritten by the file content. It only takes effect locally and will not be synchronized to other users.

  • Default value: rgb(241, 243, 244).

When to call

ZegSuperBoard SDK is initialized.

  • Available since: v2.0.0

Return

Set result

setSizeChangedListener

setSizeChangedListener
void setSizeChangedListener(IZegoSuperBoardSizeChangedListener listener)
Set up monitoring after SubView size changes
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
listenerIZegoSuperBoardSizeChangedListenerInterface for monitoring SubView size changes

Details

Set up monitoring after SubView size changes

  • Available since: v2.0.0

setScrollChangedListener

setScrollChangedListener
void setScrollChangedListener(IZegoSuperBoardScrollChangedListener listener)
Set up monitoring of SubView scrolling process
Declared in ZegoSuperBoardSubView.java

Parameters

NameTypeDescription
listenerIZegoSuperBoardScrollChangedListenerSubView scroll monitoring

Details

Set up the monitoring of SubView scrolling.

  • Available since: v2.0.0

ZegoSuperBoardSubViewModel

Details

Data model class that contains the name of the ZegoSuperBoardSubView that was created, the time it was created, the ID of the contained file, the type of the file, and the unique identifier of the ZegoSuperBoardSubView object.

  • Use cases: :The user obtains the ID, name and file information of the corresponding ZegoSuperBoardSubView object.

Declared in ZegoSuperBoardSubViewModel.java

Properties

name

name
public String name

Name of SuperBoardSubView

createTime

createTime
public long createTime

Whiteboard Creation Time Unix timestamp (milliseconds)

fileID

fileID
public String fileID

File ID, which is unique

fileType

fileType
public ZegoSuperBoardFileType fileType

File type, refer to ZegoSuperBoardFileType

uniqueID

uniqueID
public String uniqueID

SuperBoardSubview ID, This ID is unique.

whiteboardIDList

whiteboardIDList
public List<String> whiteboardIDList

A list of whiteboard IDs

ZegoSuperBoardView

Details

This class mainly realizes the function of switching SuperBoardSubView and Excel file sheet in SuperBoardSubView. After initializing SDK, You can get the ZegoSuperBoardView object directly using the ZegoSuperBoardManager, through the outside of the class does not need to deal with the ZegoSuperBoardView switching and synchronization logic, ZegoSuperBoardView handles the logic for switching synchronised presentations internally.

  • Use cases: Simplify the complexity of accessing the SDK and don't want to deal with too much switching ZegoSuperBoardView logic.
  • Caution: To use ZegoSuperBoardView, you need to turn on enableSuperBoardView. The default is on.

Declared in ZegoSuperBoardView.java

Methods

getCurrentSuperBoardSubView

getCurrentSuperBoardSubView
ZegoSuperBoardSubView | null getCurrentSuperBoardSubView()
Get the current display superBoardSubView
Declared in ZegoSuperBoardView.java

If you need to perform page turning operations on the currently displayed superBoardSubView, etc., after obtaining the currently displayed superBoardSubView, call the page turning method on the superBoardSubView.

  • When to call: After ZegSuperBoard SDK is initialized.
  • Caution: Effective when the superBoardView mode is turned on.
  • Available since: 2.0.0

Current display superBoardSubView

setBoardViewListener

setBoardViewListener
void setBoardViewListener(IZegoSuperBoardViewListener boardViewListener)
Set up the monitoring of ZegoSuperBoardView's internal changes (size, scrolling, etc.)
Declared in ZegoSuperBoardView.java

Parameters

NameTypeDescription
boardViewListenerIZegoSuperBoardViewListenerBoardView status monitoring interface

Details

Set up the monitoring of ZegoSuperBoardView's internal changes (size, scrolling, etc.).

  • Available since: v2.0.0.

switchSuperBoardSubView

switchSuperBoardSubView
void switchSuperBoardSubView(String uniqueID, IZegoSuperBoardSwitchCallback callback)
Switch to the specified SuperBoardSubView
Declared in ZegoSuperBoardView.java

Parameters

NameTypeDescription
uniqueIDStringUnique IDENTIFIER of the SuperBoardSubView
callbackIZegoSuperBoardSwitchCallbackToggle the result callback of SuperBoardSubView

Details

Supported version: 2.0.0 and above.

Detailed description: switch to the specified SubView, multi-terminal synchronization.

Related callback: IZegoSuperBoardSwitchCallback.

switchSuperBoardSubView

switchSuperBoardSubView
void switchSuperBoardSubView(String uniqueID, int sheetIndex, IZegoSuperBoardSwitchCallback callback)
Toggles the specified SuperBoardSubView to the specified sheet
Declared in ZegoSuperBoardView.java

Parameters

NameTypeDescription
uniqueIDStringUnique IDENTIFIER of the SuperBoardSubView
sheetIndexintExcel sheetIndex
callbackIZegoSuperBoardSwitchCallbackResult callback switching Excel

Details

Switches Excel from the specified SuperBoardSubView to the specified sheet.

  • Use cases: Switch to Excel Sheet.

When to call

after the file is loaded.

Use restrictions: Only Excel files are supported.

  • Available since: v2.0.0

Return

Operation result

ZegoUploadCustomH5Config

Details

Custom H5 courseware property construction class can set the width, height, page number and thumbnail information of custom courseware.

  • Use cases: It needs to be passed in the interface of uploading custom H5 courseware.

Declared in ZegoUploadCustomH5Config.java

Properties

width

width
public int width

Customize the width of H5 courseware

Required or not: Mandatory

  • Value range: Greater than 0
  • Available since: v2.0.0

height

height
public int height

Customize the height of H5 courseware.

Required or not: Mandatory

  • Value range: Greater than 0
  • Available since: v2.0.0

pageCount

pageCount
public int pageCount

Customize the number of pages of H5 courseware.

  • Available since: v2.0.0

thumbnailList

thumbnailList
public String[] thumbnailList

Customize H5 courseware thumbnail relative path array.

  • Required: optional parameters
  • Available since: v2.0.0

Previous

Function Overview

Next

Interface