共计 6895 个字符，预计需要花费 18 分钟才能阅读完成。
# 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
