Class
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
public void onError(int errorCode)IZegoSuperBoardManagerListener.javaParameters
| Name | Type | Description |
|---|---|---|
| errorCode | int | Description: error code. |
- When to call /Trigger: Error callback in the process of using whiteboard
- Available since: v2.0.0.
onRemoteSuperBoardSubViewAdded
public void onRemoteSuperBoardSubViewAdded(ZegoSuperBoardSubViewModel subViewModel)IZegoSuperBoardManagerListener.javaParameters
| Name | Type | Description |
|---|---|---|
| subViewModel | ZegoSuperBoardSubViewModel | Description: 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
public void onRemoteSuperBoardSubViewRemoved(ZegoSuperBoardSubViewModel subViewModel)IZegoSuperBoardManagerListener.javaParameters
| Name | Type | Description |
|---|---|---|
| subViewModel | ZegoSuperBoardSubViewModel | Description: 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
public void onRemoteSuperBoardSubViewSwitched(String uniqueID)IZegoSuperBoardManagerListener.javaParameters
| Name | Type | Description |
|---|---|---|
| uniqueID | String |
- 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
public void onRemoteSuperBoardSubViewExcelSwitched(String uniqueID, int sheetIndex)IZegoSuperBoardManagerListener.javaParameters
| Name | Type | Description |
|---|---|---|
| uniqueID | String | Description: |
| sheetIndex | int | Description: |
- Available since: v2.0.0.
onRemoteSuperBoardAuthChanged
public void onRemoteSuperBoardAuthChanged(HashMap<String,Integer> authInfo)IZegoSuperBoardManagerListener.javaParameters
| Name | Type | Description |
|---|---|---|
| authInfo | HashMap<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
public void onRemoteSuperBoardGraphicAuthChanged(HashMap<String,Integer> authInfo)IZegoSuperBoardManagerListener.javaParameters
| Name | Type | Description |
|---|---|---|
| authInfo | HashMap<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
public String fileIDID 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
public String nameCreate 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
public int perPageWidthWidth of each whiteboard page.
Required or not: Mandatory
- Value range: Positive integer greater than 0.
- Available since: 2.0.0及以上
perPageHeight
public int perPageHeightHeight of each whiteboard page.
Required or not: Mandatory
- Value range: Positive integer greater than 0.
- Available since: v2.0.0
pageCount
public int pageCountTotal 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
pox_x
public int pox_x- Default value: 0 Supported version: v2.4.0
pox_y
public int pox_y- Default value: 18 Supported version: v2.4.0
titleStyle
public ZegoSuperBoardCursorTitleStyle 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
public String titleCursor custom text content
- Required: no
- Default value: ""
- Recommended value: User login name display
- Value range: 15 characters or less
bold
public boolean boldWhether the cursor custom text is bold
- Required: no
- Default value: false
italic
public boolean italicWhether the cursor custom text is italic
- Required: no
- Default value: false
size
public int sizeCursor custom text font size
- Required: 否
- Default value: 16
- Value range: 12-20
color
public int colorCursor custom text font color
- Required: no
- Default value: white
backgroundColor
public int backgroundColorCursor custom text font background color
- Required: no
position
public ZegoSuperBoardCursorTitlePosition positionCustomize 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
public long appIDZEGO application ID for developers, please apply from ZEGO management console.
Required or not: Mandatory
Reference range: 0-4294967295.
token
public String tokenThe 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
public String parentDomIDdisplay 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
public String userIDUser 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
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
public String cacheFoldercache directory
logFolder
public String logFolderlog 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
public boolean enableCustomCursorDetailed 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
public boolean enableRemoteCursorVisibleDetailed 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
~ ~ superBoardMaxScaleFactorMethod 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
public void setSuperBoardMaxScaleFactor(Float scaleFactor)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| scaleFactor | Float | Description 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
public void renewToken(String token)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| token | String | A 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
void enableCustomCursor(boolean enable)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| enable | boolean | Whether 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
void enableRemoteCursorVisible(boolean enable)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| enable | boolean | Whether to open |
Details
Supported version: 2.2.0 and above.
Required or not: Yes.
Call timing: After the SDK is initialized.
getCustomText
String getCustomText()ZegoSuperBoardManager.javaGet 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
ZegoSuperBoardManager getInstance()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
List<ZegoSuperBoardSubViewModel> getSuperBoardSubViewModelList()ZegoSuperBoardManager.javaThrough 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
boolean isCustomCursorEnabled()ZegoSuperBoardManager.javaSupported 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
boolean isEnableResponseScale()ZegoSuperBoardManager.javaGet 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
boolean isEnableSyncScale()ZegoSuperBoardManager.javaGet 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
boolean isRemoteCursorVisibleEnabled()ZegoSuperBoardManager.javaSupported 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
void setCustomText(String text)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| text | String | Default 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
void setManagerListener(IZegoSuperBoardManagerListener listener)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| listener | IZegoSuperBoardManagerListener | Monitor whiteboard callback information |
- When to call /Trigger: after init
- Available since: v2.0.0
uploadFile
int uploadFile(String filePath, ZegoSuperBoardRenderType renderType, IZegoSuperBoardUploadFileListener listener)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| filePath | String | The 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. |
| renderType | ZegoSuperBoardRenderType | After the upload file transcoding rendering mode type, suggest set to VectorAndIMG, see ZegoSuperBoardRenderType. |
| listener | IZegoSuperBoardUploadFileListener | The 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
void cancelUploadFile(int seq, IZegoSuperBoardApiCalledCallback listener)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| seq | int | Upload seq returned when uploadFile is called. |
| listener | IZegoSuperBoardApiCalledCallback | Cancel 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
int cacheFile(String fileID, IZegoSuperBoardCacheFileListener listener)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| fileID | String | The fileID to be cached. |
| listener | IZegoSuperBoardCacheFileListener | The 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
public void cancelCacheFile(int seq, IZegoSuperBoardApiCalledCallback listener)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| seq | int | The sequence number of caching operation. |
| listener | IZegoSuperBoardApiCalledCallback | Callback 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
public void queryFileCached(String fileID, IZegoDocsViewQueryCachedListener listener)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| fileID | String | The ID of the file to be queried. |
| listener | IZegoDocsViewQueryCachedListener | Callback 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
int uploadH5File(String file, ZegoUploadCustomH5Config config, IZegoSuperBoardUploadFileListener listener)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| file | String | Local path for custom courseware |
| config | ZegoUploadCustomH5Config | Configuration of H5 courseware customization |
| listener | IZegoSuperBoardUploadFileListener | The 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
void setCustomFontFromAsset(String regularAssetPath, String boldAssetPath)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| regularAssetPath | String | Font name of regular font. Please contact technical support to obtain the font. |
| boldAssetPath | String | Font 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
void init(Application application, ZegoSuperBoardInitConfig initConfig, IZegoSuperBoardInitCallback callback)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| application | Application | app's appcalition |
| initConfig | ZegoSuperBoardInitConfig | Configuration information required for SDK initialization |
| callback | IZegoSuperBoardInitCallback | Initialization 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
void setCustomizedConfig(String key, String value)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| key | String | key |
| value | String | value |
- When to call: Called after initializing the Superboard SDK
- Available since: v2.0.0
Return
Whether the setting is successful
enableSuperBoardView
void enableSuperBoardView(boolean enable)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| enable | boolean | YES: 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
void createWhiteboardView(ZegoCreateWhiteboardConfig config, IZegoSuperBoardCreateCallback callback)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| config | ZegoCreateWhiteboardConfig | Pure Whiteboard configuration parameters |
| callback | IZegoSuperBoardCreateCallback | Creates 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
void createFileView(ZegoCreateFileConfig config, IZegoSuperBoardCreateCallback callback)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| config | ZegoCreateFileConfig | The configuration parameters required to create the file |
| callback | IZegoSuperBoardCreateCallback | Create 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
void destroySuperBoardSubView(String uniqueID, IZegoSuperBoardDestroyCallback callback)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| uniqueID | String | Unique identifier of the ZegoSuperBoardSubView object |
| callback | IZegoSuperBoardDestroyCallback | Destroys 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
void querySuperBoardSubViewList(IZegoSuperBoardQueryListCallback callback)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| callback | IZegoSuperBoardQueryListCallback | Gets 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
ZegoSuperBoardSubView getSuperBoardSubView(String uniqueID)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| uniqueID | String | Unique 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
void clearCache()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
void clear()ZegoSuperBoardManager.javaWhen 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
void unInit()ZegoSuperBoardManager.java- When to call: When you need to reinitialize the SDK, you must first call unInit.
- Available since: v2.0.0
getSDKVersion
String getSDKVersion()ZegoSuperBoardManager.javaObtain the SDK version number.
- Use cases:
- 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.
- 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
String getCustomizedConfig(String key)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| key | String |
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
ZegoSuperBoardView getSuperBoardView()ZegoSuperBoardManager.javaOpen 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
void enableSyncScale(boolean enable)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| enable | boolean |
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
void enableResponseScale()ZegoSuperBoardManager.javaAfter 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
void enableHandwriting(boolean enable)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| enable | boolean | Whether 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
boolean isHandwritingEnabled()ZegoSuperBoardManager.javaWhen 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
void setToolType(ZegoSuperBoardTool tool)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| tool | ZegoSuperBoardTool | The 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
ZegoSuperBoardTool getToolType()ZegoSuperBoardManager.javaGet 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
void setFontBold(boolean bold)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| bold | boolean | Whether 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
boolean isFontBold()ZegoSuperBoardManager.javaWhen 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
boolean setFontItalic(boolean italic)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| italic | boolean |
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
boolean isFontItalic()ZegoSuperBoardManager.javaWhen 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
boolean setFontSize(number fontSize)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| fontSize | number | font 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
number getFontSize()ZegoSuperBoardManager.javaWhen 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
boolean setBrushSize(number size)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| size | number | Brush 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
number getBrushSize()ZegoSuperBoardManager.javaWhen 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
boolean setBrushColor(String color)ZegoSuperBoardManager.javaParameters
| Name | Type | Description |
|---|---|---|
| color | String | color |
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
String getBrushColor()ZegoSuperBoardManager.javaWhen 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
void setCustomCursorAttribute(ZegoSuperBoardViewCursorType type, ZegoSuperBoardCursorAttribute attribute, IZegoSuperBoardApiCalledCallback listener)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| type | ZegoSuperBoardViewCursorType | Set the tool type, currently only supports setting the brush style |
| attribute | ZegoSuperBoardCursorAttribute | cursor attribute |
| listener | IZegoSuperBoardApiCalledCallback | callback |
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
ArrayList<String> getExcelSheetNameList()ZegoSuperBoardSubView.javaGet 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
ArrayList<String> getThumbnailUrlList()ZegoSuperBoardSubView.javaIf 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
String getPPTNotes(int page)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| page | int | The 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
ZegoSuperBoardSubViewModel getModel()ZegoSuperBoardSubView.javaGet 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
void inputText(IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| callback | IZegoSuperBoardApiCalledCallback | Operation 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
void addText(String text, int positionX, int positionY, IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| text | String | The string content of the text primitive to be added |
| positionX | int | The horizontal offset relative to the upper left corner of the viewport, such as 10, where the viewport refers to the writable area |
| positionY | int | The vertical offset relative to the upper left corner of the viewport, such as 10, where the viewport refers to the writable area |
| callback | IZegoSuperBoardApiCalledCallback | Operation 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
void undo()ZegoSuperBoardSubView.javaUndo 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
void redo()ZegoSuperBoardSubView.javaRestore 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
void clearCurrentPage(IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| callback | IZegoSuperBoardApiCalledCallback | Operation 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
void clearAllPage(IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| callback | IZegoSuperBoardApiCalledCallback | Operation 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
void setOperationMode(int mode)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| mode | int | Operation 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
void flipToPage(int targetPage, IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| targetPage | int | The page number of the target page, starting from 1 |
| callback | IZegoSuperBoardApiCalledCallback | Operation 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
void flipToPrePage(IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| callback | IZegoSuperBoardApiCalledCallback | Operation 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
void flipToNextPage(IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| callback | IZegoSuperBoardApiCalledCallback | Operation 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
void preStep(IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| callback | IZegoSuperBoardApiCalledCallback | Operation 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
int getCurrentPage()ZegoSuperBoardSubView.javaGet 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
void nextStep(IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| callback | IZegoSuperBoardApiCalledCallback | Operation 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
int getPageCount()ZegoSuperBoardSubView.javaGet 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
void switchExcelSheet(int sheetIndex, IZegoSuperBoardSwitchCallback switchCallback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| sheetIndex | int | The index of the target sheet of the excel file |
| switchCallback | IZegoSuperBoardSwitchCallback | Operation 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
Size getVisibleSize()ZegoSuperBoardSubView.javaGet 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
String getCurrentSheetName()ZegoSuperBoardSubView.javaGet 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
void addImage(ZegoSuperBoardViewImageType type , String address, int positionX, int positionY, IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| type | ZegoSuperBoardViewImageType | Picture type, currently supports normal pictures and custom graphics |
| address | String | Picture 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", " ". |
| positionX | int | The 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. |
| positionY | int | The 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. |
| callback | IZegoSuperBoardApiCalledCallback | Add 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
void clearSelected(IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| callback | IZegoSuperBoardApiCalledCallback | Operation 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
void setBackgroundImage(String address, ZegoSuperBoardViewImageFitMode mode, IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| address | String | The background image path, local path or network path can be used (network image only supports https). Example: "xxxxxxxxxx.png", " ". |
| mode | ZegoSuperBoardViewImageFitMode | Background image fill mode |
| callback | IZegoSuperBoardApiCalledCallback | Callback 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
void clearBackgroundImage(IZegoSuperBoardApiCalledCallback callback)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| callback | IZegoSuperBoardApiCalledCallback | Clear 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
void stopPlayPPTVideo()ZegoSuperBoardSubView.javaStop 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
void setWhiteboardBackgroundColor(String color)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| color | String | Background 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
void setSizeChangedListener(IZegoSuperBoardSizeChangedListener listener)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| listener | IZegoSuperBoardSizeChangedListener | Interface for monitoring SubView size changes |
Details
Set up monitoring after SubView size changes
- Available since: v2.0.0
setScrollChangedListener
void setScrollChangedListener(IZegoSuperBoardScrollChangedListener listener)ZegoSuperBoardSubView.javaParameters
| Name | Type | Description |
|---|---|---|
| listener | IZegoSuperBoardScrollChangedListener | SubView 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
public String nameName of SuperBoardSubView
createTime
public long createTimeWhiteboard Creation Time Unix timestamp (milliseconds)
fileID
public String fileIDFile ID, which is unique
fileType
uniqueID
public String uniqueIDSuperBoardSubview ID, This ID is unique.
whiteboardIDList
public List<String> whiteboardIDListA 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
ZegoSuperBoardSubView | null getCurrentSuperBoardSubView()ZegoSuperBoardView.javaIf 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
void setBoardViewListener(IZegoSuperBoardViewListener boardViewListener)ZegoSuperBoardView.javaParameters
| Name | Type | Description |
|---|---|---|
| boardViewListener | IZegoSuperBoardViewListener | BoardView status monitoring interface |
Details
Set up the monitoring of ZegoSuperBoardView's internal changes (size, scrolling, etc.).
- Available since: v2.0.0.
switchSuperBoardSubView
void switchSuperBoardSubView(String uniqueID, IZegoSuperBoardSwitchCallback callback)ZegoSuperBoardView.javaParameters
| Name | Type | Description |
|---|---|---|
| uniqueID | String | Unique IDENTIFIER of the SuperBoardSubView |
| callback | IZegoSuperBoardSwitchCallback | Toggle 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
void switchSuperBoardSubView(String uniqueID, int sheetIndex, IZegoSuperBoardSwitchCallback callback)ZegoSuperBoardView.javaParameters
| Name | Type | Description |
|---|---|---|
| uniqueID | String | Unique IDENTIFIER of the SuperBoardSubView |
| sheetIndex | int | Excel sheetIndex |
| callback | IZegoSuperBoardSwitchCallback | Result 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
public int widthCustomize the width of H5 courseware
Required or not: Mandatory
- Value range: Greater than 0
- Available since: v2.0.0
height
public int heightCustomize the height of H5 courseware.
Required or not: Mandatory
- Value range: Greater than 0
- Available since: v2.0.0
pageCount
public int pageCountCustomize the number of pages of H5 courseware.
- Available since: v2.0.0
thumbnailList
public String[] thumbnailListCustomize H5 courseware thumbnail relative path array.
- Required: optional parameters
- Available since: v2.0.0


