알림

청취, 시각과 촉각 장치 알림입니다.

메서드

• notification.alert
• notification.confirm
• notification.prompt
• notification.beep
• notification.vibrate

기능 액세스

버전 3.0, 코르도바 플러그인으로 장치 수준 Api를 구현합니다. CLI의 사용 plugin 명령 설명에 명령줄 인터페이스를 추가 하거나 프로젝트에 대 한이 기능을 제거 하려면:

    $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-vibration.git
    $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-dialogs.git
    $ cordova plugin rm org.apache.cordova.core.dialogs
    $ cordova plugin rm org.apache.cordova.core.vibration

이 명령은 모든 타겟된 플랫폼에 적용 하지만 플랫폼 관련 구성 설정을 아래에 설명 된 수정:

• 안 드 로이드

  (in app/res/xml/config.xml)
  <feature name="Notification">
      <param name="android-package" value="org.apache.cordova.Notification" />
  </feature>
  
  
  (in app/AndroidManifest.xml)
  <uses-permission android:name="android.permission.VIBRATE" />
  

• 블랙베리 WebWorks

  (in www/plugins.xml)
  <feature name="Notification">
      <param name="blackberry-package" value="org.apache.cordova.notification.Notification" />
  </feature>
  
  
  (in www/config.xml)
  <feature id="blackberry.ui.dialog" />
  

• (iOSconfig.xml)

  <feature name="Notification">
      <param name="ios-package" value="CDVNotification" />
  </feature>
  

일부 플랫폼은 특별 한 구성이 필요 없이이 기능을 지원할 수 있습니다. 플랫폼 지원에 대 한 참조.

---

notification.alert

사용자 지정 경고 또는 대화 상자를 보여 줍니다.

navigator.notification.alert(message, alertCallback, [title], [buttonName])

• 메시지: 대화 메시지. (문자열)

• alertCallback: 콜백을 호출할 때 경고 대화 기 각. (기능)

• 제목: 제목 대화 상자. (문자열) (옵션, 기본값:Alert)

• buttonName: 단추 이름. (문자열) (옵션, 기본값:OK)

설명

이 기능에 대 한 기본 대화 상자를 사용 하는 대부분의 코르도바 구현 하지만 일부 플랫폼 사용 브라우저의 alert 함수는 일반적으로 덜 사용자 정의할 수 있습니다.

지원 되는 플랫폼

• 안 드 로이드
• 블랙베리 WebWorks (운영 체제 5.0와 더 높은)
• iOS
• Tizen
• Windows Phone 7과 8
• 윈도우 8

빠른 예제

// Android / BlackBerry WebWorks (OS 5.0 and higher) / iOS / Tizen
//
function alertDismissed() {
    // do something
}

navigator.notification.alert(
    'You are the winner!',  // message
    alertDismissed,         // callback
    'Game Over',            // title
    'Done'                  // buttonName
);

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>Notification Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        // Empty
    }

    // alert dialog dismissed
        function alertDismissed() {
            // do something
        }

    // Show a custom alertDismissed
    //
    function showAlert() {
        navigator.notification.alert(
            'You are the winner!',  // message
            alertDismissed,         // callback
            'Game Over',            // title
            'Done'                  // buttonName
        );
    }

    </script>
  </head>
  <body>
    <p><a href="#" onclick="showAlert(); return false;">Show Alert</a></p>
  </body>
</html>

Windows Phone 7, 8 특수

• 아니 내장 브라우저 경고 하지만 다음과 같이 전화를 바인딩할 수 있습니다 alert() 전역 범위에서:

  window.alert = navigator.notification.alert;
  

• 둘 다 alert 와 confirm 는 비차단 호출, 결과 비동기적으로 사용할 수 있습니다.

---

notification.confirm

사용자 정의 확인 대화 상자가 표시 됩니다.

navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])

• 메시지: 대화 메시지. (문자열)

• confirmCallback: 인덱스 버튼 (1, 2 또는 3) 또는 대화 상자 버튼을 누르면 (0) 없이 기 각 될 때 호출할 콜백 합니다. (기능)

