使用白板工具

  • HarmonyOS

更新时间

了解如何在互动白板 SDK 中白板工具,包括适用场景、配置步骤、实现要点和注意事项。

在成功加入房间后,通过 Controller 使用工具和状态接口。

TypeScript
import { Appliance, MemberState } from '@shengwang/whiteboard';

controller.setAppliance(Appliance.PENCIL);
controller.setStrokeWidth(4);
controller.setStrokeColor('#ff0000');
能力公开接口
工具和文本样式setAppliance、setStrokeColor、setStrokeWidth、setTextSize、setTextColor、setMemberState
读写权限setWritable(boolean): Promise<boolean>、getWritable(): boolean
选择和历史操作copy、paste、duplicate、deleteOperation、undo、redo;需要可写并开启序列化
状态查询getRoomState、getRoomPhase、getRoomMembers、getMemberState、getGlobalState、getBroadcastState
场景getSceneState、getEntireScenes、setScenePath、setSceneIndex、putScenes、moveScene、removeScenes、cleanScene
图片 / 文本insertImage(ImageInformation)、insertText(x,y,text): Promise<string>、updateText(identifier,text)
主白板页addPage、removePage、prevPage、nextPage;场景 index 从 0 开始
输入与视角disableDeviceInputs、disableCameraTransform、disableWindowOperation、refreshViewSize
表格内容超出当前宽度,可横向滚动查看更多列。

getWritable 返回 Controller 已知的本地读写状态,其他状态查询为 Promise。回调 onRoomStateChanged 通常为变化字段补丁,按需合并或重新查询。

房间阶段枚举从包入口导出:RoomPhase.CONNECTING/CONNECTED/RECONNECTING/DISCONNECTING/DISCONNECTED。房间断开错误通过 onDisconnectWithError,被踢原因通过 onKickedWithReason 处理。

ViewMode 出现在 setViewMode 的签名中,但本版包入口未单独导出,无法从包名导入该枚举对象。完整参数、模型字段、方法和回调见客户端 API。