實習期的第一個任務就是為專案組預研FACE++智慧人臉識別這一新功能。呼叫曠視FACE++人臉識別介面，進行人臉識別有兩種方式：一是通過先上傳圖片到雲端儲存網站（網盤，雲盤，七牛雲等）獲得圖片檔案對應的URL引數，通過圖片的網路URL引數呼叫FACE++介面；二是在手機客戶端直接上傳檔案呼叫FACE++介面。第二種方式需要通過POST 請求方式上傳圖片檔案的二進位制資料，而我們選擇用Retrofit 2來實現這一功能。接下來主要分析第二種情況。請求URL介面呼叫示例如下：

https://api-cn.faceplusplus.com/facepp/v3/detect/detection?api_key=YOUR_API_KEY&api_secret=YOUR_API_SECRET&img_file=YOUR_IMAGE_FILE&return_attributes=YOUR_ATTRIBUTE

其中：api_key與api_secret欄位分別表示你在官網建立應用時建立的對應api_key和api_secret，img_file 欄位表示要上傳的圖片檔案的二進位制資料，需要用post multipart/form-data 方式上傳；return_attributes 欄位表示需要獲取的人臉屬性，我們這裡獲取人臉對應的性別和年齡資料即可。

Retrofit 2定義網路請求是通過註解的方式，所以自然我們這裡就用到了@POST 註解來提交我們的圖片檔案的二進位制資料，需要注意用@Part MultipartBody.Part 註解來定義我們要上傳的圖片檔案，用@Part("attribute") RequestBody

public interface DetectService {
    @Multipart //請求體有多部分，使用@MultiPart上傳
    @POST("detection/detect") //URL，可以為空
    Call<PhotoBean> detect(
            @Part("api_key") RequestBody request_api_key,
            @Part("api_secret") RequestBody request_api_secret,
            @Part MultipartBody.Part request_img_part,
            @Part("attribute") RequestBody request_attribute
            );
}
 

接下來，我們需要在MainActivity 中呼叫DetectService 介面定義的detect() 方法發起網路請求，在發起網路請求是，我們需要先建立一下介面方法中定義的4個請求引數，具體程式碼如下：

// YOUR_API_KEY，YOUR_API_SECRET，YOUR_ATTRIBUTE
String apiKey = "YOUR_API_KEY";
Stirng apiSecret = "YOUR_API_SECRET";
Stirng attribute = "YOUR_ATTRIBUTE";

// 建立RequestBody，傳入引數："multipart/form-data"，String
RequestBody requestApiKey = RequestBody.create(MediaType.parse("multipart/form-data"), apiKey);
RequestBody requestApiSecret = RequestBody.create(MediaType.parse("multipart/form-data"), apiSecret);
RequestBody requestApiAttribute = RequestBody.create(MediaType.parse("multipart/form-data"), attribute);

// 建立RequestBody，傳入引數："multipart/form-data"，File
RequestBody requestImgFile = RequestBody.create(MediaType.parse("multipart/form-data"), imgFile);
// 建立MultipartBody.Part，用於封裝檔案資料
MultipartBody.Part requestImgPart = 
        MultipartBody.Part.createFormData("img_file", imgFile.getName(), requestImgFile);

// 發起網路請求，上傳圖片我二進位制資料
DetectService service = new DetectService();
Call<ResponseBody> call = service.detect(requestApiKey, requestApiSecret, requestImgPart, requestApiAttribute);
call.enqueue(new Callback<ResponseBody>() {
        @Override
        public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
            // 網路請求成功，處理響應結果
        }

        @Override
        public void onFailure(Call<ResponseBody> call, Throwable t) {
            // 網路請求失敗，錯誤處理
        }
    });

至此，通過Retrofit 2 @POST 註解上傳檔案二進位制資料到伺服器就完成啦，OK！