Windows 방사형 컨트롤러 기능 보고서
이 항목에서는 Windows 10, 버전 1607 이상 운영 체제에서 방사형 컨트롤러 햅틱 피드백 지원에 사용되는 HID 기능 보고서에 대해 자세히 설명합니다.
햅틱 피드백 컬렉션(선택 사항)
Windows 방사형 컨트롤러 디바이스가 햅틱 피드백을 지원하는 경우 Windows 방사형 컨트롤러 TLC 내에 햅틱 피드백 컬렉션(페이지 0x0E, 사용량 0x01)을 포함하여 시스템 및 애플리케이션이 이를 활용하도록 할 수 있습니다. HID 사양이 햅틱 피드백을 지원하는 방법에 대한 자세한 내용은 HID 사양에 대한 햅틱 페이지 비준을 참조하세요.
호스트는 햅틱 피드백 컬렉션을 통해 다음 사용을 통해 햅틱 피드백 파형 지원을 전달하고 호스트가 Windows 방사형 컨트롤러 디바이스에서 햅틱 피드백을 구성할 수 있도록 합니다. 디바이스가 햅틱 피드백 컬렉션을 노출하도록 선택한 경우 자동 햅틱 피드백 구성이 지원되도록 하려면 일부 사용이 필수입니다.
| 멤버 | Description | 페이지 | ID | 필수/선택 |
|---|---|---|---|---|
| 파형 목록 | 디바이스에서 지원하는 햅틱 파형의 순서가 지정된 목록 | 0x0E | 0x10 | 필수 |
| 지속 시간 목록 | 파형 목록에 있는 파형 지속 시간의 순서가 지정된 목록 | 0x0E | 0x11 | 필수 |
| 자동 트리거 | 디바이스 재량에 따라 자동으로 발생하는 파형 | 0x0E | 0x20 | 필수 |
| 자동 트리거 관련 제어 | 햅틱 피드백과 관련된 컨트롤의 HID 사용 | 0x0E | 0x22 | 필수 |
| 강도 | 출력 – 백분율로 표시되는 수동 트리거 파형의 출력 강도 | 0x0E | 0x23 | 선택 사항 |
| 반복 횟수 | 출력 – 최초 재생 후 수동 트리거 파형 재생 횟수 | 0x0E | 0x24 | 선택 사항 |
| 재트리거 기간 | 출력 – 반복 시 수동 트리거 재트리거 전까지의 대기 시간 | 0x0E | 0x25 | 선택 사항 |
| 파형 컷오프 시간 | 수동 트리거 파형이 차단되기 전에 재생할 수 있는 최대 시간 | 0x0E | 0x28 | 선택 사항 |
파형 목록
파형 목록 사용량은 서수를 사용하여 순서가 지정된 지원되는 파형의 HID 사용 컬렉션을 나타냅니다. 미리 정의된 햅틱 파형은 HID 사양에 정의되어 있습니다. Windows는 햅틱 피드백 지원 디바이스에 대해 다음 파형 구현을 지원합니다.
| 파형 | Description | 페이지 | ID | 필수/선택 |
|---|---|---|---|---|
| WAVEFORM_NONE | No-op. 진행 중인 파형의 재생 상태에 영향을 주지 않아야 합니다. | 0x0E | 0x1001 | 필수 |
| WAVEFORM_STOP | 진행 중인 파형의 재생을 중지합니다. | 0x0E | 0x1002 | 필수 |
| WAVEFORM_CLICK | 짧은 "클릭" 피드백 만들기 | 0x0E | 0x1003 | 필수 |
| WAVEFORM_BUZZ_CONTINUOUS | 오랜 시간 동안 디바이스를 울립니다. | 0x0E | 0x1004 | 선택 사항 |
모든 HID 호환 햅틱 디바이스에는 WAVEFORM_NONE 및 WAVEFORM_STOP이 모두 필요합니다. 서수 1과 2는 암시적으로 WAVEFORM_NONE 및 WAVEFORM_STOP으로 설정됩니다. 파형 목록 또는 지속 시간 목록에서 선언할 필요가 없습니다. 파형 목록은 목록에 있는 각 서수의 물리적 최솟값과 최댓값으로 지원되는 파형을 선언합니다.
지속 시간 목록
지속 시간 목록 사용량은 서수를 사용하여 순서가 지정된 파형 목록에서 지원되는 파형의 지속 시간 컬렉션을 나타냅니다. 파형 지속 시간의 단위는 밀리초이며 지속 시간은 비연속 파형에 대해 0이 아닌 양수 값이어야 합니다. 파형이 연속적이면(호스트에서 중지하거나 파형 차단 시간이 초과될 때까지 재생됨) 해당 지속 시간은 0으로 정의됩니다.
WAVEFORM_NONE 및 WAVEFORM_STOP은 지속 시간이 0인 것으로 가정합니다. 지속 시간 목록에 선언할 필요는 없습니다.
자동 트리거
자동 트리거 사용량은 사용자 상호 작용을 기반으로 필요에 따라 디바이스에서 자동으로 트리거되는 파형 목록에서 지원되는 파형 사용량을 나타냅니다. 이를 통해 회전 및 클릭과 같은 일반적인 사용자 상호 작용에 대한 응답 대기 시간을 줄일 수 있습니다. 이는 호스트에서 수정하거나 사용하지 않도록 설정해야 할 수 있으며 기능 보고서를 통해 설정할 수 있습니다. 자동 트리거 파형은 호스트에서 0으로 설정하여 사용하지 않도록 설정할 수 있습니다.
자동 트리거 관련 제어
자동 트리거 관련 제어는 디바이스의 자동 햅틱 피드백과 관련된 물리적 제어의 확장된 HID 사용을 지정합니다. 방사형 컨트롤러 디바이스의 경우 이 컨트롤은 동일한 최상위 컬렉션 내에서 지정된 다이얼 사용량으로 정의되어야 합니다.
강도
강도 사용량은 파형에 적용할 최대 강도의 백분율을 나타냅니다. 이 값은 0%에서 100% 사이여야 합니다. 100%는 파형이 최대 강도에서 디바이스에 의해 트리거됨을 나타내고 0%는 햅틱 변환기가 사용하도록 설정되지 않았음을 나타냅니다.
기능 보고서에 정의된 경우 디바이스의 모든 자동 트리거 및 수동 트리거 파형에 대한 기본 강도를 설정합니다.
반복 횟수
반복 횟수 사용량은 파형을 반복하는 횟수를 나타냅니다. 반복 횟수가 0이면 수동 트리거 파형이 한 번만 재생되어야 함을 나타냅니다(반복 없음). 파형 컷오프 시간이 초과된 경우 불완전한 반복은 무시됩니다.
기능 보고서에 정의된 경우 디바이스의 모든 자동 트리거 및 수동 트리거 파형에 대한 기본 반복 횟수를 설정합니다.
재트리거 기간
재트리거 기간 사용량은 반복 카운트에 지정된 값에 따라 출력 보고서에서 수동 트리거 파형을 반복하기 전에 디바이스가 대기하는 시간을 나타냅니다. 이 값의 단위는 밀리초입니다. 재트리거 주기가 재생 중인 파형의 지속 시간보다 짧으면 재트리거 주기로 표시된 시간 주기에 파형을 중지했다가 다시 시작해야 합니다.
기능 보고서에 정의된 경우 디바이스의 모든 자동 트리거 및 수동 트리거 파형에 대한 기본 재트리거 기간을 설정합니다.
파형 컷오프 시간
파형 차단 시간 사용량은 재생을 종료하기 전에 디바이스에서 수동 트리거 파형이 반복되도록 허용하는 최대 시간을 나타냅니다. 이는 디바이스에 대한 상수 값이며 설정 지속 시간이 없는 연속 파형과 여러 번 반복하도록 설정된 불연속 지속 시간이 있는 파형을 모두 포함합니다. 이 값의 단위는 밀리초입니다.