LiveKit Room and Participant

Definition

Room は音声・映像・データをやり取りする通信空間であり、Participant はその Room に参加する主体である。

Why It Matters

LiveKit Agents を理解する時、Agent logic だけ見ていると足場を失う。実際の対話は必ず Room という場で起こり、ユーザーも Agent も Participant としてその場に存在する。

Current Understanding

Room は transport / media の基盤であり、Track や data channel などもこの空間に属する。Participant はその空間でメディアを送受信する主体であり、ユーザー、Agent、他システム参加者が含まれる。

AgentSession はこの Room を使って対話する論理レイヤであり、Room そのものではない。したがって Room / Participant を理解すると、Session, Job, dispatch の議論がどの基盤の上に乗っているかが見えやすくなる。

Connections

New Insights

  • Room は場、Participant は主体、AgentSession は会話管理レイヤという三層で切ると混乱しにくい
  • Session 理解を深めるには、先に Room 側の基盤概念を安定させる必要がある

Open Questions

  • Track と data channel をこのノートに含めるか、別ノートへ切り出すか
  • frontend 連携時に Participant の種類差はどこまで重要になるか