PhoneGap/Cordova Notification API

21 Şubat 2013
Bu yazıyı beğendiysen paylaşmayı unutma :)
Pin It

Mobil cihazların tüm bildirim işlemlerini kullanmanıza olanak sağlayan Cordova Notification API ile uygulamalarınızı çok daha kullanışlı hale getirebilirsiniz.

Notification (Bildirim) API 4 metottan oluşur. Bunlar;

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

Şimdi bu metotları sırasıyla inceleyelim.

“notification.alert” Kullanımı

İletişim kutusu şeklinde bir uyarı göstermek için kullanılır.

Kullanım Şekli
navigator.notification.alert(message, alertCallback, [title], [buttonName])

Aldığı Parametreler

message: Mesaj metni. (String)
alertCallback: Mesaj kutusu kapatıldığında yapılması gereken bir işlem varsa bu fonksiyonda tanımlanır. (Function)
title: Mesaj penceresinin başlığı (String) (Opsiyonel, Varsayılan: “Alert”)
buttonName: Buton ismi (String) (Opsiyonel, Varsayılan: “OK”)

Örnek-1:

Kod   
document.addEventListener("deviceready", onDeviceReady, false);
 
function onDeviceReady() {
    alertMetodu();
}
 
function alertMetodu() {
    navigator.notification.alert("Merhaba!", alertCallbackMetodu, "Mesaj Başlığı", "Tamam");
}
 
function alertCallbackMetodu(){
    console.log("Pencere Kapatıldı!");
}

“notification.confirm” Kullanımı

Bir onay iletişim kutusu gösterir. Tıkladığınız onay butonuna göre işlem yapabilirsiniz.

Kullanım Şekli:
navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])

Aldığı Parametreler

message: Mesaj metni. (String)
confirmCallback: – Tıklanan butonun index (1, 2, 3) numarasına göre cevap döndüren bir fonksiyondur. Parametre olarak da bir buttonIndex kullanır. (Function)
title: Mesaj penceresinin başlığı (String) (Opsiyonel, Varsayılan: “Confirm”)
buttonLabels: Virgülle ayrışmış şekilde buton isimleri verebilirsiniz. (String) (Opsiyonel, Varsayılan: “OK,Cancel”)

Örnek-1:

Kod   
document.addEventListener("deviceready", onDeviceReady, false);
 
function onDeviceReady() {
}
 
function onayIste(butonIndex) {
	alert("Seçtiğiniz buton Index'i " + butonIndex);
}
 
function confirmGoster() {
	navigator.notification.confirm(
    	'Çıkmak istediğinize emin misiniz?',
    	onayIste,
    	'ÇIKIŞ',
    	'Hayır,Evet' //Buton indexleri 1 ile başlar ve 1,2,3.. şeklinde devam eder.
	);
}
Kod   
<body>
<p>
    <a href="#" onclick="confirmGoster(); return false;">ÇIKIŞ YAP</a>
</p>
</body>

Onayları ardı ardına isteyebilirsiniz de! Bunun için örneğimizi biraz daha eğlenceli hale getirelim.

Örnek-2:

Kod   
document.addEventListener("deviceready", onDeviceReady, false);
 
function onDeviceReady() {}
 
function onayIste(butonIndex) {
	if (butonIndex == 2){
	 confirmTekrarGoster();
	}
}
 
function onayTekrarIste(butonIndex) {
	if (butonIndex == 2){
	 alert("Çıkışınıza izin verildi!");
	}
}
 
function confirmGoster() {
	navigator.notification.confirm(
		'Çıkmak yapmak istediğinize emin misiniz?',
		onayIste,
		'ÇIKIŞ',
		'Hayır,Evet'
	);
}
 
function confirmTekrarGoster() {
	navigator.notification.confirm(
		'Son kararınız mı?',
		onayTekrarIste,
		'ÇIKIŞ',
		'Hayır,Evet'
	);
}
Kod   
<body>
<p>
    <a href="#" onclick="confirmGoster(); return false;">ÇIKIŞ YAP</a>
</p>
</body>

“notification.beep” Kullanımı

Cihazın bip sesi çalmasını sağlar.

Kullanım Şekli:
navigator.notification.beep(times);

Aldığı Parametreler

times: Bip sesinin kaç kez yineleneceğini sayısı belirtir. (Sayı)

Örnek-1:

Kod   
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() { navigator.notification.beep(2); }

“notification.vibrate” Kullanımı

Belirtilen zaman miktarında cihazı titretir.

Kullanım Şekli
navigator.notification.vibrate(milliseconds)

Aldığı Parametreler

milliseconds: Milisaniye cinsinden süreyi ifade eder. (Not: 1000 milisaniye = 1 saniye)

Örnek-1:

Kod   
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() { navigator.notification.vibrate(2000); }

Bir sonraki yazıda görüşmek üzere..

Benzer Yazılar


DeliPenguen'i Google+'da bulun



  1. Cenk Atalay
    28 Mayıs 2015 - 23:11

    Merhaba hocam, phonegap ile geliştirdiğimiz uygulamada uygulama kapalıyken kullanıcıya özel bildirim gönderebilmemizin bir yolu var mıdır? Teşekkürler.