Ubuntu 24.04のWayland環境でタッチパッドジェスチャーが動作しない問題を修正する

ポインターを通常どおり動かすと、2本指スクロールは引き続き機能するかもしれませんが、おなじみの3本指スワイプではアクティビティが開いたりワークスペースが切り替わったりしなくなります。Ubuntu 24.04 では、この症状は「Wayland ジェスチャーが無効になっている」と誤診されることがよくあります。標準の GNOME デスクトップでは、組み込みの 3本指システムジェスチャー用の個別のマスター スイッチはありません。重要なのは、ジェスチャーがどこで停止するかです。セッション、タッチパッドの設定、libinput、GNOME Shell、またはハードウェア自体のどれでしょうか。

このガイドでは、まず迅速かつ元に戻せるチェックから始め、次にインプット診断へと進みます。Ubuntu 24.04 LTS は、サポートされているシステムではデフォルトで Wayland 上の GNOME を使用し、GNOME では、アクティビティの概要を開いたりワークスペースを切り替えたりするための 3 本の指のスワイプ操作について説明しています。基盤となる libinput スタックは、サポートされているタッチパッドでスワイプおよびピンチ イベントを報告できます。これらの 2 つの事実から、明確なトラブルシューティング手順が得られます。Wayland であることを確認し、タッチパッドがアクティブであることを確認し、標準の GNOME ジェスチャーをテストし、libinput がマルチフィンガー イベントを受信するかどうかを確認します。

1. 実際にWaylandセッションに参加していることを確認してください。

ターミナルを開いて以下を実行します。

echo $XDG_SESSION_TYPE

期待される結果は ですwayland。コマンドが を出力する場合はx11、別の入力パスのトラブルシューティングを行っています。Ubuntu は Xorg セッションを提供できますが、そこでのジェスチャー動作はネイティブの GNOME Wayland エクスペリエンスと同一ではありません。

Xorg環境でデフォルトのWaylandセッションを使用したい場合は、ログアウトしてください。サインイン画面でアカウントを選択し、セッション選択画面を開いて、利用可能なオプションが表示されたら「Ubuntu on Xorg」ではなく「Ubuntu」を選択してください。ハードウェア、グラフィックドライバ、リモートデスクトップセッション、または管理者ポリシーによって、提供されるセッションが影響を受ける場合があります。そのため、利用できないオプションがある理由を確認せずに、無理やり選択しないでください。

GNOME の公式ジェスチャー動作については、GNOME ヘルプ: タッチパッドとタッチスクリーンでのジェスチャーの使用に記載されています。

2. タッチパッド自体が有効になっていることを確認してください。

設定 > マウスとタッチパッドを開きます。タッチパッドが有効になっていることを確認してください。また、2本指スクロールと基本的なタップ操作もテストしてください。GNOMEの設定パネルは、デスクトップがタッチパッドを認識している場合にのみタッチパッドのコントロールを表示するため、タッチパッドのセクションが表示されない場合は、見た目の問題ではなく、重要な手がかりとなります。

Ubuntu 24.04の標準設定パネルで「3本指ジェスチャー」の切り替えスイッチを探すのに時間を費やさないでください。GNOME Shellに組み込まれているシステムジェスチャーは、通常、専用のオン/オフスイッチで制御されるものではありません。ポインターの移動と2本指スクロールは機能するのに3本指ジェスチャーが機能しない場合は、次のテストに進んでください。

タッチパッドの操作方法については、GNOME ヘルプ: タッチパッドでクリック、ドラッグ、スクロールするを参照してください。

3. アプリ固有のジェスチャーではなく、標準のGNOMEジェスチャーをテストしてください。

タッチパッド上で3本の指を使って上方向にスワイプしてください。GNOMEがアクティビティの概要画面を開きます。さらに上方向にスワイプすると、アプリケーション画面が開きます。3本の指で左右にスワイプすると、ワークスペースが切り替わります。これらはGNOME Shellのジェスチャーであり、Firefox、ブラウザ拡張機能、デスクトップアドオン、またはサードパーティ製のジェスチャーデーモンが提供する機能ではないため、最適なベースラインテストと言えます。

