您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

PhoneGap API 中文說明文件:Notification(通知與提醒)

編輯:iOS 開發綜合

Notification 模組概覽

行動裝置上的「提醒」從來不只是畫面上的一塊方塊。PhoneGap 的 Notification 模組把視覺、聽覺與觸覺三種通道整合在同一組 API 之下,讓以 HTML、CSS、JavaScript 撰寫的應用程式,也能跳出接近原生的對話框、發出提示音,甚至驅動震動馬達。

整個模組只對外開放四個方法:

  • notification.alert:顯示自訂訊息的警示對話框
  • notification.confirm:顯示可自訂按鈕文字與回呼的確認對話框
  • notification.beep:讓裝置發出嗶聲
  • notification.vibrate:讓裝置震動

支援平台大致涵蓋 Android、BlackBerry(OS 4.6 以上)、BlackBerry WebWorks(OS 5.0 以上)與 iPhone,但各方法的支援程度略有差異,後文會逐一標註。

notification.alert

跳出一個自訂的警示或對話框。

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

參數說明:

  • message:對話框要顯示的內容(String)。
  • alertCallback:使用者關閉對話框後要呼叫的函式(Function)。
  • title:對話框標題(String,選填,預設為 "Alert")。
  • buttonName:按鈕上的文字(String,選填,預設為 "OK")。

多數平台上的 PhoneGap 會直接呼叫原生的對話框元件,因此外觀與系統其他提示一致;但部分平台只是轉手呼叫瀏覽器本身的 alert(),這種情況下的樣式幾乎無法客製。

支援平台:Android、BlackBerry(OS 4.6)、BlackBerry WebWorks(OS 5.0 以上)、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);

        function onDeviceReady() {
            // PhoneGap 載入完成
        }

        // 對話框被關閉後呼叫
        function alertDismissed() {
            // 進行處理
        }

        // 顯示自訂警示框
        function showAlert() {
            navigator.notification.alert(
                'You are the winner!',  // 顯示訊息
                alertDismissed,         // 關閉後的回呼
                'Game Over',            // 標題
                'Done'                  // 按鈕文字
            );
        }
    </script>
</head>
<body>
    <p><a href="#" onclick="showAlert(); return false;">Show Alert</a></p>
</body>
</html>

notification.confirm

顯示一個可高度自訂的確認對話框,讓使用者從多個選項中挑選。

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

參數說明:

  • message:對話框內容(String)。
  • confirmCallback:按下按鈕後呼叫的函式,會收到被按下按鈕的索引(1、2 或 3)。
  • title:對話框標題(String,選填,預設為 "Confirm")。
  • buttonLabels:以逗號分隔的按鈕文字(String,選填,預設為 "OK,Cancel")。

相比瀏覽器原生的 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">
        document.addEventListener("deviceready", onDeviceReady, false);

        function onDeviceReady() {
            // PhoneGap 載入完成
        }

        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 為嗶聲重複的次數(Number)。支援平台:Android、BlackBerry(OS 4.6)、BlackBerry WebWorks(OS 5.0 以上)、iPhone。

簡短範例:

// 響兩聲
navigator.notification.beep(2);

平台差異值得留意:

  • Android:播放的是「設定/音效與顯示」面板中指定的預設「通知鈴聲」,因此實際聽到的聲音取決於使用者自己的設定。
  • iPhone:會忽略次數參數,因為 iOS 本身並沒有原生的嗶聲 API。PhoneGap 改以多媒體 API 播放音檔來模擬,開發者必須自行提供名為 beep.wav 的檔案,放在 www/root 目錄下,長度須短於 30 秒。

notification.vibrate

讓裝置震動一段時間。

navigator.notification.vibrate(milliseconds);

參數為震動毫秒數,1000 毫秒等於 1 秒(Number)。支援平台:Android、BlackBerry(OS 4.6)、BlackBerry WebWorks(OS 5.0 以上)、iPhone。

簡短範例:

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

iPhone 上的行為不同:時長參數會被忽略,震動長度固定為系統預先設定的值,因此下列寫法效果相同:

navigator.notification.vibrate();
navigator.notification.vibrate(2500);   // 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">
        document.addEventListener("deviceready", onDeviceReady, false);

        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>

實務上提醒一句:震動與音效都應該由使用者的主動操作觸發,例如在點擊事件或遊戲結束的瞬間呼叫,而不是頁面載入時自動播放,否則容易招致使用者反感,也可能被系統靜音或省電機制抑制。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved