Capacitor音声認識が1回おきに5msで失敗

対象のアプリは自作の旅行英語シャドーイングツールで、ユーザーの音声を録音し、音声認識でテキスト化して模範文との一致度を採点する。PCではブラウザのWeb Speech APIを使っていたが、CapacitorでAndroidアプリとして包む際、AndroidのWebViewはwebkitSpeechRecognitionを存在するように見せかけながら実際には機能しない（Chromium issue 41172064）ため、常にネイティブのAndroid音声認識器を使う方針を選んだ。この判断が、ネイティブプラグイン層に潜んでいたバグの土台となった。

デバッグはClaude Codeが行い、まずプラグインのAndroidソースを読んで破棄・再生成のパターンを疑ったが、変更する前に実機をつないで計測した。adbでWebViewのデバッグポートに接続し、Capacitorのネイティブ呼び出しブリッジをラップして呼び出しごとの応答時間を記録し、同時にadb logcatで端末ログを取得した。ログでは、startの4 ms後にすでにエラーが送られ、続いてマイクが開いて5秒間聞き取り、「no speech detected」で終了していた。しかも同じ呼び出しでエラー通知が3回届いていた。プラグインのgetErrorText()は未知のエラーコードを既定の「Didn't understand, please try again.」に変換するため、修正前の版では正確なコードは見えなかった。

パッチは3点を変更する。SpeechRecognizerがなければ作成し、あれば前のセッションをcancel()するだけにした。onError()で呼び出し参照をnullにし、同じ呼び出しが二重に拒否されないようにした。onResults()でも同じく一度だけ確定させるようにした。なお、Androidの公式ドキュメントはSpeechRecognizerが不要になったら呼び出し側がdestroy()を呼ぶべきとしているが、このパッチは単に毎回のdestroy()をやめただけで、プラグインに他に呼び出す箇所はない。Windowsでのパッチ作業では、npx patch-packageが「Filename too long」エラーを出し、パッチを再生成する前にandroid/buildフォルダを削除して解決した。