Events

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

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

• 지원하지 않음

• 지원하지 않음

• 지원하지 않음

• 지원하지 않음

• pause handler는 Objective-C 에서 작동하지 않는다.
• Plugins 이나 PhoneGap API 에서 사용할 수 없다.
• 단지, resume 이벤트로 처리된다.

• 프로그램이 처음 실행되기 위해 초기화할 때는 online 이벤트를 감지하는데 약간의 지연시간이 있다.

• 프로그램이 처음 실행되기 위해 초기화할 때는 offline 이벤트를 감지하는데 약간의 지연시간이 있다.

• 지원하지 않음

• 지원하지 않음

• 지원하지 않음

• 지원하지 않음

• 지원하지 않음

• 지원하지 않음

• 지원하지 않음

• app/res/xml/config.xml

<plugin name="Battery" value="org.apache.cordova.BatteryListener" />

• app/AndroidManifest

<uses-permission android:name="android.permission.BROADCAST_STICKY" />

• App/Supporting Files/Cordova.plist

<key>Plugins</key>
<dict>
    <key>Battery</key>
    <string>CDVBattery</string>
</dict>

• phoneGap 라이브러리 호출을 완료 했을 때 발생한다.

document.addEventListener("deviceready", yourCallbackFunction, false);

• Quick Example

document.addEventListener("deviceready", onDeviceReady, false);

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

• phoneGap이 백그라운드에 있을 경우, 중지 됐을 때 발생한다.

document.addEventListener("pause", yourCallbackFunction, false);

• Quick Example

document.addEventListener("pause", onPause, false);

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

• phoneGap이 백그라운드에 있을 경우, 다시 전면에 나타날 때 발생한다.

document.addEventListener("resume", yourCallbackFunction, false);

• Quick Example

document.addEventListener("resume", onResume, false);

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

• phoneGap의 네트워크 상태가 온라인일 때, 발생한다.

document.addEventListener("online", yourCallbackFunction, false);

• Quick Example

document.addEventListener("online", onOnline, false);

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

• phoneGap의 네트워크 상태가 오프라인일 때, 발생한다.

ocument.addEventListener("offline", yourCallbackFunction, false);

• Quick Example

document.addEventListener("offline", onOffline, false);

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

• 단말기에 있는 백(back) 버튼을 눌렀을 때, 발생한다.

document.addEventListener("backbutton", yourCallbackFunction, false);

• Quick Example

document.addEventListener("backbutton", onBackKeyDown, false);

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

• 단말기의 배터리가 경고 수준으로 떨어졌을 경우, 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!"); 
}

• 단말기의 배터리가 ‘배터리 낮음’ 수준으로 떨어졌을 경우, 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 + "%"); 
}

• 배터리 잔량의 변화가 있을 경우, 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); 
}

• 단말기의 메뉴 버튼을 눌렀을 경우 발생한다.

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

* Quick Example

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

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

• 단말기의 검색 버튼을 눌렀을 경우 발생한다.

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

* Quick Example

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

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

• start call 버튼을 눌렀을 경우, 발생한다.

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

* Quick Example

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

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

• end call 버튼을 눌렀을 경우, 발생한다.

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

* Quick Example

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

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

• volume down 버튼을 눌렀을 경우, 발생한다.

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

* Quick Example

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

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

• volume up 버튼을 눌렀을 경우, 발생한다.

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

* Quick Example

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

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

• N/A

• N/A

• Phonegap : http://docs.phonegap.com/en/2.9.0/cordova_events_events.md.html#Events 새 창 열림