Phonegap (Cordova) 2.0 için bir eklentidir.
For English please see README_EN.md.
Bu projeye BluetoothPlugin'i çatallayarak başlamıştım. Eklenti ile Bluetooth donanımına javascript üzerinden erişilebiliyor. Çatalladığım eklentiyi 2.0 ile çalışacak şekilde düzeltirken bazı eksiklerini gördüm ve yeni özellikler ekledim. Daha sonra da önceki fonksiyonlara verilen isimlerin değişmesi gerektiğini düşündüm. Phonegap eklentilerindeki Bluetooth eklentisi ile farklılıkları olduğundan önceden yazılmış bir kodunuz varsa bu eklentiyi kullanırken yeni API fonksiyonlarına özellikle dikkat etmeniz gerekiyor.
Fonksiyon | Android | En Düşük SDK Sürümü | Ayrıntılar |
---|---|---|---|
isSupported() | Evet | 5 | Bluetooth desteğinin olup olmadığını denetler. |
enable() | Evet | 5 | Kullanıcıdan Bluetooth u açması için isten gönderir. |
disable() | Evet | 5 | Bluetooth u kapatır. |
isEnabled() | Evet | 5 | Bluetooth un açık olup olmadığını kontrol eder. |
getAddress() | Evet | 5 | Çalıştırdığınız cihazın Bluetooth adresini getirir. |
getName() | Evet | 5 | Çalıştırdığınız cihazın Bluetooth taki görünür ismini getirir. |
requestDiscoverable() | Evet | 5 | Çalıştırdığınız cihazın diğer cihazlar tarafından görünmesi için kullanıcıdan izin ister. |
startDiscovery() | Evet | 5 | Keşfedilebilir cihazları tarar. |
cancelDiscovery() | Evet | 5 | Yürümekte olan tarama işlemini iptal eder. |
getBondedDevices() | Evet | 5 | Eşleştirilmiş cihazları getirir. |
fetchUUIDs() | Evet | 15 | Uzak cihazın UUID lerini sorgulayıp getirir. |
connect() | Evet | 5 | UUID kullanarak uzak cihazla bağlantı kurar. |
connectInsecure() | Evet | 10 | UUID kullanarak uzak cihazla güvensiz bağlantı kurar. |
disconnect() | Evet | 5 | Mevcut bağlantıyı sonlandırır. |
listen() | Evet | 5 | Gelen bağlantı isteklerini dinler. |
stopListening() | Evet | 5 | Gelen bağlantıları dinlemeyi durdurur. |
listenInsecure() | Evet | 10 | Gelen güvensiz bağlantı isteklerini dinler. |
stopInsecureListening() | Evet | 10 | Gelen güvensiz bağlantıları dinlemeyi durdurur. |
read() | Evet | 5 | Bağlantı kurulmuş cihazdan veri okur. |
write() | Evet | 5 | Bağlantı kurulmuş cihaza veri yazar. |
Sıradan bir Phonegap projesi oluşturup aşağıdaki dosyaları projeye aynı dizinlerde kopyalayın :
assets/www/bluetooth.js
src/org/apache/cordova/plugin/BluetoothPlugin.java
İpucu: İndirmiş olduğunuz ekentinin ana dizindeyken tüm dizinleri kopyalayıp Eclipse teki projenize sağ tıklayabilirsiniz.
Eğer örnek olarak verilen index.htm i çalıştırmak istiyorsanız aşağıdaki dosyalara da ihtiyacınız olacak:
assets/www/jquery-1.8.0.js
assets/www/cordova-2.0.0.js
Bluetooth eklentisini kullanmadan önce projenizde bazı düzenlemeler yapmanız gerekiyor. Aşağıda bu verilen dosyalarda neler yapmanız gerektiği veriliyor.
Bluetooth yetkisi alablmek için aşağıdaki satırları <manifest>
ve </manifest>
etiketlerinin
arasına girin :
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
Phonegap e yeni eklentinizi tanıtmak için aşağıdaki satırı <plugin>
ve </plugin>
etiketlerinin
arasına girin :
<plugin name="BluetoothPlugin" value="org.apache.cordova.plugin.BluetoothPlugin"/>
API yi javascript e dahil etmek için aşağıdaki satırı <head>
and </head>
etiketlerinin arasına girin :
<script type="text/javascript" charset="utf-8" src="bluetooth.js"></script>
Bununla birlikte javascript nesnesini hazırlamanız gerekiyor. Hazrılama işlemini aşağıda görüleceği üzere onload olayı ile yapabilirsiniz :
var g_bluetoothPlugin = null;
function onload() {
document.addEventListener("deviceready", function() {
g_bluetoothPlugin = cordova.require( 'cordova/plugin/bluetooth' );
}, true);
}
Tam bir örnek için assets/www/index.html dosyasına bakın.
Apache Lisansı, 2.0 Sürümü ile lisanslanmıştır. Ayrıntılı bilgi için LICENSE dosyasına bakın.