com.herewhite.sdk.RoomParams类参考

RoomParams 类，用于配置实时房间的参数。
注解RoomParams 类中所有的方法都必须在 joinRoom 前调用；成功加入房间后，调用该类中的任何方法都不会生效。

构造及析构函数说明

RoomParams() [1/3]

初始化房间配置参数。

Java
com.herewhite.sdk.RoomParams.RoomParams(String uuid, String roomToken, String uid )

参数

参数名	描述
uuid	房间 UUID，即房间唯一标识符。传入的房间 UUID 必须和生成RoomToken 时填入的房间 UUID 一致。
roomToken	用于鉴权的RoomToken。
uid	自从 v2.15.0。用户唯一标识符，字符串格式，长度不能超过 1024 字节。如果你使用 2.15.0 及之后版本的 SDK，必须传入该参数。请确保同一房间内每个用户`uid`的唯一性。

RoomParams() [2/3]

初始化房间配置参数并传入用户信息。

Java
com.herewhite.sdk.RoomParams.RoomParams(String uuid, String roomToken, String uid, MemberInformation memberInfo )

参数

参数名	描述
uuid	房间 UUID，即房间唯一标识符。传入的房间 UUID 必须和生成RoomToken 时填入的房间 UUID 一致。
roomToken	用于鉴权的RoomToken。
uid	自从 v2.15.0。用户唯一标识符，字符串格式，长度不能超过 1024 字节。如果你使用 2.15.0 及之后版本的 SDK，必须传入该参数。请确保同一房间内每个用户`uid`的唯一性。
memberInfo	自定义用户信息，详见`MemberInformation`。

RoomParams() [3/3]

初始化房间配置参数并传入自定义的用户信息。

Java
com.herewhite.sdk.RoomParams.RoomParams(String uuid, String roomToken, String uid, Object userPayload )

参数

参数名	描述
uuid	房间 UUID，即房间唯一标识符。传入的房间 UUID 必须和生成RoomToken 时填入的房间 UUID 一致。
roomToken	用于鉴权的RoomToken。
uid	自从 v2.15.0。用户唯一标识符，字符串格式，长度不能超过 1024 字节。如果你使用 2.15.0 及之后版本的 SDK，必须传入该参数。请确保同一房间内每个用户`uid`的唯一性。
userPayload	自定义用户信息，必须为`WhiteObject`子类。

成员函数说明

setRegion()

设置数据中心。

注解

该方法设置的数据中心必须与要加入的互动白板实时房间所在数据中心一致，否则无法加入房间。
该方法与 WhiteSdkConfiguration 类中的 setRegion 方法作用相同，两个方法只需要调用其中的一个。如果同时调用，该方法会覆盖 WhiteSdkConfiguration 类中的 setRegion。

Java
void com.herewhite.sdk.RoomParams.setRegion(Region region)

参数

参数名	描述
region	数据中心，详见`Region`。

getRegion()

获取设置的数据中心。

Java
Region com.herewhite.sdk.RoomParams.getRegion()

返回值

设置的数据中心，详见 Region 。

isWritable()

获取用户是否以互动模式加入白板房间。

Java
boolean com.herewhite.sdk.RoomParams.isWritable()

返回值

用户是否以互动模式加入白板房间：

true：以互动模式加入白板房间，即具有读写权限。
false：以订阅模式加入白板房间，即具有只读权限。

setWritable()

设置用户是否以互动模式加入白板房间。
用户可以以以下模式加入互动白板实时房间：

互动模式：对白板具有读写权限，会出现在房间的成员列表中，对其他用户可见。
订阅模式：对白板具有只读权限，不会出现在房间的成员列表中，对其他用户不可见。

Java
void com.herewhite.sdk.RoomParams.setWritable(boolean writable)

参数

参数名描述

参数名	描述
writable	用户是否以互动模式加入白板房间： `true`：（默认）以互动模式加入白板房间。 `false`：以订阅模式加入白板房间。

writable

用户是否以互动模式加入白板房间：

true：（默认）以互动模式加入白板房间。
false：以订阅模式加入白板房间。

getDisableEraseImage()

