이 항목에서는 Windows 10, 버전 1607 이상 운영 체제에서 방사형 컨트롤러 햅틱 피드백 지원에 사용되는 HID 출력 보고서에 대해 자세히 설명합니다.
햅틱 피드백 컬렉션(선택 사항)
Windows 방사형 컨트롤러 디바이스가 햅틱 피드백을 지원하는 경우 Windows 방사형 컨트롤러 TLC 내에 햅틱 피드백 컬렉션(페이지 0x0E, 사용량 0x01)을 포함하여 시스템 및 애플리케이션이 이를 활용하도록 할 수 있습니다. HID 사양이 햅틱 피드백을 지원하는 방법에 대한 자세한 내용은 HID 사양에 대한 햅틱 페이지 비준을 참조하세요.
호스트는 출력 보고서에서 다음 사용을 사용하여(햅틱 피드백 컬렉션을 통해) 호스트가 Windows 방사형 컨트롤러 디바이스에 햅틱 피드백 이벤트를 발행할 수 있도록 합니다. 디바이스가 햅틱 피드백 컬렉션을 노출하도록 선택한 경우 호스트 시작 햅틱 피드백이 지원되도록 허용하려면 일부 사용이 필수입니다.
| 멤버 | Description | 페이지 | ID | 필수/선택 |
|---|---|---|---|---|
| 수동 트리거 | 호스트에서 명시적 명령으로 실행할 파형 | 0x0E | 0x21 | 필수 |
| 강도 | 출력 – 백분율로 표시되는 수동 트리거 파형의 출력 강도 | 0x0E | 0x23 | 선택 사항 |
| 반복 횟수 | 출력 – 최초 재생 후 수동 트리거 파형 재생 횟수 | 0x0E | 0x24 | 선택 사항 |
| 재트리거 기간 | 출력 – 반복 시 수동 트리거 재트리거 전까지의 대기 시간 | 0x0E | 0x25 | 선택 사항 |
수동 트리거
수동 트리거 사용량은 호스트에서 재생하도록 요청한 파형 목록에서 지원되는 파형 사용량을 나타냅니다. WAVEFORM_NONE 이외의 수동 트리거가 포함된 출력 보고서가 디바이스로 전송되면 출력 보고서에 포함된 추가 속성(강도, 반복 횟수, 재트리거 기간)으로 지정된 파형 재생을 즉시 시작해야 합니다. 출력 보고서에 WAVEFORM_STOP의 수동 트리거가 포함된 경우 진행 중인 파형 재생을 중지해야 합니다.
강도
강도 사용량은 파형에 적용할 최대 강도의 백분율을 나타냅니다. 이 값은 0%에서 100% 사이여야 합니다. 100%는 파형이 최대 강도에서 디바이스에 의해 트리거됨을 나타내고 0%는 햅틱 변환기가 사용하도록 설정되지 않았음을 나타냅니다.
출력 보고서에 이 값을 설정하면 동일한 출력 보고서에 정의된 수동 트리거 파형의 기본 강도가 재정의됩니다. 새 기본 강도가 설정되지는 않습니다.
반복 실행 횟수
반복 횟수 사용량은 파형을 반복하는 횟수를 나타냅니다. 반복 횟수가 0이면 수동 트리거 파형이 한 번만 재생되어야 함을 나타냅니다(반복 없음). 파형 컷오프 시간이 초과된 경우 불완전한 반복은 무시됩니다.
출력 보고서에 이 값을 설정하면 동일한 출력 보고서에 정의된 수동 트리거 파형의 기본 반복 횟수가 재정의됩니다. 새 기본 반복 횟수가 설정되지는 않습니다.
재트리거 기간
재트리거 기간 사용량은 반복 카운트에 지정된 값에 따라 출력 보고서에서 수동 트리거 파형을 반복하기 전에 디바이스가 대기하는 시간을 나타냅니다. 이 값의 단위는 밀리초입니다. 재트리거 주기가 재생 중인 파형의 지속 시간보다 짧으면 재트리거 주기로 표시된 시간 주기에 파형을 중지했다가 다시 시작해야 합니다.
출력 보고서에 설정하면 동일한 출력 보고서에 정의된 수동 트리거 파형의 기본 재트리거 기간이 재정의됩니다. 새 기본 재트리거 기간이 설정되지는 않습니다.