(2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)
前回の第3回:RTCPeerConnection で1対1通話をつなぐ(offer/answer/ICE)で、同じルームに入った2人がビデオ通話できるようになりました。ただ、ルームIDは自分でURLに打ち込む必要があり、3人目が入ってくると何も表示されないまま待たされる状態でした。今回は、ビデオチャットの「入口」まわりを整えます。
「ビデオ通話の招待リンクって、どうやって作るの?URLを知っている人なら誰でも入れてしまうのは大丈夫?」
結論から言うと、招待リンクは「推測されにくいルームID(UUID)をURLに入れる」だけで作れます。ただしこれは「URLを知っている人は誰でも入れる」設計です。今回のサンプルでは、定員(1対1なので2名)を超えた入室をサーバーで断るところまでを実装し、認証・有効期限・待合室のような本格的な入室制御は発注時に決めるべき論点として整理します。
今回作るもの:ルーム作成・招待リンク・入室前のカメラ確認
- トップページの「新しいルームを作成する」ボタンで、UUID のルームIDを発行してルームページへ移動する
- ルームページの上部に招待リンクを表示し、「コピー」ボタンでクリップボードにコピーできる
- 入室前に、カメラ映像のプレビューとカメラ・マイクの選択ができる(第1回の部品を再利用)
- 定員(2名)に達しているルームに入ろうとすると、サーバーが断り、理由を画面に表示する
- あわせて、第3回の接続処理で見つかった「まれに接続が始まらない」問題を修正する
追加・変更するファイル
| ファイル | 役割 |
|---|---|
| server/utils/rooms.ts | 定員(ROOM_CAPACITY)のチェックを追加 |
| server/routes/_ws.ts | 定員オーバー時に room-full エラーを返す |
| shared/types/signaling.ts | エラーコードに room-full を追加 |
| app/composables/useSignaling.ts | サーバーから届いたエラーを error として公開 |
| app/pages/index.vue | ルーム作成ボタン |
| app/components/JoinPanel.vue | 入室前のカメラ・マイク確認パネル(新規) |
| app/pages/room/[id].vue | 招待リンク、JoinPanel の組み込み、定員オーバーの表示 |
| app/composables/usePeerConnection.ts | 最初の offer を作る側を一方に固定(不具合修正) |
| app/composables/useLocalMedia.ts | 戻り値の型 LocalMedia を追加 |
仕組み:招待リンクと定員チェックの役割分担
| 役割 | 担当 | 方法 |
|---|---|---|
| ルームIDを作る | ブラウザ | crypto.randomUUID() で UUID(v4)を生成 |
| 招待リンクを見せる・コピーする | ブラウザ | location.origin + /room/<ID> を表示し、Clipboard API でコピー |
| 入室できるか判断する | サーバー(シグナリング) | ルームの人数を数え、定員以上なら参加させない |
ここで大事なのは、「入れるかどうか」の判断はサーバー側で行うことです。画面側で「満員です」と表示するだけだと、ブラウザを操作できる人なら画面の判定を飛ばして参加できてしまいます。第2回から、ルームの参加者はサーバーのメモリで管理しているので、そこに定員チェックを足します。
UUID(v4)は、暗号学的に安全な乱数で作られる36文字のIDです。連番や日付のIDと違い、他人のルームIDを当て推量で見つけることは現実的ではありません。ただし「推測されにくい」だけで、URLが転送されたり画面共有で映り込んだりすれば、誰でも入れます。
📰 出典:MDN「Crypto: randomUUID() method」
実装1:サーバーで定員を超えた入室を断る
ルームの定員チェック
server/utils/rooms.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/utils/rooms.ts
+++ b/server/utils/rooms.ts
@@ -1,11 +1,19 @@
// 第2回: どのピアがどのルームにいるかを覚えておく(サーバーのメモリ上。再起動で消える)
+// 第4回: 定員チェックを追加(1対1通話なので2名)
const rooms = new Map<string, Set<string>>() // roomId -> peerId の集合
const peerRooms = new Map<string, string>() // peerId -> roomId
-export function joinRoom(roomId: string, peerId: string): string[] {
+/** 1ルームの定員。第11回(メッシュで少人数通話)で 4 に増やす */
+export const ROOM_CAPACITY = 2
+
+/**
+ * ルームに参加する。成功したら先にいたピアの一覧を、定員オーバーなら null を返す。
+ */
+export function joinRoom(roomId: string, peerId: string): string[] | null {
const members = rooms.get(roomId) ?? new Set<string>()
- const others = [...members]
+ if (members.size >= ROOM_CAPACITY && !members.has(peerId)) return null
+ const others = [...members].filter(id => id !== peerId)
members.add(peerId)
rooms.set(roomId, members)
peerRooms.set(peerId, roomId)
戻り値を「先にいたピアの一覧、または null(満員)」にしました。定員は定数にしておき、第11回で少人数通話に広げるときに変更します。
WebSocket ハンドラで room-full を返す
server/routes/_ws.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/routes/_ws.ts
+++ b/server/routes/_ws.ts
@@ -46,6 +46,11 @@ export default defineWebSocketHandler({
case 'join': {
leave(peer) // 別のルームにいたら先に抜ける(1接続=1ルーム)
const others = joinRoom(msg.roomId, peer.id)
+ if (!others) {
+ // 第4回: 定員オーバー。subscribe しないので、このルームのメッセージは届かない
+ sendTo(peer, { type: 'error', code: 'room-full', message: `このルームは定員(${ROOM_CAPACITY}名)に達しています` })
+ return
+ }
peer.subscribe(roomTopic(msg.roomId))
sendTo(peer, { type: 'joined', roomId: msg.roomId, selfId: peer.id, peers: others })
broadcast(peer, msg.roomId, { type: 'peer-joined', peerId: peer.id })
満員のときは subscribe も peer-joined の通知もしないので、通話中の2人には何も届かず、通話は影響を受けません。エラーコードは shared/types/signaling.ts の SignalingErrorCode に 'room-full' を追加しています(サーバーとブラウザで同じ型を使うため、片方だけ直し忘れると型チェックで気付けます)。
shared/types/signaling.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/shared/types/signaling.ts
+++ b/shared/types/signaling.ts
@@ -36,6 +36,7 @@ export type ServerMessage =
export type SignalingErrorCode =
| 'invalid-message' // 形式が正しくない
| 'not-joined' // ルームに参加する前に通話用のメッセージを送った
+ | 'room-full' // 第4回: ルームが定員に達している
/** ルームIDとして受け付ける文字列(英数字・ハイフン・アンダースコア、1〜64文字) */
export const ROOM_ID_PATTERN = /^[\w-]{1,64}$/
ブラウザ側の useSignaling では、error メッセージを受け取ったら error という ref に入れて公開するようにしました(join のたびに null に戻します)。
app/composables/useSignaling.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/app/composables/useSignaling.ts
+++ b/app/composables/useSignaling.ts
@@ -1,5 +1,5 @@
// 第2回: シグナリングサーバー(/_ws)への WebSocket クライアント
-import type { ClientMessage, PeerId, ServerMessage } from '#shared/types/signaling'
+import type { ClientMessage, PeerId, ServerMessage, SignalingErrorCode } from '#shared/types/signaling'
/** idle=未接続 / connecting=接続中 / open=接続済み / closed=切断した・切れた */
export type SignalingStatus = 'idle' | 'connecting' | 'open' | 'closed'
@@ -10,6 +10,8 @@ export function useSignaling() {
const selfId = ref<PeerId | null>(null)
/** 同じルームにいる自分以外のピア */
const peers = ref<PeerId[]>([])
+ /** 第4回: サーバーから届いた直近のエラー(定員オーバー等) */
+ const error = ref<{ code: SignalingErrorCode; message: string } | null>(null)
let ws: WebSocket | null = null
const listeners = new Set<(msg: ServerMessage) => void>()
@@ -38,6 +40,9 @@ export function useSignaling() {
case 'peer-left':
peers.value = peers.value.filter(id => id !== msg.peerId)
break
+ case 'error':
+ error.value = { code: msg.code, message: msg.message }
+ break
}
listeners.forEach(listener => listener(msg))
}
@@ -51,6 +56,7 @@ export function useSignaling() {
function join(targetRoomId: string) {
disconnect()
+ error.value = null
// ページが https なら wss、http(localhost)なら ws で同じホストに接続する
const protocol = location.protocol === 'https:' ? 'wss:' : 'ws:'
const socket = new WebSocket(`${protocol}//${location.host}/_ws`)
@@ -91,5 +97,5 @@ export function useSignaling() {
onScopeDispose(disconnect)
- return { status, roomId, selfId, peers, join, disconnect, send, onMessage }
+ return { status, roomId, selfId, peers, error, join, disconnect, send, onMessage }
}
実装2:トップページでルームを作る
app/pages/index.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/pages/index.vue
+++ b/app/pages/index.vue
@@ -1,5 +1,6 @@
<script setup lang="ts">
// 第0回: ベースライン。第1回以降でカメラ・マイク取得 → シグナリング → 通話 と機能を足していく。
+// 第4回: ルーム作成ボタンを追加
useHead({ title: 'ホーム | Nuxt WebRTC Video Chat' })
type Check = { label: string; ok: boolean | null; hint: string }
@@ -24,6 +25,17 @@ onMounted(() => {
]
checks.value = checks.value.map((c, i) => ({ ...c, ok: results[i] ?? false }))
})
+
+// 第4回: 新しいルームを作る。推測されにくい ID として UUID(v4)を使う
+const createError = ref('')
+async function createRoom() {
+ // crypto.randomUUID() も Secure Context 限定(HTTP の LAN アドレス等では使えない)
+ if (typeof crypto.randomUUID !== 'function') {
+ createError.value = 'このページではルームを作成できません。HTTPS(開発中は http://localhost)で開いてください。'
+ return
+ }
+ await navigateTo(`/room/${crypto.randomUUID()}`)
+}
</script>
<template>
@@ -31,6 +43,15 @@ onMounted(() => {
<h1>Nuxt WebRTC Video Chat</h1>
<p>連載のサンプルプロジェクト(第0回:ベースライン)です。ここに通話機能を順番に追加していきます。</p>
+ <h2>通話を始める</h2>
+ <p>ルームを作成すると、招待リンクが表示されます。リンクを相手に送り、同じルームに入ってもらいます(1ルーム2名まで)。</p>
+ <button type="button" class="create" @click="createRoom">
+ 新しいルームを作成する
+ </button>
+ <p v-if="createError" class="create__error" role="alert">
+ {{ createError }}
+ </p>
+
<h2>環境チェック</h2>
<p>表示中のオリジン: <code>{{ origin || '確認中…' }}</code></p>
<ul class="checks">
@@ -53,4 +74,6 @@ onMounted(() => {
.checks li[data-ok='true'] strong { color: #1a7f37; }
.checks li[data-ok='false'] strong { color: #cf222e; }
.checks__hint { color: #666; font-size: 0.9em; }
+.create { padding: 8px 16px; font-weight: 700; }
+.create__error { padding: 8px 12px; background: #ffebe9; color: #82071e; border-radius: 6px; }
</style>
crypto.randomUUID() は、カメラの API と同じく Secure Context(HTTPS か localhost)でしか使えません。第0回で説明した「LAN のIPアドレスを http で開くと動かない」問題がここでも起きるため、使えないときはメッセージを出します。UUID は英数字とハイフンだけなので、第2回で決めたルームIDのルール(ROOM_ID_PATTERN)にもそのまま合います。
ルームIDをサーバーで発行する方法もありますが、今回のサーバーは「ルームは誰かが入った時点で作られ、全員抜けたら消える」だけのシンプルな作りなので、ブラウザで作っても困りません。予約機能や有効期限を持たせる場合は、サーバー側で発行・保存する設計に変えることになります。
実装3:入室前にカメラとマイクを確認する JoinPanel
app/components/JoinPanel.vue(script 部分の抜粋。全文はこの節の最後に載せます)
<script setup lang="ts">
// カメラの取得(useLocalMedia)は通話でもそのまま使うため、親ページが持ち、ここでは操作だけを行う。
import type { LocalMedia } from '~/composables/useLocalMedia'
const props = defineProps<{
media: LocalMedia
/** 入室できない理由(定員オーバー等)。親から渡す */
joinError?: string | null
}>()
const emit = defineEmits<{ join: [] }>()
const { videoInputs, audioInputs, refresh } = useDevices()
const videoDeviceId = ref('')
const audioDeviceId = ref('')
async function check() {
await props.media.start({
videoDeviceId: videoDeviceId.value || undefined,
audioDeviceId: audioDeviceId.value || undefined,
})
if (!props.media.stream.value) return
// 許可後はデバイス名が取れるので一覧を取り直し、実際に使われているデバイスを選択状態にする
await refresh()
videoDeviceId.value = props.media.currentDeviceId('video') ?? ''
audioDeviceId.value = props.media.currentDeviceId('audio') ?? ''
}
</script>
中身は第1回のプレビューページ(preview.vue)とほぼ同じです。違いは、カメラの MediaStream をこのコンポーネントではなく親のルームページが持っている点です。入室前に確認した映像を、そのまま通話に使いたいからです。そこで useLocalMedia() の戻り値をまるごと props で受け取り、start を呼ぶだけにしています(型は useLocalMedia.ts に export type LocalMedia = ReturnType<typeof useLocalMedia> を追加しました)。
app/composables/useLocalMedia.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/app/composables/useLocalMedia.ts
+++ b/app/composables/useLocalMedia.ts
@@ -94,3 +94,6 @@ export function useLocalMedia() {
return { stream, error, isStarting, start, stop, currentDeviceId }
}
+
+/** 第4回: useLocalMedia の戻り値の型(コンポーネントに渡すときに使う) */
+export type LocalMedia = ReturnType<typeof useLocalMedia>
画面は「カメラとマイクを確認する」→ プレビューとデバイス選択 →「この設定で入室する」の順です。確認前には映像も音声も誰にも送られないこと、を冒頭に書いています。
app/components/JoinPanel.vue を新しく作ります。全文は次のとおりです。
app/components/JoinPanel.vue の全文(82行)
<!-- app/components/JoinPanel.vue -->
<script setup lang="ts">
// 第4回: 入室前のカメラ・マイク確認パネル
// カメラの取得(useLocalMedia)は通話でもそのまま使うため、親ページが持ち、ここでは操作だけを行う。
import type { LocalMedia } from '~/composables/useLocalMedia'
const props = defineProps<{
media: LocalMedia
/** 入室できない理由(定員オーバー等)。親から渡す */
joinError?: string | null
}>()
const emit = defineEmits<{ join: [] }>()
const { videoInputs, audioInputs, refresh } = useDevices()
const videoDeviceId = ref('')
const audioDeviceId = ref('')
const stream = computed(() => props.media.stream.value)
const isStarting = computed(() => props.media.isStarting.value)
const mediaError = computed(() => props.media.error.value)
async function check() {
await props.media.start({
videoDeviceId: videoDeviceId.value || undefined,
audioDeviceId: audioDeviceId.value || undefined,
})
if (!props.media.stream.value) return
// 許可後はデバイス名が取れるので一覧を取り直し、実際に使われているデバイスを選択状態にする
await refresh()
videoDeviceId.value = props.media.currentDeviceId('video') ?? ''
audioDeviceId.value = props.media.currentDeviceId('audio') ?? ''
}
// 確認中にデバイスを選び直したら取り直す(第1回の preview.vue と同じ考え方)
watch([videoDeviceId, audioDeviceId], ([v, a]) => {
if (!stream.value) return
if (v === props.media.currentDeviceId('video') && a === props.media.currentDeviceId('audio')) return
void check()
})
</script>
<template>
<div class="join">
<p class="join__lead">
入室する前に、カメラとマイクを確認してください。映像と音声は、入室するまで誰にも送られません。
</p>
<LocalPreview :stream="stream" />
<p v-if="mediaError" class="join__error" role="alert">
{{ mediaError.message }}
</p>
<p v-if="joinError" class="join__error" role="alert">
{{ joinError }}
</p>
<DeviceSelector
v-if="stream"
v-model:video-device-id="videoDeviceId"
v-model:audio-device-id="audioDeviceId"
:video-inputs="videoInputs"
:audio-inputs="audioInputs"
:disabled="isStarting"
/>
<div class="join__actions">
<button v-if="!stream" type="button" :disabled="isStarting" @click="check">
{{ isStarting ? '確認中…' : 'カメラとマイクを確認する' }}
</button>
<button v-else type="button" class="join__primary" :disabled="isStarting" @click="emit('join')">
この設定で入室する
</button>
</div>
</div>
</template>
<style scoped>
.join { display: flex; flex-direction: column; gap: 12px; }
.join__lead { margin: 0; }
.join__error { margin: 0; padding: 8px 12px; background: #ffebe9; color: #82071e; border-radius: 6px; }
.join__actions { display: flex; gap: 8px; }
.join__primary { font-weight: 700; }
</style>
実装4:ルームページに招待リンクと定員オーバーの表示を追加
app/pages/room/[id].vue に次の変更を加えます(+ が追加、- が削除)。第3回の入室ボタンとカメラのエラー表示は、JoinPanel に移ったので削除します。
--- a/app/pages/room/[id].vue
+++ b/app/pages/room/[id].vue
@@ -1,5 +1,6 @@
<script setup lang="ts">
// 第3回: 通話のページ(/room/<ルームID>)
+// 第4回: 招待リンクのコピー、入室前のカメラ確認(JoinPanel)、定員オーバー時の表示を追加
import { ROOM_ID_PATTERN } from '#shared/types/signaling'
const route = useRoute()
@@ -8,11 +9,13 @@ const isValidRoomId = computed(() => ROOM_ID_PATTERN.test(roomId.value))
useHead({ title: () => `ルーム ${roomId.value} | Nuxt WebRTC Video Chat` })
-const { stream: localStream, error: mediaError, isStarting, start: startMedia, stop: stopMedia } = useLocalMedia()
+const media = useLocalMedia()
+const { stream: localStream, stop: stopMedia } = media
const signaling = useSignaling()
const { remoteStream, connectionState, close: closePeer } = usePeerConnection(signaling, () => localStream.value)
const joined = computed(() => signaling.status.value === 'open' && signaling.roomId.value !== null)
+const joinError = ref<string | null>(null)
/** 接続状態を利用者向けの言葉にする */
// 相手がいない間(接続を作る前)も new なので「相手を待っています」と表示する
@@ -26,13 +29,44 @@ const CONNECTION_LABELS: Record<RTCPeerConnectionState, string> = {
}
const stateLabel = computed(() => CONNECTION_LABELS[connectionState.value])
-// カメラ・マイクを取得してからルームに参加する(先に参加すると映像なしで offer が作られるため)
-async function enter() {
- await startMedia()
+// --- 招待リンク ---
+// location はブラウザにしか無いため、URL は onMounted で組み立てる
+const inviteUrl = ref('')
+const copyState = ref<'idle' | 'copied' | 'failed'>('idle')
+const inviteInput = ref<HTMLInputElement | null>(null)
+
+onMounted(() => {
+ inviteUrl.value = `${location.origin}/room/${encodeURIComponent(roomId.value)}`
+})
+
+async function copyInviteUrl() {
+ try {
+ // Clipboard API は Secure Context 限定。ブラウザの設定で拒否されることもある
+ await navigator.clipboard.writeText(inviteUrl.value)
+ copyState.value = 'copied'
+ }
+ catch {
+ // コピーできなければ全選択して、手動でコピーしてもらう
+ copyState.value = 'failed'
+ inviteInput.value?.select()
+ }
+}
+
+// --- 入室・退出 ---
+// カメラ・マイクは JoinPanel で確認済み。取得できている時だけ参加する
+function enter() {
if (!localStream.value) return
+ joinError.value = null
signaling.join(roomId.value)
}
+// 定員オーバーなどで参加を断られたら、接続を閉じて入室前の画面に理由を出す
+watch(signaling.error, (err) => {
+ if (err?.code !== 'room-full') return
+ joinError.value = `${err.message}。通話が終わってから、もう一度お試しください。`
+ signaling.disconnect()
+})
+
function leave() {
closePeer()
signaling.disconnect()
@@ -48,16 +82,20 @@ function leave() {
ルームIDに使えない文字が含まれています(英数字・ハイフン・アンダースコア、64文字まで)。
</p>
<template v-else>
- <p v-if="mediaError" class="room__error" role="alert">
- {{ mediaError.message }}
- </p>
-
- <div v-if="!joined" class="room__actions">
- <button type="button" :disabled="isStarting" @click="enter">
- {{ isStarting ? '準備中…' : 'カメラとマイクをオンにして入室' }}
- </button>
+ <div class="room__invite">
+ <label for="invite-url">招待リンク(通話相手に送ってください)</label>
+ <div class="room__invite-row">
+ <input id="invite-url" ref="inviteInput" :value="inviteUrl" readonly>
+ <button type="button" :disabled="!inviteUrl" @click="copyInviteUrl">
+ コピー
+ </button>
+ </div>
+ <small v-if="copyState === 'copied'" class="room__hint">コピーしました</small>
+ <small v-else-if="copyState === 'failed'" class="room__hint">自動でコピーできませんでした。選択された URL を手動でコピーしてください</small>
</div>
+ <JoinPanel v-if="!joined" :media="media" :join-error="joinError" @join="enter" />
+
<template v-else>
<p class="room__state" role="status">
{{ stateLabel }}
@@ -82,6 +120,10 @@ function leave() {
<style scoped>
.room { display: flex; flex-direction: column; gap: 12px; }
.room__error { margin: 0; padding: 8px 12px; background: #ffebe9; color: #82071e; border-radius: 6px; }
+.room__invite { display: flex; flex-direction: column; gap: 4px; font-size: 0.9em; }
+.room__invite-row { display: flex; gap: 8px; }
+.room__invite-row input { flex: 1; min-width: 0; padding: 4px 8px; }
+.room__hint { color: #666; }
.room__state { margin: 0; font-weight: 700; }
.room__videos { position: relative; }
.room__self { position: absolute; right: 12px; bottom: 12px; width: 30%; }
ポイントは3つです。
- 招待URLは onMounted で作る:Nuxt はページをサーバーでも描画(SSR)するため、サーバー側には
locationがありません。ブラウザで表示された後に組み立てます。 - コピーに失敗しても困らないようにする:Clipboard API(
navigator.clipboard.writeText)は Secure Context 限定で、ブラウザの設定によっては拒否されます。失敗したら入力欄の URL を全選択し、手動でコピーしてもらう案内を出します。 - 定員オーバーはサーバーからのエラーで判断する:
room-fullを受け取ったら WebSocket を閉じ、JoinPanel に理由を表示します。カメラは止めないので、通話が空いたらそのまま「この設定で入室する」を押し直せます。
📰 出典:MDN「Clipboard: writeText() method」
テンプレートでは、入室前は JoinPanel を、入室後は第3回と同じ通話画面を表示するように v-if で切り替えています。
不具合修正:最初の offer は後から入った側だけが作る
今回の動作確認を繰り返す中で、2人が入室しても「相手を待っています」のまま接続が始まらないことがあると分かりました。筆者の検証環境(Chromium を自動操作)で同じ手順を8回繰り返したところ、3回で発生しました。
調べると、失敗したときは次のような状態でした。
- 第3回のコードでは、2人とも接続を作った直後にカメラのトラックを載せるため、毎回お互いが同時に offer を送り合う(衝突する)
- 衝突は Perfect negotiation の仕組みで解決され、answer までは正しく返っている
- しかし、譲った側(polite)のブラウザで ICE 候補の収集と接続確認が始まらず、状態が new のまま止まる
Perfect negotiation は衝突しても正しく動くための仕組みですが、「毎回必ず衝突させる」必要はありません。そこで、最初の offer は後から入った側(polite)だけが作り、先にいた側は offer を受け取ってからトラックを載せるように変えました。
app/composables/usePeerConnection.ts に次の変更を加えます(+ が追加、- が削除)。第3回の追記に従ってすでに当てている場合は、この変更は済んでいます。
--- a/app/composables/usePeerConnection.ts
+++ b/app/composables/usePeerConnection.ts
@@ -24,11 +24,20 @@ export function usePeerConnection(
let makingOffer = false
let ignoreOffer = false
let isSettingRemoteAnswerPending = false
+ let localTracksAdded = false
function sendDescription(description: RTCSessionDescription | null) {
if (description) signaling.send({ type: 'description', description: description.toJSON() })
}
+ /** 自分のカメラ・マイクのトラックを載せる。stable な状態で載せると negotiationneeded が発生する */
+ function addLocalTracks(conn: RTCPeerConnection) {
+ if (localTracksAdded) return
+ localTracksAdded = true
+ const localStream = getLocalStream()
+ localStream?.getTracks().forEach(track => conn.addTrack(track, localStream))
+ }
+
/** 相手1人との接続を作る。polite は「衝突したら自分が譲る側」かどうか */
function connect(peerId: PeerId, isPolite: boolean) {
close()
@@ -37,13 +46,14 @@ export function usePeerConnection(
makingOffer = false
ignoreOffer = false
isSettingRemoteAnswerPending = false
+ localTracksAdded = false
const conn = new RTCPeerConnection(rtcConfig)
pc = conn
- // 自分のカメラ・マイクのトラックを載せる。これで negotiationneeded が発生する
- const localStream = getLocalStream()
- localStream?.getTracks().forEach(track => conn.addTrack(track, localStream))
+ // 第4回で変更: 最初の offer は「後から入った側(polite)」だけが作る。
+ // 先にいた側(impolite)は、相手の offer を受け入れてから載せる(handleSignal の中)
+ if (isPolite) addLocalTracks(conn)
conn.addEventListener('negotiationneeded', async () => {
try {
@@ -91,6 +101,8 @@ export function usePeerConnection(
await conn.setRemoteDescription(description) // polite 側の取り下げ(rollback)はブラウザが自動で行う
isSettingRemoteAnswerPending = false
if (description.type === 'offer') {
+ // 相手の offer を受け入れた後に載せると、offer の音声・映像の枠がそのまま使われ、answer に含まれる
+ addLocalTracks(conn)
await conn.setLocalDescription()
sendDescription(conn.localDescription)
}
相手の offer を受け入れた(setRemoteDescription した)後に addTrack すると、offer によって作られた音声・映像の枠(トランシーバー)がそのまま使われ、返す answer に自分の映像・音声も含まれます。修正後は同じ手順を10回繰り返してすべて接続し、双方で音声・映像の両方を受信できることを確認しました。衝突時の処理(polite/impolite)はそのまま残しているので、後の回で通話中に再交渉が起きた場合にも対応できます。
なお、失敗の根本原因がブラウザ側の実装によるものかどうかまでは特定できていません。「毎回衝突させない」ことで回避した、という位置づけです。
動作確認の方法
npm run build→node .output/server/index.mjs(またはnpm run dev)で起動する- http://localhost:3000 を開き、「新しいルームを作成する」を押す → /room/UUID に移動し、招待リンクが表示される
- 「コピー」を押し、別のブラウザ(またはシークレットウィンドウ)に貼り付けて開く
- 両方で「カメラとマイクを確認する」→「この設定で入室する」→ 両方「接続しました」になる
- 3つ目のウィンドウで同じURLを開いて入室しようとすると、定員オーバーのメッセージが出る。通話中の2人は影響を受けない
- 2人のうち1人が退出すると、3人目は入室し直せる
筆者の環境では、Playwright で Chromium を操作し、テスト用のカメラ・マイク(--use-fake-device-for-media-stream)で次の点を確認しました。
| 確認したこと | 結果 |
|---|---|
| ルーム作成 | UUID のルームIDでルームページに移動し、招待リンクが表示される |
| コピー | クリップボードに招待リンクが入る。writeText を失敗させた場合は URL が全選択され、手動コピーの案内が出る |
| LAN のIPアドレスを http で開いて作成 | 「このページではルームを作成できません」と表示される |
| 招待リンクから2人目が入室 | 両方「接続しました」、音声・映像トラックを受信 |
| 3人目 | 「定員(2名)に達しています」と表示され、通話中の2人は接続を維持 |
| 1人退出後に3人目が再入室 | 残っていた人と接続 |
実際のカメラ・マイク、スマホのブラウザ、Safari・Firefox での表示やクリップボードの挙動はこの環境では確認していません。npm run build と npm run typecheck は通っています。
つまずきやすい点とセキュリティ上の注意
- 定員チェックは画面ではなくサーバーで:画面で満員表示をするだけでは、WebSocket に直接つなげば入れてしまいます。今回のようにシグナリングサーバーで判定します。
- 定員チェックは「同時に接続している人数」だけを見ている:ルームのメンバーはサーバーのメモリにあるため、サーバーを再起動すると消えます。複数台のサーバーで動かす場合は、Redis などの共有ストアに移す必要があります。
- 招待リンク=鍵:URLを知っていれば誰でも入れます。チャットツールへの貼り付け、画面共有への映り込み、ブラウザの履歴などから漏れる可能性があります。社外秘の会議に使うなら、ログインや参加者の承認(待合室)が必要です。
- ルームIDをログに出しすぎない:アクセスログやエラー監視サービスにURLが残ると、そこから入れてしまいます。ログの保存先と閲覧権限も確認しておきます。
- 入室前プレビューのカメラは入室後も使い続ける:JoinPanel と通話画面で別々にカメラを取得すると、OSや機種によっては2つ目の取得に失敗することがあります(同じカメラを二重に開けない場合があるため)。今回はページが1つの MediaStream を持つ形にしています。
発注者向けメモ:「URLを知っていれば入れる」でよいかを最初に決める
招待リンク方式は手軽で、利用者にも分かりやすい方法です。一方で、誰が入れるのかという「入室の管理」は、あとから足すと画面・サーバー・運用のすべてに影響します。要件定義の早い段階で、次の点を決めておくと手戻りを防げます。
- ☐ ルームに入れるのは「URLを知っている人」でよいか、ログインした社員だけか、社外ゲストも入れるか
- ☐ ルームに有効期限(予約した時間帯だけ入れる等)が必要か
- ☐ 主催者が参加者を承認する「待合室」が必要か、途中で退出させる機能が必要か
- ☐ 1ルームの定員は何名か(2名か、数名か、それ以上か。第11回で扱う構成の選択に直結します)
- ☐ 定員オーバーやURL間違いのとき、利用者にどう案内するか(文言・問い合わせ先)
開発会社への質問例:
- 「招待URLが第三者に転送された場合、その人は入室できますか?防ぐ仕組みは何がありますか?」
- 「定員や入室の可否は、画面ではなくサーバー側で判定していますか?」
- 「サーバーを複数台にしたとき、ルームの参加者情報はどこで管理しますか?」
- 「待合室や有効期限を後から追加する場合、どの部分の改修が必要になりますか?」
認証や待合室を追加すると、ログイン画面、参加者管理、主催者向けの操作画面などが増えるため、工数も大きく変わります。「最初はURL方式で、社外秘の会議には使わない」といった運用ルールで割り切るのも一つの判断です。
まとめと次回予告
- 招待リンクは、推測されにくい UUID をルームIDにしてURLに入れるだけで作れる。
crypto.randomUUID()と Clipboard API はどちらも Secure Context 限定 - 定員などの「入れるかどうか」の判断は、画面ではなくシグナリングサーバーで行う
- 入室前プレビューは、確認した MediaStream をそのまま通話に使うよう、ページ側で1つだけ持つ
- 最初の offer を後から入った側だけが作るように変え、接続が始まらないことがある問題を回避した
- 「URLを知っていれば入れる」でよいかは、発注時に早めに決めるべき論点
次回(第5回)は「ミュートとカメラオフ」です。track.enabled でマイクとカメラを一時的に止め、その状態をシグナリングで相手に伝えて表示するところまで作ります。
この連載の記事一覧
この記事は連載「NuxtとWebRTCで作るビデオチャット」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。
- 【NuxtとWebRTCで作るビデオチャット 第0回】Nuxt 4でビデオチャットの土台を作る:なぜHTTPSが必要なのか
- 【NuxtとWebRTCで作るビデオチャット 第1回】カメラとマイクを取得してプレビューし、デバイスを選べるようにする
- 【NuxtとWebRTCで作るビデオチャット 第2回】Nitro の WebSocket でシグナリングサーバーを作る
- 【NuxtとWebRTCで作るビデオチャット 第3回】RTCPeerConnection で1対1通話をつなぐ(offer/answer/ICE)
- 【NuxtとWebRTCで作るビデオチャット 第4回】ルーム作成と招待リンク、入室前プレビュー(この記事)
- 【NuxtとWebRTCで作るビデオチャット 第5回】ミュートとカメラオフ
- 【NuxtとWebRTCで作るビデオチャット 第6回】STUN/TURN と本番デプロイ:「社外とつながらない」を解消する
- 【NuxtとWebRTCで作るビデオチャット 第7回】画面共有
- 【NuxtとWebRTCで作るビデオチャット 第8回】DataChannel でテキストチャット
- 【NuxtとWebRTCで作るビデオチャット 第9回】MediaRecorder で録画する前に考えること
- 【NuxtとWebRTCで作るビデオチャット 第10回】切断・再接続とエラーハンドリング
- 【NuxtとWebRTCで作るビデオチャット 第11回】少人数通話へ:メッシュ実装と SFU という選択肢










コメント
コメント一覧 (1件)
[…] 前回の第4回:ルーム作成と招待リンク、入室前プレビューで、ルームを作って招待リンクを送り、入室前にカメラを確認できるようになりました。今回は、ビデオ通話に欠かせない「マイクのミュート」と「カメラのオフ」を追加します。 […]