這個專案跟繪文字刮刮樂EmojiScratch使用的核心技術是相同的,其實這個專案才是最早的靈感而建立的,只是因為在研發過程中嘗試了一些UI上的設計,但一直覺得不是很滿意。結果作到一半又基於同樣的技術產生了繪文字刮刮樂這個遊戲,也很快的製作完成,所以反而繪文字刮刮樂這個遊戲先release了,而訊息刮刮樂斷斷續續的修修改改直到這幾天才release。
刮刮樂的製作相關技術可參考繪文字括括樂的記錄,而這個專案比較值得記錄的是關於QR Code掃瞄和顯示的功能。本專案的QR Code程式庫是使用zxing-android-embedded,這是ZXing Barcode Scanner的精簡版本。
一開始的時候我並沒有直接整合QRCode程式庫,而是因為本來手機上己經有安裝BarcodeScanner了,所以可以直接在自己的APP裡面透過Android Intent的方式呼叫BarcodeScanner提供的掃瞄和顯示QRCode的功能。
呼叫BarcodeScanner的掃瞄QRCode功能很簡單,如下:
void scanQrCode(Activity a, int reqCode) { try { Intent intent = new Intent("com.google.zxing.client.android.SCAN"); intent.putExtra("SCAN_MODE", "QR_CODE_MODE"); a.startActivityForResult(intent, reqCode); } catch (Exception e) { downloadScanner(a); } }
顯示QRCode也同樣簡單,如下:
void showQrCode(Activity a, String content) { try { Intent intent = new Intent("com.google.zxing.client.android.ENCODE"); intent.putExtra("ENCODE_TYPE", "TEXT_TYPE"); intent.putExtra("ENCODE_SHOW_CONTENTS", false); intent.putExtra("ENCODE_DATA", content); a.startActivity(intent); } catch (Exception e) { downloadScanner(a); } }
注意到上面二段code都是用try包起來,如果因為手機上沒有預先安裝BarcodeScanner無法使用功能的話,就可以幫user開啟google play下載頁面,讓user自行安裝。
void downloadScanner(Activity a) { Uri uri = Uri.parse("market://details?id=com.google.zxing.client.android"); Intent intent = new Intent(Intent.ACTION_VIEW, uri); a.startActivity(intent); }
在release之前以上面的作法快速且簡單的讓APP可以有掃瞄及顯示QRCode功能是很好,但當要真正release至google play上時,就會有違反google play policies的可能。因為在APP裡會跳出至google play的其它APP安裝頁面,會有虛假廣告的疑慮。所以這時候得要自己把QRCode程式庫整合進APP裡。
選擇zxing-android-embedded作為QRCode程式庫,除了因為它是個精簡版的程式庫,最主要還是因為它的整合非常簡單,按照它的readme上的說明,只要幾行就搞定。
如readme上所說明的,只要在build.grandle裡加上如下幾行,即完成整合。
// Config for SDK 24+ repositories { mavenCentral() } dependencies { implementation 'com.journeyapps:zxing-android-embedded:4.3.0' }
因為TextureView需要硬體加速,所以如下所示manifest裡開啟硬體加速參數。
<application android:hardwareAccelerated="true" ... >
接下來按照readme上的說明,透過使用IntentIntegrator就能很簡單的呼叫掃瞄QRCode的功能。
new IntentIntegrator(this).initiateScan(); // 'this' is the current Activity. // Get the results: @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { IntentResult result = IntentIntegrator.parseActivityResult(requestCode, resultCode, data); if (null != result) { if (null != result.getContents()) { Toast.makeText(this, "Cancelled", Toast.LENGTH_LONG).show(); } else { Toast.makeText(this, "Scanned: " + result.getContents(), Toast.LENGTH_LONG).show(); } } else { super.onActivityResult(requestCode, resultCode, data); } }
而使用BarcodeEncoder則可以產生一內含QRCode的Bitmap物件,有了這個Bitmap就可以指定給UI上的ImageView顯示QRCode了。
try { BarcodeEncoder barcodeEncoder = new BarcodeEncoder(); Bitmap bitmap = barcodeEncoder.encodeBitmap("content", BarcodeFormat.QR_CODE, 400, 400); ImageView imageViewQrCode = (ImageView)findViewById(R.id.qrCode); imageViewQrCode.setImageBitmap(bitmap); } catch(Exception e) { // Handle error. }