• 제목: 제목 대화 상자. (문자열) (옵션, 기본값:Confirm)

• buttonLabels: 단추 레이블을 지정 하는 문자열 배열입니다. (배열) (옵션, 기본값은 [ OK,Cancel ])

설명

notification.confirm메서드는 브라우저의 보다 더 많은 사용자 정의 기본 대화 상자 표시 confirm 기능.

confirmCallback

confirmCallback사용자가 확인 대화 상자에서 단추 중 하나를 누를 때 실행 됩니다.

콜백 인수 buttonIndex (번호)를누르면된 버튼의 인덱스입니다. 참고 인덱스에서는 인덱스 1부터 값은 1 , 2 , 3 , 등등.

지원 되는 플랫폼

• 안 드 로이드
• 블랙베리 WebWorks (운영 체제 5.0와 더 높은)
• iOS
• Tizen
• Windows Phone 7과 8
• 윈도우 8

빠른 예제

// process the confirmation dialog result
function onConfirm(buttonIndex) {
    alert('You selected button ' + buttonIndex);
}

// Show a custom confirmation dialog
//
function showConfirm() {
    navigator.notification.confirm(
        'You are the winner!', // message
         onConfirm,            // callback to invoke with index of button pressed
        'Game Over',           // title
        ['Restart','Exit']         // buttonLabels
    );
}

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>Notification Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        // Empty
    }

    // process the confirmation dialog result
    function onConfirm(buttonIndex) {
        alert('You selected button ' + buttonIndex);
    }

    // Show a custom confirmation dialog
    //
    function showConfirm() {
        navigator.notification.confirm(
            'You are the winner!', // message
             onConfirm,            // callback to invoke with index of button pressed
            'Game Over',           // title
            ['Restart','Exit']         // buttonLabels
        );
    }

    </script>
  </head>
  <body>
    <p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p>
  </body>
</html>

Windows Phone 7, 8 특수

• 에 대 한 기본 제공 브라우저 함수가 window.confirm , 그러나 할당 하 여 바인딩할 수 있습니다:

  window.confirm = navigator.notification.confirm;
  

• 호출 alert 및 confirm 되므로 차단 되지 않은 결과만 비동기적으로 사용할 수 있습니다.

---

notification.prompt

사용자 지정 프롬프트 대화 상자를 보여 줍니다.

navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])

• 메시지: 대화 메시지. (문자열)

• promptCallback: 단추를 누르면 호출할 콜백 합니다. (기능)

• 제목: 제목 (문자열) (옵션, 기본값 대화 상자Prompt)

• buttonLabels: 단추를 지정 하는 문자열의 배열 (배열) (옵션, 기본값은 레이블["OK","Cancel"])

• defaultText: 기본 텍스트 상자 입력 값 ( String ) (옵션, 기본값: 빈 문자열)

설명

notification.prompt메서드는 브라우저의 보다 더 많은 사용자 정의 기본 대화 상자 표시 prompt 기능.

promptCallback

promptCallback사용자가 프롬프트 대화 상자에서 단추 중 하나를 누를 때 실행 됩니다. results콜백에 전달 된 개체에는 다음 속성이 포함 되어 있습니다:

• buttonIndex: 눌려진된 버튼의 인덱스. (수) 참고 인덱스에서는 인덱스 1부터 값은 1 , 2 , 3 , 등등.

• input1: 프롬프트 대화 상자에 입력 한 텍스트. (문자열)

지원 되는 플랫폼

• 안 드 로이드
• iOS

빠른 예제

// process the promp dialog results
function onPrompt(results) {
    alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
}

