SimpleHapticsController 클래스

참조

정의

네임스페이스:: Windows.Devices.Haptics

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

편집

연결된 입력 디바이스에서 지원하는 햅틱 파형을 열거하고 특정 촉각 응답을 트리거하는 데 사용할 수 있는 단일 촉각 입력 디바이스에 대한 액세스를 제공합니다.

public ref class SimpleHapticsController sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SimpleHapticsController final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SimpleHapticsController

Public NotInheritable Class SimpleHapticsController

상속: Object Platform::Object IInspectable SimpleHapticsController

특성: ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 Creators Update (10.0.15063.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v4.0에서 도입되었습니다.)

예제

다음 완전 기능 샘플은 다양한 디바이스에서 햅틱 기능을 보여 줍니다.

펜 햅틱

다음 기능의 작업 예제는 펜 햅틱스 샘플을 참조하세요.

펜 입력에서 SimpleHapticsController 가져오기: PointerPoint.PointerId 에서 PenDevice 로 이동하여 SimpleHapticsController 로 이동합니다(햅틱 지원 펜과 펜을 지원하는 장치가 모두 필요).
펜 햅틱스 기능 확인: SimpleHapticsController는 IsIntensitySupported, IsPlayCountSupported, SupportedFeedback을 포함하여 펜 하드웨어 기능에 대한 속성을 공개합니다.
햅틱 피드백 시작 및 중지: SendHapticFeedback 및 StopFeedback 메서드를 적절하게 사용합니다.
햅틱 피드백 트리거: 수동 입력 및 상호 작용에 대한 피드백을 모두 트리거합니다.

RadialController 햅틱

Surface Dial과 같은 RadialController 디바이스에서 햅틱을 사용하는 방법에 대한 예제는 RadialController를 참조하세요.

혼합 현실 컨트롤러 햅틱

Windows Mixed Reality Desktop에서 6DOF(6DOF) 컨트롤러에서 햅틱을 사용하는 방법에 대한 예제는 공간 상호 작용 원본 샘플을 참조하세요.

속성

Id	촉각 입력 디바이스의 식별자를 가져옵니다.
IsIntensitySupported	촉각 입력 디바이스가 피드백 강도를 지원하는지 여부를 가져옵니다.
IsPlayCountSupported	촉각 입력 디바이스가 피드백 수를 지원하는지 여부를 가져옵니다.
IsPlayDurationSupported	촉각 입력 디바이스가 피드백 기간을 지원하는지 여부를 가져옵니다.
IsReplayPauseIntervalSupported	촉각 입력 디바이스가 피드백 주기 간의 일시 중지 간격을 지원하는지 여부를 가져옵니다.
SupportedFeedback	촉각 입력 디바이스에서 지원하는 피드백 유형을 가져옵니다.

메서드

SendHapticFeedback(SimpleHapticsControllerFeedback)	입력 디바이스에서 촉각 피드백을 시작합니다.
SendHapticFeedback(SimpleHapticsControllerFeedback, Double)	지정된 강도로 입력 디바이스에서 촉각 피드백을 시작합니다.
SendHapticFeedbackForDuration(SimpleHapticsControllerFeedback, Double, TimeSpan)	입력 디바이스에서 햅틱 피드백을 시작하고 지정된 시간 동안 계속 진행합니다.
SendHapticFeedbackForPlayCount(SimpleHapticsControllerFeedback, Double, Int32, TimeSpan)	입력 디바이스에서 촉각 피드백을 시작하고 지정된 횟수만큼 반복합니다.
StopFeedback()	입력 디바이스에서 촉각 피드백을 종료합니다.

적용 대상