PhoneGap API介绍：Notification-android api

方法：

notification.alert
notification.confirm
notification.beep
notification.vibrate

显示一个定制的警告或对话框。

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

message：对话框信息。（字符串类型）
alertCallback：当警告对话框被忽略时调用的回调函数。（函数类型）
title：对话框标题。（字符串类型）（可选项，默认值为“Alert”）
buttonName：按钮名称（字符串类型）(可选项，默认值为“OK”)

说明：

大多数PhoneGap使用本地对话框实现该功能。然而，一些平台只是简单的使用浏览器的alert函数，而这种方法通常是不能定制的。

支持的平台：

Android
BlackBerry (OS 4.6)
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：

// Android / BlackBerry WebWorks (OS 5.0 and higher) // iPhone 
function alertDismissed() { 
    // 进行处理 
} 
 
navigator.notification.alert( 
    'You are the winner!',  // 显示信息 
       alertDismissed,         // 警告被忽视的回调函数 
       'Game Over',            // 标题 
       'Done'                  // 按钮名称 
); 
 
// BlackBerry (OS 4.6) // webOS 
navigator.notification.alert('You are the winner!');

完整的范例：

<!DOCTYPE html> 
<html> 
<head>     
<title>Notification Example</title> 
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
<script type="text/javascript" charset="utf-8"> 
 
    // 等待加载PhoneGap 
    document.addEventListener("deviceready", onDeviceReady, false); 
     
    // PhoneGap加载完毕 
    function onDeviceReady() { 
        // 空 
    } 
     
    // 警告对话框被忽视 
    function alertDismissed() { 
        // 进行处理 
    } 
     
    // 显示一个定制的警告框 
    function showAlert() { 
        navigator.notification.alert( 
            'You are the winner!',  // 显示信息 
            alertDismissed,         // 警告被忽视的回调函数 
            'Game Over',            // 标题 
            'Done'                  // 按钮名称 
        ); 
    } 
 
</script> 
</head> 
<body> 
    <p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p> 
</body> 
</html>

notification.confirm

显示一个可定制的确认对话框。

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

message：对话框信息。（字符串类型）
confirmCallback：按下按钮后触发的回调函数，返回按下按钮的索引（1、2或3）。（函数类型）
title：对话框标题。（字符串类型）（可选项，默认值为“Confirm”）
buttonLabels：逗号分隔的按钮标签字符串。(字符串类型)（可选项，默认值为“OK、Cancel”）

说明：

notification.confirm函数显示一个定制性比浏览器的confirm函数更好的本地对话框。

支持的平台：

Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：

// 处理确认对话框返回的结果 
function onConfirm(button) { 
    alert('You selected button ' + button); 
} 
 
// 显示一个定制的确认对话框 
function showConfirm() { 
       navigator.notification.confirm( 
           'You are the winner!',  // 显示信息 
           onConfirm,              // 按下按钮后触发的回调函数，返回按下按钮的索引 
           'Game Over',            // 标题 
           'Restart,Exit'          // 按钮标签 
       ); 
 }

完整的范例：

<!DOCTYPE html> 
<html> 
<head>     
<title>Notification Example</title> 
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
<script type="text/javascript" charset="utf-8"> 
     
    // 等待加载PhoneGap 
    document.addEventListener("deviceready", onDeviceReady, false); 
     
    // PhoneGap加载完毕 
    function onDeviceReady() { 
        // 空 
    } 
     
    // 处理确认对话框返回的结果 
    function onConfirm(button) { 
        alert('You selected button ' + button); 
    } 
     
    // 显示一个定制的确认对话框 
    function showConfirm() { 
        navigator.notification.confirm( 
            'You are the winner!',  // 显示信息 
            onConfirm,              // 按下按钮后触发的回调函数，返回按下按钮的索引     
            'Game Over',            // 标题 
            'Restart,Exit'          // 按钮标签 
        ); 
    } 
 
</script> 
</head> 
<body> 
    <p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p> 
</body> 
</html>

notification.beep

设备将发出蜂鸣声。

navigator.notification.beep(times);

times：蜂鸣声的重复次数。（数字类型）

支持的平台：

Android
BlackBerry (OS 4.6)
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：

// 蜂鸣2次！ 
navigator.notification.beep(2);

完整的范例：

<!DOCTYPE html> 
<html> 
<head>     
<title>Notification Example</title> 
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
<script type="text/javascript" charset="utf-8"> 
 
// 等待加载PhoneGap 
document.addEventListener("deviceready", onDeviceReady, false); 
 
// PhoneGap加载完毕 
function onDeviceReady() { 
       // 空 
} 
 
// 显示一个定制的警告框 
function showAlert() { 
       navigator.notification.alert( 
           'You are the winner!',  // 显示信息 
           'Game Over',            // 标题 
           'Done'                  // 按钮名称 
       ); 
} 
 
// 蜂鸣三次 
function playBeep() { 
       navigator.notification.beep(3); 
} 
 
// 震动两秒 
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>

Android的特异情况：

Androids会播放在“设置/音效及显示”面板中指定的默认“通知铃声”。

iPhone的特异情况：

忽略蜂鸣次数参数。
iPhone没有本地的蜂鸣API。
PhoneGap通过多媒体API播放音频文件来实现蜂鸣。
用户必须提供一个包含所需的蜂鸣声的文件。
此文件播放时长必须短于30秒，位于www/root，并且必须命名为beep.wav。

notification.vibrate

使设备震动指定的时长。

navigator.notification.vibrate(milliseconds);

time：以毫秒为单位的设备震动时长，1000毫秒为1秒。（数字类型）

支持的平台：

Android
BlackBerry (OS 4.6)
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：

// 震动2.5秒 
navigator.notification.vibrate(2500);

完整的范例：

<!DOCTYPE html> 
<html> 
<head>     
<title>Notification Example</title> 
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
<script type="text/javascript" charset="utf-8"> 
 
// 等待加载PhoneGap 
document.addEventListener("deviceready", onDeviceReady, false); 
 
// PhoneGap加载完毕 
function onDeviceReady() { 
       //空 
} 
 
// 显示定制警告框 
function showAlert() { 
       navigator.notification.alert( 
           'You are the winner!',  // 显示信息 
           'Game Over',            // 标题 
           'Done'                  // 按钮名称 
       ); 
} 
 
// 响三次 
function playBeep() { 
       navigator.notification.beep(3); 
} 
 
// 震动两秒 
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>

iPhone的特异情况：

time：忽略时长参数，震动时长为预先设定值。

简单的范例：

navigator.notification.vibrate(); 
navigator.notification.vibrate(2500);   // 2500被忽略掉