IGameInputDevice::GetBatteryState
참고 항목
이 기능은 아직 구현되지 않았습니다.
장치의 배터리 상태를 가져옵니다.
구문
void GetBatteryState(
GameInputBatteryState* state
)
매개 변수
state _Out_
형식: GameInputBatteryState*
충전 속도, 남은 충전량 및 충전 용량과 같은 장치 배터리에 대한 정보입니다.
반환 값
형식: void
0 값 및 알 수 없는 상태로 채워진 GameInputBatteryState* 구조체를 반환합니다.
설명
GetBatteryState 메서드는 장치 배터리의 현재 상태에 대한 정보를 반환합니다. 이 정보는 GameInputBatteryStatus 열거형과 GameInputBatteryState 구조체로 정의됩니다.
이 열거형과 이 구조를 정의하는 멤버를 정의하는 상수를 보려면 다음 코드 예제를 참조하십시오.
typedef enum GameInputBatteryStatus
{
GameInputBatteryUnknown = -1,
GameInputBatteryNotPresent = 0,
GameInputBatteryDischarging = 1,
GameInputBatteryIdle = 2,
GameInputBatteryCharging = 3
} GameInputBatteryStatus;
typedef struct GameInputBatteryState
{
float chargeRate;
float remainingCapacity;
float fullChargeCapacity;
GameInputBatteryStatus status;
} GameInputBatteryState;
모든 부동 소수점 값은 와트 시간으로 표시됩니다. 장치에 배터리가 없거나 현재 배터리 상태를 확인할 수 없으면 모든 부동 소수점 값이 0입니다. 그렇지 않으면 배터리가 충전될 때 음수 값이 되는 chargeRate 멤버를 제외한 모든 부동 소수점 값이 양수입니다.
장치에서 검색될 수 있을 때마다 정확한 와트 시간 값이 제공됩니다. 하지만 모든 장치가 이 정보를 제공하지는 않으며, 일부 값만 제공할 수도 있습니다. 정확한 와트 시간 수치를 사용할 수 없는 모든 부동 소수점 값에는 다음과 같이 기본값이 지정됩니다.
chargeRate는 충전/방전 중일 때fullChargeCapacity값의 +/- 10%로 설정되며, 충전 상태가 "유휴"일 때는 0으로 설정됩니다.remainingCapacity은fullChargeCapacity의 값으로 설정되며, 이것은 남은 충전 비율을 곱한 값입니다.fullChargeCapacity은 1와트 시간 값으로 설정됩니다.
| 세부 충전 수준 | 매핑된 백분율 값 |
|---|---|
| 꽉 참 | 100% |
| 보통 | 70% |
| 낮음 | 40% |
| 위험 | 10% |
배터리 수준을 표시할 때 최상의 사용자 환경을 제공하려면 배터리 전원의 "막대"를 표시하는 UI 코드가 앞의 표에 지정된 값과 일치해야 합니다. 자세한 내용은 게임에 대한 입력 방법을 참조하십시오.
시스템에서 장치 연결을 해제할 때 GetBatteryState 메서드가 호출되면 모든 부동 소수점 값이 0으로 설정되고, 상태 멤버가 GameInputBatteryUnknown으로 설정됩니다(장치가 연결될 때 유효한 값이 제공된 경우도 포함). 이 메서드는 단순히 로컬 메모리에 저장된 데이터를 검색하며, 어떤 컨텍스트에서도 안전하게 호출할 수 있습니다.
요건
헤더: GameInput.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