jupyterlab_gather

JupyterLab-Gather 允许在Jupyter Lab中直接启用视频会议功能，并引入了使用AR立方体标记在视频通话中实时显示GLTF模型的功能。

想象一下，您能够在这个熟悉的Jupyter Lab环境中分享您的工作，在项目中协作，甚至以更加沉浸和互动的方式教学。有了这个扩展，您现在可以

• 视频会议： 从Jupyter Lab直接进行实时视频通话，促进团队成员或学生之间的无缝协作和沟通。
• AR立方体标记： 在视频通话中使用AR立方体标记实时显示GLTF模型。此功能允许将3D模型动态集成到您的演示或协作会议中，增强学习体验，使复杂概念更加具体。
• 与JupyterCAD集成：使用JupyterCAD-Gather，将使用JupyterCAD创建的模型无缝集成到您的视频通话中。JupyterCAD是一款强大的JupyterLab扩展，用于3D几何建模。这允许您在实时中分享和协作复杂的3D设计，通过使其更具交互性和直观性来增强学习和协作体验。

此扩展建立在JupyterLab强大生态系统的基石之上，确保与现有JupyterLab功能和扩展兼容。无论您是希望使您的课程更具互动性的教师，还是希望以更具吸引力的方式分享您的发现的研究人员，或者寻求更沉浸式学习体验的学生，此扩展都旨在满足您的需求。

此扩展由一个名为jupyterlab_gather的Python包组成，用于服务器扩展，以及一个名为jupyterlab_gather的NPM包，用于前端扩展。

要求

• JupyterLab >= 4.0.0

安装

要安装此扩展，请执行

pip install jupyterlab_gather

设置

1. 前往https://www.100ms.live/并点击免费试用开始。

   

2. 随意登录。

   

3. 选择视频会议。

   

4. 前往仪表板。

   

5. 点击加入以查看房间详情。

   

6. 复制您喜欢的任何角色的房间代码。此代码将在加入表单中输入，以获得视频会议房的访问权限。任何拥有代码的人都可以加入房间。

   

7. 从JupyterLab启动页面启动Gather。

   

8. 在加入表单中输入房间代码并点击加入。

   

9. 就这样！您已设置完毕！

用法

请在此处查看使用说明

卸载

要删除扩展，请执行

pip uninstall jupyterlab_gather

故障排除

检查前端扩展是否已安装

jupyter labextension list

贡献

开发安装

注意：您将需要NodeJS来构建扩展包。

jlpm命令是JupyterLab的固定版本yarn，它是与JupyterLab一起安装的。您可以使用yarn或npm代替下面的jlpm。

# Clone the repo to your local environment
# Change directory to the jupyterlab_gather directory
# Install package in development mode
pip install -e ".[test]"
# Link your development version of the extension with JupyterLab
jupyter labextension develop . --overwrite
# Server extension must be manually installed in develop mode
jupyter server extension enable jupyterlab_gather
# Rebuild extension Typescript source after making changes
jlpm build

您可以在不同的终端中同时监视源目录并运行JupyterLab，以监视扩展源中的更改并自动重新构建扩展。

# Watch the source directory in one terminal, automatically rebuilding when needed
jlpm watch
# Run JupyterLab in another terminal
jupyter lab

在运行监视命令时，每次保存的更改都将立即在本地构建并可供您的运行的JupyterLab使用。刷新JupyterLab以在浏览器中加载更改（您可能需要等待几秒钟以重新构建扩展）。

默认情况下，jlpm build命令为此扩展生成源映射，以便更容易使用浏览器开发工具进行调试。要为JupyterLab核心扩展也生成源映射，可以运行以下命令

jupyter lab build --minimize=False

开发卸载

# Server extension must be manually disabled in develop mode
jupyter server extension disable jupyterlab_gather
pip uninstall jupyterlab_gather

在开发模式下，您还需要删除由jupyter labextension develop命令创建的符号链接。要找到其位置，可以运行jupyter labextension list以确定labextensions文件夹的位置。然后您可以在该文件夹中删除名为jupyterlab_gather的符号链接。

测试扩展

前端测试

此扩展使用Jest对JavaScript代码进行测试。

要执行它们，请执行

jlpm
jlpm test

集成测试

此扩展使用Playwright进行集成测试（也称为用户级测试）。更确切地说，JupyterLab辅助Galata用于处理在JupyterLab中测试扩展。

更多信息请参阅ui-tests的README。

打包扩展

见RELEASE