aauzid/bigbluebutton-livestreaming

BBB直播流传输

将指定的BBB会议流传输到RTMP服务器。

许可证： http://www.gnu.org/copyleft/gpl.html

开始使用

前提条件

只需在您的机器上运行Docker，并拥有一个用于流传输的媒体服务器。

配置

运行容器前需要设置一些环境变量。

必需设置

• BBB_URL - BBB的URL，包括http/https，例如[***]
• BBB_MEETING_ID - BBB会议的ID（可通过API调用获取：[***]）
• BBB_SECRET - BBB安装的密钥（可通过命令获取：bbb-conf --secret）
• BBB_STREAM_URL - 流媒体服务器的URL，包括rtmp。留空则禁用流传输（例如rtmp://media_server_url/stream/stream_key）

可选设置

• BBB_START_MEETING - 启动会议
• BBB_ATTENDEE_PASSWORD - 参会者密码（可选 - 需设置为Moodle/Greenlight或其他前端的参会者密码，以允许通过其链接加入）
• BBB_MODERATOR_PASSWORD - 主持人密码（可选 - 需设置为Moodle/Greenlight或其他前端的主持人密码，以允许通过其链接加入）
• BBB_MEETING_TITLE - 会议标题（可选 - 仅当直播流传输启动会议时有效）
• BBB_DOWNLOAD_MEETING - 以无损mkv格式下载/保存BigBlueButton会议
• BBB_INTRO - 播放 intro 文件（可以是videodata文件夹中的本地文件，例如/video/intro.mp4，或媒体流的URL，例如[***]
• BBB_BEGIN_INTRO_AT=04:40 - 在指定位置开始intro（可选，例如00:00:05）
• BBB_END_INTRO_AT - intro结束时间（可选，例如01:00:00 - 一小时后）
• BBB_USER_NAME - 加入会议的用户名（默认：Live）
• BBB_SHOW_CHAT - 在窗口左侧显示聊天（默认：false）
• BBB_RESOLUTION - 流传输/下载的分辨率（默认：1920x1080）
• BBB_CHAT_MESSAGE - 加入会议时发送到BBB聊天的消息前缀（默认："This meeting is streamed to"）
• TZ - 时区（默认：Europe/Vienna）

聊天设置

• BBB_ENABLE_CHAT - 启用聊天反馈通道
• BBB_REDIS_HOST - 设置REDIS主机（默认：redis）
• BBB_REDIS_CHANNEL - 设置REDIS通道（默认：chat）
• BBB_CHAT_NAME - 用于聊天的用户名（默认：Chat）
• BBB_CHAT_STREAM_URL - 应在聊天中显示的流URL（默认：rtmp://目标地址）

调试

• DEBUG - 设置为非空值将产生更详细的输出

高级用法

• FFMPEG_STREAM_THREADS - 流传输期间ffmpeg的线程数（默认：0（自动））
• FFMPEG_STREAM_VIDEO_BITRATE - 视频比特率（单位：k）（默认：4000）
• FFMPEG_INPUT_THREAD_QUEUE_SIZE - 传递给ffmpeg的thread_queue_size选项（默认：1024）
• FFMPEG_STREAM_OPTIONS - 流传输时使用的ffmpeg选项（比特率/编解码器等），默认值见stream.py
• FFMPEG_DOWNLOAD_OPTIONS - 下载时使用的ffmpeg选项，默认值见stream.py
• BROWSER_DISABLE_DEV_SHM_USAGE - 是否禁用浏览器的/dev/shm使用（默认：false），用于/dev/shm可用空间非常有限的场景，注意设置为true可能导致磁盘抖动

启动直播流传输

bash
wget -O docker-compose.yml https://raw.github.com/aau-zid/BigBlueButton-liveStreaming/1.0.0-beta.7/examples/docker-compose.yml.example
# 修改配置
docker-compose up -d
docker-compose down

聊天反馈

要使用通过聊天注入的用户反馈，您需要设置一个网站，用户可以在该网站上编写评论并发送到您的会议。示例文件夹中有两个文件可作为起点：

• player_and_chat.php
  将此文件放在公共网页中，或创建类似的Web表单，该表单将发送到处理PHP文件sendChatMessage.php。

• sendChatMessage.php
  此文件必须可通过Web表单访问，并且必须能够访问您在docker-compose文件中配置的redis数据库。

已知限制

• 当与BigBlueButton的连接丢失时，流传输器不会重新连接
• 使用分组讨论室时，流传输器将显示邀请弹窗，无法返回主会议

隐私政策和***说明

请尽量遵循数据保护和隐私的最佳实践。采取所有步骤遵守隐私法原则，禁止非法、不透明和无限期地捕获和处理个人数据。

GDPR（通用数据保护条例）为欧盟公民提供了与个人数据相关的个人权利。要了解更多关于GDPR的信息，请访问欧盟网站。

加州消费者隐私法（CCPA）为加州居民提供了与其个人信息相关的某些权利。

与GDPR和CCPA类似，其他地方隐私法原则也可能对因安全程序不佳而遭受数据泄露的企业实施处罚。始终保持透明，并根据隐私权利和联邦***采取行动。

许可证

BigBlueButton-liveStreaming是自由软件：您可以根据自由软件基金会发布的GNU通用公共许可证第3版或更高版本的条款重新分发和/或修改它。

BigBlueButton-liveStreaming的分发旨在有用，但不提供任何明示或暗示的保证，包括但不限于适销性和特定用途适用性的保证。有关更多详细信息，请参见GNU通用公共许可证。

您应该已经收到了BigBlueButton-liveStreaming附带的GNU通用公共许可证。如果没有，请参见https://www.gnu.org/licenses%E3%80%82