Başarılar

Başarılar, kullanıcılarınızın oyununuzdaki etkileşimini artırmanın harika bir yolu olabilir. Oyuncuları normalde kullanmayabilecekleri özelliklerle deneme yapmaya veya oyununuza tamamen farklı oyun tarzlarıyla yaklaşmaya teşvik etmek için oyununuza başarılar ekleyebilirsiniz. Başarılar, oyuncuların ilerleme durumlarını karşılaştırmaları ve eğlenceli bir rekabete girmeleri için de kullanılabilir.

Platformunuzda başarıları nasıl uygulayacağınızı öğrenmek için İstemci uygulamaları bölümüne bakın.

Özellikler

Başarıların nasıl çalıştığını anlamak için bunlarla ilişkili bazı özellikler hakkında bilgi edinmeniz gerekir.

Bu temel öğeler her başarıyla ilişkilendirilir:

  • Id, Google Play Console tarafından oluşturulan benzersiz bir dizedir. Bu benzersiz kimliği, oyun istemcilerinizde başarıya referans vermek için kullanırsınız.
  • Ad, başarının kısa adıdır (örneğin, "Pieman"). Değer en fazla 100 karakter olabilir.
  • Açıklama, başarınızla ilgili kısa bir açıklamadır. Bu metin genellikle oyuncunuza başarıyı nasıl kazanacağını söyler (örneğin, "Gün batımından önce limonlu beze yapın"). Değer en fazla 500 karakter olabilir.
  • Simge, başarınızla ilişkilendirilmiş kare bir simgedir. Başarı simgelerinizi oluştururken en iyi uygulamalar için Simge Kuralları bölümüne bakın.
  • Liste sırası, bir oyuncu oyununuzla ilişkili başarıları görüntülediğinde kilitli başarıların göründüğü sıradır. Bu, istediğiniz sırada olabilir. Kilidi açılan başarılar, kazanılma sırasına göre listenin en üstünde gösterilir.

Eyalet

Başarılar üç farklı durumda olabilir:

  • Gizli başarı, başarıyla ilgili ayrıntıların oyuncudan gizlendiği anlamına gelir. Play Games Hizmetleri, başarı gizli durumdayken başarı için genel bir yer tutucu açıklama ve simge sağlar. Oyununuzla ilgili çok erken açıklamak istemediğiniz bir spoiler içeren başarıları gizlemenizi öneririz (ör. "Baştan beri hayalet olduğunuzu keşfedin!").
  • Açıklanmış bir başarı, oyuncunun başarıdan haberdar olduğu ancak henüz kazanmadığı anlamına gelir. Çoğu başarı, açıklanmış durumda başlar.
  • Kilidi açılmış bir başarı, oyuncunun başarıyı başarıyla kazandığı anlamına gelir. Başarıların kilidi çevrimdışı olarak açılabilir. Oyun internete bağlandığında, kilidi açılan başarı durumunu güncellemek için Play Oyun Hizmetleri ile senkronize edilir.

Artımlı başarılar

Başarılar standart veya artımlı olarak belirlenebilir. Genellikle, artımlı başarılar, oyuncunun daha uzun bir süre boyunca başarıyı kazanmaya yönelik kademeli ilerleme kaydetmesini içerir. Oyuncu, artımlı başarıya doğru ilerledikçe oyuncunun kısmi ilerleme durumunu Play Games Hizmetleri'ne bildirebilirsiniz.

Google Play hizmeti, ilerleme bilgilerini takip eder, oyuncu ilgili başarıyı açmak için gereken ölçütleri karşıladığında oyunu uyarır ve oyuncuya bu hedefe ulaşmak için ne kadar ilerlediğini bildirir.

Oyuncunun %23 ilerleme kaydettiğini gösteren örnek bir artımlı başarı.
Oyuncunun %23 ilerleme kaydettiğini gösteren artımlı başarı.

