입력 장치에 대한 포커스 정책을 열거합니다.
구문
typedef enum GameInputFocusPolicy
{
GameInputDefaultFocusPolicy = 0x00000000,
GameInputDisableBackgroundInput = 0x00000001,
GameInputExclusiveForegroundInput = 0x00000002,
GameInputDisableBackgroundGuideButton = 0x00000004,
GameInputExclusiveForegroundGuideButton = 0x00000008,
GameInputDisableBackgroundShareButton = 0x00000010,
GameInputExclusiveForegroundShareButton = 0x00000020,
GameInputEnableBackgroundInput = 0x00000040
} GameInputFocusPolicy
상수
| 상수 | 설명 |
|---|---|
| GameInputDefaultFocusPolicy | 포커스가 없을 때 입력 및 시스템 단추가 게임에 전송되지 않도록 합니다. 입력 장치에 대한 기본 포커스 정책입니다. |
| GameInputDisableBackgroundInput | 입력(시스템 단추 제외)이 포커스가 있는 경우에만 게임에 전송되도록 합니다. 게임에 포커스가 없으면 사용자가 디바이스와 상호 작용하지 않는 것처럼 입력 장치에서 중립 또는 "rest" 상태 보고서를 받습니다. |
| GameInputExclusiveForegroundInput | GameInput을 사용하는 다른 프로세스가 수신하는 입력을 볼 수 없도록 합니다. 이 제한은 게임이 포커스가 있고 시스템 단추에 적용되지 않는 경우에만 적용됩니다. |
| GameInputDisableBackgroundGuideButton | 가이드 단추 이벤트가 포커스가 있는 경우에만 게임으로 전송되도록 합니다. 가이드 단추는 게임이 포커스가 없을 때 누르지 않는 것으로 보고됩니다. |
| GameInputExclusiveForegroundGuideButton | GameInput을 사용하는 다른 프로세스에서 가이드 단추가 수신되는 것을 볼 수 없습니다. 이 제한은 게임이 포커스 상태일 때에만 적용됩니다. |
| GameInputDisableBackgroundShareButton | 공유 단추 이벤트가 포커스가 있는 경우에만 게임에 전송되도록 합니다. 공유 단추는 게임이 포커스가 없을 때 누르지 않은 것으로 보고됩니다. |
| GameInputExclusiveForegroundShareButton | GameInput을 사용하는 다른 프로세스에서 공유 단추가 수신되는 것을 볼 수 없습니다. 이 제한은 게임이 포커스 상태일 때에만 적용됩니다. |
| GameInputEnableBackgroundInput | 포커스가 없는 경우에도 입력(시스템 단추 제외)이 항상 게임에 전송되도록 합니다. |
비고
이 열거형은 IGameInput::SetFocusPolicy 메서드에서 사용됩니다. 포커스에 없는 경우 게임에 입력을 보낼지 여부를 지정하려면 SetFocusPolicy를 호출합니다. 이전 버전의 GameInput은 기본적으로 백그라운드의 모든 애플리케이션에 입력을 보냈습니다. GameInput v2 이상에서는 이전 v0 및 v1 인터페이스에 대해서도 기본적으로 입력을 보내지 않습니다. 백그라운드 입력을 수신하도록 애플리케이션을 등록하려면 를 통해 SetFocusPolicy 포커스 정책을 위의 값 중 하나로 명시적으로 설정합니다. 값을 결합할 수 있습니다.
게임에서 가이드 또는 공유 단추를 처리하는 경우 GameInputExclusiveForegroundGuideButton 또는 GameInputExclusiveForegroundShareButton 플래그를 각각 설정하면 백그라운드 오버레이 애플리케이션도 이를 처리하지 않도록 할 수 있습니다. 예를 들어 이렇게 하면 단추 자체를 사용하려는 게임에 원치 않는 오버레이 메뉴 또는 스크린샷이 표시되지 않도록 방지할 수 있습니다.
참고 항목
많은 사용자가 메뉴에 가이드 단추를 사용하고 스크린샷에 공유 단추를 사용하는 오버레이 애플리케이션을 사용합니다. 사용자 혼동을 피하기 위해 게임에서 해당 기능을 재정의해야 하는지 여부를 고려합니다. 포커스 정책은 Windows에만 적용됩니다. GameInputFocusPolicy의 가이드 및 공유 단추 값은 Windows SDK 10.0.26031 Preview GameInput.h에 추가되었으며 향후 GDK 릴리스에 추가될 예정입니다.
자세한 내용은 GameInput 기본 사항을 참조하세요.
요구 사항
헤더: GameInput.h
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