jsWaffle for Android マニュアル

jsWaffle は、Androidの標準ブラウザが持つ機能を全て兼ね備えており、以下に紹介する独自APIを使うことで、Androidの持つ固有のAPIも使うことができます。

Androidの各種機能にアクセスする

jsWaffle を使うと、Android標準ブラウザでは利用できないセンサーなどの機能を利用できます。HTMLの先頭<HEAD>タグに以下のようなタグを挿入します。(※jsWaffle.js を www フォルダの中に配置した場合です。）

<script type="text/javascript" src="./jsWaffle.js"></script>

すると、JavaScriptのコードの中で、droid.xxx() のような形式で、jsWaffle の APIにアクセスできます。

ただし、これらのAPIを使う場合、実行権限をAndroidManifest.xmlに追記する必要があります。

...
<!-- バイブ機能を使うとき -->
<uses-permission android:name="android.permission.VIBRATE"/>
<!-- インターネットへのアクセスを使う時 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- GPSを使う時 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- SDカードなどへ書き込みを行う時 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
...

端末情報の機能

マニュアル/端末情報の機能
- droid.getDisplayInfo()
- droid.getSystemMemory()
- droid.getMemoryInfo()
- droid.hasSDCard()
- droid.getSDCardPath()
- droid.getAndroidVersionRelease()
- droid.getAndroidVersionInt()
- droid.getAndroidId()

BEEPやバイブなど通知系の機能

マニュアル/BEEPやバイブなど通知系の機能
- droid.beep()/droid.ring()
- droid.vibrate()
- droid.makeToast()

マルチメディア系の機能

マニュアル/マルチメディア系の機能
- droid.loadSoundPool()/droid.playSoundPool()
- droid.playSound()/droid.stopSound()
- droid.startIntent() ... YouTubeの再生

位置情報の利用/GPS

マニュアル/位置情報の機能
- droid.getCurrentPosition()
- droid.watchPosition()
- droid.clearWatchPosition()

傾きセンサー/シェイク

マニュアル/傾きセンサー
- droid.watchAccel(callback) .. 傾きセンサーを開始
- droid.clearAccel() ... センサーをキャンセル
マニュアル/シェイク
- droid.watchShake(fn) ... シェイクを始めた時に fn を実行する

インテント操作(カメラ/SMS/メール/HTML)

マニュアル/インテント操作
- droid.startIntent(uri) ... Intentを起動する
- droid.startIntentForResult(uri, callback) ... Intentを起動して結果をcallbackで受け取る
- droid.scanBarcode(callback, mode, show_help) ... バーコードリーダーアプリを起動してバーコードを読み取る
- scanQRCode(callback, show_help) ... QRコードを読み取る

ローカルストレージ

マニュアル/設定の保存
- HTML5の window.localStorage のエミュレート
- localStorage.setItem()/getItem()/removeItem()/clear()
- droid.pref_get()/pref_set()/pref_remove()/pref_clear()