Events

설명

  • 폰갭 라이프 사이클 이벤트 콜백 함수를 정의한다.

제약사항

  • Events API의 플랫폼별 제약사항은 다음과 같다.

Android

startcallbutton
  • 지원하지 않음
endcallbutton
  • 지원하지 않음
volumedownbutton
  • 지원하지 않음
volumeupbutto
  • 지원하지 않음

iOS

pause
  • pause handler는 Objective-C 에서 작동하지 않는다.
  • Plugins 이나 PhoneGap API 에서 사용할 수 없다.
  • 단지, resume 이벤트로 처리된다.
online
  • 프로그램이 처음 실행되기 위해 초기화할 때는 online 이벤트를 감지하는데 약간의 지연시간이 있다.
offline
  • 프로그램이 처음 실행되기 위해 초기화할 때는 offline 이벤트를 감지하는데 약간의 지연시간이 있다.
backbutton
  • 지원하지 않음
menubutton
  • 지원하지 않음
searchbutton
  • 지원하지 않음
startcallbutton
  • 지원하지 않음
endcallbutton
  • 지원하지 않음
volumedownbutton
  • 지원하지 않음
volumeupbutto
  • 지원하지 않음

환경 설정

Android

  • app/res/xml/config.xml
<plugin name="Battery" value="org.apache.cordova.BatteryListener" />
  • app/AndroidManifest
<uses-permission android:name="android.permission.BROADCAST_STICKY" />

iOS

  • App/Supporting Files/Cordova.plist
<key>Plugins</key>
<dict>
    <key>Battery</key>
    <string>CDVBattery</string>
</dict>

이벤트 타입

deviceready

  • phoneGap 라이브러리 호출을 완료 했을 때 발생한다.
document.addEventListener("deviceready", yourCallbackFunction, false);
  • Quick Example
document.addEventListener("deviceready", onDeviceReady, false);

function onDeviceReady() {
    // Now safe to use the Cordova API
}

pause

  • phoneGap이 백그라운드에 있을 경우, 중지 됐을 때 발생한다.
document.addEventListener("pause", yourCallbackFunction, false);

  • Quick Example
document.addEventListener("pause", onPause, false);

function onPause() {
    // Handle the pause event
}

resume

  • phoneGap이 백그라운드에 있을 경우, 다시 전면에 나타날 때 발생한다.
document.addEventListener("resume", yourCallbackFunction, false);

  • Quick Example
document.addEventListener("resume", onResume, false);

function onResume() {
    // Handle the resume event
}

online

  • phoneGap의 네트워크 상태가 온라인일 때, 발생한다.
document.addEventListener("online", yourCallbackFunction, false);

  • Quick Example
document.addEventListener("online", onOnline, false);

function onOnline() {
    // Handle the online event
}

offline

  • phoneGap의 네트워크 상태가 오프라인일 때, 발생한다.
ocument.addEventListener("offline", yourCallbackFunction, false);

  • Quick Example
document.addEventListener("offline", onOffline, false);

function onOffline() {
    // Handle the offline event
}

backbutton

  • 단말기에 있는 백(back) 버튼을 눌렀을 때, 발생한다.
document.addEventListener("backbutton", yourCallbackFunction, false);

  • Quick Example
document.addEventListener("backbutton", onBackKeyDown, false);

function onBackKeyDown() {
    // Handle the back button
}

batterycritical

  • 단말기의 배터리가 경고 수준으로 떨어졌을 경우, phoneGap이 감지했을 때 발생한다.
  • batterycritical 핸들러는 두 가지 속성을 구성된다:
  1. level: battery 잔량의 백분율 (0-100). (Number)
  2. isPlugged: 단말기가 배터리 충전기에 충전되고 있는지의 여부. (Boolean)
window.addEventListener("batterycritical", yourCallbackFunction, false);

  • Quick Example
window.addEventListener("batterycritical", onBatteryCritical, false);

function onBatteryCritical(info) {
    // Handle the battery critical event
    alert("Battery Level Critical " + info.level + "%\nRecharge Soon!"); 
}

