縦書きの際のOSジェスチャー干渉

[L4Ph]

以前のコミットでできる限り直したつもりだったが、全く効果がなく、縦書きのときにホームに戻ろうとすると、次のエピーソードにスクロールが発生してしまう。

[L4Ph]

@claude とくにAOSPで絶望的なまでに干渉するので、用途に耐えうるAPIがないか調査してほしい

もしないのであれば、仕方ないがジェスチャー丸ごとロックするか、スクロールの方向を考える必要がある

[claude]

Claude finished @L4Ph's task in 5m 7s —— View job

---

タスク一覧

• プロジェクト構造を理解し、現在のスクロール/ジェスチャー処理コードを確認
• Flutter/AndroidのジェスチャーAPI調査
• AOSP特有のエッジジェスチャー干渉問題の調査
• 調査結果の報告と解決策の提案

---

調査結果

縦書きスクロール時のOSジェスチャー干渉について、以下の調査結果と解決策をまとめました。

現状の問題点

1. novel_page.dartのPageView (L131-168)

   • systemGestureInsetsを考慮していない
   • 縦書き時のエッジスワイプとシステムナビゲーションジェスチャーが競合

2. tategaki_text_paged.dartのPageView (L71-87)

   • RTL方向のPageViewにエッジスワイプ対策がない

利用可能なAPI

1. SystemGestureInsets (最も手軽)

• MediaQuery.of(context).systemGestureInsetsでシステムジェスチャー領域を取得
• Android Q (API 29) 以降で有効
• 現在novel_content.dartでは既にパディング計算に使用されているが、novel_page.dartのPageViewには適用されていない

2. android_gesture_exclusion パッケージ

• Android 10以降のsetSystemGestureExclusionRects APIをFlutterから利用
• 特定の矩形領域をシステムジェスチャーから除外可能
• 制限: 矩形の合計高さが200dp未満に制限されている

3. カスタムScrollPhysics

• PageViewのジェスチャー感度を細かく制御
• エッジ付近でのスワイプ反応を調整可能

推奨される解決策

以下の3つのアプローチを提案します:

オプションA: SystemGestureInsetsの適用 (推奨)

最も手軽で効果的な方法。novel_page.dartのPageViewにシステムジェスチャー領域を考慮したパディングを追加:

// novel_page.dartのPageView.builderの外側にPaddingを追加
final systemInsets = MediaQuery.of(context).systemGestureInsets;
Padding(
  padding: EdgeInsets.only(
    left: settings.isVertical ? systemInsets.left : 0,
    right: settings.isVertical ? systemInsets.right : 0,
    top: !settings.isVertical ? systemInsets.top : 0,
    bottom: !settings.isVertical ? systemInsets.bottom : 0,
  ),
  child: PageView.builder(...),
)

メリット: 簡単、Flutter標準API、追加依存なし
デメリット: パディング分、表示領域が狭くなる

オプションB: PageViewのジェスチャー無効化

ページ遷移を自動スクロールに任せ、PageViewのスワイプを完全に無効化:

PageView.builder(
  physics: NeverScrollableScrollPhysics(),
  // ...
)

メリット: 干渉が完全に解消
デメリット: ユーザーが明示的にページをめくれなくなる(UX低下)

オプションC: android_gesture_exclusionパッケージ

Android固有の機能を使い、PageView領域をシステムジェスチャーから除外:

dependencies:
  android_gesture_exclusion: ^1.0.0

メリット: 最も根本的な解決
デメリット:

• Android専用(iOSでは効果なし)
• 矩形の高さ制限(200dp未満)があるため、全画面除外は不可
• 追加の依存関係

補足: スクロール方向の変更について

もう一つの選択肢として、縦書きモード時のPageViewのスクロール方向を変更する方法もあります:

現在は縦書き時に Axis.vertical (上下スワイプ)でエピソード遷移していますが、これを Axis.horizontal (左右スワイプ)に変更すれば、ホームジェスチャー(下から上へのスワイプ)との干渉は解消されます。

ただし、この方法は読書体験の変更を伴うため、ユーザーの好みに応じて選択できるようにするのが良いかもしれません。

次のステップ

どのアプローチを採用するか、以下の点を考慮して決定する必要があります:

1. オプションAを試して効果を確認する(最も低リスク)
2. 効果が不十分な場合、オプションCの導入を検討
3. オプションBはUXへの影響が大きいため、最終手段
4. スクロール方向の変更も設定として提供可能

いずれの方法で進めるか、ご指示ください。

---