Skor tabloları

Skor tabloları, hem en sıkı takipçileriniz (herkese açık bir skor tablosunda birincilik için mücadele edecek) hem de daha sıradan oyuncularınız (ilerleme durumlarını arkadaşlarıyla karşılaştırmak isteyen) için oyuncularınız arasında rekabeti artırmanın eğlenceli bir yolu olabilir.

Platformunuz için lider tablolarını nasıl uygulayabileceğinizi öğrenmek üzere İstemci uygulamalarını inceleyin.

Skor tablolarını anlama

Play Oyun Hizmetleri, oluşturduğunuz lider tablonun çoğu yönünü sizin için yönetir. Tipik süreç şu şekilde işler:

  1. Oyun, bir oyunun sonunda (veya belirlediğiniz uygun bir anda) oyuncunun puanını oyun için oluşturduğunuz bir veya daha fazla lider tablosuna gönderir.
  2. Play Games Hizmetleri, bu puanın oyuncunun günlük, haftalık veya tüm zamanların en iyi puanı için mevcut liderlik tablosu girişinden daha iyi olup olmadığını kontrol eder. Bu durumda Play Games Hizmetleri, ilgili skor tablolarını yeni puanla günceller.
  3. Play Oyun Hizmetleri, oyun istemcisine bir puan raporu gönderir. Bu rapor, müşteriye bunun günlük, haftalık veya tüm zamanların en yüksek puanı olup olmadığını bildirir. Aksi takdirde Play Games Hizmetleri, istemciye bu oyuncunun mevcut günlük, haftalık veya tüm zamanların en yüksek puanını bildirir.
  4. Bir oyuncunun skor tablosundaki sonuçlarını almak için bir zaman aralığı (günlük, haftalık veya tüm zamanlar) isteyebilir ve kullanıcının sosyal skor tablosu mu yoksa herkese açık skor tablosu mu görmek istediğini belirtebilirsiniz. Play Games Hizmetleri gerekli tüm filtrelemeleri gerçekleştirir ve ardından sonuçları istemciye geri gönderir.
  5. Bildirilecek çok sayıda skor olduğunda Play Games Hizmetleri yalnızca skor tablosundaki en yüksek skorlara ait verileri döndürür. Ayrıca en yüksek puanlar veya oyuncunun yanındaki puanlar için ham puan verilerini de alabilirsiniz.

Birden fazla skor tablosu

Oyunlarda en fazla 70 skor tablosu olabilir. Örneğin, çok seviyeli bir oyunda her seviye için farklı bir liderler tablosu olabilir. Yarış oyunlarında ise her pist için ayrı bir liderler tablosu olabilir.

Skor tablosu zaman aralıkları

Play Games SDK'sı, oluşturduğunuz her liderlik tablosunun günlük, haftalık ve tüm zamanların sürümlerini otomatik olarak oluşturur. Her zaman aralığı için ayrı skor tabloları oluşturmanız gerekmez.

Günlük lider tabloları, yıl boyunca UTC-7'de ("Pasifik Yaz Saati'ne göre gece yarısı") sıfırlanır.

Haftalık lider tabloları, cumartesi ile pazar arasında gece yarısında, günlük lider tablolarıyla aynı saat diliminde (UTC-7) sıfırlanır.

Herkese açık ve sosyal skor tabloları

Play Games SDK'sı, her bir lider tablonun oyuncuya iki farklı sürümünü gösterebilir:

Sosyal skor tablosu, kullanıcının gruplarındaki (veya daha doğrusu, kullanıcının uygulamanızla paylaşmayı seçtiği grupların üyelerinden) oyun etkinliğini kullanıcıyla paylaşmaya karar veren kişilerden oluşan bir skor tablosudur.

Herkese açık skor tablosu, oyun etkinliğini herkese açık olarak paylaşmayı seçen oyunculardan oluşur. Oyuncunuz oyun etkinliğini herkese açık olarak paylaşmayı seçmediyse bu liderlik tablosunda görünmez.

Skor tablolarını görüntüleme

Mobil istemci kitaplıklarında, listelerin biçimlendirilmesi ve gösterilmesi kitaplıklar tarafından yapılır. Bir oyuncunun belirli bir skor tablosunu görüp göremeyeceğini veya aralarından seçim yapabileceği tüm skor tablolarınızın listesini görüp göremeyeceğini belirtebilirsiniz.

Verilere doğrudan istemci kitaplıklarından erişerek kendi liderlik tablolarınızı da uygulayabilirsiniz.

