GameInput 햅틱 요구 사항

GameInput이 노출하는 햅틱 기능은 Windows 오디오 시스템과 통합되어, 호환 장치에 파형 데이터를 성능 좋고 견고하게 스트리밍합니다. 햅틱 지원 장치에 대한 오디오 요구 사항은 일반적인 데스크톱 스피커나 헤드폰과 매우 유사합니다. GameInput은 규약과 제조업체가 지정한 메타데이터를 조합하여 입력 장치를 햅틱 재생에 사용할 오디오 엔드포인트와 연결합니다.

요구 사항

장치는 Windows에서 오디오 원본으로 인식되어야 합니다. 연결 매체(USB, Bluetooth® 등)는 중요하지 않습니다.
장치는 하나 이하의 햅틱 엔드포인트만 노출해야 합니다.
장치는 최대 8개 이하의 햅틱 위치만 노출해야 합니다.
장치는 연결된 후 자신의 햅틱 기능을 변경해서는 안 됩니다.
장치에는 동일한 형식(샘플당 비트 수 및 초당 샘플 수)의 여러 오디오 엔드포인트가 있으면 안 됩니다.
장치는 오디오 엔드포인트에 대해 나머지 장치와 동일한 컨테이너 ID를 제공해야 합니다.

장치는 햅틱 엔드포인트를 명시적으로 식별하기 위한 레지스트리 항목을 가지고 있어야 합니다. 형식은 다음과 같습니다.

햅틱 장치는 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\GameInput\Devices 아래 레지스트리에 열거됩니다.
특정 장치 키는 공급업체 ID, 제품 ID, 사용 페이지, 사용 ID를 16진수 문자열로 조합한 것입니다.
HapticSamplesPerSecond는 햅틱 엔드포인트 형식의 초당 샘플 수(Hz)를 식별하는 DWORD 값입니다.
HapticsBitsPerSample은 햅틱 엔드포인트 형식의 샘플 비트 수(샘플 크기)를 식별하는 DWORD 값입니다.
HapticLocations는 햅틱 위치 GUID의 BYTE 배열입니다. 이 배열은 햅틱 채널 매핑에 대응하는 1~8개의 GUID를 포함해야 합니다.

이해를 돕기 위해 다음 샘플 장치를 살펴보세요.

필드	값
공급업체 ID	0x045e
제품 ID	0x1234
사용 페이지	0x0001
사용 ID	0x0005
샘플 주파수	0x0fa0
샘플 크기	0x0010
햅틱 위치	GAMEINPUT_HAPTIC_LOCATION_GRIP_LEFT, GAMEINPUT_HAPTIC_LOCATION_GRIP_RIGHT

관련된 햅틱 레지스트리 항목은 다음과 같습니다.

    Windows Registry Editor Version 5.00

    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\GameInput\Devices\045E123400010005]
    "HapticSamplesPerSecond"=dword:00000fa0
    "HapticBitsPerSample"=dword:00000010
    "HapticLocations"=hex:c2,07,c7,08,bb,66,6c,40,a8,4a,df,e0,85,12,0a,92,77,0b,5a,\
    15,b2,8b,db,40,86,90,b6,d4,11,26,df,c1

햅틱 위치

현재, 다음의 햅틱 위치 GUID가 일반 사용을 위해 정의되어 있습니다.

// { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_NONE, 0x00000000, 0x0000, 0x0000, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00);

// { 0xc2, 0x07, 0xc7, 0x08, 0xbb, 0x66, 0x6c, 0x40, 0xa8, 0x4a, 0xdf, 0xe0, 0x85, 0x12, 0x0a, 0x92 }
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_GRIP_LEFT, 0x08c707c2, 0x66bb, 0x406c, 0xa8, 0x4a, 0xdf, 0xe0, 0x85, 0x12, 0x0a, 0x92);

// { 0x77, 0x0b, 0x5a, 0x15, 0xb2, 0x8b, 0xdb, 0x40, 0x86, 0x90, 0xb6, 0xd4, 0x11, 0x26, 0xdf, 0xc1 }
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_GRIP_RIGHT, 0x155a0b77, 0x8bb2, 0x40db, 0x86, 0x90, 0xb6, 0xd4, 0x11, 0x26, 0xdf, 0xc1);

// { 0x96, 0xd8, 0xe4, 0x8d, 0x59, 0x55, 0x81, 0x40, 0x86, 0xe5, 0x17, 0x24, 0xcc, 0x07, 0xc6, 0xbc }
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_TRIGGER_LEFT, 0x8de4d896, 0x5559, 0x4081, 0x86, 0xe5, 0x17, 0x24, 0xcc, 0x07, 0xc6, 0xbc);

// { 0x57, 0xb5, 0x0c, 0xff, 0xf5, 0x3a, 0x6b, 0x40, 0x8b, 0x0f, 0x55, 0x5a, 0x2d, 0x92, 0xa2, 0x20 }
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_TRIGGER_RIGHT, 0xff0cb557, 0x3af5, 0x406b, 0x8b, 0x0f, 0x55, 0x5a, 0x2d, 0x92, 0xa2, 0x20);

위 예에서 GUID는 인메모리 리틀 엔디언 표현을 사용하여 레지스트리에 직렬화됩니다.

참조 API 문서

GameInput(API 콘텐츠)
- 구조체
  - GameInputHapticInfo

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

요구 사항

햅틱 위치

참조 API 문서

함께 보기

​요구 사항

​햅틱 위치

​참조 API 문서

​함께 보기

요구 사항

햅틱 위치

참조 API 문서

함께 보기