Retroalimentación háptica (táctil) del lápiz óptico

Obtenga información sobre cómo usar comentarios hápticos de dispositivos de lápiz para proporcionar interacciones más naturales y táctiles en la aplicación de SDK de Aplicaciones para Windows.

Windows 11 introdujo comentarios hápticos para lápices digitales, lo que permite a los usuarios sentir su lápiz interactuando con la interfaz de usuario de la aplicación. Al referirse a esta función, háptico se usa en las API para desarrolladores y en la documentación, mientras que táctil es el nombre visible para el usuario que se muestra en Configuración de Windows.

APIs clave

• PenDevice
• SimpleHapticsController
• KnownSimpleHapticsControllerWaveforms
• PenDeviceInterop (SDK de Aplicaciones para Windows)

Tipos de comentarios hápticos

Hay dos tipos de comentarios hápticos disponibles:

• Respuesta háptica de entrada manuscrita — Simula la sensación de herramientas de escritura o dibujo (bolígrafo, rotulador, lápiz, marcador fluorescente) mediante vibraciones continuas mientras el lápiz toca la pantalla.
• Comentarios de interacción : señales táctiles cortas para acciones del usuario, como mantener el puntero sobre un botón, hacer clic o confirmar una acción completada.

Detección de la entrada del lápiz

Regístrese para el PointerEntered evento y compruebe si el tipo de dispositivo de puntero es un lápiz:

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

    // Pen detected — check for haptic support.
}

Obtener el PenDevice en el SDK de Aplicaciones para Windows

En una aplicación del SDK de aplicaciones de Windows, use PenDeviceInterop —una clase de interoperabilidad del SDK de aplicaciones de Windows— para obtener el objeto WinRT PenDevice a partir de un punto del puntero. PenDevice, SimpleHapticsController y KnownSimpleHapticsControllerWaveforms son tipos WinRT de los espacios de nombres Windows.Devices.Input y Windows.Devices.Haptics; solo la propia llamada de interop procede del espacio de nombres Microsoft.UI.Input.Interop del SDK de aplicaciones de Windows:

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).
}

Formas de onda de digitalización de trazos

Las formas de onda de la entrada de lápiz se muestran continuamente mientras el lápiz está en contacto con la pantalla. Se garantiza que las formas de onda necesarias sean compatibles con cualquier lápiz háptico.

Formas de onda de interacción

Las formas de onda de interacción proporcionan comentarios cortos y directos para las acciones de la interfaz de usuario.

Enviar comentarios hápticos

Recorra SupportedFeedback para encontrar la forma de onda deseada y, a continuación, llame a 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);
}

Desactivar respuesta háptica

Detenga siempre los comentarios hápticos cuando el puntero salga del elemento. Regístrese para PointerExited en el mismo elemento:

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

Personalización de comentarios hápticos

Algunos lápices admiten personalizaciones adicionales. Compruebe el soporte técnico antes de usarlos:

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

Artículos relacionados

• Interacciones de lápiz y lápiz óptico