InputHapticsManager 클래스

정의

네임스페이스:

Windows.Devices.Haptics

디바이스가 촉각을 지원하고 입력이 최근에 수신된 경우 가장 최근에 연결된 스레드에 입력을 전달한 입력 디바이스에서 촉각 피드백을 트리거하는 기능을 제공합니다. 개체를 만든 스레드와 동일한 스레드에서 사용해야 합니다.

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(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

Public NotInheritable Class InputHapticsManager

상속

Object Platform::Object IInspectable InputHapticsManager

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

요구 사항	Description
디바이스 패밀리	Windows 11, version 24H2 (10.0.26100.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v19.0에서 도입되었습니다.)

예제

다음 예제에서는 가장 최근에 현재 스레드에 입력을 전달한 입력 디바이스에서 촉각 파형을 트리거하는 방법을 보여줍니다. 요청된 파형이 지원되지 않는 경우 두 번째 매개 변수에 대해 0을 전달하면 시스템에서 디바이스 유형별 대체를 사용할 수 있습니다. 이 예제에서는 API를 사용할 수 없거나 지원되지 않는 경우도 처리합니다.

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

속성

Name	Description
CurrentHapticsController	가장 최근에 스레드에 입력을 전달한 입력 디바이스(또는 재정의가 활성 상태인 경우 SetOverrideHapticsController에서 설정한 컨트롤러)에 대한 SimpleHapticsController 개체를 가져옵니다.
CurrentHapticsControllerDeviceType	스레드에서 가장 최근에 입력을 받은 입력 디바이스의 촉각 디바이스 유형을 가져옵니다(또는 재정의가 활성화된 경우 SetOverrideHapticsController 에서 설정한 디바이스 유형).
ThreadId	이 InputHapticsManager 개체를 소유하는 스레드의 ID를 가져옵니다.

메서드

Name	Description
ClearOverrideHapticsController(HapticsControllerOverrideToken)	이전에 지정된 토큰으로 설정한 SimpleHapticsController 재정의를 지웁니다.
GetForCurrentThread()	현재 스레드에 대한 InputHapticsManager 개체를 반환합니다.
IsHapticDevicePresent()	가장 최근에 호출 스레드에 입력을 전달한 디바이스와 관계없이 촉각을 지원하는 디바이스가 시스템에 있는지 여부를 나타냅니다.
IsSupported()	InputHapticsManager 기능이 시스템에서 지원되는지 여부를 나타냅니다.
SetOverrideHapticsController(HapticDeviceType, SimpleHapticsController)	관리자가 메서드 및 속성에 사용해야 하는 SimpleHapticsController 및 HapticDeviceType 을 설정합니다. 관리자가 가장 최근에 제공된 재정의를 사용하여 여러 재정의를 동시에 활성화할 수 있습니다.
TryGetForThread(UInt32)	지정된 스레드가 있는 경우 InputHapticsManager 를 검색합니다.
TrySendHapticWaveform(UInt16, UInt16, Double)	가장 최근에 스레드에 입력을 전달한 입력 디바이스에서 지정된 강도로 지정된 파형을 트리거하려고 시도합니다. 첫 번째 파형이 지원되지 않는 경우 대체 파형이 사용됩니다.
TrySendHapticWaveform(UInt16, UInt16)	가장 최근에 스레드에 입력을 전달한 입력 디바이스에서 지정된 파형을 트리거하려고 시도합니다. 첫 번째 파형이 지원되지 않는 경우 대체 파형이 사용됩니다.
TrySendHapticWaveformForDuration(UInt16, UInt16, Double, TimeSpan)	가장 최근에 스레드에 입력을 전달한 입력 디바이스에서 지정된 강도 및 기간으로 지정된 파형을 트리거하려고 시도합니다. 첫 번째 파형이 지원되지 않는 경우 대체 파형이 사용됩니다.
TrySendHapticWaveformForPlayCount(UInt16, UInt16, Double, Int32, TimeSpan)	가장 최근에 스레드에 입력을 전달한 입력 디바이스에서 지정된 강도, 재생 횟수 및 재생 일시 중지 간격으로 지정된 파형을 트리거하려고 시도합니다. 첫 번째 파형이 지원되지 않는 경우 대체 파형이 사용됩니다.
TryStopFeedback()	가장 최근에 관리자로부터 촉각 파형을 받은 입력 디바이스에서 진행 중인 촉각 재생을 중지하려고 시도합니다.

추가 정보

• SimpleHapticsController
• HapticDeviceType
• HapticsControllerOverrideToken
• KnownSimpleHapticsControllerWaveforms