# 應用場景
拍照購物服務主要應用於線上購物場景。例如，購物類App整合該服務可以提供圖片搜尋商品功能，使用者拍攝商品影像時，可以利用該功能快速找到想要的商品。

## 一． 開啟服務
1.   在AppGallery Connect上的 我的專案 à 構建 à 機器學習服務 à 配置 à 拍照購物 裡新增商品集：

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210106101450562.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/2021010610151774.png#pic_center)

2.  新增完後需要聯絡ml相關人員來進行稽核，稽核透過後即可新增離線商品，這裡介紹用postman來新增商品。
稽核完成後的商品集：

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/2021010610160416.png#pic_center)

## 二． 簡單新增商品
1.    申請accessToken：
拍照購服務會對每個訪問的請求進行身份驗證，所以無論是.com或.cn提交請求，都需要在請求頭中包含簽名(Authorization)資訊。拍照購服務透過使用使用者在華為應用聯盟申請的clientId和clientSecre獲取accessToken進行對稱加密的方法來驗證請求的傳送者身份，accessToken有效期為一個小時。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210106101748428.png#pic_center)

這裡的URI為https://oauth-login.cloud.huawei.com/oauth2/v2/token

clientId和clientSecre都是在AppGallery Connect中的應用資訊裡的引數。

請求結果示例:

```java
HTTP/1.1 200 OK
Content-Type: text/html;charset=UTF-8
{
    "access_token":"CFyJ7eTl8WIPi9603E7Ro9Icy+K0JYe2qVjS8uzwCPltlO0fC7mZ0gzZX9p8CCwAaiU17nyP+N8+ORRzjjk1EA==",
    "expires_in":3600,
    "token_type":"Bearer"
}
```

2.    新增商品
（1）首先將獲得的token輸入在Authorization的token處，TYPE選Bearer Token

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210106101903552.png#pic_center)

（2）配置post的Headers引數

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210106101934512.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

這裡post的引數為服務地址+訊息頭，中國區的地址為 https://ml-api-drcn.ai.dbankcloud.com 。

URI為/v1/mlkit/snapshop/set/${product-set-id}/product/add，其中${product-set-id}就是申請的商品集的名稱。
HMS-APPLICATION-ID：APK的標識 app_id 華為開發者聯盟申請的client_id。
 X-Request-ID：請求ID 透過UUID.randomUUID()生成。
X-Package-Name：包名package_name 使用者的包路徑。
X-Mlkit-Version：MLKIT版本號。

（3）  最後在Body的raw中配置引數(JSON)。

```java
{
"appPackage":"com.huawei.industrydemo.shopping",
"category": "4",
"customContent": "test",
"images": [{"imageId": "", "region": "", "url": "https://res.vmallres.com/pimages//product/6941487204656/group//800_800_2A4099A441BF0670CA0F6BA0EEF5D70E16430F99A6699CB3.png"}],
"productId": 5,
"productUrl": "https://res.vmallres.com/pimages//product/6941487204656/group//800_800_2A4099A441BF0670CA0F6BA0EEF5D70E16430F99A6699CB3.png"
}
```

其中必須要有的引數為productId、images以及images裡的url。

category ：0-others,1-clothing,2-shoes,3-bags,4-digital & home appliances,5-homegoods,6-toys,7-cosmetics,8-accessories,9-food

customContent ：使用者自定義商品資訊，查詢的時候會返回該引數

productId ：商品ID，用於唯一標識商品，相同商品集不能夠重複；格式:只允許包含大小寫字母數字、-、_

images ：圖片列表

productUrl ：商品的Url，可選引數，查詢的時候會返回該引數

（1）  以上都設定完畢就可以傳送post請求了，成功後返回：
{"retCode":"0","retMsg":"Success"}

3.   刪除商品
既然有新增商品，這裡再介紹一下刪除商品，以便可以更好地除錯。
（1） 第一步和上面一樣都是配置Authorization。
（2） 配置Headers。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210106102159486.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

這裡的是DELETE請求URI為 /v1/mlkit/snapshop/set/${product-set-id}/product/${product-id}
${product-set-id}就是申請的商品集的名稱，${product-id}為商品ID。
其餘引數與上面的基本一致，多了個X-Country-Code：cn，填寫地區資訊。

（3） 刪除不用配置Body的引數，上述2部完成即可傳送，成功刪除時返回：
{"retCode":"0","retMsg":"Success"}

## 三． Demo開發
1.  在專案級gradle裡新增maven倉

