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/[email protected]/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、選擇:我的項目-> 構建 – 雲數據庫 點擊開通,開通雲數據庫,然後根據華爲文檔要求,創建對象類型和存儲區
在對象類型頁籤,點擊新增,新增一個名爲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