ペンの操作とハプティクス (触覚) のフィードバック

Windows には長期的にサポートされているデジタル ペンがあります。これにより、ユーザーは自然かつ直接的な方法でデバイスを操作し、デジタル インクを使用してリッチな書き込みと描画を行うことによって創造性を表現できます。

Windows 11 では、デジタル ペンのエクスペリエンスをより自然で説得力のあるものにする新しい機能が導入されています。"ハプティクス フィードバック" をサポートするペンを使用すると、ユーザーは、アプリのユーザー インターフェイス (UI) を使用して触覚的な方法でペンを操作することができます。

Windows 11 でサポートされているハプティクス フィードバック エクスペリエンスには、"インク フィードバック" と "相互作用フィードバック" が含まれます。

• インク フィードバックは、ペンが画面と接触している間に連続的な振動を使用して、さまざまな種類の手書きツールまたは描画ツール (ペン、マーカー、鉛筆、蛍光ペンなど) の感覚をシミュレートします。 既定では、Windows Ink プラットフォームは、すべての描画ツールでハプティクス フィードバックをサポートしています (このトピックでは、Windows Ink でサポートされているもの以外のカスタム インク ソリューションを提供する方法について説明します)。
• 一方、相互作用フィードバックは、ボタンの上への移動やボタンのクリックなどの主要なユーザー操作、アクションの完了に対する応答に基づいているか、ユーザーの注意を引くための、直接的なフィードバックです。

通常、ハプティクス フィードバックを完全にサポートするには、次の 5 つの手順を実行する必要があります。

• ペン入力を検出します。
• 現在のペンとデバイスでハプティクス フィードバックがサポートされているかどうかを判断し、サポートされている場合はハプティクス フィードバック機能を確認します。
• 送信するハプティクス フィードバック信号を決定します。
• ハプティクス フィードバックを送信します。
• ハプティクス フィードバックを停止します。

ペン入力を検出する

ペン入力を検出して分離するには、最初に PointerEntered イベントに登録してから、PointerDeviceType が pen であるかどうかを確認する必要があります。

次のコードは、PointerEntered イベント内でポインター デバイスの種類を確認する方法を示しています。 この例では、入力がペンからのものではない場合、単にイベント ハンドラーから戻ります。 それ以外の場合は、ペン機能を確認し、ハプティクス フィードバックを構成します。

private void InputObserver_PointerEntered(object sender, PointerRoutedEventArgs e)
{
    ...
    
    // If the current Pointer device is not a pen, exit.
    if (e.Pointer.PointerDeviceType != PointerDeviceType.Pen) 
    {
       return;
    }
    
    ...    
}

ハプティクス フィードバックのサポートを確認する

すべてのペンとデジタイザーでハプティクス フィードバックがサポートされているわけではありません。また、このトピックで説明されているハプティクス フィードバック機能をすべてサポートしているとは限りません。 そのため、アクティブなペンでサポートされている機能をプログラムによって確認することが重要です。

前の例の続きとして、アクティブなペンがハプティクス フィードバックをサポートしているかどうかを確認する方法を示します。

まず、現在の PointerId から、PenDevice オブジェクトの取得を試みます。 PenDevice を取得できない場合は、単にイベント ハンドラーから戻ります。

PenDevice を取得した場合は、SimpleHapticsController プロパティがサポートされているかどうかをテストします。 そうでない場合も、単にイベント ハンドラーから戻ります。

// Attempt to retrieve the PenDevice from the current PointerId.
penDevice = PenDevice.GetFromPointerId(e.Pointer.PointerId);

// If a PenDevice cannot be retrieved based on the PointerId, it does not support 
// advanced pen features, such as haptic feedback. 
if (penDevice == null)
{
    return;
}

// Check to see if the current PenDevice supports haptic feedback by seeing if it 
// has a SimpleHapticsController.
hapticsController = penDevice.SimpleHapticsController;
if (hapticsController == null)
{
    return;
}

前の例で取得した SimpleHapticsController は、ハプティクス機能を照会し、ハプティクス フィードバックを送信/停止するために次の例で使用されます。

private void InputObserver_PointerEntered(PointerInputObserver sender, PointerEventArgs args)
{
    var penDevice = PenDeviceInterop.PenDeviceFromPointerPoint(args.CurrentPoint);
}

以下のセクションでは、ハプティクス ペンがサポートする必要があるフィードバック機能と、オプションのフィードバック機能について説明します。 必須のハプティクス フィードバックの種類は、通常、オプション機能ではなくフォールバックとして使用できます。

インクの波形