```java
buildscript {
repositories {
google()
jcenter()
maven {url 'https://developer.huawei.com/repo/'}
}
dependencies {
...
classpath 'com.huawei.agconnect:agcp:1.4.1.300'
}
}
 
allprojects {
repositories {
google()
jcenter()
maven {url 'https://developer.huawei.com/repo/'}
}
}
```

2.  在應用級的build.gradle裡面加上SDK依賴

```java
dependencies{
// 引入拍照購物服務SDK
implementation 'com.huawei.hms:ml-computer-vision-cloud:2.0.3.300'
}
 
在apply plugin: 'com.android.application' 的下面加上：
apply plugin: 'com.huawei.agconnect'
```

3.  在AndroidManifest.xml檔案裡面申請必要的許可權

```java
<uses-permission android:name="android.permission.CAMERA"></uses-permission>
 <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
 <uses-permission android:name="android.permission.INTERNET"></uses-permission>
```

4.  獲得照片後，建立拍照購物分析器，進行圖片分析

```java
MLApplication.getInstance().setApiKey(AGConnectServicesConfig.fromContext(this).getString("client/api_key"));
 MLRemoteProductVisionSearchAnalyzerSetting setting = new MLRemoteProductVisionSearchAnalyzerSetting.Factory()     // 設定最多返回的商品資訊數。
     .setLargestNumOfReturns(2)     // 設定商品集ID。
     .setProductSetId("demo")     // 設定站點區域
     .setRegion(MLRemoteProductVisionSearchAnalyzerSetting.REGION_DR_CHINA)
     .create();
 MLRemoteProductVisionSearchAnalyzer analyzer =
     MLAnalyzerFactory.getInstance().getRemoteProductVisionSearchAnalyzer(setting);// 透過bitmap建立MLFrame，bitmap為透過拍照獲得的圖片。
 MLFrame frame = new MLFrame.Creator().setBitmap(photo).create();//進行圖片檢測
 Task<list>> task = analyzer.asyncAnalyseFrame(frame);
 task.addOnSuccessListener(new OnSuccessListener<list>>() {
     @Override
     public void onSuccess(List<mlproductvisionsearch> productVisionSearchList) {
         if (productVisionSearchList == null || productVisionSearchList.size() == 0) {
             return;
         }
         for (MLProductVisionSearch productVisionSearch : productVisionSearchList) {
             for (MLVisionSearchProduct product : productVisionSearch.getProductList()) {             // 識別成功的處理邏輯，這裡是獲取商品的url顯示圖片
                 String url = product.getProductUrl();
                 if (url != null && !(url.equals(""))) {
                     MyAsyncTask asyncTask = new MyAsyncTask(resultImg);
                     asyncTask.execute(url);
                     resultText.setText(product.getCustomContent());
                 }                     }
         }
 
     }
 }).addOnFailureListener(new OnFailureListener() {
     @Override
     public void onFailure(Exception e) {       // 識別失敗的處理邏輯
         MLException mlException = (MLException) e;
         Log.e(TAG, "error " + "error code: " + mlException.getErrCode() + "\n" + "error message: "
                 + mlException.getMessage());
     }
 });
```

5.  識別完成，停止分析器，釋放檢測資源。

```java
if (analyzer != null) {
         analyzer.stop();
         }
```

## 四． 效果動圖：

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210106102830906.gif#pic_center)

欲瞭解更多詳情，請參閱：
華為開發者聯盟官網：[https://developer.huawei.com/consumer/cn/hms?ha_source=hms1](https://developer.huawei.com/consumer/cn/hms?ha_source=hms1)
獲取開發指導文件：[https://developer.huawei.com/consumer/cn/doc/development?ha_source=hms1](https://developer.huawei.com/consumer/cn/doc/development?ha_source=hms1)
參與開發者討論請到Reddit社群：[https://www.reddit.com/r/HuaweiDevelopers/](https://www.reddit.com/r/HuaweiDevelopers/)
下載demo和示例程式碼請到Github：[https://github.com/HMS-Core](https://github.com/HMS-Core)
解決整合問題請到Stack Overflow：[https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest](https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest)

---
原文連結：[https://developer.huawei.com/consumer/cn/forum/topic/0201436704554280219?fid=18](https://developer.huawei.com/consumer/cn/forum/topic/0201436704554280219?fid=18)

原作者：胡椒</mlproductvisionsearch></list></list>

ML拍照購物功能整合教程分享

相關文章