batterylow

  • 단말기의 배터리가 ‘배터리 낮음’ 수준으로 떨어졌을 경우, phoneGap이 감지했을 때 발생한다.
  • batterycritical 핸들러는 두 가지 속성을 구성된다:
  1. level: battery 잔량의 백분율 (0-100). (Number)
  2. isPlugged: 단말기가 배터리 충전기에 충전되고 있는지의 여부. (Boolean)
window.addEventListener("batterylow", yourCallbackFunction, false);

  • Quick Example
window.addEventListener("batterylow", onBatteryLow, false);

function onBatteryLow(info) {
    // Handle the battery low event
    alert("Battery Level Low " + info.level + "%"); 
}

batterystatus

  • 배터리 잔량의 변화가 있을 경우, phoneGap이 감지했을 때 발생한다..
  • batterycritical 핸들러는 두 가지 속성을 구성된다:
  1. level: battery 잔량의 백분율 (0-100). (Number)
  2. isPlugged: 단말기가 배터리 충전기에 충전되고 있는지의 여부. (Boolean)
window.addEventListener("batterystatus", yourCallbackFunction, false);

  • Quick Example
window.addEventListener("batterystatus", onBatteryStatus, false);

function onBatteryStatus(info) {
    // Handle the online event
    console.log("Level: " + info.level + " isPlugged: " + info.isPlugged); 
}

menubutton

  • 단말기의 메뉴 버튼을 눌렀을 경우 발생한다.
document.addEventListener("menubutton", yourCallbackFunction, false);

* Quick Example

document.addEventListener("menubutton", onMenuKeyDown, false);

function onMenuKeyDown() {
    // Handle the back button
}

searchbutton

  • 단말기의 검색 버튼을 눌렀을 경우 발생한다.
document.addEventListener("searchbutton", yourCallbackFunction, false);

* Quick Example

document.addEventListener("searchbutton", onSearchKeyDown, false);

function onSearchKeyDown() {
    // Handle the search button
}

startcallbutton

  • start call 버튼을 눌렀을 경우, 발생한다.
document.addEventListener("startcallbutton", yourCallbackFunction, false);

* Quick Example

document.addEventListener("startcallbutton", onStartCallKeyDown, false);

function onStartCallKeyDown() {
    // Handle the start call button
}

endcallbutton

  • end call 버튼을 눌렀을 경우, 발생한다.
document.addEventListener("endcallbutton", yourCallbackFunction, false);

* Quick Example

document.addEventListener("endcallbutton", onEndCallKeyDown, false);

function onEndCallKeyDown() {
    // Handle the end call button
}

volumedownbutton

  • volume down 버튼을 눌렀을 경우, 발생한다.
document.addEventListener("volumedownbutton", yourCallbackFunction, false);

* Quick Example

document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);

function onVolumeDownKeyDown() {
    // Handle the volume down button
}

voumeupbutton

  • volume up 버튼을 눌렀을 경우, 발생한다.
document.addEventListener("volumeupbutton", yourCallbackFunction, false);

* Quick Example

document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);

function onVolumeUpKeyDown() {
    // Handle the volume up button
}

파라미터

  • N/A

Objects

  • N/A

참고 자료

 
egovframework/hyb/hrte/deviceapi/events.txt · 마지막 수정: 2023/12/21 05:21 (외부 편집기)
 
이 위키의 내용은 다음의 라이센스에 따릅니다 :CC Attribution-Noncommercial-Share Alike 3.0 Unported
전자정부 표준프레임워크 라이센스(바로가기)

전자정부 표준프레임워크 활용의 안정성 보장을 위해 위험성을 지속적으로 모니터링하고 있으나, 오픈소스의 특성상 문제가 발생할 수 있습니다.
전자정부 표준프레임워크는 Apache 2.0 라이선스를 따르고 있는 오픈소스 프로그램입니다. Apache 2.0 라이선스에 따라 표준프레임워크를 활용하여 발생된 업무중단, 컴퓨터 고장 또는 오동작으로 인한 손해 등에 대해서 책임이 없습니다.
Recent changes RSS feed CC Attribution-Noncommercial-Share Alike 3.0 Unported Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki