Steamworks Belgeleri
Steam Envanteri Öğe Etiketleri
Öğe etiketleri Steam'in kullanıcılara, içerisinde envanter ve pazar arama görünümleri dahil öğeler için olan "Gelişmiş Filtre"
diyaloglarını göstermesine olanak sağlar. Oyuncular hızlı bir şekilde öğeleri görüntülerken istediği nadirlikte öğeleri veya sadece onların karakter sınıfına uyumlu olan öğeleri sıralayabilir.

inventory_tag_filtering.png
Etiketleri kullanmak için ilk olarak kategorileri ve etiketleri direkt olarak Öğe Tanımlamalarında belirleyin, daha sonra
kullanıcı tarafından görülebilen yerelleştirilmiş dizeleri İngilizce olarak veya desteklemek istediğiniz diğer dillerde sağlayın. En az bir İngilizce yerelleştirme dizesine sahip olmayan etiketler
envanter özellikleri tarafından yok sayılacaklardır.

Öğe tanımı içerisinde kullanılacak olan değerler kısa ve basit metin belirteçleri olmalıdır. Bu belirteçler her dil için yerelleştirilmiş dizeleri belirlemek için bir anahtar olarak kullanılırlar. Bu belirteçler kullanıcıya direkt olarak asla gösterilmez.

Öğe Etiketi Yerelleştirmesi

Öğeleriniz için etiketleri tanımladıktan sonra, onları kullanıcılara görülebilir yapmak için onlara en azından İngilizce ama tercihen bütün desteklenen diller için de
kullanıcı tarafından görülen çeviriler sağlamalısınız. Bu, SteamWorks ayarlamanızın bir parçası olarak, uygulamanızın Envanter Hizmeti sayfasından da ayarlanabilir.

inventory_tag_localize.png

Öğe Etiket Formatı

tag alanı kategorileştirilmiş belirteçlerin bir listesi olarak, ";" karakteri ile ayrılmış bir şekilde sunulmalıdır.
Her belirteç, ";" karakteri ile ayrılmış bir şekilde bir kategori belirteci ve bir değer belirteci içermelidir.

<tag_list>: <tag_pair> { ";" <tag_pair> } <tag_pair>: <category_token> ":" <tag_token>

Öğe Etiketi Örneği

"tags":"class:elf;farms:potato;rarity:legendary;type:character;handed:ambi" ... "tags":"class:troll;farms:gold;rarity:common;type:character;handed:left"

Öğe Başına Etiketler


Ne zaman bir öğe bir generator, playtimegenerator veya bundle tarafından oluşturulsa, o öğeye hayatı boyunca saklayacağı ve sahiplik değişiklikleri boyunca devam edecek etiketler verebilirsiniz.

Bu etiketler diğer öğe özellikleri ile birlikte otomatik olarak Steam İstemcisine gönderilir ve özellik ismi "tags" ile birlikte ISteamInventory::GetResultItemProperty() çağrısı ile çağrılabilir. Etiketler sağlanan dize alanında getirilecektir ve ; karakteri ile sınırlanır.

Etiketleri atamanın basit bir yolu, oluşturulan öğe tanımlamasında onları tanımlamak olabilir. Basitçe tags alanı içerisindeki herhangi bir generator veya playtimegenerator öğe tanımlamaları, oluşturulan herhangi bir öğeye kopyalanacaktır.

Örnek


Oluşturucu A'nın %10'luk bir şans ile Efsanevi Oluşturucu'dan bir öğeyi oluşturma şansı vardır. Ve %90'lık bir şans ile de Yaygın Oluşturucu'dan bir öğe oluşturma şansı vardır. Oluşturucu A aynı zamanda color:red etiketini uyguluyor olsun. Efsanevi Oluşturucu quality:legendary etiketini uygular ve bir kılıç veya kalkan öğesi oluşturur. Öte yandan Yaygın Oluşturucu quality:common etiketini uygular ve bir kılıç veya kalkan öğesi oluşturur.

itemdefid: 10 type: item name: Kılıç itemdefid: 11 type: item name: Kalkan itemdefid: 100 type: generator name: Oluşturucu A bundle: 101x1;102x9 tags: color:red itemdef: 101 type: generator name: Efsanevi Oluşturucu bundle: 10;11 tags: quality:legendary itemdef: 102 type: generator name: Yaygın Oluşturucu bundle: 10;11 tags: quality:common

Etiketleri atmanın başka bir yolu, tag_generator öğe tanımı türünü kullanmaktır. Bu özel öğe tanımında (aslında öğe oluşturmaz) seçilecek belirli bir etiket seti ve onların olasılıklarını tanımlamalısınız. Bir generator, playtimegenerator veyabundle öğe tanımı içerisindekitag_generators alanını, bütün etiket oluşturucuların öğe tanım kimlikleri ile ayarlamanız gerekli. Bu etiket oluşturucular bütün alt öğelere uygulanacaktır.

Etiket Oluşturucu Örneği


Oluşturucu A ya bir kılıç ya da bir kalkan oluşturur, ona color:red etiketini uygular ve daha sonra Etiket Oluşturucu Kalitesini ve Etiket Oluşturucu Efektlerini yeni öğeye uygular. Etiket Oluşturucu Kalitesinin %10'luk bir şans ile quality:legendary etiketini ekleme şansı varken %90'lık bir şans ile quality:common etiketini uygulama şansı vardır. Etiket Oluşturucu Efektleri fx:flames, fx:sparks veya fx:lasers etiketlerinden herhangi birisini uygulamak için eşit şansa sahiptir. İşlem bir "Efsanevi Kırmızı Alevli Kalkan" veya bir "Yaygın Kırmızı Lazerli Kılıç" ile sonuçlanabilir.

itemdefid: 10 type: item name: Kılıç itemdefid: 11 type: item name: Kalkan itemdefid: 100 type: generator name: Oluşturucu A bundle: 10;11 tags: color:red tag_generators: 101;102 itemdefid: 101 type: tag_generator name: Etiket Oluşturucu Kalitesi tag_generator_name: quality tag_generator_values: legendary:1;common:9 itemdefid: 102 type: tag_generator name: Etkiket Oluşturucu Efektleri tag_generator_name: fx tag_generator_values: flames;sparks;lasers

tag_generators alanı için olan format, uygulanmasını istediğiniz etiket oluşturucularının bütün öğe tanımı kimliklerinin ";" karakteri ile ayrılmış bir listesidir.

tag_generator öğe tanımları için hem tag_generator_name alanını hem de tag_generator_values alanını tanımlamanız gerekmekte.

tag_generator_name alanı yukarıda belirtilen kategori belirteci ile aynıdır.

tag_generator_values alanı, ";" karakteri ile ayrılmış tag_token:chance listesidir. Eğer şans verilmez ise varsayılan değeri 1'dir.