Unityプラットフォーム| HuaweiAGCクラウドデータベースサービスを迅速に統合

1.環境およびアプリケーション情報

バージョン名	統合環境	試験装置
agconnect-database：1.2.3.301	Unity 2019.4.17f1c1	名誉magic2OPPO Reno2

AGCアドレス：https://developer.huawei.com/consumer/cn/service/josp/agc/index.html

2. Unity環境の準備：

公式文書：

https://docs.unity.cn/cn/Packages-cn/[email protected]/manual/clouddb.html

1. Unity Hubをダウンロードし、Unityをインストールします

https://unity.cn/releases。ダウンロードとインストールについては詳しく説明しません。

2. Android環境の構成：以下のスクリーンショットを参照してください

3.HuaweiServicesパッケージをインポートします。

AssectストアでHuaweiServicesを検索し、AGCパッケージを見つけて、[インポート]をクリックして対応するパッケージをインポートします。

3.AGC環境の構成

1. HuaweiAGCでパラメーターを構成します。AGCコンソールに戻ります。以前に作成したアプリを見つけます。

https://developer.huawei.com/consumer/cn/service/josp/agc/index.html

2.次を選択します。[マイプロジェクト]-> [ビルド]-クラウドデータベース[開く]をクリックしてクラウドデータベースを開き、Huaweiドキュメントの要件に従ってオブジェクトタイプとストレージ領域を作成します。

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

[オブジェクトタイプ]タブで、[追加]をクリックして、BookInfoという名前の新しいオブジェクトタイプを追加します。構成は次のとおりです。

[ストレージ領域]ページで、[追加]をクリックして、QuickStartDemoという名前のストレージ領域を追加します

3.サービスがアクティブ化されたら、プロジェクト設定インターフェイスに戻り、最新のjsonファイルをダウンロードします。[マイプロジェクト]-[プロジェクト設定]-[一般]-[アプリケーション]で、[agconnect-services.json]をクリックしてダウンロードします

ダウンロードしたばかりのjsonファイルをUnityプロジェクトのAssets / Plugins / Androidディレクトリに配置します。

4.Android環境をセットアップします。

1.AndroidのカスタムリストとGradleをPlayer-Publish設定で有効にします

2.その他の設定でパッケージ名を構成します。AGの公式Webサイトのパッケージ名と一致している必要があることに注意してください。

3. Assets \ Plugins \ Androidパスの下のbaseProjectTmeplate.gradleファイルに対応するプロジェクトレベルのgradleを構成し、次のコンテンツを追加します

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. Assets \ Plugins \ Androidパスの下のLauncherTmeplate.gradleファイルに対応するアプリケーションレベルのgradleを構成し、次のコンテンツを追加します。

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キット]-> [CloudDB設定]をクリックします。対応する構成は次のとおりです。

1. JavaCodeパッケージ名：Javaファイルのエクスポート時に構成されたパッケージ名を構成します

2. ObjectType JsonFileパス：対応するエクスポートされたjsonファイルを選択します。たとえば、私のパスは「Assets / Plugins / Andriod /model.json」です。

3.名前空間：生成されたC＃ファイルで使用される名前空間

4.エクスポートパス：エクスポートされたC＃ファイルのストレージパス

5.クラウドデータベース機能をゼロから開発する

1. GameObject- UI -Buttonをクリックして、いくつかのボタンを作成します。

ボタンをクリックし、右側の[コンポーネントの追加]を選択して、スクリプトファイルを作成および追加します。対応するインターフェースレイアウトは次のとおりです。

2.コードの準備と統合の準備：

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.統合認証サービス：使いやすさのためにここに統合された匿名認証

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.オブジェクトタイプを初期化して作成します

    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、ストレージ領域を開きます

    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.データを挿入します

    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.データのクエリと処理、および表示

    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<BookInfo>> ((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. [ファイル]-[ビルドと設定]をクリックしてパッケージページに入り、このページでAndroidプラットフォームを切り替えます。

2.対応する機器を選択したら、[ビルドして実行]をクリックします

3.次に、AndroidLogcatでUnity関連のログを表示できます。

その中で、挿入および削除されたデータは、AGCインターフェースで表示できます。

詳細については、以下を参照してください。

クラウドデータベースのデモ：https://github.com/AppGalleryConnect/agc-demos/tree/main/Android/agc-clouddb-demo-java

---

元のリンク：https://developer.huawei.com/consumer/cn/forum/topic/0203465380835350101?fid=0101271690375130218

著者：メイズム