获取是否关闭橡皮擦擦除图片功能。

Java
boolean com.herewhite.sdk.RoomParams.getDisableEraseImage()

返回值

是否关闭橡皮擦擦除图片功能：

true：橡皮擦不可以擦除图片。
false：橡皮擦可以擦除图片。

setDisableEraseImage()

设置是否关闭橡皮擦擦除图片功能。
默认情况下，橡皮擦可以擦除白板上的所有内容，包括图片。你可以调用 setDisableEraseImage(true) 设置橡皮擦不能擦除图片。

Java
void com.herewhite.sdk.RoomParams.setDisableEraseImage(boolean disableEraseImage)

参数

参数名描述

参数名	描述
disableEraseImage	是否关闭橡皮擦擦除图片功能： `true`：橡皮擦不可以擦除图片。 `false`：（默认）橡皮擦可以擦除图片。

disableEraseImage

是否关闭橡皮擦擦除图片功能：

true：橡皮擦不可以擦除图片。
false：（默认）橡皮擦可以擦除图片。

setTimeout()

设置加入房间的超时时间。

Java
void com.herewhite.sdk.RoomParams.setTimeout(long timeout, TimeUnit timeUnit )

参数

参数名	描述
timeout	超时时长，默认值为 45000 毫秒。
timeUnit	时长单位，默认值为毫秒（`MILLISECONDS`），取值详见TimeUnit。

isDisableDeviceInputs()

获取是否禁止白板工具响应用户输入。

Java
boolean com.herewhite.sdk.RoomParams.isDisableDeviceInputs()

返回值

是否禁止白板工具响应用户输入：

true：禁止白板工具响应用户输入。
false：允许白板工具响应用户输入。

setDisableDeviceInputs()

开启/禁止白板工具响应用户输入。

Java
void com.herewhite.sdk.RoomParams.setDisableDeviceInputs(boolean disableDeviceInputs)

参数

参数名描述

参数名	描述
disableDeviceInputs	是否禁止白板工具响应用户输入： `true`：禁止白板工具响应用户输入。 `false`：（默认）允许白板工具响应用户输入。

disableDeviceInputs

是否禁止白板工具响应用户输入：

true：禁止白板工具响应用户输入。
false：（默认）允许白板工具响应用户输入。

isDisableOperations()

获取是否禁止白板响应用户的操作。

Java
boolean com.herewhite.sdk.RoomParams.isDisableOperations()

返回值

是否禁止白板响应用户的操作。

true：禁止白板响应用户的操作。
false：允许白板响应用户的操作。

setDisableOperations()

允许/禁止白板响应用户任何操作。
禁止白板响应用户任何操作后，用户无法使用白板工具输入内容，也无法对白板进行视角缩放和视角移动。

Java
void com.herewhite.sdk.RoomParams.setDisableOperations(boolean disableOperations)

参数

参数名描述

参数名	描述
disableOperations	是否禁止白板响应用户的操作： `true`：禁止白板响应用户的操作。 `false`：（默认）允许白板响应用户的操作。

disableOperations

是否禁止白板响应用户的操作：

true：禁止白板响应用户的操作。
false：（默认）允许白板响应用户的操作。

isDisableBezier()

获取是否关闭贝塞尔曲线优化。

Java
boolean com.herewhite.sdk.RoomParams.isDisableBezier()

返回值

是否关闭贝塞尔曲线优化：

true: 关闭贝塞尔曲线优化。
false: 开启贝塞尔曲线优化。

setDisableBezier()

设置是否关闭贝塞尔曲线优化。

Java
void com.herewhite.sdk.RoomParams.setDisableBezier(boolean disableBezier)

参数

参数名描述

参数名	描述
disableBezier	是否关闭贝塞尔曲线优化： `true`: 关闭贝塞尔曲线优化。 `false`: （默认）开启贝塞尔曲线优化。

disableBezier

是否关闭贝塞尔曲线优化：

true: 关闭贝塞尔曲线优化。
false: （默认）开启贝塞尔曲线优化。

isDisableCameraTransform()

获取是否禁止本地用户操作白板视角。

