ペンのハプティック（触覚）フィードバック

ペン デバイスからの触覚フィードバックを使用して、Windows アプリ SDK アプリでより自然で触覚的な相互作用を提供する方法について説明します。

Windows 11デジタル ペンの触覚フィードバックが導入され、ユーザーはペンがアプリの UI と対話しているのを感じることができます。 この機能を参照する場合、触覚は開発者 API とドキュメントで使用され、触覚は Windows 設定に表示されるユーザー向けの名前です。

主要API

• PenDevice
• SimpleHapticsController
• KnownSimpleHapticsControllerWaveforms
• PenDeviceInterop (Windows アプリ SDK)

触覚フィードバックの種類

次の 2 種類の触覚フィードバックを利用できます。

• 手描き入力フィードバック - ペンが画面に触れる間の連続振動によって、書き込みまたは描画ツール (ペン、マーカー、鉛筆、蛍光ペン) の感覚をシミュレートします。
• 相互作用フィードバック - ボタンの上にマウスポインターを置いたり、クリックしたり、完了したアクションを確認したりするなどのユーザーアクションの短い触覚信号。

ペン入力を検出する

PointerEntered イベントに登録し、ポインター デバイスの種類がペンであるかどうかを確認します。

private void InputObserver_PointerEntered(object sender, PointerRoutedEventArgs e)
{
    if (e.Pointer.PointerDeviceType != Microsoft.UI.Input.PointerDeviceType.Pen)
    {
        return;
    }

    // Pen detected — check for haptic support.
}

Windows アプリ SDKで PenDevice を取得する

Windows アプリ SDK アプリでは、PenDeviceInterop (Windows アプリ SDK相互運用クラス) を使用して、ポインター ポイントから WinRT PenDevice オブジェクトを取得します。 PenDevice、SimpleHapticsController、およびKnownSimpleHapticsControllerWaveformsは、Windows.Devices.Input名前空間とWindows.Devices.Haptics名前空間からの WinRT 型です。相互運用呼び出し自体は、Windows アプリ SDKのMicrosoft.UI.Input.Interop名前空間から取得されます。

using Microsoft.UI.Input.Interop;
using Windows.Devices.Haptics;
using Windows.Devices.Input;
using Windows.Foundation.Metadata;

private void InputObserver_PointerEntered(object sender, PointerRoutedEventArgs e)
{
    if (e.Pointer.PointerDeviceType != Microsoft.UI.Input.PointerDeviceType.Pen)
    {
        return;
    }

    var penDevice = PenDeviceInterop.FromPointerPoint(e.GetCurrentPoint(null));

    if (penDevice == null)
    {
        return; // Pen does not support advanced features.
    }

    // SimpleHapticsController requires Windows 11. Check for API presence
    // before accessing it so the app doesn't throw on Windows 10.
    if (!ApiInformation.IsPropertyPresent(
        "Windows.Devices.Input.PenDevice", "SimpleHapticsController"))
    {
        return; // Haptic feedback requires Windows 11.
    }

    var hapticsController = penDevice.SimpleHapticsController;
    if (hapticsController == null)
    {
        return; // Pen does not support haptic feedback.
    }

    // Configure haptic feedback (see examples below).
}

インク波形

ペンが画面に接触している間、インク波形が連続して再生されます。 必要な波形は、どの触覚ペンでもサポートされることが保証されています。

相互作用波形

相互作用波形は、UI アクションに対して短く直接的なフィードバックを提供します。

触覚フィードバックを送信する

SupportedFeedbackを反復処理して目的の波形を見つけ、SendHapticFeedbackを呼び出します。

SimpleHapticsControllerFeedback currentWaveform = null;

// Try to use BrushContinuous, fall back to InkContinuous.
foreach (var waveform in hapticsController.SupportedFeedback)
{
    if (waveform.Waveform == KnownSimpleHapticsControllerWaveforms.BrushContinuous)
    {
        currentWaveform = waveform;
        break;
    }
}

if (currentWaveform == null)
{
    foreach (var waveform in hapticsController.SupportedFeedback)
    {
        if (waveform.Waveform == KnownSimpleHapticsControllerWaveforms.InkContinuous)
        {
            currentWaveform = waveform;
            break;
        }
    }
}

if (currentWaveform != null)
{
    hapticsController.SendHapticFeedback(currentWaveform);
}

触覚フィードバックを停止する

ポインターが要素を終了したときに、触覚フィードバックを常に停止します。 同じ要素で PointerExited を登録します:

private void Canvas_PointerExited(object sender, PointerRoutedEventArgs e)
{
    hapticsController?.StopFeedback();
}

触覚フィードバックをカスタマイズする

一部のペンでは、追加のカスタマイズがサポートされています。 使用する前にサポートを確認してください。

if (hapticsController.IsIntensitySupported)
{
    hapticsController.SendHapticFeedback(currentWaveform, 0.75); // 75% intensity
}

関連資料

• ペンとスタイラスの操作