ピンチズームは別問題です。libinputはピンチジェスチャーを認識できますが、ピンチ操作でコンテンツがズームされるかどうかはアプリケーションとツールキットによって異なります。あるアプリケーションで3本指スワイプが正常に動作する一方でピンチ操作が動作しない場合、通常はそのアプリケーション自体に問題があることが示唆され、Wayland全体に問題があるわけではありません。

4. libinputがタッチパッドを認識するかどうかを確認します。

Ubuntuにはlibinput-tools入力診断用のパッケージが用意されています。libinputコマンドがインストールされていない場合は、以下で追加してください。

sudo apt update
sudo apt install libinput-tools

次に、デバイスの一覧を表示します。

sudo libinput list-devices

お使いのタッチパッドに対応するブロックを見つけてください。正確なモデル名、イベントノード、寸法、構成はノートパソコンによって異なります。重要なのは、libinput がそのデバイスをタッチパッドとして認識し、期待される機能を公開することです。Ubuntu 24.04 パッケージはUbuntu Noble パッケージカタログに記載されており、コマンド自体はUbuntu libinput の man ページに記載されています。

タッチパッドが認識されない場合libinput list-devices、これはもはや主にGNOMEジェスチャーの問題ではありません。ファームウェア/BIOS設定でデバイスが表示されるか、ハードウェアタッチパッドの切り替えが有効になっているか、再起動後にカーネルがデバイスを認識するかを確認してください。GNOMEがジェスチャーを受信できるようになるには、ノートパソコン固有のカーネル、I2C-HID、またはファームウェアの問題を解決する必要があります。

5. 生のジェスチャーイベントを観察する

最も有益なテストは、3本の指を動かしたときにlibinputがジェスチャーイベントを発信するかどうかを確認することです。以下を実行してください。

sudo libinput debug-events

次に、3本指でスワイプします。対応ハードウェアでは、スワイプ開始、更新、終了などのジェスチャーイベント行が表示されます。イベントノード、タイミング、差分、フォーマットは異なる場合があります。このコマンドは/dev/input/event*デバイスを直接読み取るため、通常はroot権限が必要です。

Ubuntuの公式マニュアルページ「libinput-debug-events」では、このツールはデバッグヘルパーとして説明されており、出力形式が変更される可能性があると警告されています。libinputのジェスチャーに関するドキュメントでは、スワイプジェスチャーとピンチジェスチャーがどのように生成されるかが説明されています。

ジェスチャーイベントが表示される場合：ハードウェアとlibinputパスは正常に動作しています。次に、GNOME Shell、拡張機能、セッション状態、およびアップデートを確認してください。マルチフィンガージェスチャーイベントが表示されない場合：指をはっきりと離して再度テストしてください。基本的なポインターイベントは表示されるものの、3本指ジェスチャーがまったく表示されない場合は、タッチパッドに必要なマルチタッチ機能がないか、カーネル/ファームウェアの問題により十分な接触が報告されていない可能性があります。

6. 最新のUbuntu 24.04アップデートをインストールします。

ドライバーを交換したり、低レベルの設定ファイルを編集したりする前に、インストールされている24.04パッケージを最新の状態に更新してください。

sudo apt update
sudo apt upgrade

アップデートによって新しいカーネル、グラフィックススタック、または再起動が必要なその他のコンポーネントがインストールされる場合は、再起動してください。ジェスチャー処理は、カーネル入力ドライバ、libinput、Mutter/GNOME Shell、アプリケーションなど、複数のレイヤーにまたがるため、既に修正済みのバグが、アップデートされていないマシンで引き続き発生する可能性があります。

ランダムなSynapticsパッケージをダウンロードしたり、以前のUbuntuリリース向けに書かれたチュートリアルから古いXorg設定ファイルをコピーしたりすることは避けてください。標準のWayland GNOMEセッションでは、libinputが関連する入力ライブラリであり、Xorgのみの設定ファイルはGNOME Shellのジェスチャーを修復する信頼できる方法ではありません。

7. GNOME Shell拡張機能を一時的に無効にする

libinput debug-events3本指スワイプが明確に表示されているにもかかわらずGNOMEが何も反応しない場合は、サードパーティ製のGNOME Shell拡張機能を一時的に無効にして再度テストしてください。拡張機能は、ワークスペースの動作、ウィンドウ管理、概要表示の動作、またはジェスチャー処理を変更する可能性があります。拡張機能アプリがインストールされている場合はそれを使用するか、以下のコマンドで有効になっている拡張機能の一覧を表示してください。

gnome-extensions list --enabled

疑わしい拡張機能を一つずつ無効にするには、以下を使用してください。

gnome-extensions disable EXTENSION_UUID

EXTENSION_UUIDlist コマンドによって返される識別子に置き換えてください。シェル拡張機能を変更した後は、ログアウトして再度ログインすることで、クリーンなセッションでテストしていることを確認できます。

この手順は診断のためのものであり、拡張機能を永久的に無効にすることを推奨するものではありません。競合する拡張機能が特定できたら、それを更新するか、設定を調整するか、またはその拡張機能のみを無効にしてください。

8. クリーンなWaylandセッションに再度入り、もう一度テストしてください。

ログアウトし、サインイン時に通常のUbuntu Waylandセッションを選択してから、多くのアプリケーションを再度開く前に、標準のジェスチャーテストを繰り返してください。これにより、一時的なGNOME Shellの状態がクリアされ、拡張機能またはセッション固有のプロセスが関与していたかどうかを容易に判別できます。

Ubuntuを選択してもシステムが常にXorgに戻ってしまう場合は、タッチパッドに問題があると決めつけるのではなく、原因を調査してください。グラフィックドライバの互換性、リモートアクセス設定、またはローカルポリシーによって、利用可能なセッションが変わる可能性があります。

なぜToucheggのインストールはWaylandにおける最初の解決策ではないのか

よくある解決策として、ジェスチャーデーモンをすぐにインストールするというものがあります。これは一部の環境でカスタムアクションを実行する際には役立ちますが、WaylandセッションでGNOMEの組み込みジェスチャーが機能しない場合の最初の対応としては適切ではありません。GNOME Shellは既に独自の3本指システムジェスチャーを実装しています。libinputが認識している内容を確認する前に別のジェスチャーレイヤーを追加すると、診断が難しくなり、システム予約済みのジェスチャーとの競合が発生する可能性があります。

GNOMEのヒューマンインターフェースガイドラインでは、3本指および4本指のジェスチャーはシステム専用であると明記されています。そのため、アプリケーションレベルのジェスチャー動作は、デスクトップのワークスペースジェスチャーとは互換性がありません。GNOMEのポインターとタッチに関するガイドラインを参照してください。

問題が本当に解決されたことを確認する方法

「カーソルが動く」だけで止まってはいけません。修復が成功した場合、いくつかの独立したチェックに合格する必要があります。

• echo $XDG_SESSION_TYPE返しますwayland。
• 設定の中にタッチパッドの項目があり、通常のタッチパッド操作は正常に機能します。
• 3本の指で上にスワイプすると、アクティビティが開きます。
• 3本の指で左右にスワイプすると、ワークスペースが切り替わります。
• sudo libinput debug-events対応する複数指ジェスチャーイベントを表示します。
• ログアウト後や再起動後も、ジェスチャー操作は引き続き機能します。

libinput テストが成功しても、アップデート、拡張機能のテスト、Wayland への新規ログイン後も GNOME ジェスチャーが依然として失敗する場合は、問題がデスクトップ セッションまたはコンポジタ レベルのものである可能性が高いです。その場合は、Ubuntu のバージョン、カーネル バージョン (から取得) uname -r、GNOME Shell バージョン (から取得gnome-shell --version)、タッチパッド モデル (から取得libinput list-devices)、およびどの標準ジェスチャーが失敗するかの簡単な説明を収集してください。これらの情報は、ドライバーを闇雲に再インストールするよりも、バグ レポートを作成する上で遥かに役立ちます。

libinputが3本指ジェスチャーを報告しない場合は、ハードウェアの機能、ファームウェア、カーネルのサポートに注目してください。GNOMEワークスペースのジェスチャーは正常に動作するのに、特定のアプリケーションのピンチ操作やナビゲーション操作だけが失敗する場合は、そのアプリケーションを個別にトラブルシューティングしてください。この区別こそが、小さな入力問題をより大きなシステム構成の問題に発展させることなく、Ubuntu 24.04のタッチパッドジェスチャーを修正するための鍵となります。