用户光标
用户光标是英飞 web SDK 实现的用于显示画布内其他用户光标运动轨迹的功能。它允许你直观地看到其他协作者在画布上的实时操作。在会议讨论、协作编辑、远程教育等场景中,用户光标能显著提高协作效率和沟通效果。
用户光标只关注画布内用户光标的位置,对于协作者正在使用的工具不关注:用户在画布内使用工具时,可以看到光标变为正在使用的工具的形状,但这种变化对于其他的协作者是不可见。
特定场景下的用户光标
演讲模式
演讲模式是基于帧框的内容,呈现形式类似播放 ppt,一般用于汇报、演讲的场景。 用户进入演讲模式时,用户光标会强制隐藏。该功能的相关 API 见画布工具 。
跟随模式
当用户进入跟随状态,无论用户有没有设置显示用户光标(普通跟随或者会议内跟随),跟随目标的用户光标必然会显示。
假设当前画布上有用户 A B C,且三人都在移动光标:
-
A 没有跟随任何人,但是开启用户光标显示,则 A 可以看到 B、C 的用户光标。
-
A 没有跟随任何人,且关闭用户光标显示,则 A 不会看到 B、C 的用户光标。
-
A 跟随了 B,且关闭用户光标显示,则 A 会看到 B 的用户光标,但是不会看到 C 的用户光标。
-
A 跟随了 B,且开启用户光标显示,则 A 会看到 B C 的光标。
性能优化
开启用户光标显示后,画布内其他用户的光标运动轨迹会实时显示在用户的视野内。英飞画布支持用于大规模的协作场景,但当在线用户过多时,实时绘制大量用户光标会造成严重的性能负担,影响其他业务能力的计算和现实,因此服务端会按进入时间筛选出需要优先显示的用户光标,限制实时绘制的用户光标的数量,保证画布应用稳定、流畅地运行。
用户光标的相关配置
配置是否默认打开用户光标
画布初始化配置包含默认行为参数 defaultBehaviors
,开发者可以调整 defaultBehaviors
的 showOthersCursorByDefault: boolean
属性决定是否默认显示用户光标。详细说明见文档画布初始化相关配置项。
配置用户光标工具栏
在初始化画布应用时,开发者可以通过配置项 toolbarWidgetsConfigs
的属性 cursor: boolean
调整是否显示用户光标工具栏。
详细说明见文档工具栏配置属性说明 。