Aşamalı başarılar, oyun oturumları arasında birikimli olarak kazanılır ve ilerleme durumu oyundan kaldırılamaz veya sıfırlanamaz. Örneğin, "50 oyun kazan" artımlı başarı olarak değerlendirilir. Oyuncu bir oyunu kaybettiğinde ilerleme durumu sıfırlanacağından "Arka arkaya 3 oyun kazan" gibi bir görev olmaz. "5.000 poker çipine sahip ol" da uygun olmaz. Çünkü oyuncular oynarken çip kazanabilir ve kaybedebilir. Son iki başarı için oyuncunun "Arka arkaya kazanma" durumunu veya toplam çip sayısını takip etmek ve oyuncu kazandığında standart başarıların kilidini açmak sizin sorumluluğunuzdadır.

Aşamalı başarı oluştururken kilidini açmak için gereken toplam adım sayısını tanımlamanız gerekir (bu sayı 2 ile 10.000 arasında olmalıdır). Kullanıcı başarıyı açmaya doğru ilerledikçe, kullanıcının attığı ek adım sayısını Play Games Hizmetleri'ne bildirmeniz gerekir. Toplam adım sayısı, kilidi açma değerine ulaştığında başarı kilidi açılır (gizlenmiş olsa bile). Kullanıcının kümülatif ilerleme durumunu saklamanız gerekmez.

Puan

Başarılarla ilişkili bir puan değeri vardır. Oyuncunun puanı 5'in katı olmalıdır ve bir oyunda tüm başarılar için toplamda 1.000'den fazla puan olamaz (daha az olabilir). Ayrıca, hiçbir başarı 200'den fazla puan içermez.

Deneyim puanlarını (XP) takip etme

Oyuncular, Play Games'in etkin olduğu oyunlarda başarı kazandıkça oyun profillerinde seviye atlayabilir. Oyuncular, bir başarıyla ilişkili her puan için bu başarıyı kazandıklarında 100 deneyim puanı (XP) kazanır. Başka bir deyişle:

XP for an achievement = 100 * (point value for the achievement)

Play Games Hizmetleri, her oyuncunun kazandığı deneyim puanlarını takip eder ve oyuncu "seviye atlamak" için yeterli puanı kazandığında Google Play Games uygulamasına bildirim gönderir. Oyuncular, Google Play Games uygulamasındaki Profil sayfasından seviyelerini ve deneyim puanı geçmişlerini görüntüleyebilir.

Minimum başarı sayısı

Başarıları entegre eden bir oyunun yayınlanmadan önce en az beş başarısı olmalıdır. Beşten az başarıyla test yapabilirsiniz ancak oyununuzu yayınlamadan önce en az beş başarı oluşturmanız önerilir.

Maksimum başarılar

Başarı sayısı, puan sınırları ve dağıtımıyla sınırlıdır. Maksimum puan sayısı 1.000 ve her başarıya 5 puan verildiği için maksimum başarı sayısı 200'dür. Ancak, başarılara daha fazla puan atanırsa sonuç olarak mevcut başarıların sayısı azalır.

Başarı ekle

Google Play Console'u kullanarak ilk kez başarı oluşturmak için iki yöntem bulunur:

Başarı oluşturma

Yeni ve yayınlanmamış bir oyun için başarı oluşturmak istiyorsanız aşağıdaki adımları uygulayın:

  1. Google Play Console'da bir oyun seçin.
  2. Google Play Games Hizmetleri - Başarılar sayfasında (Büyüme > Google Play Games Hizmetleri > Kurulum ve yönetim > Başarılar), Başarı oluştur'u seçin.
  3. Başarı ekle sayfasında formu doldurun.
  4. Taslak olarak kaydet'i tıklayın.
  5. Başarı oluşturduktan sonra oyununuzu yayınlamanız gerekir.

Daha fazla başarı ekleme

