InputHapticsManager Classe

Definição

Namespace:: Windows.Devices.Haptics

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Editar

Fornece funcionalidade para disparar comentários hápticos no dispositivo de entrada que mais recentemente forneceram entrada para o thread associado, se o dispositivo der suporte a hápticos e entrada foi recebido recentemente. O objeto deve ser usado no mesmo thread no qual foi criado.

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

Herança: Object Platform::Object IInspectable InputHapticsManager

Atributos: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ExperimentalAttribute

Requisitos do Windows

Requisitos	Description
Família de dispositivos	Windows 11, version 24H2 (introduzida na 10.0.26100.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v19.0)

Exemplos

O exemplo a seguir mostra como disparar um formato de onda háptico no dispositivo de entrada que mais recentemente entregou entrada ao thread atual. Se não houver suporte para a forma de onda solicitada, passar 0 para o segundo parâmetro permitirá que o sistema use um fallback específico do tipo de dispositivo. O exemplo também lida com casos em que a API está indisponível ou sem suporte.

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;
}

Propriedades

Nome	Description
CurrentDeviceType	Fornece funcionalidade para disparar comentários hápticos no dispositivo de entrada que mais recentemente forneceram entrada para o thread associado, se o dispositivo der suporte a hápticos e entrada foi recebido recentemente. O objeto deve ser usado no mesmo thread no qual foi criado.
CurrentHapticsController	Obtém o objeto SimpleHapticsController para o dispositivo de entrada que mais recentemente entregou entrada ao thread (ou o controlador definido por SetOverrideHapticsController se uma substituição estiver ativa).
CurrentHapticsControllerDeviceType	Obtém o tipo de dispositivo háptico para o dispositivo de entrada do qual a entrada foi recebida mais recentemente pelo thread (ou o tipo de dispositivo definido por SetOverrideHapticsController se uma substituição estiver ativa).
ThreadId	Obtém a ID do thread que possui esse objeto InputHapticsManager .

Métodos

Nome	Description
ClearOverrideHapticsController(HapticsControllerOverrideToken)	Limpa a substituição SimpleHapticsController que foi definida anteriormente com o token especificado.
GetForCurrentThread()	Retorna o objeto InputHapticsManager para o thread atual.
IsHapticDevicePresent()	Indica se um dispositivo compatível com hápticos está presente no sistema, independentemente do dispositivo que mais recentemente entregou a entrada para o thread de chamada.
IsSupported()	Indica se a funcionalidade InputHapticsManager tem suporte no sistema.
SetOverrideHapticsController(HapticDeviceType, SimpleHapticsController)	Define o SimpleHapticsController e o HapticDeviceType que o gerente deve usar para seus métodos e propriedades. Várias substituições podem estar ativas simultaneamente, com o gerente usando o fornecido mais recentemente.
TryGetForThread(UInt32)	Recupera o InputHapticsManager para o thread especificado, se houver.
TrySendHapticWaveform(UInt16, UInt16, Double)	Tenta disparar a forma de onda especificada, com a intensidade especificada, no dispositivo de entrada que mais recentemente entregou entrada ao thread. A forma de onda de fallback será usada se não houver suporte para a primeira forma de onda.
TrySendHapticWaveform(UInt16, UInt16)	Tenta disparar a forma de onda especificada no dispositivo de entrada que mais recentemente entregou a entrada para o thread. A forma de onda de fallback será usada se não houver suporte para a primeira forma de onda.
TrySendHapticWaveformForDuration(UInt16, UInt16, Double, TimeSpan)	Tenta disparar a forma de onda especificada, com a intensidade e a duração especificadas, no dispositivo de entrada que mais recentemente entregou a entrada para o thread. A forma de onda de fallback será usada se não houver suporte para a primeira forma de onda.
TrySendHapticWaveformForPlayCount(UInt16, UInt16, Double, Int32, TimeSpan)	Tenta disparar a forma de onda especificada, com a intensidade especificada, a contagem de reprodução e o intervalo de pausa de reprodução, no dispositivo de entrada que mais recentemente entregou a entrada para o thread. A forma de onda de fallback será usada se não houver suporte para a primeira forma de onda.
TryStopFeedback()	Tenta interromper qualquer reprodução háptica contínua no dispositivo de entrada que mais recentemente recebeu uma forma de onda háptica do gerente.

Aplica-se a

Confira também

Comentários

Esta página foi útil?