// Show a custom prompt dialog
//
function showPrompt() {
    navigator.notification.prompt(
        'Please enter your name',  // message
        onPrompt,                  // callback to invoke
        'Registration',            // title
        ['Ok','Exit'],             // buttonLabels
        'Jane Doe'                 // defaultText
    );
}

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>Notification Prompt Dialog Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        // Empty
    }

    // process the promptation dialog result
    function onPrompt(results) {
        alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
    }

    // Show a custom prompt dialog
    //
    function showPrompt() {
        navigator.notification.prompt(
            'Please enter your name',  // message
            onPrompt,                  // callback to invoke
            'Registration',            // title
            ['Ok','Exit'],             // buttonLabels
            'Jane Doe'                 // defaultText
        );
    }

    </script>
  </head>
  <body>
    <p><a href="#" onclick="showPrompt(); return false;">Show Prompt</a></p>
  </body>
</html>

안 드 로이드 단점

• 안 드 로이드 최대 3 개의 단추를 지원 하 고 그것 보다는 더 이상 무시 합니다.

• 안 드 로이드 3.0 및 나중에, 단추는 홀로 테마를 사용 하는 장치에 대 한 반대 순서로 표시 됩니다.

---

notification.beep

장치는 경고음 소리를 재생 합니다.

navigator.notification.beep(times);

• 시간: 경고음을 반복 하는 횟수. (수)

지원 되는 플랫폼

• 안 드 로이드
• 블랙베리 WebWorks (운영 체제 5.0와 더 높은)
• iOS
• Tizen
• Windows Phone 7과 8

빠른 예제

// Beep twice!
navigator.notification.beep(2);

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>Notification Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        // Empty
    }

    // Show a custom alert
    //
    function showAlert() {
        navigator.notification.alert(
            'You are the winner!',  // message
            'Game Over',            // title
            'Done'                  // buttonName
        );
    }

    // Beep three times
    //
    function playBeep() {
        navigator.notification.beep(3);
    }

    // Vibrate for 2 seconds
    //
    function vibrate() {
        navigator.notification.vibrate(2000);
    }

    </script>
  </head>
  <body>
    <p><a href="#" onclick="showAlert(); return false;">Show Alert</a></p>
    <p><a href="#" onclick="playBeep(); return false;">Play Beep</a></p>
    <p><a href="#" onclick="vibrate(); return false;">Vibrate</a></p>
  </body>
</html>

안 드 로이드 단점

• 안 드 로이드 기본 알림 벨소리 설정/사운드 및 디스플레이 패널에서 지정 합니다.

Windows Phone 7, 8 특수

• 코르 도우 바 분포에서 일반 경고음 파일에 의존합니다.

Tizen 특수

• Tizen은 미디어 API 통해 오디오 파일을 재생 하 여 경고음을 구현 합니다.

• 경고음 파일에 위치 해야 합니다, 짧은 해야 한 sounds 응용 프로그램의 루트 디렉터리의 하위 디렉터리 명명 해야 합니다beep.wav.

---

notification.vibrate

지정 된 시간 동안 장치를 진동.

navigator.notification.vibrate(milliseconds)

• 시간: 밀리초 1000 밀리초 1 초를 같게 장치 진동. (수)

지원 되는 플랫폼

• 안 드 로이드
• 블랙베리 WebWorks (운영 체제 5.0와 더 높은)
• iOS
• Windows Phone 7과 8

빠른 예제

// Vibrate for 2.5 seconds
//
navigator.notification.vibrate(2500);

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>Notification Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        // Empty
    }

    // Show a custom alert
    //
    function showAlert() {
        navigator.notification.alert(
            'You are the winner!',  // message
            'Game Over',            // title
            'Done'                  // buttonName
        );
    }

    // Beep three times
    //
    function playBeep() {
        navigator.notification.beep(3);
    }

    // Vibrate for 2 seconds
    //
    function vibrate() {
        navigator.notification.vibrate(2000);
    }

    </script>
  </head>
  <body>
    <p><a href="#" onclick="showAlert(); return false;">Show Alert</a></p>
    <p><a href="#" onclick="playBeep(); return false;">Play Beep</a></p>
    <p><a href="#" onclick="vibrate(); return false;">Vibrate</a></p>
  </body>
</html>

iOS 단점

• 시간: 지정 된 시간을 무시 하 고 미리 설정 된 시간 동안 진동.

  navigator.notification.vibrate();
  navigator.notification.vibrate(2500);   // 2500 is ignored