Apple Pencil のホバー機能を試す
2022 年 10 月に発売された最新の iPad Pro では、Apple Pencil のホバー状態（iPad Pro に直接タッチしておらず少し浮かせている状態）を検出できるようになりました。この機能は、サードパーティ製のアプリでも利用できます。
前提条件
ホバー状態の検出機能を使うには、以下のものが必要です。最新の iPad Pro でしか使えないという条件が厳しいところです。
- iPadOS 16.1（リリース日：2022-10-25）
- M2 iPad Pro（発売日：2022-10-26）
- iPad Pro 11-inch 4th gen
- iPad Pro 12.9-inch 6th gen
- Apple Pencil 2nd gen（これは以前からある）
実機での挙動
Apple Pencil のホバー状態を検出できるのは、タッチパネルから約 1cm 以内にペン先があるときです。
iPadOS 標準のメモアプリはホバー状態の検出に対応しており、次のような挙動をします。
- 手書きモードで、ペン先が浮いている状態でペンのタッチ位置がプレビュー表示される
- ボタンなどの UI コントロールの上にかざすと、そのコントロールがハイライト表示される
アプリでの検出方法
この機能はサードパーティ製のアプリでも利用できます。
具体的には UIHoverGestureRecognizer を使えば良いです。他の Gesture Recognizer と実装方法は同じです。
let hover = UIHoverGestureRecognizer(target: self, action: #selector(hovering(_:)))
button.addGestureRecognizer(hover)
@objc
private func hovering(_ recognizer: UIHoverGestureRecognizer) {
// 検出時の処理
}
実装例として、Apple のサンプルが参考になります。
UIHoverGestureRecognizer
上述の UIHoverGestureRecognizer は iPadOS 13 から存在しています。iPadOS 13 は、iOS から iPadOS が分離した最初のバージョンでした。
このバージョンから、iPad はマウス操作に対応しています。 UIHoverGestureRecognizer は View の上をマウスポインターがホバーしたことを検出できるものでした。これが iPadOS 16.1 から Apple Pencil のホバーも検出するようになりました。
つまり、Apple Pencil のホバーは、マウスポインターのホバーと同じ挙動が期待されていると考えられます。
- UI コントロールのハイライト表示など
- 標準の UI コントロールは自動的に対応する
zOffset
UIHoverGestureRecognizer プロパティ zOffset が iPadOS 16.1 で追加されました。
- 0〜1 の値でタッチパネルからの距離が取得できる
- Apple Pencil でない場合は常に 0 の値
zOffset で Apple Pencil かどうかを判別でき、距離も取得できます。このため、ペン先のタッチ位置のプレビュー表示に活用できます。
ただ、どのようなプレビュー表示をするのが良いかは、現在はガイドラインがない状態です。
- 標準メモアプリは単純にポイント位置を点で表示している（ひょっとしたらアルファ値も微妙に変えているかも）
- 上述のサンプルコードでは、点で表示するのに加えて、距離によってアルファ値を変えている（これは見た目の変化が少ないため、意味があるか微妙）
標準メモアプリやサンプルコードの対応が妥当かどうかは悩むところです。ただ、実際の使用感としては、このくらい単純な表示でも、ユーザーにとっての使い勝手は向上しそうです。
ホバー検出の有効化・無効化
なお、このホバー検出はユーザーの設定によって無効化できます。ユーザーが Apple Pencil の設定のうち「Pencil を使用するときにエフェクトを表示」をオフにしているとホバー検出できませんので、ご注意ください。
備考
この記事は potatotips #79 で話した内容をもとにしています。
Discussion