이 문서는 초안 문서이며 언제든지 업데이트, 교체 또는 폐기될 수 있습니다. 진행 중인 작업 외의 것으로 이 문서를 인용하는 것은 적절하지 않습니다.
이 문서는 W3C 특허 정책에 따라 운영되는 그룹에서 작성되었습니다.
W3C는 그룹의 산출물과 관련하여 공개 특허 공개 목록을 유지합니다. 해당 페이지에는 특허 공개 방법도 포함되어 있습니다. 어떤 개인이
필수 청구를 포함한다고 믿는 특허에 대해 실제로 알고 있다면, W3C 특허 정책 6절에 따라 정보를 공개해야 합니다.
배터리 상태 API 명세는 웹 개발자가 호스트 장치의 배터리 상태를 프로그래밍 방식으로 확인할 수 있는 방법을 정의합니다.
장치의 배터리 상태를 알지 못하면, 웹 개발자는 특정 작업에 충분한 배터리 잔량이 있다고 가정하고 웹 애플리케이션을 설계해야 합니다. 이로 인해 개발자가 배터리 상태를 기반으로 의사결정을 내리지
못해 장치의 배터리가 원치 않게 빨리 소모될 수 있습니다. 배터리 상태를 알게 되면, 웹 개발자는 효율적으로 전력을 사용하는 웹 콘텐츠 및 애플리케이션을 제작할 수 있어 사용자 경험이
향상됩니다.
단, 이 API의 단순한 구현은 오히려 배터리 수명에 악영향을 줄 수 있다는 점을 저자들은 인지해야 합니다.
배터리 상태 API는 장치가 충전 중이 아니거나 배터리 잔량이 적을 때 작업을 연기하거나 축소하는 데 사용할 수 있습니다. 예를 들어, 고급 웹 애플리케이션의 전형인 웹 기반 이메일 클라이언트는
장치가 충전 중일 때는 몇 초마다 서버에 새 이메일을 확인할 수 있지만, 충전 중이 아니거나 배터리 잔량이 적을 때는 확인 빈도를 줄일 수 있습니다. 또 다른 예로, 웹 기반 워드 프로세서는
배터리 잔량을 모니터링하여 배터리가 소진되기 전에 변경 사항을 저장함으로써 데이터 손실을 방지할 수 있습니다.
2. 적합성
비규범으로 표시된 섹션뿐만 아니라, 이 명세서의 모든 작성 지침, 다이어그램, 예시, 참고도 비규범적입니다. 그 외 모든 내용은 규범적입니다.
이 문서의 MAY, MUST, SHOULD와 같은 주요
용어들은
BCP 14
[RFC2119] [RFC8174]
에서 설명된 대로 해석되어야 하며, 오직 이 문서에서 대문자로 표시된 경우에만 해당합니다.
이 명세서는 하나의 제품에 적용되는 적합성 기준을 정의합니다. 즉, 명세서에 포함된 인터페이스를 구현하는 사용자 에이전트에 적용됩니다.
3.
보안 및 프라이버시 고려사항
이 명세서에서 정의된 API는 호스트 장치의 배터리 상태를 확인하는 데 사용됩니다.
사용자 에이전트는 배터리 상태 정보를 너무 정밀하게 노출해서 새로운 지문 인식 벡터가 생기지 않도록 SHOULD 합니다.
사용자 에이전트는 사용자에게 배터리 상태 정보 접근을 요청하거나, 또는 프라이빗 브라우징 모드에서 사용자 권한 요구를 강제할 수 있습니다(MAY).
사용자 에이전트는 스크립트에서 API를 사용할 때 사용자에게 방해가 되지 않는 방식으로 알리고 투명성을 높이며, 사용자가 API 접근을 취소할 수 있도록 SHOULD 합니다.
사용자 에이전트는 호스트 장치에 배터리가 없는지, 충전 중인지, 또는 허위 값을 노출하는지 저자가 직접 알 수 없도록 값을 난독화할 수 있습니다(MAY).
[[ChargingTime]] 내부 슬롯은
시스템 배터리가 완전히 충전될 때까지 남은 시간을 초 단위로 나타냅니다. 배터리가 가득 찼거나 시스템에 배터리가 없으면 반드시 0으로
설정되어야 하며,
배터리가 방전 중이거나, 구현체가 남은 충전 시간을 보고할 수 없거나 그 밖의 경우에는 양의 무한대로 설정되어야 합니다.
[[DischargingTime]]
속성은 시스템 배터리가 완전히 방전되어 시스템이 중단되기까지 남은 시간을 초 단위로 나타냅니다. 배터리가 충전 중이거나, 구현체가 남은 방전 시간을 보고할 수 없거나, 시스템에
배터리가 없거나 그 밖의 경우에는 반드시 양의 무한대로 설정되어야 합니다.
<!DOCTYPE html><html><head><title>Battery Status API Example</title><script>window.onload = function () {
functionupdateBatteryStatus(battery) {
document.querySelector('#charging').textContent = battery.charging ? 'charging' : 'not charging';
document.querySelector('#level').textContent = battery.level;
document.querySelector('#dischargingTime').textContent = battery.dischargingTime / 60;
}
navigator.getBattery().then(function(battery) {
// 프라미스가 resolve될 때 초기 배터리 상태를 업데이트 ...updateBatteryStatus(battery);
// ... 이후의 모든 업데이트도.
battery.onchargingchange = function () {
updateBatteryStatus(battery);
};
battery.onlevelchange = function () {
updateBatteryStatus(battery);
};
battery.ondischargingtimechange = function () {
updateBatteryStatus(battery);
};
});
};
</script></head><body><divid="charging">(충전 상태 알 수 없음)</div><divid="level">(배터리 레벨 알 수 없음)</div><divid="dischargingTime">(방전 시간 알 수 없음)</div></body></html>
그룹은 Mounir Lamouri, Jonas Sicking, 그리고 Mozilla WebAPI 팀 전체에 프로토타입 구현을 기반으로 한 소중한 피드백에 깊이 감사드립니다. System
Information API와 Device Orientation Event 명세를 만든 분들께도 초기 영감에 감사드립니다. 또한 Page Visibility 명세를 가져와서, 실제로 가치 있는
웹 사용 사례들이 어떻게 이 명세에도 적용되는지를 소개장에서 다루도록 동기를 준 모든 분께 고마움을 전합니다. Device APIs 워킹 그룹의 모든 참가자와 실질적인 피드백을 보내주신 분들께,
그리고 그렇게 함으로써 모두를 위한 더 나은 웹을 만들어주신 분들께 특별히 감사드립니다. 마지막으로, Lukasz Olejnik, Gunes Acar, Claude Castelluccia,
Claudia Diaz에게 이 API의 프라이버시 분석에 대한 감사를 전합니다.