PhoneGap:掃描QRcode

掃描 QRcode 在我們開發APP的時候,算是滿常使用的功能。PhoneGap API 有提供很簡單的方式讓我們可以在 APP 裡呼叫 QRcode 掃描程式,當然前提是手機裡必須有安裝 QRcode 掃描程式才行。根據測式,系統會自動開啟該手機有安裝的 QRcode 掃描APP,似乎沒有限制要用那一種特定的APP才行,不過若讀者不放心,或是不知道要安裝那一款 QRcode APP 時,可以考慮使用「條碼掃描器」,因為有些程式會限制使用此APP進行掃描。

在我們開始寫程式之前,要記得到 config.xml 宣告使用 QRcode 的擴充 API。在 config.xml 加入下面這行指令即可。

<gap:plugin name="com.phonegap.plugins.barcodescanner" version="2.0.0" />

以下直接列出掃描 QRcode 所需要的必要程式碼,並且以程式碼做解說。



掃描QRcode


首先是在第 8 行引用了 PhoneGap API 的JavaScript,這個檔案會在我們編譯 PhoneGap 程式時,自動加到根目錄(參考用HTML5製作APP),所以不必覺得奇怪這個檔案不知從何而來。接著我們先跳到 25 行,按下連結時開啟 openScanner(),基本上就是呼叫掃描 QRcode 的 function,可以根據自己的需求移動到任何位置,例如開啟網頁時執行,就是 ,相信有點 JavaScript 基礎的人都不會太陌生。

執行 openScanner() 會呼叫第 10 行宣告的 function。API的重點只有第 11 行而已,呼叫 QRcode APP 的程式只要寫這一行,PhoneGap API自動幫你搞定。當然,取得掃描結果後要做什麼事情,仍然是我們必須要寫程式撰寫的。所以第 12 行宣告掃描完成後要做的事情,並且會得到一個 result 的參數儲存掃描的結果,裡面要做什麼事情就由我們自由發揮。16-19 行是掃描程式出現錯誤時的回報,例如手機內沒有安裝任何QRcode掃描APP時,就會產生錯誤。

以上就是 PhoneGap 掃描 QRcode 的程式。