ReelSync

简体中文 / English

随时随地和另一个人同时观看一个视频 | Watch videos with someone in sync, anytime, anywhere.

如简介所言，这是一个 基于现代 Web 技术（如 WebRTC）的 实时视频流共享工具。

• 在配置了 TURN / STUN 服务器的条件下，她允许用户 向互联网上任意其他用户分享本地的视频（或在线视频流），而无需担心跨平台、跨设备、跨网络的问题。
• 出于她 端到端 的工作原理，用户不需要有任何形式的注册登录行为，视频流数据也不会被存储在服务器上。
• 在未来，更多特性将会被加入，如 屏幕共享、实时聊天 等。

部署

⠀←⠀点击这个按钮部署到 Vercel（推荐），或者：

git clone https://github.com/kev1nweng/reel-sync && cd reel-sync && npm run build && npm run preview

环境变量

Warning

ReelSync 的自动同步目标为 现实世界中的同步；因此，双方设备时间准确 是一个关键因素。 您可以使用时间服务器统一校时来达到这一点。 若无法保证时间的精确同步，请将最大可接受延迟时间调高一些（至少 1 秒钟）。

• VITE_NODE_SERVER_URL - 你的 iceServer 服务器列表地址（API 格式参考 Cloudflare Call）
• VITE_MAX_ACCEPTABLE_DELAY_SECONDS - 最大可接受延迟时间（秒）
• VITE_SAME_ORIGIN_SYNC_INTERVAL_SECONDS - 同源模式下视频进度同步间隔时间（秒）

路线图

上学比较忙，进度可能推进缓慢。欢迎 Fork 并贡献。

• 浏览器适配

  • Mozilla Firefox
    • 因不支持 captureStream() 可接收不可发送的问题
    • 主页样式错误问题（padding 未被正确显示）
  • Safari (以及所有利用 Apple Webkit 的浏览器)
    • 因不支持 captureStream() 可接收不可发送的问题

• 点对点模式

  • WebRTC 实时视频流传输
  • 屏幕共享（桌面视频流传输）←
  • 用户摄像头视频流传输

• 同源模式

  • WebRTC 播放进度和行为通讯
  • 端到端播放进度同步
  • 延迟测量
  • 考虑网络延迟的播放进度同步
  • 从节点视频操作请求

• 实时聊天

  • WebRTC 文字消息传输
  • WebRTC 语音消息传输

• 用户设置

  • 自定义设置 UI
  • localStorage API 配置存储

• 跨平台应用

  • 原生 WebView 安卓应用
  • Capacitor iOS 应用

• i18n 多语言支持

  • StartView UI (CN/EN)
  • StreamView UI (CN/EN)
  • msg (CN/EN)
  • 手动切换

• 其他功能

  • 分享直链
  • 自定义背景图
  • 基于 RTT（往返延迟）的增强同步

许可证

该项目在 GPL-3.0 许可证 下发布。

GNU 通用公共许可证第三版（GPL-3.0）是由自由软件基金会（FSF）于2007年发布的自由软件许可证，旨在保障用户运行、研究、共享及修改软件的自由。 其核心条款基于 Copyleft 机制，要求任何使用或分发 GPL-3.0 授权代码的衍生作品必须采用相同许可证公开源码，以防止专有软件对自由软件的限制。 该协议还强化了对数字版权管理（DRM）的技术中立性约束，并提升了与其他开源许可证的兼容性。

有关更多信息，请参阅 LICENSE 文件。

一行命令开始开发

推荐使用 VSCode + Volar (禁用 Vetur).

git clone https://github.com/kev1nweng/reel-sync && cd reel-sync && npm i

星标历史记录