Mevcut başarılarınız varsa ve daha fazla başarı eklemek istiyorsanız:

  1. Google Play Console'da bir oyun seçin.
  2. Google Play Games Hizmetleri - Başarılar sayfasında (Büyüme > Google Play Games Hizmetleri > Kurulum ve yönetim > Başarılar) Başarı ekle'yi seçin.

Başarıları içe aktar

Oyununuza aynı anda birden fazla başarı eklemek için aşağıdaki adımları uygulayın:

  1. Başarılarınızı içeren bir ZIP dosyası oluşturun.
  2. Dosyayı yükleyin.

ZIP dosyası hakkında daha fazla bilgi için ZIP dosyası yönergeleri konusunu inceleyin.

Başarıları içe aktarmak için:

  1. Google Play Console'da bir oyun seçin.
  2. Google Play Games Hizmetleri - Başarılar sayfasında (Büyüme > Google Play Games Hizmetleri > Kurulum ve yönetim > Başarılar) Başarıları içe aktar'ı seçin.
  3. Başarıları içe aktar sayfasında Yükle'yi tıklayın.
  4. Yüklenecek ZIP dosyasını seçin.
  5. Taslak olarak kaydet'i tıklayın.
  6. Başarıları içe aktardıktan sonra oyununuzu yayınlamanız gerekir.

Oyununuzu yayınlayın

Oyununuzu test edip yayınladıktan sonra oyununuzdaki tüm başarılar da yayınlanır.

Başarıları düzenleme

Daha önce oluşturduğunuz bir başarıyı düzenlemek için Google Play Console'daki Başarılar sekmesinde ilgili başarıyı seçin. Bu aşamada, başarıyı ilk kez oluştururken kullandığınız formu görürsünüz ve alanlardan herhangi birini istediğiniz gibi düzenleyebilirsiniz.

Bir başarıyı düzenlemeyi bitirdiğinizde Taslak olarak kaydet düğmesini tıklayın. Yeni düzenlenen başarı, "test için hazır" aşamasına geçer ve ardından başarıyı test edebilirsiniz. Düzgün çalışıyorsa açılır listeden Yeniden yayınla'yı seçin. Bu işlem, oyununuzu ve güncellenmiş tüm başarılarınızı herkese açık olarak yeniden yayınlar.

Düzenlemeleri geri alma

Mevcut başarınız hoşunuza gitmezse ve başarınızı eski haline döndürmek isterseniz Google Play Console'daki açılır listeden Geri dön'ü seçin. Bu işlemden sonra tüm başarılarınız daha önce yayınlanan sürüme geri döner.

Başarıları silme

Başarınız yayınlandıktan sonra silinemez.

Önceden yayınlanmış durumdaki bir başarıyı yalnızca ilgili başarı formunun alt kısmındaki Sil düğmesini tıklayarak silebilirsiniz.

Başarıları sıfırlama

Yalnızca taslak durumundaki başarılarınıza ait oyuncu ilerleme verilerini sıfırlayabilirsiniz.

  • Google Play Console'da başarıları sıfırlamak için ilgili etkinlik formunun alt kısmındaki Başarı ilerleme durumunu sıfırla düğmesini tıklayın.
  • Başarı verilerini programatik olarak sıfırlamak için Management API Achievements yöntemlerini çağırın.

Simgeyle ilgili kurallar

Simgeler 512 x 512 PNG, JPEG veya JPG dosyaları olarak oluşturulmalıdır. Bize yalnızca kilidi açılmış başarının simgesini göndermeniz yeterlidir. Ardından, görünür simgenin gri tonlamalı sürümü otomatik olarak oluşturulur. Bu nedenle, kullanıcılarınızın görünür ve kilidi açılan başarıları ayırt edebilmesi için başarı simgelerinizin renkli öğeler içermesini öneririz.

Android kısa iletisinde başarı simgesi gösterildiğinde simgenin üzerine bir daire yerleştirilir ve dış köşeleri gizlenir. Simgenizin bu koşullarda da iyi göründüğünden emin olun.

