InputHapticsManager Clase

Definición

Espacio de nombres:: Windows.Devices.Haptics

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Editar

Proporciona funcionalidad para desencadenar comentarios hápticos en el dispositivo de entrada que más recientemente entregó la entrada al subproceso asociado, si el dispositivo admite hápticos y la entrada se recibió recientemente. El objeto debe usarse en el mismo subproceso en el que se creó.

public ref class InputHapticsManager sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 1245184)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class InputHapticsManager final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 1245184)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Experimental]
class InputHapticsManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 1245184)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class InputHapticsManager

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 1245184)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Experimental]
public sealed class InputHapticsManager

Public NotInheritable Class InputHapticsManager

Herencia: Object Platform::Object IInspectable InputHapticsManager

Atributos: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ExperimentalAttribute

Requisitos de Windows

Requisitos	Description
Familia de dispositivos	Windows 11, version 24H2 (se introdujo en la versión 10.0.26100.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v19.0)

Ejemplos

En el ejemplo siguiente se muestra cómo desencadenar una forma de onda háptica en el dispositivo de entrada que más recientemente entregó la entrada al subproceso actual. Si no se admite la forma de onda solicitada, pasar 0 para el segundo parámetro permite al sistema usar una reserva específica del tipo de dispositivo. En el ejemplo también se controlan los casos en los que la API no está disponible o no es compatible.

bool SendHapticFeedback(uint16_t waveform)
{
    auto hapticsManagerStatics = winrt::try_get_activation_factory<
        winrt::InputHapticsManager, winrt::IInputHapticsManagerStatics>();

    if (hapticsManagerStatics && hapticsManagerStatics.IsSupported())
    {
        return hapticsManagerStatics
            .GetForCurrentThread()
            .TrySendHapticWaveform(waveform, 0);
    }

    return false;
}

Propiedades

Nombre	Description
CurrentDeviceType	Proporciona funcionalidad para desencadenar comentarios hápticos en el dispositivo de entrada que más recientemente entregó la entrada al subproceso asociado, si el dispositivo admite hápticos y la entrada se recibió recientemente. El objeto debe usarse en el mismo subproceso en el que se creó.
CurrentHapticsController	Obtiene el objeto SimpleHapticsController para el dispositivo de entrada que más recientemente entregó la entrada al subproceso (o el controlador establecido por SetOverrideHapticsController si una invalidación está activa).
CurrentHapticsControllerDeviceType	Obtiene el tipo de dispositivo háptico para el dispositivo de entrada desde el que el subproceso recibió más recientemente la entrada (o el tipo de dispositivo establecido por SetOverrideHapticsController si una invalidación está activa).
ThreadId	Obtiene el identificador del subproceso que posee este objeto InputHapticsManager .

Métodos

Nombre	Description
ClearOverrideHapticsController(HapticsControllerOverrideToken)	Borra la invalidación simpleHapticsController que se estableció anteriormente con el token especificado.
GetForCurrentThread()	Devuelve el objeto InputHapticsManager para el subproceso actual.
IsHapticDevicePresent()	Indica si un dispositivo que admite hápticos está presente en el sistema, independientemente del dispositivo que más recientemente entregó la entrada al subproceso que realiza la llamada.
IsSupported()	Indica si la funcionalidad InputHapticsManager es compatible con el sistema.
SetOverrideHapticsController(HapticDeviceType, SimpleHapticsController)	Establece simpleHapticsController y HapticDeviceType que el administrador debe usar para sus métodos y propiedades. Varias invalidaciones pueden estar activas simultáneamente, con el administrador mediante el que se proporcionó más recientemente.
TryGetForThread(UInt32)	Recupera inputHapticsManager para el subproceso especificado, si existe uno.
TrySendHapticWaveform(UInt16, UInt16, Double)	Intenta desencadenar la forma de onda especificada, con la intensidad especificada, en el dispositivo de entrada que más recientemente entregó la entrada al subproceso. La forma de onda de reserva se usa si no se admite la primera forma de onda.
TrySendHapticWaveform(UInt16, UInt16)	Intenta desencadenar la forma de onda especificada en el dispositivo de entrada que más recientemente entregó la entrada al subproceso. La forma de onda de reserva se usa si no se admite la primera forma de onda.
TrySendHapticWaveformForDuration(UInt16, UInt16, Double, TimeSpan)	Intenta desencadenar la forma de onda especificada, con la intensidad y duración especificadas, en el dispositivo de entrada que más recientemente entregó la entrada al subproceso. La forma de onda de reserva se usa si no se admite la primera forma de onda.
TrySendHapticWaveformForPlayCount(UInt16, UInt16, Double, Int32, TimeSpan)	Intenta desencadenar la forma de onda especificada, con la intensidad, el recuento de reproducción y el intervalo de pausa de reproducción especificados, en el dispositivo de entrada que más recientemente entregó la entrada al subproceso. La forma de onda de reserva se usa si no se admite la primera forma de onda.
TryStopFeedback()	Intenta detener cualquier reproducción háptica en curso en el dispositivo de entrada que recibió recientemente una forma de onda háptica del administrador.

Se aplica a

Consulte también

Comentarios

¿Le ha resultado útil esta página?