다음을 통해 공유

GameBar 클래스

  • 참조

정의

네임스페이스:
Windows.Gaming.UI
편집

게임 바의 표시 유형 및 입력 리디렉션 상태에 대한 알림 및 정보를 제공합니다.

public ref class GameBar abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class GameBar final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class GameBar
Public Class GameBar
상속
Object Platform::Object IInspectable GameBar
특성
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

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

설명

의 이벤트 및 속성은 클래스 정적입니다. 개체는 이 클래스에 대해 인스턴스화되지 않습니다.

속성

IsInputRedirected

입력이 현재 게임 바로 리디렉션되는지 여부를 나타냅니다.

사용자가 게임 바를 호출하면 플레이어가 게임 막대와 상호 작용하는 동안 입력이 게임 바로 리디렉션될 수 있습니다. 더 이상 입력을 받지 않는 게임은 일반적으로 게임 플레이를 일시 중지하거나 유휴 상태를 표시하려고 합니다. 일시 중지되거나 유휴 상태인 경우 현재 프레임이나 장면을 계속 렌더링하여 플레이어가 녹음을 시작하거나 이미 녹화 중인 경우 녹음이 원활하고 원활하도록 하는 것이 가장 좋습니다. 멀티 플레이어 게임은 일시 중지하지 않고 게임 플레이를 계속하도록 선택할 수 있습니다.

에 대한 변경 내용에 대한 알림을 받도록 IsInputRedirectedChanged 이벤트를 처리합니다.
Visible

게임 바가 현재 표시되는지 여부를 나타냅니다.

사용 된 게임 표시줄의 표시 상태를 확인 하려면 속성입니다. 게임은 게임 표시줄이 표시되고 게임 위에 그려질 때 게임 플레이를 일시 중지하거나 유휴 상태를 표시하도록 선택할 수 있습니다. 일시 중지되거나 유휴 상태인 경우 현재 프레임이나 장면을 계속 렌더링하여 플레이어가 녹음을 시작하거나 이미 녹화 중인 경우 녹음이 원활하고 원활하도록 하는 것이 가장 좋습니다. 멀티 플레이어 게임은 일시 중지하지 않고 게임 플레이를 계속하도록 선택할 수 있습니다.

에 대한 변경 내용에 대한 알림을 받도록 VisibilityChanged 이벤트를 처리합니다.

이벤트

IsInputRedirectedChanged

입력이 게임 바로 리디렉션되거나 입력이 게임으로 복원될 때 발생합니다.

사용자가 게임 바를 호출하면 플레이어가 게임 막대와 상호 작용하는 동안 입력이 게임 바로 리디렉션될 수 있습니다. 더 이상 입력을 받지 않는 게임은 일반적으로 게임 플레이를 일시 중지하거나 유휴 상태를 표시하려고 합니다. 일시 중지되거나 유휴 상태인 경우 현재 프레임이나 장면을 계속 렌더링하여 플레이어가 녹음을 시작하거나 이미 녹화 중인 경우 녹음이 원활하고 원활하도록 하는 것이 가장 좋습니다. 멀티 플레이어 게임은 일시 중지하지 않고 게임 플레이를 계속하도록 선택할 수 있습니다.

팁

이 이벤트는 백그라운드(비 UI) 스레드에서 발생할 수 있습니다. UI 작업을 수행하려면 이벤트를 UI 스레드에 게시해야 할 수 있습니다.

IsInputRedirected를 사용하여 입력이 현재 게임 바로 리디렉션되는지 여부를 확인합니다.
VisibilityChanged

게임 표시줄이 표시되거나 해제될 때 발생합니다.

이벤트를 사용하여 게임 바의 표시 상태를 모니터링합니다. 게임은 게임 표시줄이 표시되고 게임 위에 그려질 때 게임 플레이를 일시 중지하거나 유휴 상태를 표시하도록 선택할 수 있습니다. 일시 중지되거나 유휴 상태인 경우 현재 프레임이나 장면을 계속 렌더링하여 플레이어가 녹음을 시작하거나 이미 녹화 중인 경우 녹음이 원활하고 원활하도록 하는 것이 가장 좋습니다. 멀티 플레이어 게임은 일시 중지하지 않고 게임 플레이를 계속하도록 선택할 수 있습니다.

팁

이 이벤트는 백그라운드(비 UI) 스레드에서 발생할 수 있습니다. UI 작업을 수행하려면 이벤트를 UI 스레드에 게시해야 할 수 있습니다.

Visible를 사용하여 게임 바가 현재 표시되는지 여부를 확인합니다.

적용 대상