Başlamadan önce
Realtime Database kullanabilmek için:
Unity projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.
Unity projeniz zaten Firebase kullanıyorsa Firebase için kaydedilmiş ve yapılandırılmış demektir.
Unity projeniz yoksa örnek bir uygulama indirebilirsiniz.
Firebase Unity SDK'sını (özellikle
FirebaseDatabase.unitypackage
) Unity projenize ekleyin.
Firebase'i Unity projenize eklemenin hem Firebase konsolunda hem de açık Unity projenizde görevler içerdiğini unutmayın (örneğin, Firebase yapılandırma dosyalarını konsoldan indirip Unity projenize taşırsınız).
Verileri Kaydetme
Firebase Realtime Database öğesine veri yazmak için beş yöntem vardır:
Yöntem | Yaygın kullanım alanları |
---|---|
SetValueAsync() |
Verileri tanımlı bir yola yazın veya bu yoldaki verileri değiştirin. Örneğin:
users/<user-id>/<username> . |
SetRawJsonValueAsync() |
Verileri ham JSON ile yazın veya değiştirin. Örneğin, users/<user-id>/<username> . |
Push() |
Veri listesine ekleme Push() işlevini her çağırdığınızda Firebase, user-scores/<user-id>/<unique-score-id> gibi benzersiz tanımlayıcı olarak da kullanılabilen benzersiz bir anahtar oluşturur. |
UpdateChildrenAsync() |
Tanımlanmış bir yolun anahtarlarından bazılarını tüm verileri değiştirmeden güncelleyin. |
RunTransaction() |
Eşzamanlı güncellemeler nedeniyle bozulabilecek karmaşık verileri güncelleyin. |
DatabaseReference alma
Veritabanına veri yazmak için DatabaseReference
örneğine ihtiyacınız vardır:
using Firebase; using Firebase.Database; public class MyScript: MonoBehaviour { void Start() { // Get the root reference location of the database. DatabaseReference reference = FirebaseDatabase.DefaultInstance.RootReference; } }
Referansta veri yazma, güncelleme veya silme
Temel yazma işlemleri
Temel yazma işlemleri için SetValueAsync()
kullanarak verileri belirtilen bir referansa kaydedebilir ve bu yoldaki mevcut verilerin yerini alabilirsiniz. Bu yöntemi, kullanılabilir JSON türlerine karşılık gelen türleri aşağıdaki gibi iletmek için kullanabilirsiniz:
string
long
double
bool
Dictionary<string, Object>
List<Object>
Türü belirlenmiş bir C# nesnesi kullanıyorsanız nesneyi ham JSON'a dönüştürmek ve SetRawJsonValueAsync()
işlevini çağırmak için yerleşik JsonUtility.ToJson()
işlevini kullanabilirsiniz.
Örneğin, aşağıdaki gibi bir User sınıfınız olabilir:
public class User { public string username; public string email; public User() { } public User(string username, string email) { this.username = username; this.email = email; } }
SetRawJsonValueAsync()
ile kullanıcı eklemek için:
private void writeNewUser(string userId, string name, string email) { User user = new User(name, email); string json = JsonUtility.ToJson(user); mDatabaseRef.Child("users").Child(userId).SetRawJsonValueAsync(json); }
SetValueAsync()
veya SetRawJsonValueAsync()
öğelerini bu şekilde kullanmak, belirtilen konumdaki verilerin (alt düğümler dahil) üzerine yazar. Ancak yine de nesnenin tamamını yeniden yazmadan bir alt öğeyi güncelleyebilirsiniz. Kullanıcıların profillerini güncellemelerine izin vermek istiyorsanız kullanıcı adını aşağıdaki şekilde güncelleyebilirsiniz:
mDatabaseRef.Child("users").Child(userId).Child("username").SetValueAsync(name);
Veri listesine ekleme
Çok kullanıcılı uygulamalarda bir listeye veri eklemek için Push()
yöntemini kullanın.
Push()
yöntemi, belirtilen Firebase referansına her yeni alt öğe eklendiğinde benzersiz bir anahtar oluşturur. Listedeki her yeni öğe için bu otomatik olarak oluşturulan anahtarları kullanarak birden fazla istemci, yazma çakışmaları olmadan aynı anda aynı konuma alt öğeler ekleyebilir. Push()
tarafından oluşturulan benzersiz anahtar, zaman damgasına dayalıdır. Bu nedenle, liste öğeleri kronolojik olarak otomatik olarak sıralanır.
Push()
yöntemi tarafından döndürülen yeni verilere yapılan referansı kullanarak çocuğun otomatik olarak oluşturulan anahtarının değerini alabilir veya çocuk için veri ayarlayabilirsiniz. Push()
referansında Key
çağrısı yapıldığında otomatik olarak oluşturulan anahtarın değeri döndürülür.
Belirli alanları güncelleme
Bir düğümün belirli alt öğelerine diğer alt düğümleri üzerine yazmadan aynı anda yazmak için UpdateChildrenAsync()
yöntemini kullanın.
UpdateChildrenAsync()
çağrısı yaparken anahtar için bir yol belirterek alt düzeydeki alt değerleri güncelleyebilirsiniz. Veriler daha iyi ölçeklendirme için birden fazla konumda depolanıyorsa veri dağıtımı kullanarak bu verilerin tüm örneklerini güncelleyebilirsiniz. Örneğin, bir oyunda aşağıdaki gibi bir LeaderboardEntry
sınıfı olabilir:
public class LeaderboardEntry { public string uid; public int score = 0; public LeaderboardEntry() { } public LeaderboardEntry(string uid, int score) { this.uid = uid; this.score = score; } public Dictionary<string, Object> ToDictionary() { Dictionary<string, Object> result = new Dictionary<string, Object>(); result["uid"] = uid; result["score"] = score; return result; } }
Oyun, LeaderboardEntry oluşturmak ve aynı anda bunu son skor feed'i ve kullanıcının kendi skor listesiyle güncellemek için aşağıdaki gibi bir kod kullanır:
private void WriteNewScore(string userId, int score) { // Create new entry at /user-scores/$userid/$scoreid and at // /leaderboard/$scoreid simultaneously string key = mDatabase.Child("scores").Push().Key; LeaderBoardEntry entry = new LeaderBoardEntry(userId, score); Dictionary<string, Object> entryValues = entry.ToDictionary(); Dictionary<string, Object> childUpdates = new Dictionary<string, Object>(); childUpdates["/scores/" + key] = entryValues; childUpdates["/user-scores/" + userId + "/" + key] = entryValues; mDatabase.UpdateChildrenAsync(childUpdates); }
Bu örnekte, Push()
kullanılarak /scores/$key
adresindeki tüm kullanıcıların girişlerini içeren düğümde bir giriş oluşturulur ve aynı anda Key
ile anahtar alınır. Ardından anahtar, kullanıcının /user-scores/$userid/$key
puanlarında ikinci bir giriş oluşturmak için kullanılabilir.
Bu yolları kullanarak, UpdateChildrenAsync()
için tek bir çağrıyla JSON ağacındaki birden fazla konumda eşzamanlı güncellemeler yapabilirsiniz. Örneğin, bu örnekte her iki konumda da yeni giriş oluşturulur. Bu şekilde yapılan eşzamanlı güncellemeler atomiktir: Tüm güncellemeler başarılı olur veya tüm güncellemeler başarısız olur.
Verileri silin
Verileri silmenin en basit yolu, verilerin konumuna yapılan bir referansta RemoveValue()
işlevini çağırmaktır.
Ayrıca null
veya UpdateChildrenAsync()
gibi başka bir yazma işlemi için değer olarak SetValueAsync()
belirterek de silebilirsiniz. Tek bir API çağrısında birden fazla çocuğu silmek için bu tekniği UpdateChildrenAsync()
ile birlikte kullanabilirsiniz.
Verilerinizin ne zaman işlendiğini öğrenin.
Verilerinizin Firebase Realtime Database sunucusuna ne zaman işlendiğini öğrenmek için devamlılık ekleyebilirsiniz. Hem SetValueAsync()
hem de UpdateChildrenAsync()
, işlemin tamamlandığını bilmenizi sağlayan bir Task
döndürür. Arama herhangi bir nedenle başarısız olursa Görevler IsFaulted
doğru olur ve Exception
özelliği, hatanın nedenini belirtir.
Verileri işlem olarak kaydetme
Eşzamanlı değişiklikler nedeniyle bozulabilecek verilerle (ör. artımlı sayaçlar) çalışırken işlem işlemi kullanabilirsiniz.
Bu işleme Func
veriyorsunuz. Bu güncelleme, Func
verilerin mevcut durumunu bağımsız değişken olarak alır ve yazmak istediğiniz yeni durumu döndürür. Başka bir istemci, yeni değeriniz başarıyla yazılmadan önce konuma yazarsa güncelleme işleviniz yeni geçerli değerle tekrar çağrılır ve yazma işlemi yeniden denenir.
Örneğin, bir oyunda kullanıcıların skor tablosunu en yüksek beş puanla güncellemesine izin verebilirsiniz:
private void AddScoreToLeaders(string email, long score, DatabaseReference leaderBoardRef) { leaderBoardRef.RunTransaction(mutableData => { List<object> leaders = mutableData.Value as List<object> if (leaders == null) { leaders = new List<object>(); } else if (mutableData.ChildrenCount >= MaxScores) { long minScore = long.MaxValue; object minVal = null; foreach (var child in leaders) { if (!(child is Dictionary<string, object>)) continue; long childScore = (long) ((Dictionary<string, object>)child)["score"]; if (childScore < minScore) { minScore = childScore; minVal = child; } } if (minScore > score) { // The new score is lower than the existing 5 scores, abort. return TransactionResult.Abort(); } // Remove the lowest score. leaders.Remove(minVal); } // Add the new high score. Dictionary<string, object> newScoreMap = new Dictionary<string, object>(); newScoreMap["score"] = score; newScoreMap["email"] = email; leaders.Add(newScoreMap); mutableData.Value = leaders; return TransactionResult.Success(mutableData); }); }
İşlem kullanmak, birden fazla kullanıcı aynı anda puan kaydettiğinde veya istemcide eski veriler olduğunda skor tablosunun yanlış olmasını önler. İşlem reddedilirse sunucu, mevcut değeri istemciye döndürür. İstemci, işlemi güncellenmiş değerle tekrar çalıştırır. Bu işlem, işlem kabul edilene veya çok fazla deneme yapılana kadar tekrarlanır.
Verileri çevrimdışı yazma
Bir istemcinin ağ bağlantısı kesilirse uygulamanız doğru şekilde çalışmaya devam eder.
Firebase veritabanına bağlı her istemci, etkin verilerin kendi dahili sürümünü korur. Veriler yazılırken önce bu yerel sürüme yazılır. Ardından Firebase istemcisi, bu verileri uzak veritabanı sunucularıyla ve diğer istemcilerle "en iyi çaba" prensibine göre senkronize eder.
Sonuç olarak, veritabanına yapılan tüm yazma işlemleri, sunucuya herhangi bir veri yazılmadan önce yerel etkinlikleri anında tetikler. Bu sayede uygulamanız, ağ gecikmesinden veya bağlantısından bağımsız olarak yanıt vermeye devam eder.
Bağlantı yeniden kurulduğunda uygulamanız, istemcinin mevcut sunucu durumuyla senkronize olması için uygun etkinlik kümesini alır. Bu işlem için özel kod yazmanız gerekmez.