Java
boolean com.herewhite.sdk.RoomParams.isDisableCameraTransform()

返回值

是否禁止本地用户操作白板视角：

true：禁止本地用户操作白板视角。
false：允许本地用户操作白板视角。

setDisableCameraTransform()

禁止/允许本地用户操作白板的视角，包括缩放和移动视角。

Java
void com.herewhite.sdk.RoomParams.setDisableCameraTransform(boolean disableCameraTransform)

参数

参数名描述

参数名	描述
disableCameraTransform	是否禁止本地用户操作白板视角： `true`：禁止本地用户操作白板视角。 `false`：（默认）允许本地用户操作白板视角。

disableCameraTransform

是否禁止本地用户操作白板视角：

true：禁止本地用户操作白板视角。
false：（默认）允许本地用户操作白板视角。

isDisableNewPencil()

获取是否关闭新铅笔工具。

Java
boolean com.herewhite.sdk.RoomParams.isDisableNewPencil()

返回值

是否关闭新铅笔工具：

true: 关闭新铅笔工具。
false: 开启新铅笔工具。

setDisableNewPencil()

关闭/开启新铅笔工具。

注解

在 2.12.2 版本中，setDisableNewPencil 的默认值为 false，自 2.12.3 版本起，setDisableNewPencil 的默认值改为 true。
为正常显示笔迹，在开启新铅笔工具前，请确保该房间内的所有用户使用如下 SDK：
- Android SDK 2.12.3 版或之后
- iOS SDK 2.12.3 版或之后
- Web SDK 2.12.5 版或之后

Java
void com.herewhite.sdk.RoomParams.setDisableNewPencil(boolean disableNewPencil)

参数

参数名描述

参数名	描述
disableNewPencil	是否关闭新铅笔工具： `true`: （默认）关闭新铅笔工具。关闭后，SDK 对铅笔工具（`pencil`）应用旧版笔迹平滑算法。 `false`: 开启新铅笔工具。开启后，SDK 对铅笔工具应用新版笔迹平滑算法，使书写笔迹更加流畅自然，并带有笔锋效果。

disableNewPencil

是否关闭新铅笔工具：

true: （默认）关闭新铅笔工具。关闭后，SDK 对铅笔工具（pencil）应用旧版笔迹平滑算法。
false: 开启新铅笔工具。开启后，SDK 对铅笔工具应用新版笔迹平滑算法，使书写笔迹更加流畅自然，并带有笔锋效果。

getCameraBound()

获取视角边界。

Java
CameraBound com.herewhite.sdk.RoomParams.getCameraBound()

返回值

视角边界。

setCameraBound()

设置本地用户的视角边界。

Java
void com.herewhite.sdk.RoomParams.setCameraBound(CameraBound cameraBound)

参数

参数名	描述
cameraBound	视角边界，详见`CameraBound`。

getUserPayload()

获取自定义用户信息。

Java
Object com.herewhite.sdk.RoomParams.getUserPayload()

返回值

自定义用户信息。

setUserPayload()

自定义用户信息。
你可以在 userPayload 中传入自定义的用户信息，例如用户ID，昵称和头像，然后调用此方法将信息发送给应用程序。

注解

为确保传入的 userPayload 格式正确，必须为 WhiteObject 的子类。

Java
void com.herewhite.sdk.RoomParams.setUserPayload(Object userPayload)

参数

参数名	描述
userPayload	自定义的用户信息，必须为 key-value 结构，例如，`"avatar", "https://example.com/user.png")`。

getMemberInfo()

获取自定义的用户信息。

Java
MemberInformation com.herewhite.sdk.RoomParams.getMemberInfo()

返回值

自定义用户信息，详见 MemberInformation 。

setMemberInfo()

自定义用户信息。

Java
void com.herewhite.sdk.RoomParams.setMemberInfo(MemberInformation memberInfo)

参数

参数名	描述
memberInfo	用户信息，详见`MemberInformation`。

getUuid()

获取房间 UUID。

Java
String com.herewhite.sdk.RoomParams.getUuid()

返回值

房间 UUID，即房间的唯一标识符。

setUuid()

设置房间 UUID。