Örnek başarı simgesi.
Örnek başarı simgesi.

Tüm yerel ayarlarda aynı simge kullanıldığı için simgelere metin veya yerelleştirilmiş içerik eklemeniz önerilmez.

ZIP dosyası yönergeleri

ZIP dosyası kullanarak birden fazla başarıyı tek seferde içe aktarabilirsiniz. ZIP dosyanızda kullanabileceğiniz tam dosya adları için tabloya bakın:

Dosya adı Zorunlu veya İsteğe Bağlı Kabul edilen değerler
AchievementsMetadata.csv Zorunlu Her başarıya ait meta veriler. Özellikler başlıklı makaleyi inceleyin.
AchievementsLocalizations.csv İsteğe bağlı Başarı adları ve açıklamalarını çevirir.
AchievementsIconMappings.csv İsteğe bağlı Başarıları, simge dosyalarıyla eşleştirir.
Simge dosyaları İsteğe bağlı PNG, JPEG veya JPG biçimindeki simgeler.

ZIP dosyasıyla ilgili şartlar:

  • Alt dizin içermez.
  • Benzersiz dosya adları.
  • Yalnızca CSV, PNG, JPEG veya JPG dosyaları.
  • CSV dosyalarında başlık satırı bulunmamalıdır.
  • Her dosya 1 MB'tan küçük olmalıdır.
  • Zip dosyası 203'ten fazla dosya içermemelidir.
  • Toplam ZIP dosyası boyutu 200 MB'tan az olmalıdır.

AchievementsMetadata.csv biçimi

AchievementsMetadata.csv dosyası, her başarıya ait meta verileri içerir. Bilgiler aşağıdaki sırayla virgülle ayrılmış değerler olarak eklenmelidir:

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

Bu alanlar aşağıdaki tabloda açıklanmıştır:

CSV sütun başlıkları Zorunlu veya İsteğe Bağlı Kabul edilen değerler
Name (Ad) Zorunlu Maksimum 100 karakterdir
Description (Açıklama) İsteğe bağlı Maksimum 500 karakterdir
Incremental Value (Artımlı Değer) İsteğe bağlı True veya False
Steps Needed (Gereken Adım Sayısı) Incremental Value, True. ise zorunludur. Sayı (kesirli veya ondalık sayı içermez)
Initial State (İlk Durum) Zorunlu Hidden veya Revealed
Puan Zorunlu 5 ile 200 arasında 5'in katları olan bir sayı
List Order (Liste Sıralaması) İsteğe bağlı Sayı (kesirli veya ondalık sayı içermez, sıfırdan büyüktür)

AchievementsMetadata.csv dosyasıyla ilgili şartlar:

  • Her satırda yedi değer olmalıdır. Bir değeri çıkarmak istiyorsanız boş bırakın.
  • Name ve Description alanları varsayılan yerel ayar olarak kullanılır.
  • Name alanı, tüm başarılarda benzersiz olmalıdır.
  • Şu alanlar virgül içermemelidir: Name ve Description.

Örnek AchievementsMetadata.csv dosyası:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

AchievementsLocalizations.csv biçimi

AchievementsLocalizations.csv dosyası, farklı yerel ayarlardaki kullanıcılara her bir başarıyı açıklamak için gerekli tüm verilerin ayarlandığı isteğe bağlı bir dosyadır. Başarılar, oyun için belirtilen yerel ayarlara göre çevrilir.

Bilgiler aşağıdaki sırayla virgülle ayrılmış değerler olarak eklenmelidir:

   Name, Localized name, Localized description, locale

Bu alanlar aşağıdaki tabloda açıklanmıştır:

CSV sütun başlıkları Zorunlu veya İsteğe Bağlı Açıklama Kabul edilen değerler
Name (Ad) Zorunlu AchievementsMetadata.csv dosyasındaki Name sütunuyla eşleşmelidir. Maksimum 100 karakterdir
Localized name (Yerelleştirilmiş ad) Zorunlu Başarının yerelleştirilmiş adı. Maksimum 100 karakterdir
Localized description (Yerelleştirilmiş açıklama) İsteğe bağlı Başarının, belirtilen yerel ayardaki yerelleştirilmiş açıklaması. Maksimum 500 karakterdir
Locale (Yerel ayar) Zorunlu Yerel ayar kodu (ör. en-US). Yerel ayar belirtmeden önce oyununuza çeviri ekleyin. Varsayılan yerel ayar belirtemeyeceğinizi hatırlatırız.

Desteklenen yerel ayar kodlarını desteklenen diller listesinde bulabilirsiniz.

AchievementsLocalizations.csv dosyasıyla ilgili şartlar:

  • Bir oyundaki başarı adları, her yerel ayar için benzersiz olmalıdır. Örneğin, bir oyun hem en-US hem de fr-FR yerel ayarlarını destekliyorsa en-US için "Achievement1" adlı bir başarı, fr-FR için de "Achievement1" olarak adlandırılabilir.
  • Her satırda dört değer bulunmalıdır. Yerelleştirilmiş açıklama değerini çıkarmak istiyorsanız bu alanı boş bırakın.

Örnek AchievementsLocalizations.csv dosyası:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE

AchievementsIconMappings.csv biçimi

AchievementsIconMappings.csv dosyası, başarılarınızı belirli bir simgeyle eşlemek için kullanılan isteğe bağlı dosyadır. Bilgiler aşağıdaki sırayla virgülle ayrılmış değerler olarak eklenmelidir:

Name, icon filename

Bu alanlar aşağıdaki tabloda açıklanmıştır:

CSV sütun başlıkları Zorunlu veya İsteğe Bağlı Açıklama
Name (Ad) Zorunlu AchievementsMetadata.csv dosyasındaki Name sütunuyla eşleşmelidir.
Icon filename (Simge dosyası adı) Zorunlu Simge dosyanızın adı.

AchievementsIconMappings.csv dosyasıyla ilgili şartlar:

  • Her satırda iki değer bulunmalıdır.
  • Simge dosyaları yalnızca PNG veya JPEG biçiminde olabilir.

ÖrnekAchievementsIconMappings.csv dosyası:

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

Simge dosyaları

AchievementsIconMappings.csv dosyasında referans verdiğiniz simgeler, içe aktardığınız mevcut ZIP arşivinde bulunmalıdır. Daha fazla bilgi için Simgeyle ilgili kurallar konusunu inceleyin.

Başarıların çevirisini ekleme

Oyununuzla ilişkili başarılar için kendi çevirilerinizi belirtebilirsiniz. Bunu yapmadan önce Oyununuza çeviri ekleme bölümünde açıklanan adımları uyguladığınızdan emin olun.

Oyununuza iki şekilde çeviri ekleyebilirsiniz:

  • Birçok yeni başarının çevirisini tek seferde yüklemek için Başarıları içe aktar seçeneğini kullanabilirsiniz. Bu seçeneği, mevcut başarıların çevirilerini yüklemek için kullanamazsınız.

  • Oyununuzdaki her başarı için çeviri ekleyebilirsiniz. Her başarı için kendi çevirinizi eklemek istiyorsanız:

    1. Google Play Console'da oyununuzun Başarılar sekmesini açıp mevcut bir başarıyı seçin.
    2. Başarı ayrıntıları sayfasında, daha önce Oyun ayrıntıları sekmesinde eklediğiniz bir dilin sekmesini seçin.
    3. İlgili dilin başarı ayrıntıları sayfasında başarıyla ilgili çevirilerinizi ekleyerek formu düzenleyin.
    4. Çevrilmiş başarı ayrıntılarınızı kaydetmek için Kaydet'i tıklayın

İstemci uygulamaları

Platformunuzda başarıları nasıl uygulayacağınızı öğrenmek için aşağıdaki kaynaklara göz atın: