【Android】camera2 -- YUV格式圖檔

Android5以後的android.hardware.camera被列為「@Deprecated，請改用android.hardware.camera2。」

但就算不提「android.hardware.camera2」的複雜，傳入的照片資料結構本身跟「android.hardware.camera」的差異也非常大，如果要升級，光是改寫相機硬體與權限套件還不夠，還要連照片的轉檔也一併完成。


Android相機預設的檔案格式稱為YUV，它是種「用三種向量的方式來記錄圖片資料」的格式(完全無法理解怎麼實作)，一共有420、422和444三種格式。(但也可以指定相機傳入舊格式檔案，但會造成「無法預覽」，自然也無法進行拍照。這格式的檔案在實用上功能有點不明。)

這檔案的格式技術細節未來需要慢慢補完。



Android使用這種格式的檔案奇妙之處在於：View元件本身幾乎都不支援這個格式的檔案，依然支援傳統RGB(Bitmap)或Drawalbe。

「android.hardware.camera」中取得的是YUV圖片的raw資料格式，也就byte矩陣檔。

但「android.hardware.caemra2」中經由「ImageReader」取得的是YUV圖片的資料格式封裝物件「Image」，這東西並不是YUV檔的實體，也無法直接轉成raw資料格式。

一個Image中有三層「Plane」，每一層都可以視為是對應「YUV」中的一種向量資料，因為是向量，所以每一張照片中的每一層Plane資料格式大小其實都不一定，跟RGB格式不一樣，只要知道的圖片長寬和格式，幾乎就可以順利估算出檔案大小或資料長度。

將Image物件格式轉成raw格式的演算法如下。三層ByteBuffer剛好是依序三層Plane的ByteBuffer資料。

// nv12: true = NV12, false = NV21
    public static byte[] YUV_420_888toNV(ByteBuffer yBuffer, ByteBuffer uBuffer, ByteBuffer vBuffer, boolean nv12) {
        byte[] nv;

        int ySize = yBuffer.remaining();
        int uSize = uBuffer.remaining();
        int vSize = vBuffer.remaining();

        nv = new byte[ySize + uSize + vSize];

        yBuffer.get(nv, 0, ySize);
        if (nv12) {//U and V are swapped
            vBuffer.get(nv, ySize, vSize);
            uBuffer.get(nv, ySize + vSize, uSize);
        } else {
            uBuffer.get(nv, ySize , uSize);
            vBuffer.get(nv, ySize + uSize, vSize);
        }
        return nv;
    }

但用QRCode Decode的套件:ZXing作測試，它可以接受「android.hardware.camera」的raw資料，但仍無法接收這個格式的資料。所以這個演算法還需要再檢討。

但奇妙的是：這個演算法獲得的raw格式資料確實可以轉成RGB格式檔案/Bitmap物件。

演算法如下。

public static byte[] NV21toJPEG(byte[] nv21, int width, int height, int quality) {
        ByteArrayOutputStream out = new ByteArrayOutputStream();
        YuvImage yuv = new YuvImage(nv21, ImageFormat.NV21, width, height, null);
        yuv.compressToJpeg(new Rect(0, 0, width, height), quality, out);
        return out.toByteArray();
    }

參考連結

https://stackoverflow.com/questions/9325861/converting-yuv-rgbimage-processing-yuv-during-onpreviewframe-in-android

【Android】實際使用Socket傳輸資料

這是在「同一台裝置內的兩個不同APP/線程」要互傳資料時使用Socket的心得。

大致原則跟一般Java的Socket使用並無差異。


1.連線的兩頭都可以使用InetAddress這個物件內的static功能「getLocalHost」來取得IP，不然很有可能會失敗。

2.建議要有一頭使用ServerSocket來當聆聽連線請求端。

3.Socket建立後第一件事是「在迴圈內容重複檢查Connect是否已經建立起來」，因為InputStream/OutputStream本身不會檢查，資料丟進Stream中，即使另一端沒有東西接收也會執行。──建立一個while迴圈，重複檢查Socket的「isConnected」是否傳出false，如果是false就重複執行迴圈，直到是true為止。

4.連線完成務必關閉Stream和Socket。(ServerSocket本身不用關閉，要關閉從ServerSocket執行「accept」後取得的Socket。)

其餘細節跟標準Java Socket和Java Stream的使用沒有差別。

【Andoid Facebook SDK】隱私權測試

Test

本APP絕對不會收集使用者的私人隱私，僅使用Facebook的帳號作為快速登入的信任機制。

【AWS & RDB & EC2】讓已經存在的EC2上的專案存取新建立的RDB instance

這實在是很矛盾的一件事，但RDS DB可以讓外界(非AWS的環境)存取，可是自己內部的EC2要連線卻需要設定層層關卡。

(據說，這是安全需要。其實RDS DB都有對外部連線設下層層保護，並不是單純的只靠帳號密碼和Endpoint而已。反而是內部的雲端伺服器群可能會有安全疑慮，所以反而要層層把關。)



如果沒有特別選擇，其實AWS會自動把使用者建立一組default的VPC。(不知道什麼是VPC的人就比較尷尬，因為我不知道怎麼精準正確的解釋。就先假設它是種為了使用者設計的「沙箱式」的防火牆，在這牆內的任何AWS雲端虛擬主機都可以視為在同一個子網域中。──解釋的很爛。)

官方標準Guide文件「Create VPL Connect RDS DB」並沒有提到這點，就好像它們也不會說「虛擬機建好以後不能修改VPC」。──VPC的內容可以隨意修改，Instance的各項設定也可以隨意修改，唯獨一旦指定VPC，除非Instance整個刪除否則這項設定不會再更動。


所以某些情況下，建立了一組EC2虛擬主機後也在上面安裝了資料庫的人，可能會想要改用AWS RDS DB服務，這時可能就會碰到不知從何下手的困擾。

幸運的是：建立EC2時即使沒有新建VPC，系統也會幫忙設定一組VPC，而且這組VPC內的設定一應俱全。有Subnet、也有SecurityGroup。而且在新建RDS DB Instance時也可以選用這組PVC。

所以如果想要讓EC2可以存取使用RDS DB，只要找到這組VPC即可。

(這組VPC的名稱也可以修改，修改後就可以快速找到相對的Subnet和SecurityGroup，然後進行修改。)

(修改的原則跟新建時的原則並沒有太多不同。所以可以參考剩下的官方文件、將剩餘步驟改成「修改現有EC2 Instance」和「新建RDS DB並使用現有VPC」即可。)

【AWS & RDB】設定中文語系

