# 1、環境與應用資訊

AGC地址：[https://developer.huawei.com/consumer/cn/service/josp/agc/index.html](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)
  
# 2、Unity環境準備：
官方文件：

[https://docs.unity.cn/cn/Packages-cn/com.unity.huaweiservice@1.3/manual/clouddb.html](https://docs.unity.cn/cn/Packages-cn/com.unity.huaweiservice@1.3/manual/clouddb.html)

1、  下載Unity Hub，安裝Unity

https://unity.cn/releases。 下載安裝就不詳細介紹了。

2、  Android環境配置：可參考如下截圖

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

3、匯入HuaweiServices的Package包：

在Assect Store中搜尋Huawei Services， 找到AGC的包，然後點選Import，匯入相應的包。

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

# 3、AGC環境配置
1、配置華為AGC上的引數：回到AGC控制檯：找到之前建立的App:

[https://developer.huawei.com/consumer/cn/service/josp/agc/index.html](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)

2、選擇：我的專案-> 構建 – 雲資料庫 點選開通，開通雲資料庫，然後根據華為文件要求，建立物件型別和儲存區

[https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-clouddb-get-started#h1-1594006870043-0](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-clouddb-get-started#h1-1594006870043-0)

在物件型別頁籤，點選新增，新增一個名為BookInfo的物件型別，配置如下：

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

在儲存區頁面，點選新增，新增一個名為QuickStartDemo的儲存區

3、服務開通以後，回到專案設定介面，下載最新的json檔案。在我的專案-專案設定-常規-應用下，點選agconnect-services.json下載

將剛下載好json檔案，放到Unity專案Assets / Plugins / Android目錄下：

# 4、設定Android環境：
1、在Player-Publish Setting中啟用Android的自定義清單和gradle

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

2、在Other Setting中配置包名：注意需要和AG官網的包名保持一致：

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

3、配置專案級gradle，此處對應Assets\Plugins\Android路徑下的baseProjectTmeplate.gradle檔案，新增如下內容

```java
allprojects {
        buildscript {
            repositories {
                maven { url 'https://developer.huawei.com/repo/' }
            }
        }
        dependencies {
            classpath 'com.android.tools.build:gradle:3.4.0'
            classpath 'com.huawei.agconnect:agcp:1.4.2.301'
            **BUILD_SCRIPT_DEPS**
        }
    }
        repositories {
            maven { url 'https://developer.huawei.com/repo/' }
        }
    }
```

4、配置應用級gradle，此處對應Assets\Plugins\Android路徑下的LauncherTmeplate.gradle檔案，新增如下內容：

```java
apply plugin: 'com.android.application'
apply plugin: 'com.huawei.agconnect'
 
dependencies {
implementation project(':unityLibrary')
    implementation 'com.android.support:appcompat-v7:28.0.0'
    implementation 'com.huawei.agconnect:agconnect-core:1.2.0.300'
    implementation "com.huawei.agconnect:agconnect-database:1.2.3.301"
    }
```

5、回到AGC介面，匯出物件型別檔案：

1、點選“匯出”，選擇json，將json檔案匯出到Unity專案Assets / Plugins / Android目錄下

2、點選“匯出”，選擇java，選擇“Android”，配置包名，將zip檔案匯出並且解壓到Unity專案Assets / Plugins / Android目錄下

6、生成CloudDB檔案：

在Unity中，點選選單欄的CloudDB Kit - > CloudDB Settting 相應的配置如下：

1、  JavaCode Package Name：配置匯出java檔案時配置的包名

2、  ObjectType JsonFile Path：選擇對應匯出的json檔案：例如我的路徑為‘Assets/Plugins/Andriod/model.json’

3、  Namespace：生成的C# 檔案所用的namespace

4、  Export Path：匯出的C# 檔案的存放路徑

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

# 5、從零開發雲資料庫功能
## 1、點選GameObject- UI –Button，  建立幾個按鈕：
點選按鈕，然後在右側選擇 Add Component， 建立並且新增一個Script檔案。對應的介面佈局如下：

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

## 2、程式碼前置與整合準備：

```java
using System;
using System.Collections;
using UnityEngine;
using HuaweiService;
using HuaweiService.CloudDB;
using HuaweiService.Auth;
using HuaweiServiceDemo;
 
public class testDBDemo : MonoBehaviour
{
    private static AGConnectCloudDB mCloudDB;
    private static CloudDBZone mCloudDBZone;
    private static CloudDBZoneConfig mConfig;
    private static CloudDBZoneQuery mQuery;
    private const string mClouudDBZoneName = "QuickStartDemo";
    private const string bookInfoClass = "com.huawei.agc.clouddb.quickstart.model.BookInfo";
    private const string testAllClass = "com.huawei.agc.clouddb.quickstart.model.TestAll";
    private static CloudDBZoneObjectList<bookinfo> mObjectList = new CloudDBZoneObjectList<bookinfo> ();
 
    // 成功回撥
    public delegate void SuccessCallBack<t>(T o);
    public class HmsSuccessListener<t>:OnSuccessListener{
        public SuccessCallBack<t> CallBack;
        public HmsSuccessListener(SuccessCallBack<t> c){
            CallBack = c;
        }
        public void onSuccess(T arg0)
        {
            Debug.Log("OnSuccessListener onSuccess");
            if(CallBack != null)
            {
                CallBack.Invoke(arg0);
            }
        }
        
        public override void onSuccess(AndroidJavaObject arg0){
            Debug.Log("OnSuccessListener onSuccess");
            if(CallBack !=null)
            {
                Type type = typeof(T);
                IHmsBase ret = (IHmsBase)Activator.CreateInstance(type);
                ret.obj = arg0;
                CallBack.Invoke((T)ret);
            }
        }
    }
    // 失敗回撥
    public delegate void FailureCallBack(HuaweiService.Exception e);
    public class HmsFailureListener : OnFailureListener
    {
        public FailureCallBack CallBack;
 
        public HmsFailureListener(FailureCallBack c)
        {
            CallBack = c;
        }
 
        public override void onFailure(HuaweiService.Exception arg0)
        {
            if (CallBack != null)
            {
                CallBack.Invoke(arg0);
            }
        }
}
    // Start is called before the first frame update
    void Start()
    {
        login();
    }
 
    // Update is called once per frame
    void Update()
    {
 
    }
}
```

## 3、整合認證服務：此處為方便使用，整合匿名認證

```java
public void login()
    {
        AGConnectAuth auth = AGConnectAuth.getInstance();
        auth.signInAnonymously().addOnSuccessListener(new HuaweiOnsuccessListener<signinresult>((signresult) =>
        {
            Debug.Log("sign in successfully." + signresult.getUser().getUid());
 
        })).addOnFailureListener(new HuaweiOnFailureListener((e) =>
        {
            Debug.Log("sign in failed");
        }));
    }
```

# 6、整合雲資料庫介面
## 1、始化以及建立物件型別

```java
    public void CreateObjectType()
    {
        AGConnectCloudDB.initialize(new Context());
        mCloudDB = AGConnectCloudDB.getInstance();
        Debug.Log("CloudDBInstance: " + mCloudDB);
        try
        {
            mCloudDB.createObjectType(ObjectTypeInfoHelper.getObjectTypeInfo());
            Debug.Log("createObjectType:" + mCloudDB );
        }
        catch (System.Exception e)
        {
            Debug.Log("createObjectType: " + e.Message);
        }
    }
```

## 2、openCloudZOne，開啟儲存區

```java
    public void OpenCloudDBZone()
    {
        // Debug.Log("Start OpenCloudDBZone:" + mCloudDB );
        mConfig = new CloudDBZoneConfig("QuickStartDemo",
            CloudDBZoneConfig.CloudDBZoneSyncProperty.CLOUDDBZONE_CLOUD_CACHE,
            CloudDBZoneConfig.CloudDBZoneAccessProperty.CLOUDDBZONE_PUBLIC);
        mConfig.setPersistenceEnabled(true);
        
        Task openDBZoneTask = mCloudDB.openCloudDBZone2(mConfig, true);
        openDBZoneTask.addOnSuccessListener(new HmsSuccessListener<clouddbzone>((cloudDBZone) =>
        {
            mCloudDBZone = cloudDBZone;
            Debug.Log("open clouddbzone2 success");
        }))
        .addOnFailureListener(new HmsFailureListener((HuaweiService.Exception e) =>
        {
            Debug.Log("open clouddbzone2 failed " + e.toString());
        }));
    }
```

## 3、插入資料

```java
    public void upsertBookInfo(){
        if (mCloudDBZone == null)
        {
             Debug.Log("CloudDBZone is null, try re-open it");
            return;
        }
        var bookInfo = new BookInfo { Id = 4, BookName = "test4" };
 
        Task task = mCloudDBZone.executeUpsert(bookInfo);
        task.addOnSuccessListener(new HmsSuccessListener<int>((cloudDBZoneResult) =>
        {
             Debug.Log("upsert " + cloudDBZoneResult + " records");
        }))
```

## 4. 查詢與處理資料並展示

```java
    public void testQueryInfo () {
        mQuery = CloudDBZoneQuery.where (new AndroidJavaClass (bookInfoClass)).equalTo ("shadowFlag", true);
        if (mCloudDBZone == null || mQuery == null) {
            Debug.Log("CloudDBZone or CloudDBZoneQuery is null, try re-open it");
            return;
        }
        Task queryTask = mCloudDBZone.executeQuery (mQuery, CloudDBZoneQuery.CloudDBZoneQueryPolicy.POLICY_QUERY_FROM_CLOUD_ONLY);
        queryTask.addOnSuccessListener (new HmsSuccessListener<clouddbzonesnapshot>> ((snapshot) => {
                processQueryResult (snapshot);
        }))
        .addOnFailureListener (new HmsFailureListener ((exception) => {
                Debug.Log ("Query book list from cloud failed: " + exception.toString ());
        }));
    }
 
    private void processQueryResult (CloudDBZoneSnapshot<bookinfo> snapshot) {
        mObjectList = snapshot.getSnapshotObjects ();
        List<bookinfo> bookInfoList = new List<bookinfo> ();
        try {
            string result = "";
            while (mObjectList.hasNext ()) {
                BookInfo bookInfo = mObjectList.next ();
                bookInfoList.add (bookInfo);
                result += $"{bookInfo.BookName} ";
            }
            Debug.Log ($"QueryResult: {result}");
 
        } catch (System.Exception e) {
            Debug.Log ($"QueryResult : {e.Message}");
        } finally {
            snapshot.release ();
        }
    }
```

# 7、打包測試

1、  點選File – Build and setting，進入打包頁面，在該頁面切換Android Platform。

2、  選擇好對應的裝置以後，點選 Build And Run

3、  然後就可以再Android的 Logcat 中，檢視Unity的相關日誌。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210317144618868.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70)
其中，插入和刪除資料都可以在AGC介面檢視到。

欲瞭解更多詳情，可參考：

雲資料庫Demo：[https://github.com/AppGalleryConnect/agc-demos/tree/main/Android/agc-clouddb-demo-java](https://github.com/AppGalleryConnect/agc-demos/tree/main/Android/agc-clouddb-demo-java)

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

原作者：Mayism</bookinfo></bookinfo></bookinfo></clouddbzonesnapshot></int></clouddbzone></signinresult></t></t></t></t></bookinfo></bookinfo>

Unity平臺 | 快速整合華為AGC雲資料庫服務

相關文章