Özellikler

Skor tabloları oluşturmak ve yönetmek için aşağıdaki skor tablosu özelliklerini bilmeniz gerekir:

Temel bilgiler

Her lider tablosuyla ilişkili olan temel öğeler şunlardır:

  • ID, Google Play Console'un sizin için oluşturacağı benzersiz bir dizedir. Oyun istemcilerinizdeki skor tablosuna referans vermek için bu benzersiz kimliği kullanırsınız.
  • Ad, lider tablosunun kısa adıdır (örneğin, "En Yüksek Puanlar" veya "3. Seviye"). Bu ad en fazla 100 karakter uzunluğunda olabilir.
  • Simge, lider tablonuzla ilişkilendirilecek kare bir simgedir. Liderlik tablosu simgelerinizi oluştururken en iyi uygulamalar için Simge Kuralları başlıklı makaleyi inceleyin.
  • Liste sırası, bir oyuncu oyununuzla ilişkili skor tablolarını görüntülediğinde skor tablosunun gösterileceği sıradır.
  • Sınırlar, skor tablosunda izin verilen skorların alt ve üst sınırlarını tanımlayan isteğe bağlı değerlerdir. Bu sayede, açıkça sahte olan puan gönderimlerini reddedebilirsiniz. Sahte skor gönderdiğini düşündüğünüz oyuncuları uygulamanızdaki tüm skor tablolarından gizlemek için Players.hide seçeneğini de kullanabilirsiniz.

Sıralama tablolarını sıralama

Lider tablolarda iki sıralama türünden biri kullanılabilir:

  • Varsayılan olarak Daha büyük, daha iyi lider tabloları kullanılır. Bu, genellikle oyuncuların puan kazandığı çoğu oyunda göreceğiniz bir durumdur.
  • Daha küçük daha iyidir lider tabloları, daha küçük bir puanın daha iyi olacağı durumlarda bazen kullanılır. Bu tür lider tablolarının en yaygın örnekleri, skorun oyuncunun yarışı tamamlama süresini temsil ettiği yarış oyunlarında görülür.

Skor biçimlendirme

Tüm puanlar skor tablolarına gönderilir ve dahili olarak uzun tam sayılar olarak depolanır. Ancak Play Oyun Hizmetleri, bunları kullanıcıya çeşitli biçimlerde sunabilir:

  • Sayısal skor tabloları, skorları sayı olarak gösterir. Bunlar tam sayı olarak veya sabit sayıda ondalık basamağı olan gerçek sayı olarak gösterilebilir. Puanı tam sayı olarak gönderirseniz ondalık nokta belirtilen konuma eklenir. Örneğin, 314159 olan bir puan, belirttiğiniz ondalık basamağa bağlı olarak 3.14159, 3141.59 veya 314159 olarak gösterilir.

  • Süre lider tablolarında puanlar saat / dakika / saniye/saniyenin yüzde biri biçiminde gösterilir. Puanları milisaniye cinsinden göndermeniz gerekir. Bu nedenle 66032, 1:06.03 olarak yorumlanır.

  • Para birimi skor tabloları, skorları para birimi biçiminde gösterir. Puanları, ana para birimi biriminin 1/1.000.000'ı olarak gönderirsiniz. Örneğin, para biriminizi ABD doları olarak belirttiğinizi varsayarsak 19.950.000 puan $19.95 olarak yorumlanır.

Sayısal lider tabloları özel birimleri de destekler. Örneğin, oyununuzda yüksek puanlar metre cinsinden ölçülüyorsa skor tablonuzun varsayılan birimi olarak "metre"yi belirtebilirsiniz.

Çeviriler ve puan biçimlendirmesi

Mobil istemci kitaplıkları, Play Games Hizmetleri'nden liderlik tablosu verileri istediğinde bu puanların gösterileceği dili ve yerel ayarı belirtir. REST API, yerel ayara dayalı bir dil de belirtmenize olanak tanır. Play Games Hizmetleri, ilgili dile ve yerel ayara uygun biçimlendirilmiş liderlik tablosu puanlarını döndürür. Bu biçimlendirilmiş puanlar, lider tablonuz için çeviri eklemiş olsanız da olmasanız da gösterilir.

Sayısal lider tablolarında sayı biçimi her dile göre farklı şekilde gösterilir. (Örneğin, ABD'de 12,345.78, Fransa'da 12 345,78.) Özel birimler kullanıyorsanız ve oyununuza çeviriler eklediyseniz eklediğiniz her dil için çevrilmiş birimler sağlamanız gerekir. Ardından hizmet, uygun durumlarda bu çevrilmiş birimleri gösterir.

