Netless

Netless

  • 通用文档
  • 常见问题
  • JavaScript
  • Android
  • iOS
  • Server
  • GitHub
  • 🇬🇧 English

›进阶教程

接入准备

  • 前提条件
  • 开源项目
  • 快速调试
  • 版本历史

快速开始

  • 原生 JavaScript
  • React

进阶教程

  • 安装
  • 实时房间
  • 教具
  • PPT 与页面管理
  • 视角
  • 禁止操作
  • 自定义行为
  • 回放

初始化参数

  • SDK参数
  • 房间参数
  • 回放参数

功能介绍

  • 教具操作
  • 视角操作
  • 页面(场景)管理
  • 状态监听
  • 白板操作
  • 自定义事件
  • 鼠标位置同步
  • 文档转换
  • 回放功能
  • 大课只读
  • 撤回与重做
  • 集成白板插件

迁移与升级

  • 2.9.0 迁移指南
  • 2.8.0 迁移指南

禁止操作

默认情况下,任何进如房间的用户都可操作白板。但有时,业务场景需要对加入房间的不同用户的操作权限加以限制。

到此章为止,我们假设你已经将 Netless 互动白板 SDK 安装并引入了项目,并且已经获取到实时房间实例 room 对象。如果没有,你可能跳过了之前的章节,强烈建议先阅读《安装》《实时房间》。

禁止设备操作

即使一行代码不写,用户也可以通过自己的设备在白板上写写画画。例如,PC 端用户可以用鼠标操作,而移动端用户可以通过触摸屏操作。如果希望禁止这种行为,可以用如下代码来实现。

room.disableDeviceInputs = true;

也可以通过如下代码,取消禁止设备操作。

room.disableDeviceInputs = false;

禁止设备操作仅仅禁止用户通过设备自主地输入操作,但并不禁止通过代码改变房间的状态。例如,你依旧可以主动调用 setMemberState 方法来修改房间状态,可以插入图片,可以插入 PPT。

只读模式

Netless 互动白板允许以「只读模式」加入房间。在加入房间时附带如下操作,声明以只读模式加入。

whiteWebSdk.joinRoom({
    uuid: "房间的 uuid",
    roomToken: "房间的 room token",
    isWritable: false, // 声明以只读模式加入房间,默认值为 true
});

也可以通过调用如下方法,从互动模式切换到只读模式。

room.setWritable(false).then(function() {
    // 切换成功
}).catch(function(err) {
    // 切换失败,报错 err
});

在只读模式下,用户无法以设备操作的方式在白板上写写画画,无法用代码改变白板状态。他就像一个看客,无法对房间其他人产生任何影响。

你可以通过调用如下方法,从只读模式切回互动模式。

room.setWritable(true).then(function() {
    // 切换成功
}).catch(function(err) {
    // 切换失败,报错 err
});

这两种模式如何选择

只读模式是一个重量级模式,它影响整个房间的行为,影响计费。Netless 互动白板,同一个房间,互动模式的用户最高为 40 人,如果超过上线,房间将阻止下一个互动模式的用户加入。然而,只读模式的用户是没有任何限制的。

如果你业务场景比较特殊,请合理分配只读模式和互动模式的名额。比如,某人的业务场景是大型公开课,有 5 个老师,50,000 学生。其中 5 个老师都可以操作白板,而学生没有权限操作白板,只能观看老师的操作结果。

这种业务场景可以将 5 个老师设为互动模式,50,000 个学生设为只读模式。如果不假思索的把老师学生都默认设为互动模式,显然,房间无法容纳这么多学生加入。

禁止设备操作只是一个轻量级模式,即便禁止了设备操作,当前用户依然属于互动模式。

此外,只读模式和互动模式的计费是不一样的。如果你不假思索地把所有用户一股脑设置成互动模式,你可能需要支付一部分不必要的费用。

Last updated on 6/15/2020 by rick
← 视角自定义行为 →
  • 禁止设备操作
  • 只读模式
  • 这两种模式如何选择
Netless
接入即互动
产品
管理控制台官网网站Demo 体验Github
公司
加入我们服务条款隐私协议
联系方式
support@netless.link社区
Copyright © 2020 Netless