乐趣区

关于HMS-Core:Unity平台-快速集成华为AGC云数据库服务

# 1、环境与利用信息

版本名称 集成环境 测试设施
agconnect-database:1.2.3.301 Unity 2019.4.17f1c1 光荣 magic2 OPPO Reno2

AGC 地址: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

1、下载 Unity Hub,装置 Unity

https://unity.cn/releases。下载安装就不具体介绍了。

2、Android 环境配置:可参考如下截图

3、导入 HuaweiServices 的 Package 包:

在 Assect Store 中搜寻 Huawei Services,找到 AGC 的包,而后点击 Import,导入相应的包。

3、AGC 环境配置

1、配置华为 AGC 上的参数:回到 AGC 控制台:找到之前创立的 App:

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

在对象类型页签,点击新增,新增一个名为 BookInfo 的对象类型,配置如下:

在存储区页面,点击新增,新增一个名为 QuickStartDemo 的存储区

3、服务开明当前,回到我的项目设置界面,下载最新的 json 文件。在我的我的项目 - 我的项目设置 - 惯例 - 利用下,点击 agconnect-services.json 下载

将刚下载好 json 文件,放到 Unity 我的项目 Assets / Plugins / Android 目录下:

4、设置 Android 环境:

1、在 Player-Publish Setting 中启用 Android 的自定义清单和 gradle

2、在 Other Setting 中配置包名:留神须要和 AG 官网的包名保持一致:

3、配置我的项目级 gradle,此处对应 Assets\Plugins\Android 门路下的 baseProjectTmeplate.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、配置利用级 gradle,此处对应 Assets\Plugins\Android 门路下的 LauncherTmeplate.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 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# 文件的寄存门路

5、从零开发云数据库性能

1、点击 GameObject- UI –Button,创立几个按钮:

点击按钮,而后在右侧抉择 Add Component,创立并且增加一个 Script 文件。对应的界面布局如下:

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、点击 File – Build and setting,进入打包页面,在该页面切换 Android Platform。

2、抉择好对应的设施当前,点击 Build And Run

3、而后就能够再 Android 的 Logcat 中,查看 Unity 的相干日志。


其中,插入和删除数据都能够在 AGC 界面查看到。

欲了解更多详情,可参考:

云数据库 Demo:https://github.com/AppGalleryConnect/agc-demos/tree/main/Android/agc-clouddb-demo-java


原文链接:https://developer.huawei.com/consumer/cn/forum/topic/0203465380835350101?fid=0101271690375130218

原作者:Mayism

退出移动版