Seçtiğiniz dile bağlı olarak birimlerinizin adlarının farklı sürümlerini sağlamanız gerekebilir. İngilizcede bir öğe için bir sürüme, diğer her şey için başka bir sürüme (ör. "metre" ve "metreler") ihtiyacınız vardır. Öte yandan Polonya'da bir birim, birkaç birim, çok sayıda birim ve diğer her şey için bir sürüm sağlamanız gerekir. Çoğul kuralları hakkında daha fazla bilgi edinmek için Miktar dizelerini(çoğullar) inceleyin.

Süre liderlik tablolarında saat biçimi, oyuncunun diline ve yerel ayarına göre gösterilir. Bu durum, özellikle saniyenin kesirli bölümlerini kullanıyorsanız veya 3'ten fazla basamaklı bir saat değeri varsa (ör. ABD'de 4,815:16:23.42 ve Almanya'da 4.815:16:23,42) fark edilir.

Para birimi lider tablolarında para birimi biçimi, oyuncunun diline ve yerel ayarına göre gösterilir. Ancak para birimini değiştiremezsiniz. Örneğin, para biriminizi ABD doları olarak belirtirseniz oyun ABD'de $19.95, Fransa'da ise 19,95 $ olarak gösterilir. Ancak oyununuzda ABD'de doların, Fransa'da avronun kullanıldığını belirtemezsiniz.

Simgeyle ilgili kurallar

Simgeler 512 x 512 PNG veya JPEG dosyası olarak oluşturulmalıdır. Simgeleriniz çoğu oyun istemcisinde küçültüleceğinden çok fazla ayrıntı içeren simgeler oluşturmaktan kaçının. Alfa kanalı içeren simgeler gönderebilirsiniz. Bu durumda şeffaflık korunur. Skor tablosu simgesi, Android cihazlarda koyu gri bir arka plan üzerinde gösterilir. Bu nedenle, bu durumda iyi sonuç verebilecek bir simge seçin.

Tüm yerel ayarlarda aynı simge kullanılır. Bu nedenle, simgelere metin veya yerelleştirilmiş içerik eklemenizi önermeyiz.

Skor tablosu oluşturma

Bu bölümde, yeni veya mevcut oyunlar için nasıl skor tabloları oluşturacağınız açıklanmaktadır.

Yeni bir oyun için lider tablosu oluşturma

Yeni ve yayınlanmamış bir oyun için skor tablosu oluşturmak istiyorsanız oyununuzun Google Play Console girişine gidin, Büyüme > Play Games Hizmetleri > Kurulum ve yönetim > Skor tabloları'na gidin ve Skor tablosu oluştur düğmesini tıklayın.

Ana Skor Tabloları panelindeki "Skor Tablosu Ekle" düğmesi
Ana Skor Tabloları panelindeki "Skor Tablosu Ekle" düğmesi

Ardından, bu liderlik tablosu için gerekli bilgileri doldurmanız yeterlidir.

"En iyi tur" lider tablosu için doldurulmuş bir form.
"En iyi tur" skor tablosu için doldurulmuş bir form.

Taslak olarak kaydet'i tıkladığınızda lider tablonuz "Taslak" durumunda olur. Oyununuzu yayınladıktan sonra oyununuzun tüm skor tabloları da yayınlanır.

Yayınlanan bir oyun için skor tablosu oluşturma

Daha önce yayınlanmış bir oyun için ek bir lider tablosu oluşturmak istiyorsanız yukarıdaki adımları uygulayın. Bir oyunun güncellenmiş sürümünü test etme hakkında daha fazla bilgi için Oyun Değişikliklerinizi Yayınlama başlıklı makaleyi inceleyin.

Skor tablonuzu test edip memnun kaldıktan sonra oyununuzu yeni skor tablolarıyla yeniden yayınlayabilirsiniz. Bu skor tabloları tüm dünyada kullanıma sunulur.

Skor tablosunu düzenleme

Daha önce oluşturduğunuz bir skor tablosunu düzenlemek için Google Play Console'un Skor Tabloları sekmesinde ilgili skor tablosunu tıklayın. Bu noktada, lider tablosunu ilk kez oluştururken kullandığınız formu görürsünüz ve alanlardan herhangi birini istediğiniz gibi düzenleyebilirsiniz.