ペンが画面と接触している間は、インクの波形が連続して再生され、さまざまな手書きツールまたは描画ツールの感覚をシミュレートしようとします。

相互作用波形

相互作用波形は通常は短い (例外については次の表で説明されています)、直接的なフィードバックの波形です。ボタンの上への移動やボタンのクリックなどの主要な操作、アクションの完了に対する応答を確認するか、ユーザーの注意を引くために、必要に応じて生成されます。

ハプティクス フィードバックのカスタマイズ

一部のハプティクス ペンは、次のカスタマイズをサポートしています。

カスタム設定のサポートを確認する

強度、再生カウント、再生の一時停止間隔、再生時間のサポートを確認するには、SimpleHapticsController の次のプロパティを使用します。

• IsIntensitySupported
• IsPlayCountSupported
• IsPlayDurationSupported
• IsReplayPauseIntervalSupported

インクのハプティクス フィードバックの送信と停止

SimpleHapticsController オブジェクトの SendHapticFeedback メソッドを使用して、インクの波形をユーザーのペンに渡します。 このメソッドは、波形またはカスタマイズされた強度値を持つ波形の両方の受け渡しをサポートしています (「ハプティクス フィードバックをカスタマイズする」を参照してください)。

ペンの端が画面に触れたらすぐにその波形の再生を開始するようにペンを構成するには、SendHapticFeedback を呼び出し、インクの波形を渡します。 ペンが持ち上げられるか、StopFeedback が呼び出されるまで (いずれかが先に発生するまで)、波形の再生が継続されます。 これは、ハプティクスを再生する要素の PointerEntered イベント ハンドラーで実行することをお勧めします。 たとえば、カスタム インク実装を持つアプリでは、そのインク キャンバスの PointerEntered メソッドでこれを行います。

目的のインクの波形を取得するには、SimpleHapticsController の SupportedFeedback コレクションを反復処理して、アクティブなペンでサポートされていることを確認する必要があります。

サポートされていない場合は、何も再生しないか、サポートが保証されている InkContinuous 波形に戻すかのいずれかを選択できます。

次の例では、BrushContinuous 波形を送信します (BrushContinuous がサポートされていない場合は InkContinuous に戻します)。

SimpleHapticsControllerFeedback currentWaveform;

// Attempt to set the currentWaveform to BrushContinuous.
foreach (var waveform in hapticsController.SupportedFeedback)
{
    if (waveform.Waveform == KnownSimpleHapticsControllerWaveforms.BrushContinuous)
    {
        currentWaveform = waveform;
    }
} 

// If currentWaveform is null, it was not in the SupportedFeedback collection, so instead set 
// the waveform to InkContinuous.
if (currentWaveform == null)
{
    foreach (var waveform in hapticsController.SupportedFeedback)
    {
        if (waveform.Waveform == KnownSimpleHapticsControllerWaveforms.InkContinuous)
        {
            currentWaveform = waveform;
        }
    }
}

// Send the currentWaveform 
hapticsController.SendHapticFeedback(currentWaveform);

関連付けられているポインターが、ハプティクス フィードバック用に登録した要素から出たときには、ハプティクス フィードバックも停止することが重要です。 それ以外の場合、波形はアクティブなペンで再生を試み続けます。

要素に対するハプティクス フィードバックを停止するには、ハプティクス信号を送信した PointerEntered ハンドラーを登録したのと同じ要素で PointerExited イベントに登録します。 終了したイベント ハンドラーで、次に示すように StopFeedback を呼び出します。

hapticsController.StopFeedback();

相互作用フィードバックを送信および停止する

相互作用フィードバックの送信は、インク フィードバックの送信と非常に似ています。

SimpleHapticsController オブジェクトの SendHapticFeedback メソッドを使用して、相互作用波形をユーザーのペンに渡します。 このメソッドは、波形またはカスタマイズされた強度値を持つ波形の両方の受け渡しをサポートしています (「ハプティクス フィードバックをカスタマイズする」を参照してください)。

(インク フィードバックの場合のように、ペンの端が画面に触れたときではなく) アプリ内の何らかの操作に基づいて、すぐに波形を再生し始めるようにペンを構成するには、SendHapticFeedback を呼び出し、インクの波形を渡します。

連続しない相互作用波形を使用する場合は、対応する StopFeedback 呼び出しを行う必要はありません。 連続的な相互作用波形に対しては StopFeedback を呼び出す必要があります。

目的の相互作用波形を取得するには、SimpleHapticsController の SupportedFeedback コレクションを反復処理して、アクティブなペンでサポートされていることを確認する必要があります。

サポートされていない場合は、何も再生しないか、サポートが保証されている Click 波形に戻すかのいずれかを選択できます。

次の例では、Error 波形を送信します (Error がサポートされていない場合は Click に戻します)。

SimpleHapticsControllerFeedback currentWaveform;  

// Attempt to set the currentWaveform to BrushContinuous.
foreach (var waveform in hapticsController.SupportedFeedback)
{
    if (waveform.Waveform == KnownSimpleHapticsControllerWaveforms.Error)
    {
        currentWaveform = waveform;
    }
} 

// If currentWaveform is null, it was not in the SupportedFeedback collection, so instead set 
// the waveform to Click.
if (currentWaveform == null)
{
    foreach (var waveform in hapticsController.SupportedFeedback)
    {
        if (waveform.Waveform == KnownSimpleHapticsControllerWaveforms.Click)
        {
            currentWaveform = waveform;
        }
    }
} 

// Send the currentWaveform.
hapticsController.SendHapticFeedback(currentWaveform); 

ハプティクス フィードバックをカスタマイズする

ハプティクス フィードバックをカスタマイズするには、3 つの方法があります。 1 つ目はインク フィードバックと相互作用フィードバックの両方でサポートされていますが、2 つ目と 3 つ目は相互作用フィードバックでのみサポートされています。

1. システムの最大強度設定を基準に、フィードバックの強度を調整します。 これを行うには、まず SimpleHapticsController が強度の設定をサポートしていることを確認してから、目的の Intensity の値で SendHapticFeedback を呼び出す必要があります。

   if (hapticsController.IsIntensitySupported) 
   {
       foreach (var waveform in hapticsController.SupportedFeedback)
       {
           if (waveform.Waveform == KnownSimpleHapticsControllerWaveforms.Click)
           {
               double intensity = 0.75;
               hapticsController.SendHapticFeedback(waveform, intensity);
           }
       }
   }
   

2. 指定した回数、ハプティクス信号を繰り返します。 これを行うには、まず SimpleHapticsController が強度の設定をサポートしていることを確認してから、目的のカウントの値で SendHapticFeedbackForPlayCount を呼び出す必要があります。 強度と再生の一時停止間隔の両方を設定できます。

   Note

   SimpleHapticsController が強度または再生の一時停止間隔の設定をサポートしていない場合、指定された値は無視されます。

   if (hapticsController.IsPlayCountSupported && hapticsController.IsIntensitySupported && hapticsController.IsReplayPauseIntervalSupported)
   {
       foreach (var waveform in hapticsController.SupportedFeedback)
       {
           if (waveform.Waveform == KnownSimpleHapticsControllerWaveforms.Click)
           {
               double intensity = 0.75;
               int playCount = 3;
               System.TimeSpan pauseDuration = new System.TimeSpan(1000000);
               hapticsController.SendHapticFeedbackForPlayCount(currentWaveform, intensity, playCount, pauseDuration);
           }
       }
   }
   

3. ハプティクス信号の継続時間を設定します。 これを行うには、まず SimpleHapticsController が再生時間の設定をサポートしていることを確認してから、目的の時間間隔の値で SendHapticFeedbackForDuration を呼び出す必要があります。 強度を設定することもできます。

   Note

   SimpleHapticsController が強度の設定をサポートしていない場合、指定された値は無視されます。

   if (hapticsController.IsPlayDurationSupported && hapticsController.IsIntensitySupported)
   {
       foreach (var waveform in hapticsController.SupportedFeedback)
       {
           if (waveform.Waveform == KnownSimpleHapticsControllerWaveforms.RumbleContinuous)
           {
               double intensity = 0.75;
               System.TimeSpan playDuration = new System.TimeSpan(5000000);
               hapticsController.SendHapticFeedbackForDuration(currentWaveform, intensity, playDuration);
           }
       }
   }
   

例

次の機能の動作例については、ペン ハプティクス サンプルを参照してください。

• ペンの入力から SimpleHapticsController を取得する: PointerId から PenDevice、そして SimpleHapticsController へと移動します (ハプティクス対応ペンとペンをサポートするデバイスの両方が必要です)。
• ペン ハプティクス機能を確認する: SimpleHapticsController では、IsIntensitySupported、IsPlayCountSupported、SupportedFeedback など、ペンのハードウェア機能に関するプロパティが公開されます。
• ハプティクス フィードバックの開始と停止: SendHapticFeedback メソッドと StopFeedback メソッドを適切に使用します。
• ハプティクス フィードバックをトリガーする: "インク フィードバック" と "相互作用フィードバック" の両方に対するフィードバック。