# 音声AIの割込みで古い再生バッファを止める設計

> 音声AIへの割込みでは、interrupted受信時に再生キューを空にし新ターンを受け付ける状態遷移が要です。Gemini Live APIの仕様に沿って整理します。

- Canonical: https://kuucorp.com/blog/live-audio-interruption-playback-buffer-state-machine/
- Date: 2026-11-17
- Last modified: 2026-11-17
- Publisher: Kuu株式会社 (https://kuucorp.com)

---
音声AIに話しかけて途中で割り込んだのに、数秒前の回答が流れ続ける。原因の多くはモデルではなく、クライアント側の再生バッファが残っていることです。サーバーが生成を止めても、手元のキューに積んだ音声は自動では消えません。本記事では、Gemini Live APIの公式仕様をもとに、割込み時の状態遷移を小さな実装単位で整理します。

## 割込み時に何が止まり何が残るのか

> サーバーは割込みで生成を取り消しますが、クライアントが既に受け取った音声は残るため、再生側で明示的に破棄する必要があります。

Firebase AI Logicの設定ドキュメントによると、`activityHandling`の既定値は`INTERRUPT`で、ユーザーの発話を検出すると現在の応答を即座に取り消します。このとき生成は中止され、保留中のツール呼び出しも破棄されます。セッション履歴は切り詰められ、割込み前にクライアントへ送信済みの内容だけがコンテキストに残ります。

つまり、サーバー側の整合性はサーバーが保ちます。残る問題は次の2点です。

- 受信済みで未再生の音声チャンクがクライアントのキューに残る
- 再生中のチャンクが最後まで鳴り続ける

ドキュメントは、アプリが再生用に音声をバッファしている場合、割込みシグナルを受けたら再生を止めてキューを空にするよう求めています。シグナル名はSDKにより異なり、Swiftでは`wasInterrupted`、Kotlin・Java・Web・Flutter・Unityでは`interrupted`です。

## どのイベントで状態を遷移させるのか

> 割込みターンは「interrupted → turn_complete」の順で終わり、generation_completeは来ません。

Vertex AI側のLive APIリファレンスには、割込みされたターンに`generation_complete`メッセージは出ず、`interrupted`から`turn_complete`へ進むと明記されています。一方、割込みなしの通常ターンでは、モデルがリアルタイム再生を想定して再生完了を待つため、`generation_complete`と`turn_complete`の間に遅延が生じます。

このため、終了判定を`turn_complete`だけ、あるいは`generation_complete`だけに頼る実装は誤作動します。最小構成の状態は次の4つで足ります。

1. `IDLE`: 入力待ち
2. `LISTENING`: ユーザー発話を送信中
3. `SPEAKING`: モデル音声を受信し再生中
4. `DRAINING`: 生成は終わったが未再生音声が残っている

遷移規則は次のとおりです。

- `SPEAKING`で`interrupted`を受信 → 再生を停止しキューを破棄、`LISTENING`へ
- `SPEAKING`で`generation_complete`を受信 → `DRAINING`へ
- `DRAINING`でキューが空になり`turn_complete`も受信済み → `IDLE`へ
- `SPEAKING`で`turn_complete`のみ受信 → 次ターンを受け付けつつ再生は継続

```python
def on_server_message(msg, player, state):
    sc = msg.server_content
    if sc and sc.interrupted:
        player.stop()          # 再生中のチャンクを止める
        player.clear_queue()   # 未再生のキューを捨てる
        state.value = "LISTENING"
        return
    if sc and sc.model_turn:
        for part in sc.model_turn.parts:
            player.enqueue(part.inline_data.data)
        state.value = "SPEAKING"
    if sc and sc.generation_complete:
        state.value = "DRAINING"
    if sc and sc.turn_complete:
        state.turn_done = True
```

上記は疑似コードです。実際のフィールド名は採用するSDKのイベント定義で確認してください。

## 古い音声が混ざる競合をどう防ぐか

> 破棄後に遅れて届く音声チャンクは、ターンIDで弾かないと新しい応答に混ざります。

`interrupted`を受けた時点でキューを空にしても、ネットワーク上を移動中のチャンクは後から到着する可能性があります。公式ドキュメントはこの遅延パケットの扱いまで規定していないため、アプリ側で防御する前提で設計します。

- クライアントで「現在のターン番号」を持ち、`interrupted`受信時にインクリメントする
- 受信チャンクを再生キューに積む前に、現在のターン内かを確認する
- `turn_complete`を受けるまでは、次ターンのチャンクと前ターンの残りを区別する

プロトコル上でチャンクにターンIDが付かない場合、「`interrupted`以降、次の`model_turn`が到着するまでの音声は破棄する」という保守的なルールが現実的です。この値と挙動は実環境で計測して調整してください。

## 自動VADをオフにすると何が変わるのか

> 自動VADを切ると、発話の開始と終了をクライアントが送る責任を負い、割込み判定もアプリの実装になります。

VAD（Voice Activity Detection、発話区間検出）は既定で有効です。Firebaseのドキュメントでは、感度（`startSensitivity`・`endSensitivity`）、無音判定の長さ（`silenceDuration`、既定は約800ms、推奨500〜800ms）、先頭の切れを防ぐ`prefixPadding`（推奨20〜50ms）を調整できます。

自動VADを無効にする場合は、`sendStartActivityRealtime`、`sendAudioRealtime`、`sendStopActivityRealtime`の順でクライアントが送ります。Vertex側のリファレンスでも、`activity_start`と`activity_end`は自動検出が無効のときだけ送信でき、この構成では`AudioStreamEnd`は送られず、ストリームの中断は`ActivityEnd`で示されます。

注意点が2つあります。

- 無効時はサーバーが`sendStopActivityRealtime`で即座に動くため、クライアント側の検出器は500ms以上の無音しきい値を推奨とされています
- 割込みの前提となる「発話開始の検知」もアプリが担うため、環境ノイズでの誤割込みはアプリ側の責任になります

PoCの段階では、自動VADのまま感度だけ調整する構成から始めるのが安全です。

## 実装前に確認すべきチェックリスト

> 採用するSDKとモデルのイベント名・順序を、実機のログで確認してから状態機械を固定します。

公式リファレンスはイベント名をsnake_caseで、Firebaseのサンプルはキャメルケースで記載しており、SDKごとに表記が異なります。コミュニティでは、特定のLiveモデルで`turnComplete`が割込みまで届かないという報告もありますが、公式の確認が取れていないため、設計の前提にはしないでください。

- 通常ターンと割込みターンで、受信イベントの順序をログに出して確認する
- `interrupted`受信から再生停止までの遅延を計測する
- 破棄後に届いた遅延チャンクの有無を、ネットワーク遅延を入れて再現する
- ログは構造化して保存し、ターン番号と状態遷移を追えるようにする

小規模な検証から本番導入までの進め方は、[Kuu株式会社のAI運用管理サービス](https://kuucorp.com/services/ai-ops/)でも支援しています。通信方式やテキスト配信の逆圧は[LLMストリーミング実装の選択基準](/blog/llm-streaming-sse-websocket-agent-design/)を参照してください。

## 参考

- [Configure Live API — Firebase AI Logic](https://firebase.google.com/docs/ai-logic/live-api/configuration)
- [Live API reference — Gemini Enterprise Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/models/live-api)

## まとめ

音声AIの割込み対応は、`interrupted`を受けたら再生を止めてキューを破棄し、`LISTENING`へ戻す一点に集約されます。割込みターンは`interrupted`から`turn_complete`へ進み`generation_complete`が来ないため、通常ターンとは別の終了経路として扱ってください。

遅延チャンクの混入と自動VAD無効時の責任範囲は、実環境のログで検証してから状態機械を固定するのが確実です。音声エージェントの検証設計のご相談は、[AI運用管理サービス](https://kuucorp.com/services/ai-ops/)までお気軽にどうぞ。
