Android の VideoView で再生するファイルが消えていると、OS の英語のエラーダイアログが画面を覆う。setOnErrorListener で true を返して自前の文言に

結論

VideoView にエラーのリスナーが無いと、再生できないときに OS の既定のダイアログ(英語)が出ます。setOnErrorListener で true を返して既定のダイアログを止め、ファイルが無いときはそもそも VideoView を作らずに自前の文言を出すようにしたら、試験が通りました。

作った動画を一時ファイルに置いて、アプリの中で再生する画面での話です。エミュレーター(AVD)で画面の試験を流していたら、動画の再生の試験が落ちていて、調べるとアプリ側の不具合でした。

症状

  • 再生する一時ファイルが消えている状態で動画の画面を開くと、OS の英語のエラーダイアログが出て、画面を覆う。
  • アプリの文言は日本語なのに、ここだけ英語になる。用意していた「一時ファイルが見つからない」の文言は出ない。
  • 動画の画面の試験(u06)が落ちていた。

環境

  • Android アプリ(Kotlin)、動画の再生に VideoView を使用
  • Android エミュレーター(AVD)で画面の試験を実行

原因

再生の部品(VideoPlayer)が、VideoView にエラーのリスナー(setOnErrorListener)を付けていませんでした。

VideoView は、再生でエラーが起きたときにリスナーが無いか、リスナーが false を返すと、OS の既定のダイアログを出します。そのため、ファイルが消えているときにアプリの文言ではなく英語のダイアログが出ていました。

解決手順

  1. VideoView に setOnErrorListener を付け、自前の文言を出してから true を返す。true を返すと「エラーは処理した」扱いになり、既定のダイアログは出ません。

kotlin
videoView.setOnErrorListener { _, _, _ ->
// アプリの文言を出す(既存の TEMP_MISSING の文言)
showMessage(TEMP_MISSING)
true
}

  1. 再生する前に一時ファイルがあるかを確かめ、無いときは VideoView を作らずに同じ文言を出す。ファイルが無いことが分かっているなら、再生してエラーを待つ必要はありません。

kotlin
if (!tempFile.exists()) {
showMessage(TEMP_MISSING)
return
}

  1. エミュレーターで該当の試験を1件ずつ流して確かめる。
版 u06 u07
直す前 落ちる 落ちない
直した後 合格 合格

直す前の版で u06 が落ちることも確かめたので、試験がこの不具合を捕まえられることも分かりました。

利用者に出る文言は「動画の一時ファイルが見つかりません。もう一度つくってください。」です。

再発防止・気づき

  • VideoView を使うなら、エラーのリスナーは必ず付ける。付けないと、OS の言語のダイアログがアプリの見た目を無視して出ます。
  • 「ファイルが無い」のように事前に分かる失敗は、再生の前に確かめて分岐する。エラーのリスナーは、ファイルはあるのに再生できない場合の受け皿にする。
  • 直した後も、全部の試験を続けて流す確認はまだでした。1件ずつ通ったことと、全体で通ることは分けて確かめます。

関連

この記事を書いた人

realine

Windows の PC で、MT5(MQL5)の EA・インジケーターの開発、WordPress のプラグイン開発とサイト運営、PowerShell・Python での作業の自動化をしています。このサイトには、その作業で実際につまずいたことと、効いた直し方を、確かめた環境と手順つきで残しています。

運営者情報と記事の作り方