Liderlik tablosunu düzenlemeyi tamamladığınızda Taslak olarak kaydet düğmesini tıklayın. Yeni düzenlenen liderlik tablosu "Taslak" durumunda olur. Bu durumda, tabloyu test edebilirsiniz.

Doğru çalışıyorsa liderlik tablosu formunun üst kısmındaki kutudan Değişiklikleri yayınla'yı seçin. Böylece oyununuzu ve güncellenmiş tüm liderlik tablolarınızı herkese açık olarak yeniden yayınlayabilirsiniz.

Düzenlemeyi geri alma

Yeni düzenlediğiniz lider tablosunu beğenmediğinize karar verip önceki iterasyona dönmek isterseniz lider tablosu formunun üst kısmındaki kutudan Geri al'ı seçmeniz yeterlidir. Lider tablonuz, daha önce yayınlanan sürüme geri döner.

Skor tablosunu silme

"Taslak" durumundaki veya yayınlanmış olan lider tablolarını silebilirsiniz. Google Play Console'da bir skor tablosunu silmek için ilgili skor tablosunun formuna gidin ve formun üst kısmındaki Skor tablosunu sil'i tıklayın.

Alternatif olarak, uygulamada bir oyuncunun lider tablosunu gizlemek için Players.hide kodunu da arayabilirsiniz.

Skor tablosunu sıfırlama

Oyuncu ilerleme verilerini yalnızca taslak skor tablolarınız için sıfırlayabilirsiniz.

  • Google Play Console'da skor tablolarını sıfırlamak için ilgili etkinliğin formunun üst kısmındaki İlerlemeyi sıfırla'yı tıklayın.
  • Liderlik tablosu verilerini programatik olarak sıfırlamak için Management API Scoresyöntemlerini çağırın.

Skor tabloları için çeviriler ekleme

Oyununuzla ilişkili skor tabloları için kendi çevirilerinizi belirtebilirsiniz. Bunu yapmadan önce Oyununuza çeviri ekleme bölümünde açıklanan adımları tamamladığınızdan emin olun. Ayrıca, oyununuz için bir veya daha fazla skor tablosu oluşturmuş olmanız gerekir.

Skor tabloları için kendi çevirilerinizi eklemek istiyorsanız Google Play Console'da oyununuzun Skor Tabloları sekmesini açıp mevcut bir skor tablosunu seçin. Liderler tablosu ayrıntıları sayfasında, daha önce Oyun ayrıntıları sekmesinde eklediğiniz bir dilin sekmesini tıklayın. İlgili dilin liderler tablosu ayrıntıları sayfasında, formu ilgili liderler tablosunun çevirilerinizle düzenleyin. Çevrilmiş liderlik tablosu ayrıntılarınızı kaydetmek için Kaydet'i tıklayın.

Skor tablosu puanlarını gizleme

Google Play Games Hizmetleri, değiştirilmiş olabileceğinden şüphelenilen skorları kontrol edip otomatik olarak gizleyen bir skor tablosu değiştirmeye karşı koruma özelliği sunar. Bu özellik yalnızca Android oyunlarında kullanılabilir.

Kurcalama koruması, Android oyununuz için oluşturduğunuz yeni skor tablolarında varsayılan olarak etkindir ancak mevcut skor tablolarında devre dışıdır. Yayınlanmış mevcut skor tablolarınızda kurcalama korumasını etkinleştirmek için aşağıdaki adımları uygulayın:

  1. Google Play Console'da Oyun hizmetleri sekmesini açıp listeden oyununuzu seçin.
  2. Puan tabloları sekmesini açın, ardından müdahale korumasını etkinleştirmek istediğiniz puan tablosu örneğini seçin.
  3. Skor tablosunun bozulmasına karşı korumayı etkinleştir seçeneğini AÇIK duruma getirin.
  4. Kaydet'i tıklayın ve devam edin.
  5. Oyununuzu yayınlayın.

Google Play Console'da bir skor tablosu için kurcalama koruması etkinleştirildikten sonra bu özelliğin geçerlilik kazanması 24 saati bulabilir. Bozulma korumasını etkinleştirmeden önce gönderilen puanlar geriye dönük olarak gizlenmez.

Bazı durumlarda kurcalama korumasını devre dışı bırakmak isteyebilirsiniz (örneğin, oyununuz Android'e ek olarak web'de de çalışıyorsa ve skor tablolarını bu platformlarda paylaşıyorsa).

İstemci uygulamaları

Platformunuz için nasıl liderlik tabloları uygulayacağınızı öğrenmek üzere aşağıdaki kaynaklara göz atın: