PhoneGap API介绍:Notification

移动开发
本文将介绍PhoneGap API——Notification:设备的视觉、声音和触觉提醒。PhoneGap API Notification设备的视觉、听觉和触觉通知。

方法

 notification.alert

  • 显示一个定制的警告或对话框。
  1. 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

简单的范例

  1. // Android / BlackBerry WebWorks (OS 5.0 and higher) // iPhone 
  2. function alertDismissed() { 
  3.     // 进行处理 
  4.  
  5. navigator.notification.alert( 
  6.     'You are the winner!',  // 显示信息 
  7.        alertDismissed,         // 警告被忽视的回调函数 
  8.        'Game Over',            // 标题 
  9.        'Done'                  // 按钮名称 
  10. ); 
  11.  
  12. // BlackBerry (OS 4.6) // webOS 
  13. navigator.notification.alert('You are the winner!'); 

完整的范例

  1. <!DOCTYPE html> 
  2. <html> 
  3. <head>     
  4. <title>Notification Example</title> 
  5.  
  6. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
  7. <script type="text/javascript" charset="utf-8"> 
  8.  
  9.     // 等待加载PhoneGap 
  10.     document.addEventListener("deviceready", onDeviceReady, false); 
  11.      
  12.     // PhoneGap加载完毕 
  13.     function onDeviceReady() { 
  14.         // 空 
  15.     } 
  16.      
  17.     // 警告对话框被忽视 
  18.     function alertDismissed() { 
  19.         // 进行处理 
  20.     } 
  21.      
  22.     // 显示一个定制的警告框 
  23.     function showAlert() { 
  24.         navigator.notification.alert( 
  25.             'You are the winner!',  // 显示信息 
  26.             alertDismissed,         // 警告被忽视的回调函数 
  27.             'Game Over',            // 标题 
  28.             'Done'                  // 按钮名称 
  29.         ); 
  30.     } 
  31.  
  32. </script> 
  33. </head> 
  34. <body> 
  35.     <p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p> 
  36. </body> 
  37. </html> 

notification.confirm

  • 显示一个可定制的确认对话框。
  1. 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

简单的范例

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

完整的范例

  1. <!DOCTYPE html> 
  2. <html> 
  3. <head>     
  4. <title>Notification Example</title> 
  5.  
  6. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
  7. <script type="text/javascript" charset="utf-8"> 
  8.      
  9.     // 等待加载PhoneGap 
  10.     document.addEventListener("deviceready", onDeviceReady, false); 
  11.      
  12.     // PhoneGap加载完毕 
  13.     function onDeviceReady() { 
  14.         // 空 
  15.     } 
  16.      
  17.     // 处理确认对话框返回的结果 
  18.     function onConfirm(button) { 
  19.         alert('You selected button ' + button); 
  20.     } 
  21.      
  22.     // 显示一个定制的确认对话框 
  23.     function showConfirm() { 
  24.         navigator.notification.confirm( 
  25.             'You are the winner!',  // 显示信息 
  26.             onConfirm,              // 按下按钮后触发的回调函数,返回按下按钮的索引     
  27.             'Game Over',            // 标题 
  28.             'Restart,Exit'          // 按钮标签 
  29.         ); 
  30.     } 
  31.  
  32. </script> 
  33. </head> 
  34. <body> 
  35.     <p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p> 
  36. </body> 
  37. </html> 


notification.beep

  • 设备将发出蜂鸣声。
  1. navigator.notification.beep(times); 
  • times:蜂鸣声的重复次数。(数字类型)

支持的平台

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

简单的范例

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

完整的范例

  1. <!DOCTYPE html> 
  2. <html> 
  3. <head>     
  4. <title>Notification Example</title> 
  5.  
  6. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
  7. <script type="text/javascript" charset="utf-8"> 
  8.  
  9. // 等待加载PhoneGap 
  10. document.addEventListener("deviceready", onDeviceReady, false); 
  11.  
  12. // PhoneGap加载完毕 
  13. function onDeviceReady() { 
  14.        // 空 
  15.  
  16. // 显示一个定制的警告框 
  17. function showAlert() { 
  18.        navigator.notification.alert( 
  19.            'You are the winner!',  // 显示信息 
  20.            'Game Over',            // 标题 
  21.            'Done'                  // 按钮名称 
  22.        ); 
  23.  
  24. // 蜂鸣三次 
  25. function playBeep() { 
  26.        navigator.notification.beep(3); 
  27.  
  28. // 震动两秒 
  29. function vibrate() { 
  30.        navigator.notification.vibrate(2000); 
  31.  
  32. </script> 
  33. </head> 
  34. <body> 
  35.     <p><a href="#" onclick="showAlert(); return false;">Show Alert</a></p> 
  36.     <p><a href="#" onclick="playBeep(); return false;">Play Beep</a></p> 
  37.     <p><a href="#" onclick="vibrate(); return false;">Vibrate</a></p> 
  38. </body> 
  39. </html> 

Android的特异情况

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

iPhone的特异情况

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

notification.vibrate

  • 使设备震动指定的时长。
  1. navigator.notification.vibrate(milliseconds); 
  • time:以毫秒为单位的设备震动时长,1000毫秒为1秒。(数字类型)

支持的平台

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

简单的范例

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

完整的范例

  1. <!DOCTYPE html> 
  2. <html> 
  3. <head>     
  4. <title>Notification Example</title> 
  5.  
  6. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
  7. <script type="text/javascript" charset="utf-8"
  8.  
  9. // 等待加载PhoneGap 
  10. document.addEventListener("deviceready", onDeviceReady, false); 
  11.  
  12. // PhoneGap加载完毕 
  13. function onDeviceReady() { 
  14.        //空 
  15.  
  16. // 显示定制警告框 
  17. function showAlert() { 
  18.        navigator.notification.alert( 
  19.            'You are the winner!',  // 显示信息 
  20.            'Game Over',            // 标题 
  21.            'Done'                  // 按钮名称 
  22.        ); 
  23.  
  24. // 响三次 
  25. function playBeep() { 
  26.        navigator.notification.beep(3); 
  27.  
  28. // 震动两秒 
  29. function vibrate() { 
  30.        navigator.notification.vibrate(2000); 
  31.  
  32. </script> 
  33. </head> 
  34. <body> 
  35.     <p><a href="#" onclick="showAlert(); return false;">Show Alert</a></p> 
  36.     <p><a href="#" onclick="playBeep(); return false;">Play Beep</a></p> 
  37.     <p><a href="#" onclick="vibrate(); return false;">Vibrate</a></p> 
  38. </body> 
  39. </html> 

iPhone的特异情况

  • time:忽略时长参数,震动时长为预先设定值。

简单的范例

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

 

责任编辑:佚名 来源: PhoneGap中国
相关推荐

2011-09-13 13:47:56

PhoneGap AP

2011-12-19 16:09:32

PhoneGap APCamera

2011-12-20 11:20:46

PhoneGap APCompass

2011-12-20 15:34:55

PhoneGap APConnection

2011-12-21 21:56:45

PhoneGap APFile

2011-12-20 17:15:52

PhoneGap APEvents

2011-12-19 15:30:25

AccelerometPhoneGap AP

2011-12-20 13:32:52

PhoneGap APContacts

2011-12-20 16:09:57

PhoneGap APDevice

2011-12-22 09:54:40

PhoneGap APMedia

2011-12-22 09:27:36

PhoneGap APGeolocation

2011-12-19 16:26:39

PhoneGap APCapture

2011-12-22 10:45:32

PhoneGap APStorage

2011-12-30 13:47:57

PhoneGap AP视频Contacts

2011-12-30 13:59:38

PhoneGap APDevice视频

2011-12-30 14:09:32

PhoneGap APCompass视频

2011-12-30 14:13:05

PhoneGap APCamera视频

2011-12-30 14:05:17

PhoneGap APConnection视频

2011-12-30 14:16:02

AccelerometPhoneGap AP视频

2011-07-05 17:29:53

PhoneGapevents
点赞
收藏

51CTO技术栈公众号