AWS上有「建立資料庫虛擬機」的服務。(就是一個只有資料庫，除此以外啥都沒有的虛擬機。

(簡單使用過了以後的想法是：)XAMPP這樣的軟體或組站法很興盛，所以大家可能會習慣(以為)把資料庫和服務供應器架在一起是件好事，但其實服務不一定會只有一套，例如「後台」和「前台」可以分開成兩套供應器，而且只要資料庫還活著、服務供應器隨時可以整個打掉重新架構。


比較值得一提的是：AWS上的資料庫預設都不支援中文，因為語系設為latin，所以需要調整。

調整的方式是設定RDB Instance所接受的ParameterGroup。

如果沒有自己進行過「新增ParameterGroup」，那RDB Instance會自動幫使用者設為「預設/default」，這組Group內的參數都不能修改。──所以要自己新增一組後，再到Instance下去修改ParamterGroup的「指向」。


怎麼編寫自己的ParameterGroup？建議參考一下default的內容。到(左邊的面板中)ParamterGroup中把deault group打開，(這個default的名稱並不是絕對的，可能大家的名字都不一樣，所以就一律稱為default就好。)可以看到所有的參數被條列呈現。

用「char」做關鍵字，就可以看到有那些跟語系有關的選項。將參數名稱記錄下來、然後在自己新增的group中用手動輸入的方式輸入，就可以有這個屬性。


但是修改RDB Instance的ParamterGroup設定，需要決定「要即刻生效」還是「等排程」，即使選了「即刻生效」，似乎還是要用「Reboot」以後才會讓設定生效，這是比較奇怪的地方。


=============================

AWS的RDB在使用上跟一般SQL幾乎沒有什麼不同。

要指定連線的帳號密碼、用的Driver也是標準SQL Driver。

只是連線用DB Name會在設定Instance時決定，連線用網址(無IP)會在設定完後的Instance詳細資料內用「Endpoint」的名稱顯示。(挺奇妙的命名邏輯。)

【XAMPP】修改正式網站的首頁，或新增服務 (Windows環境)

1.怎麼將Tomcat下的Java專案新增到Apache中讓外部的網址可以找到它。
2.怎麼修改XAMPP的預設首頁服務。



XAMPP是一套軟體，可以幫助下載的人快速安裝好Apache+MySQL+Tomcat。同時MySQL還附帶phpMyAdmin這套視覺化的管理工具。

問題是XAMPP是預設給PHP設計族群使用的工具，裏頭的Tomcat也是「預設」執行PHP，這並不是什麼「問題」，但這導致在網路上關於它的資訊或討論就很少是針對Java族群。



以單純的在Apache上新增一個PHP Service來說，只要把整個PHP專案資料夾複製到XAMPP下的「htdocs」資料夾即可。(注意！為什麼Apache會自動去htdocs下找網站首頁？這也是個「學問」。)

雖然Java專案一樣只要把專案複製到Tomcat的webapps下，重新啟動的時候Tomcat就會自動執行這個專案，但用瀏覽器時只有在「http://localhost/」下才可以找到這個專案，用IP或外部網址其實找不到。

因為在Apache和Tomcat之間是用一種叫做AJP的方式溝通......完全不知道這是什麼，只知道AJP有兩大系列(是不是只有這兩種？我不肯定！)：mod_jk和mod_proxy_ajp。

一個標準的Apache其實並不包含這些模組，必須要自己去下載模組後安裝(其實只是把檔案複製貼上)到Apache中，並且寫「一卡車」的AJP設定檔，並且在設定檔中寫明了「Apache要怎麼去Tomcat中找到專案」。──XAMPP的好處就是幫使用者省去了這個步驟。(否則安裝Apache並不難。)

接著我們只需要搞懂XAMPP使用的是哪種版本的AJP協定。最標準的作法是到Apache下的module資料夾去找，這兩個模組其實就是檔案名稱，有模組的檔案名稱就表示這個Apache使用了哪一個模組。

(講精準一點來說，我這是預設安裝並架設Apache+Tomcat環境的老兄不會很多事的下載兩套版本的檔案，如果他真的這樣做了，那就只能從設定檔去看他幫Apache選擇使用了哪套，如果他又很多事的兩套都寫了AJP設定檔，那就只能去找看看Apache內部的設定檔「httpd.conf」中指示了會載入哪一套協定。)

XAMPP使用的是mod_proxy_ajp。(如果要尋找額外的資源，可以用這個方式更精準地找到資訊。)



「Localhost」在Server上(疑似)為「127.0.0.1」這個IP的默認。所以要將Tomcat中的Java專案新增到Apache中，必須要用「http://127.0.0.1/[專案名稱]」這樣的方式寫入設定檔。

(XAMPP中)設定檔名稱為「httpd_ajp.conf」。

設定檔的寫法是...

「ProxyPass "/[專案名稱]" "http://127.0.0.1/[專案名稱]"」和「ProxyPassReverse "/[專案名稱]" "http://127.0.0.1/[專案名稱]"」。──1.新增完建議重開Apache。2.「ProxyPassReverse」似乎可以不用加。


完成以上步驟只是讓Apache可以搜尋到Tomcat中的Java專案。

接著到htdoc中找到「index.php」，把裡面的「header('Location: '.$uri.'/dashboard/');」這段程式碼的「dashboard」改成專案名稱，接著應該就可以順利在首頁找到預期看到的專案了。

【Java】JavaMail發送信件

Java的javax.mail系列函數必須要去官網上下載套件才能使用。(去官網搜尋「JavaMailAPI」或「JavaMail」即可。)

到2017年底為止，已經更新到1.4.7版。(我使用的是1.4.2。)


網路上範例很多，以這個範例為基礎，就可以建立一個可以用的雛型。

唯一的問題是要懂得怎麼設定跟MailServer溝通所需要的參數。

譬如Mail的安全驗證有SSL和TLS兩種。(host用的是GMail。)

Properties props = new Properties();
props.put("mail.smtp.host", "smtp.gmail.com");
props.put("mail.smtp.socketFactory.port", "465");
props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.port", "465");

(這是SSL。)

Properties props = new Properties();
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.starttls.enable", "true");
props.put("mail.smtp.host", "smtp.gmail.com");
props.put("mail.smtp.port", "587");

(這是TLS。)

如果設定錯誤會得到AuthenticationFailedException。


如果MailServer使用的是GMail，那就必須要把Mail的安全設定級別調低，否則一樣是得到AuthenticationFailedException。