Skip to content

视频连线互动项目 #3

Description

@lcl6659

📝 产品需求文档(AI-Executable PRD)

产品名称(Working Title)

实时视频连接与语音聊天室(Live Video Connect Room)


一、产品目标(Product Goal)

允许用户在网页中输入视频连接后,
实时看到所有已连接用户的视频画面,
并通过语音进行双向或多向实时交流,
无需跳转页面或额外工具。


二、目标用户(Target Users)

  • 希望快速发起临时视频交流的用户
  • 需要多人同时在线视频与语音沟通的用户
  • 不希望下载安装独立客户端的网页用户

三、要解决的问题(Problem Statement)

当前用户在网页中想要进行实时视频和语音交流时,
通常需要跳转到第三方会议工具或安装额外应用,
导致使用门槛高、流程复杂、上下文中断。


四、用户使用后的结果(User Outcome)

用户在网页中输入视频连接并进入房间后,
可以立即看到所有正在连接的其他用户的实时视频画面,
并能够通过语音与这些用户进行实时对话。


五、核心用户行为(Core User Actions)

  • 用户进入网页
  • 用户输入或打开一个视频连接(Video Room Link)
  • 用户进入该连接对应的实时视频房间
  • 用户看到房间内所有已连接用户的视频流
  • 用户通过语音与房间内其他用户交流

六、功能范围(Scope)

✅ 做什么(In Scope)

  • 用户在网页中输入或访问一个视频连接
  • 系统根据视频连接识别或创建一个实时视频房间
  • 房间内所有已连接用户的实时视频画面同时展示在页面中
  • 用户的麦克风音频实时传输给房间内其他用户
  • 支持多用户同时在线视频与语音聊天
  • 用户加入或离开房间时,页面实时更新参与者列表与视频画面

❌ 不做什么(Out of Scope)

  • 不支持文字聊天(仅视频 + 语音)
  • 不支持屏幕共享
  • 不支持录制、回放或保存视频内容
  • 不提供好友系统、会议预约或历史记录
  • 不进行美颜、滤镜或视频增强处理

七、产品形态与交互方式(Product Form & Interaction)

  • 本产品为 单页面 Web 应用
  • 视频房间界面直接在当前页面渲染
  • 不跳转到外部站点
  • 不打开新窗口或弹窗
  • 页面在用户加入房间后进入“实时会话状态”

八、UI 与页面结构事实(UI Form Facts)

  • 页面包含以下区域:

    • 视频画面展示区域(Video Grid)
    • 基础控制区域(如:麦克风开关、离开房间)
  • 视频画面以网格(Grid)形式排列

  • 每个参与者对应一个视频画面区域

  • 用户自身的视频画面也必须显示在网格中


九、实时行为规则(Real-time Interaction Rules)

  • 用户加入房间时:

    • 立即请求摄像头与麦克风权限
    • 成功授权后开始推送本地视频与音频流
  • 用户离开房间时:

    • 立即停止推送视频与音频
    • 从其他用户界面中移除该用户的视频画面
  • 所有视频与音频均为实时流,不存在延迟缓存或回放


十、音视频规则(Media Rules)

视频规则

  • 每个用户最多推送一路视频流
  • 视频画面必须与用户在线状态绑定
  • 视频画面断开时需即时从 UI 中移除或标记为离线

语音规则

  • 所有已连接用户默认可以听到其他用户的语音
  • 支持用户本地关闭/开启麦克风
  • 不支持单独音量调节或静音他人

十一、边界与异常(Edge Cases & Errors)

  • 用户拒绝摄像头或麦克风权限:

    • 显示明确提示,说明无法参与实时视频/语音
  • 网络中断:

    • 当前用户视频画面进入断开状态
    • 尝试自动重连
  • 房间无其他用户:

    • 页面仅显示当前用户自己的视频画面
  • 新用户加入:

    • 其他用户页面中实时新增该用户的视频画面

十二、状态定义(UI / Session States)

  • IDLE:未加入任何视频房间
  • CONNECTING:正在连接视频房间
  • CONNECTED:已连接并正在进行视频与语音交流
  • ERROR:连接失败或媒体权限错误
  • DISCONNECTED:用户主动或被动离开房间

十三、Agent Interpretation Guardrail(强制)

Single Source of Truth

  • 视频连接(Video Room Link)唯一决定房间归属
  • 房间内用户列表由实时连接状态决定

Forbidden Interpretations

  • ❌ 不得将其理解为点对点单人视频
  • ❌ 不得使用文字聊天替代语音
  • ❌ 不得生成或展示非实时的视频内容
  • ❌ 不得自动保存或记录视频流

Allowed Flexibility

  • 视频画面排列方式可根据参与人数自适应
  • 控制按钮的具体位置允许调整,但功能必须存在

十四、一句话总结(One-line Summary)

这是一个让用户通过网页视频连接,实时看到所有参与者的视频画面,并通过语音进行即时交流的多人在线视频功能。


十五、执行说明(For AI Agents)

  • 本文档为 唯一事实源
  • 不得根据“常见视频会议产品”补充额外功能
  • 未明确写明的能力,一律视为不支持

✅ 说明你现在处在什么阶段(实话)

你现在写的已经不是普通 PRD,
而是在定义一个实时系统的行为合同

这份文档可以直接交给 agent-pm → agent-ui → agent-fe
不会被理解成直播、会议系统或聊天工具。

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions