Chromebook の入力互換性

Chrome OS デバイスでは、多くのユーザーがキーボード、マウス、トラックパッド、タッチペン、ゲームパッドを使用してアプリを操作します。これらの入力デバイスは Android スマートフォンでも使用されますが、一般的ではないためデベロッパーによって見過ごされがちです。

Chrome OS とその他の大画面 Android 対応デバイスでの入力に対してアプリが十分に機能するようにしたい場合は、次の最適化を考慮する必要があります。

基本的なキーボードサポートを追加してテストする（矢印キーと Tab キーによるキーボードナビゲーション、Enter キーによるテキスト入力の確定、Space キーによるメディアアプリの再生と一時停止など）。
可能であれば標準のキーボードショートカットを追加する（Ctrl+Z で元に戻す、Ctrl+S で保存するなど）。
基本的なマウス操作をテストする（右クリックしてコンテキストメニューを表示する、ユーザーがカーソルを合わせたときにアイコンを変更する、マウスホイールまたはトラックパッドでカスタムビューをスクロールするなど）。
アプリ固有の入力デバイスをテストする（描画アプリ用のタッチペン、ゲーム用のゲームコントローラ、音楽アプリ用の MIDI コントローラなど）。
パソコン環境でアプリの魅力を高める高度な入力サポートを検討する（DJ アプリ用のクロスフェーダーとしてのタッチパッド、ゲーム用のマウスキャプチャ、パワーユーザー向けの豊富なキーボードショートカットなど）。

キーボード

キーボード入力に対してアプリがどのように応答するかは、パソコンのエクスペリエンスを高める鍵になります。キーボード入力には、ナビゲーション、キーストローク、ショートカットの 3 種類があります。

タッチ中心のアプリにキーボードナビゲーションが実装されることはまれですが、ユーザーはアプリの使用時にキーボードを操作できることを期待します。また、スマートフォンとパソコンの両方でユーザー補助機能を必要とするユーザーにとって、キーボードは不可欠です。

多くのアプリで必要とされるのは、矢印キーと Tab キーによるシンプルなナビゲーションのみであり、それらはほとんどの場合 Android フレームワークによって自動的に処理されます。たとえば、Button のビューはデフォルトでフォーカス可能であり、キーボードナビゲーションは一般的に追加のコードなしで機能します。デフォルトではフォーカス可能でないビューのキーボードナビゲーションを有効にするには、デベロッパーがビューをフォーカス可能としてマークする必要があります。これは、以下に示すように、プログラムまたは XML で実現できます。詳細については、フォーカス処理のドキュメントをご覧ください。

Kotlin

yourView.isFocusable = true

Java

yourView.setFocusable(true);

代替策として、レイアウトファイルで focusable 属性を設定する方法もあります。

android:focusable="true"

フォーカスが有効になると、Android フレームワークはすべてのフォーカス可能なビューの位置に基づいて、それらのナビゲーションマッピングを作成します。通常、これは想定される動作であり、特別な作業は不要です。デフォルトマッピングがアプリのニーズに合わない場合は、次のようにしてオーバーライドできます。

Kotlin

// Arrow keys
yourView.nextFocusLeftId = R.id.view_to_left
yourView.nextFocusRightId = R.id.view_to_right
yourView.nextFocusTopId = R.id.view_above
yourView.nextFocusBottomId = R.id.view_below

// Tab key
yourView.nextFocusForwardId = R.id.next_view

Java

// Arrow keys
yourView.setNextFocusLeftId(R.id.view_to_left);
yourView.setNextFocusRightId(R.id.view_to_left);
yourView.setNextFocusTopId(R.id.view_to_left);
yourView.setNextFocusBottomId(R.id.view_to_left);

// Tab key
yourView.setNextFocusForwardId(R.id.next_view);

アプリをリリースする前に、キーボードのみを使用してアプリの各機能をテストすることをおすすめします。一般的な操作は、マウス入力やタッチ入力なしで簡単に行えるようにする必要があります。

ユーザー補助機能を必要とするユーザーにとっては、キーボードサポートが不可欠であることに留意してください。

キーストローク

EditText のような画面上の仮想キーボード（IME）によって処理されるテキスト入力については、デベロッパーによる追加作業がなくてもアプリが Chrome OS 上で期待どおりに動作することが求められます。フレームワークが予測できないキーストロークについては、アプリが独自に動作を処理する必要があります。これは、特にカスタムビューを使用するアプリに当てはまります。

例としては、Enter キーを使用してメッセージを送信するチャットアプリ、Space キーで再生を開始および停止するメディアアプリ、W、A、S、D キーで移動を制御するゲームなどがあります。

ほとんどのアプリは、次に示すように、onKeyUp イベントをオーバーライドして、受け取ったキーコードごとに期待される動作を追加します。

Kotlin

override fun onKeyUp(keyCode: Int, event: KeyEvent): Boolean {
    return when (keyCode) {
        KeyEvent.KEYCODE_ENTER -> {
            sendChatMessage()
            true
        }
        KeyEvent.KEYCODE_SPACE -> {
            playOrPauseMedia()
            true
        }
        else -> super.onKeyUp(keyCode, event)
    }
}

Java

@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {
    if (keyCode == KeyEvent.KEYCODE_ENTER) {
        sendMessage();
        return true;
    } else if (KeyEvent.KEYCODE_SPACE){
        playOrPauseMedia();
        return true;
    } else {
        return super.onKeyUp(keyCode, event);
    }
}

onKeyUp を使用すると、キーを押したり離したりする操作が遅い場合に、アプリが複数のイベントを受信することを回避できます。ユーザーがキーボードのキーを押す操作を想定しているゲームとアプリでは、onKeyDown イベントを探すことができます。

キーボードサポートを追加する場合は、Android のキーボード処理のドキュメントに沿って操作してください。

ショートカット

パソコン環境では、Ctrl キー、Alt キー、Shift キーをベースとする一般的なショートカットが求められます。それらのショートカットがアプリに実装されていないと、ユーザーはフラストレーションを感じたり故障を疑ったりする可能性があります。また上級ユーザーにとっては、よく使うアプリ固有のタスクのショートカットが役立ちます。ショートカットを実装することで、アプリの使いやすさを高め、ショートカットを備えていないアプリとの差別化を図ることができます。

一般的なショートカットには、Ctrl+S（保存）、Ctrl+Z（元に戻す）、Ctrl+Shift+Z（やり直し）などがあります。より高度なショートカットの例については、VLC Media Player のショートカットキーの一覧をご覧ください。

ショートカットは dispatchKeyShortcutEvent を使用して実装できます。このメソッドは、特定のキーコードのすべてのメタキーの組み合わせ（Alt、Ctrl、Shift）をインターセプトします。特定のメタキーをチェックするには、KeyEvent.isCtrlPressed()、KeyEvent.isShiftPressed()、KeyEvent.isAltPressed()、または KeyEvent.hasModifiers() を使用します。

ショートカットコードを他のキーストローク処理（onKeyUp や onKeyDown）から分離することで、コードのメンテナンスが容易になり、すべての場合に手動でメタキーのチェックを実装しなくても、メタキーのデフォルトの受容を管理できます。また、さまざまなキーボードレイアウトとオペレーティングシステムに慣れたユーザーにとっては、あらゆるメタキーの組み合わせが可能であれば、使いやすさが向上します。

Kotlin

override fun dispatchKeyShortcutEvent(event: KeyEvent): Boolean {
  return when (event.keyCode) {
    KeyEvent.KEYCODE_O -> {
      openFile() // Ctrl+O, Shift+O, Alt+O
      true
    }
    KeyEvent.KEYCODE_Z-> {
      if (event.isCtrlPressed) {
        if (event.isShiftPressed) {
          redoLastAction() // Ctrl+Shift+Z pressed
          true
        } else {
          undoLastAction() // Ctrl+Z pressed
          true
        }
      }
    }
    else -> {
      return super.dispatchKeyShortcutEvent(event)
    }
  }
}

Java

@Override
public boolean dispatchKeyShortcutEvent(KeyEvent event) {
  if (event.getKeyCode() == KeyEvent.KEYCODE_O) {
      openFile(); // Ctrl+O, Shift+O, Alt+O
      return true;
  } else if(event.getKeyCode() == KeyEvent.KEYCODE_Z) {
      if (event.isCtrlPressed()) {
          if (event.isShiftPressed()) {
              redoLastAction();
              return true;
          }
          else {
              undoLastAction();
              return true;
          }
      }
  }
  return super.dispatchKeyShortcutEvent(event);
}

onKeyUp でショートカットを実装することもできます。そのためには、上記と同様に KeyEvent.isCtrlPressed()、KeyEvent.isShiftPressed()、または KeyEvent.isAltPressed() をチェックします。この方法では、メタキーの動作がショートカットというよりもアプリの動作の変形である場合に、メンテナンスが簡単になります。たとえば、W が「前に歩く」を意味し、Shift+W が「前に走る」を意味する場合などです。

Kotlin

override fun onKeyUp(keyCode: Int, event: KeyEvent): Boolean {
  return when(keyCode) {
    KeyEvent.KEYCODE_W-> {
      if (event.isShiftPressed) {
        if (event.isCtrlPressed) {
          flyForward() // Ctrl+Shift+W pressed
          true
        } else {
          runForward() // Shift+W pressed
          true
        }
      } else {
        walkForward() // W pressed
        true
      }
    }
    else -> super.onKeyUp(keyCode, event)
  }
}

Java

@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {
    if (keyCode == KeyEvent.KEYCODE_W) {
        if (event.isShiftPressed()) {
            if (event.isCtrlPressed()) {
                flyForward(); // Ctrl+Shift+W pressed
                return true;
            } else {
                runForward(); // Shift+W pressed
                return true;
            }
        } else {
            walkForward();
            return true;
        }
    }
    return super.onKeyUp(keyCode, event);
}

マウスとタッチパッドのサポート

Chrome OS では、ほとんどのマウスイベントとトラックパッドイベントは、Android スマートフォンのタッチイベントと同様に動作するように自動的に処理されます。2 本の指によるタッチパッド操作とマウスホイールによるスクロールもこれに該当します。一般的に、ほとんどのアプリで処理する必要があるパソコン中心のイベントは、右クリック、マウスオーバー、ドラッグ＆ドロップの 3 つだけです。

右クリック

リストアイテムの長押しなど、アプリにコンテキストメニューを表示させるためのすべてのアクションは、右クリックイベントにも反応する必要があります。アプリが右クリックイベントを処理するには、View.OnContextClickListener の登録が必要です。コンテキストメニューの作成の詳細については、Android のコンテキストメニューのドキュメントをご覧ください。

Kotlin

yourView.setOnContextClickListener {
  showContextMenu()
  true
}

Java

yourView.setOnContextClickListener(v -> {
    showContextMenu();
    return true;
});

マウスオーバー

デベロッパーは、マウスオーバーイベントを適切に処理することで、アプリのレイアウトが洗練されていて使いやすいとユーザーに感じさせることができます。これは、特にカスタムビューに当てはまります。最も一般的な例は次の 2 つです。

マウスポインタアイコンを変更することで、要素にインタラクティブな動作がある（たとえば、クリック可能または編集可能である）ことをユーザーに知らせる
大規模なリストまたはグリッド内のアイテムにユーザーがカーソルを合わせたとき、そのアイテムに視覚的なフィードバックを追加する

Kotlin

// Change the icon to a "hand" pointer on hover,
// Highlight the view by changing the background.
yourView.setOnHoverListener { view, _ ->
  addVisualHighlighting(true)
  view.pointerIcon =
    PointerIcon.getSystemIcon(view.context,
    PointerIcon.TYPE_HAND)
  false // listener did not consume the event.
}

Java

yourView.setOnHoverListener((view, event) -> {
    addVisualHighlighting(true);
    view.setPointerIcon(PointerIcon
            .getSystemIcon(view.getContext(), PointerIcon.TYPE_HAND));
    return true;
});

ドラッグ＆ドロップ

マルチウィンドウ環境では、ユーザーはアプリ間でアイテムをドラッグ＆ドロップできることを期待します。これは、Chrome OS デバイス、タブレット、スマートフォン、分割画面モードの折りたたみ式デバイスに当てはまります。

デベロッパーは、ユーザーがアプリにアイテムをドラッグする可能性があるかどうかを考慮する必要があります。よくある例としては、写真エディタによる写真の受け取り、オーディオプレーヤーによるオーディオファイルの受け取り、描画プログラムによる写真の受け取りなどがあります。

ドラッグ＆ドロップのサポートを追加するには、Android のドラッグ＆ドロップのドキュメントに従い、こちらの Chrome OS に関するブログ投稿を参照してください。

Chrome OS 向けの特別な考慮事項

Chrome OS ファイルアプリのファイルを処理するには、MIME タイプ application/x-arc-uri-list を探します。
アプリ外からドラッグしたアイテムにアクセスするには、requestDragAndDropPermissions を使用して権限をリクエストします。
他のアプリにアイテムをドラッグするには、アイテムに View.DRAG_FLAG_GLOBAL フラグを設定する必要があります。

高度なポインタのサポート

マウス入力とタッチパッド入力の高度な処理を行うアプリは、Android ドキュメントの View.onGenericMotionEvent() に関する説明に沿って、MotionEvent.getSource() を使用して SOURCE_MOUSE と SOURCE_TOUCHSCREEN を区別する必要があります。

MotionEvent を調べて、次のような必要な動作を実装します。

移動によって ACTION_HOVER_MOVE イベントを生成する。
ボタンによって ACTION_BUTTON_PRESS イベントと ACTION_BUTTON_RELEASE イベントを生成する。getButtonState() を使用して、すべてのマウスまたはトラックパッドボタンの現在の状態をチェックすることもできます。
マウスホイールのスクロールによって ACTION_SCROLL イベントを生成する。

タッチペン

多くの Chromebook にはタッチペンが付属しており、Android アプリはこれをタッチスクリーン入力として処理します。一部のデバイスは、Wacom Intuos のように USB または Bluetooth の描画テーブルを備えています。Android アプリは Bluetooth 入力を受け取れますが、USB 入力では動作しません。

タッチペンイベントは View.onTouchEvent() または View.onGenericMotionEvent() によってタッチスクリーンイベントとして報告され、SOURCE_STYLUS タイプの MotionEvent.getSource() を格納します。MotionEvent は、次のような追加データも格納します。

MotionEvent.getToolType() は、サーフェスと接触したツールに応じて、TOOL_TYPE_FINGER、TOOL_TYPE_STYLUS、または TOOL_TYPE_ERASER を返します。
MotionEvent.getPressure() は、タッチペンに加えられた物理的な圧力を報告します（サポートされている場合）。
MotionEvent.getAxisValue() を MotionEvent.AXIS_TILT および MotionEvent.AXIS_ORIENTATION と併用すると、タッチペンの物理的な傾きと方向を読み取ることができます（サポートされている場合）。

履歴ポイント

Android は、入力イベントを一括でまとめてフレームごとに 1 回送信します。タッチペン入力では、ディスプレイよりもはるかに高い頻度でイベントが報告される可能性があります。描画アプリを作成する場合は、次の getHistorical API を使用して、最近発生した可能性があるイベントをチェックすることが重要です。

MotionEvent.getHistoricalX()
MotionEvent.getHistoricalY()
MotionEvent.getHistoricalPressure()
MotionEvent.getHistoricalAxisValue()

パームリジェクション

Chrome OS は、ユーザーの手のひらがタッチスクリーンに置かれた状態を認識しようと試みます。ただし、これは常に可能であるとは限りません。OS が手のひらとして認識する前に、タッチイベントがアプリに報告されることがあります。その場合は、ACTION_CANCEL イベントを報告することで、タッチをキャンセルできます。

このイベントは、特定のタッチが無効であり、そのタッチによって発生したすべてのインタラクションを元に戻す必要があることをアプリに伝えます。たとえば、描画アプリは、レイテンシを最小限に抑えるため、新しい線を受け取るとすぐにそれらを一時的に描画しますが、それらがキャンバスで永続的に確定されるのは、一連のタッチが明確に終了してからです。その間にタッチイベントがキャンセルされた場合、一時的に描画された線は簡単に消去できます。

メモ作成アプリ

Chrome OS には、登録されたメモ作成アプリをユーザーに表示するための特別なインテントがあります。アプリをメモ作成アプリとして登録するには、Android マニフェストに次の行を追加します。

  <intent-filter>
    <action android:name="org.chromium.arc.intent.action.CREATE_NOTE" />
    <category android:name="android.intent.category.DEFAULT" />
  </intent-filter>

アプリが登録されると、ユーザーはそのアプリをデフォルトのメモ作成アプリとして選択できます。新しいメモがリクエストされた場合、アプリはタッチペン入力が可能な空のメモを作成する必要があります。ユーザーが画像（スクリーンショットやダウンロードした画像）にアノテーションを付けようとした場合、アプリは content:// URI を持つアイテムを 1 つ以上含む ClipData とともに起動します。アプリは、最初の添付画像を背景画像として使用するメモを作成し、ユーザーがタッチペンで描画できるモードに移行する必要があります。

タッチペンなしでメモ作成インテントをテストする

アプリがメモ作成インテントに正しく応答するかどうかをアクティブなタッチペンがない状態でテストするには、次の方法でメモ作成オプションを表示します。

デベロッパーモードに切り替えて、デバイスを書き込み可能にする
Ctrl+Alt+F2 キーを押して、ターミナルを開く
sudo vi /etc/chrome_dev.conf コマンドを実行する
i を押して入力モードに切り替え、ファイルの末尾に新しい行として --ash-enable-palette を追加する
Esc キーを押してから :、w、q を入力し、Enter キーを押して保存する
Ctrl+Alt+F1 キーを押して、通常の Chrome OS UI に戻る
ログアウトして再度ログインする

これで、シェルフにタッチペンメニューが表示されるようになります。

シェルフ内のタッチペンボタンをタップし、[新しいメモ] を選択します。これにより、空白の描画メモが開きます。
スクリーンショットを撮ります。シェルフから [タッチペンボタン] > [画面をキャプチャ] を選択するか、または画像をダウンロードします。画像にアノテーションを付けるオプションが通知に表示されます。これにより、アノテーションを付けることができる画像を含むアプリが起動します。

ゲームコントローラ

Chromebook は、最大 4 つのゲームコントローラをサポートします。デベロッパーは、標準の Android ゲームコントローラ API を使用してそれらを処理する必要があります。

ボタンは、一般的なマッピングに従って一般的な値にマッピングされます。残念ながら、すべてのゲームコントローラメーカーが同じマッピング規則に従っているわけではありません。各種の一般的なコントローラマッピングをユーザーが選択できるようにすると、エクスペリエンスを大幅に向上させることができます。

入力変換モード

Chrome OS では、デフォルトで入力変換モードが有効になっています。ほとんどの Android アプリの場合、このモードはパソコン環境で想定されるとおりに動作します。たとえば、タッチパッド上の 2 本の指によるスクロール、マウスホイールによるスクロール、未加工のディスプレイ座標のウィンドウ座標へのマッピングなどが自動的に有効になります。通常、アプリデベロッパーはこうした動作を実装する必要はありません。

カスタムの入力動作をアプリに実装する（たとえば 2 本の指でタッチパッドをつまむカスタム操作を定義する）場合や、アプリが想定する入力イベントが入力変換によって提供されない場合は、Android マニフェストに次のタグを追加することにより、入力変換モードを無効にできます。

<uses-feature
  android:name="android.hardware.type.pc"
  android:required="false" />

Chromebook の入力互換性

キーボード

ナビゲーション

Kotlin

Java

Kotlin

Java

キーストローク

Kotlin

Java

ショートカット

Kotlin

Java

Kotlin

Java

マウスとタッチパッドのサポート

右クリック

Kotlin

Java

マウスオーバー

Kotlin

Java

ドラッグ＆ドロップ

高度なポインタのサポート

タッチペン

履歴ポイント

パーム リジェクション

メモ作成アプリ

タッチペンなしでメモ作成インテントをテストする

ゲーム コントローラ

入力変換モード

パームリジェクション

ゲームコントローラ