Google TVの消灯を複数時間帯に分けるschedule_windows設計
※本記事にはアフィリエイトリンクを含む場合があります。内容は広告の有無に影響されません。
結論
Google TVのキオスクで昼休みだけ表示を止めるため、端末アプリでは複数の点灯時間帯を優先し、どの時間帯にも入らないときにOFFとする設計を選んだ。
2026年6月29日の端末アプリの変更で、Google TVの表示スケジュールに複数の点灯時間帯を追加した。朝に表示を始め、夜に止める単一の時間帯を残しつつ、昼休み消灯のような途中の休止を表現するための拡張だ。ここではその時点の独自アプリの設計を扱う。Google TV標準のタイマー設定や、機種を問わない電源断の手順ではない。
Google TVのキオスクで昼休みだけ表示を止めるため、端末アプリでは複数の点灯時間帯を優先し、どの時間帯にも入らないときにOFFとする設計を選んだ。
消灯時間を足すより、点灯する時間帯を並べた
従来の設定は開始と終了を一組だけ持つ。既定値は平日の7:30から22:00までだった。この一組の内側に休止を挟むには、単に夜の終了時刻を変えるだけでは足りない。
そこでScheduleConfigにwindowsを追加した。各要素が点灯開始と終了を持ち、一つでも現在時刻を含めば表示する。複数の時間帯があればそちらを優先し、どれにも入らなければOFFにする。
if (windows.isNotEmpty()) {
return windows.none { it.contains(curMinutes) }
}
この戻り値は「いまOFFの時間か」なので、noneがtrueになると表示時間外になる。午前と午後を分ける場合も、消灯例外を別に重ねるのではなく、点灯時間帯の間を空ける形になる。
旧設定へ戻れることを優先した
windowsが空なら従来の開始・終了時刻で判定する。複数時間帯をまだ送らないサーバでも、単一時間帯の設定を使い続けられる。アラーム予約用のeffectiveWindows()も、複数時間帯がなければ従来の一組をリストに変換して返す。
遠隔設定では、配列の名前はschedule_windowsだ。ConfigPollerはこれをScheduleConfig.windowsへ変換する。配置には注意が要る。schedule_windowsはscheduleの子ではなく、同じ階層のフィールドを読む。ただし処理を囲む条件はscheduleの存在なので、配列だけを単独で送ってもこの読み込み処理には入らない。
設定が変わった場合は保存後にアラームを組み直し、現在時刻の状態も適用する。次の境界時刻まで待たせる設計にはしていない。
複数時間帯でも、曜日と境界は別に判定する
スケジュール無効時にはOFF期間とは判定しない。有効でも対象曜日でなければ、その日はOFFになる。複数時間帯の判定は、その後だ。時間帯を追加すれば曜日条件も上書きできるわけではない。
同日内の時間帯は開始を含み、終了を含まない。日をまたぐ時間帯は、開始以降か終了より前を含む。一方、開始と終了が同じなら、その時間帯は終日ONと扱う。これは「長さゼロだから表示しない」という解釈とは逆なので、設定を作る側も意味を合わせる必要がある。
遠隔設定の取り込みには、有効なのにdays_maskが0なら更新を拒否し、既存設定を維持するガードもある。対象曜日が一つもない設定で表示を止め続けることを避けるためだ。
空配列への復帰と、時刻の検証は同じではない
parseWindowsJson()は空文字やJSONの解析失敗を空リストへ戻す。その結果、単一時間帯へのフォールバックが働く。ただし、各時刻フィールドの読み込みにはoptInt(..., 0)を使っている。この関数だけでは時・分の範囲検証まで行っていない。
つまり「壊れたJSONなら旧設定に戻る」と「配列の中の時刻が妥当である」は別の条件だ。特に開始と終了の一致が終日ONを意味する以上、空配列と、時刻がすべて0の要素が入った配列は同じ扱いにはならない。
この拡張で選んだのは、複数の点灯時間帯を正準にしながら、未指定なら従来の一組へ戻す構造だった。昼の休止を表現できることに加え、設定が空のときと、時間帯が明示されたときの意味を分けることが互換性の要になる。
よくある質問
Q1Google TVキオスクで昼休みだけ消灯するには?
この端末アプリでは複数の点灯時間帯を持たせ、そのどれにも入らない時間をOFFとする。午前と午後を別の時間帯にすれば、間の休止時間を表現できる。Google TV標準機能の設定手順ではない。
Q2schedule_windowsはscheduleの中に入れますか?
この実装ではscheduleと同じ階層に置く。ただし読み込み処理自体はscheduleオブジェクトが存在する場合に走るため、schedule_windowsだけを送る構成にはしていない。
Q3複数時間帯が空なら終日消灯になりますか?
空配列や未指定なら、従来のonHour/onMinuteとoffHour/offMinuteによる単一時間帯へ戻る。複数時間帯の空配列を、終日OFFの指示としては使っていない。
確認した環境
- 2026-06-29のAndroid端末アプリ実装(コミットdb5d962)
- Kotlin / Google TV向けサイネージ
この記事の根拠
- Kotlinファイル 9〜81行目コミット db5d962
- Kotlinファイル 148〜162行目コミット db5d962
- Kotlinファイル 251〜278行目コミット db5d962
本文の主張は、上の記録に書かれていることだけです。運用しているリポジトリは非公開のため リンクは張れませんが、どのファイルの何行目を、どのコミット時点で見て書いたかは 記事ごとに残しています。推測で書いた箇所はありません。