当你进入白板房间时,看到的是一个向四周无限延伸的页面,Agora 互动白板将之称为场景。你可以在场景上写字绘画、插入图片、展示动态幻灯片。Agora 互动白板房间内可以插入多场景,并支持场景的移动和切换。基于这些功能,你可以实现展示完整的 PPT 文件等高级功能。
本页面介绍场景的结构、标识、支持展示的内容和增、删、改规则。了解这些基本概念后,你可以根据业务需要,构建多场景的互动白板应用。
Agora 互动白板房间内包含场景目录和场景,并呈现树状结构。新创建的 Agora 互动白板房间包含一个根目录和一个默认的初始场景。通过白板 SDK 提供的 API,你可以在房间内插入多个场景目录或场景。场景目录下可以包含子场景目录或场景。
房间内无法展示某个场景目录,但可以展示某个特定的场景,且同一时刻,只能展示一个场景。
Agora 互动白板房间内场景结构示意图
Agora 互动白板房间内的每个场景和场景目录都有唯一的路径作为其标识,用字符串表示。场景或场景目录的路径为其直接父节点路径加上场景或场景目录的名称,必须以 /
开头,并用 /
分隔层级。
你需要特别注意以下几点:
/
,默认的初始场景路径为 /init
。/
是场景目录的分隔符,场景名称不能包含 /
。例如,在根目录中插入名为 Math
的场景目录,该场景目录下包含场景 ClassA
和 ClassB
,则新增场景目录和场景的路径如下:
/Math
/Math/ClassA
/Math/ClassB
场景目录中的场景是有顺序的,以索引号标识,场景的索引号从 0 开始。通过指定场景索引号,可以切换至特定场景或在特定位置插入新场景。
在互动白板场景上,除可以使用白板工具输入文字、绘制图形外,还可以展示以下格式的图片或网页:
通过调用 API,你可以新增、删除和移动场景,具体规则如下:
新增场景
新增场景时,SDK 根据新增场景的路径执行以下一种操作:
删除场景
房间内的根目录无法被删除,且至少有一个场景。当场景目录内的所有场景和子场景目录都被删除时,该场景目录也会被删除;当房间内的所有场景都被删除后,SDK 会自动生成一个路径为 /init
的初始场景。
移动场景
场景是有序的,但场景目录没有顺序,可以通过 API 移动指定场景的位置,但无法通过 API 移动场景目录的位置。
举个例子,假如当前房间内只有根场景目录 /
和场景 /init
。
当你新增一个路径为 /math/class-A
的场景时,SDK 会自动创建路径为 /math
的场景目录。
随后,当你新增路径为 /math/class-B
的场景时,由于 /math
场景目录已存在,新场景会被直接添加到 /math
场景目录中。
当你删除路径为 /math/class-A
的场景,则从 /math
场景目录中删除场景 class-A
。
当你删除路径为 /math/class-B
的场景时,/math
场景目录中所有的场景都被删除了,SDK 会自动删除 /math
场景目录。