Java
void com.herewhite.sdk.RoomParams.setUuid(String uuid)

参数

参数名	描述
uuid	房间 UUID，即房间的唯一标识符。

getRoomToken()

获取 Room Token。

Java
String com.herewhite.sdk.RoomParams.getRoomToken()

返回值

Room Token。

setRoomToken()

设置 Room Token。

Java
void com.herewhite.sdk.RoomParams.setRoomToken(String roomToken)

参数

参数名	描述
roomToken	用于鉴权的RoomToken。生成该RoomToken 的房间 UUID 必须和上面传入的房间 UUID 一致。

setUseNativeWebSocket()

开启全链路加速功能。
Agora 互动白板服务集成了 Agora 全链路加速（FPA）服务。集成 Agora Whiteboard SDK 后，你只需调用 setUseNativeWebSocket(true)，即可在互动白板应用中开启全链路加速服务，提升传输质量。

Java
void com.herewhite.sdk.RoomParams.setUseNativeWebSocket(boolean nativeWebSocket)

参数

参数名描述

参数名	描述
nativeWebSocket	是否开启全链路加速： `true`：开启全链路加速。 `false`：（默认）关闭全链路加速。

nativeWebSocket

是否开启全链路加速：

true：开启全链路加速。
false：（默认）关闭全链路加速。

isUseNativeWebSocket()

获取是否开启全链路加速功能。

Java
boolean com.herewhite.sdk.RoomParams.isUseNativeWebSocket()

返回值

是否开启全链路加速功能：

true：开启。
false：关闭。

isUsingFloatBar()

获取浮动条功能是否已开启。

Java
boolean com.herewhite.sdk.RoomParams.isUsingFloatBar()

返回值

浮动条功能是否已开启：

true：开启。
false：关闭。

setUsingFloatBar()

设置是否开启开启浮动条功能。

Java
void com.herewhite.sdk.RoomParams.setUsingFloatBar(boolean floatBar)

参数

参数名描述

参数名	描述
floatBar	是否开启浮动条： `true`：开启浮动条功能。 `false`：（默认）关闭浮动条功能。

floatBar

是否开启浮动条：

true：开启浮动条功能。
false：（默认）关闭浮动条功能。

getModulesOrigin()

获取白板请求 modules 数据的地址。

Java
String com.herewhite.sdk.RoomParams.getModulesOrigin()

返回值

方法调用成功时返回 modules 地址。

setModulesOrigin()

设置白板请求 modules 数据的地址。配置后不会请求白板默认地址。

Java
void com.herewhite.sdk.RoomParams.setModulesOrigin(String modulesOrigin)

参数

参数名	描述
modulesOrigin	modules 地址。示例https://modules.example.com。

构造及析构函数说明

RoomParams() [1/3]

参数​

RoomParams() [2/3]

参数​

RoomParams() [3/3]

参数​

成员函数说明

setRegion()

参数​

getRegion()

返回值​

isWritable()

返回值​

setWritable()

参数​

getDisableEraseImage()

返回值​

setDisableEraseImage()

参数​

setTimeout()

参数​

isDisableDeviceInputs()

返回值​

setDisableDeviceInputs()

参数​

isDisableOperations()

返回值​

setDisableOperations()

参数​

isDisableBezier()

返回值​

setDisableBezier()

参数​

isDisableCameraTransform()

返回值​

setDisableCameraTransform()

参数​

isDisableNewPencil()

返回值​

setDisableNewPencil()

参数​

getCameraBound()

返回值​

setCameraBound()

参数​

getUserPayload()

返回值​

setUserPayload()

参数​

getMemberInfo()

返回值​

setMemberInfo()

参数​

getUuid()

返回值​

setUuid()

参数​

getRoomToken()

返回值​

setRoomToken()

参数​

setUseNativeWebSocket()

参数​

isUseNativeWebSocket()

返回值​

isUsingFloatBar()

返回值​

setUsingFloatBar()

参数​

getModulesOrigin()

返回值​

setModulesOrigin()

参数​

参数

参数

参数

参数

返回值

返回值

参数

返回值

参数

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

参数

返回值

返回值

参数

返回值

参数