Bu dokümanda, yerel (C ve C++) oyun motorlarından kare süresi verilerini kaydetmek ve yüklemek için Tuning Fork kitaplığı olarak da bilinen Android Performance Tuner'ın nasıl entegre edileceği açıklanmaktadır.
Unity oyun motoru için Unity kılavuzuna bakın.
Arka plan
Oyun deneyiminin önemli bir bileşeni oluşturma performansıdır. Oluşturma performansı, aşağıdaki iki girişin sonucudur:
- Kare hızı: Bir karenin ne sıklıkta çizildiği.
- Grafik kalitesi ayarları: Grafiklerin yanı sıra simülasyon doğruluğu da dahil olmak üzere bir karenin sunulduğu doğruluk düzeyi.
Oyunlar için iyi oluşturma performansı şu şekilde tanımlanır:
- Kararlı ve tutarlı bir kare hızı (yani istenen sıklıkta oluşturulan karelerin yüzdesi) sunma.
- Kararlılığı korurken kareleri mümkün olan en yüksek frekansta (genellikle oyunun türüne bağlı olarak 30 veya 60 FPS) oluşturma.
- Kullanıcının ekran boyutu ve yoğunluğuna göre ayrıntı düzeyini en üst düzeye çıkarırken istenen, kararlı kare hızını elde etme
Android Frame Pacing kitaplığı, kare sürelerindeki varyasyonun çoğunu sınırlayarak oyunlar için kararlı bir kare hızı sağlar. Kare sürelerindeki kalan varyasyon, oyun sırasında belirli sahnelerde gösterilen ayrıntı düzeyinden ve cihazın grafik özelliklerinden kaynaklanır. Android Performance Tuner'ı kullanarak oyun sırasında kare süresinin hedefinizden daha yavaş veya daha hızlı olduğu zamanları tespit edebilir ve bu sorunları ve fırsatları şunlarla ilişkilendirebilirsiniz:
- Belirli kalite ayarları
- Oyununuzdaki belirli sahneler
- Belirli cihaz modelleri veya cihaz özellikleri
Verileri kaydetme ve yükleme
Tuning Fork kitaplığı, Android Frame Pacing kitaplığı tarafından her karede çağrılan tick işlevlerinden birini kullanır. Kitaplıkta bu işaret bilgileri, histogramlar halinde toplanır ve ardından düzenli olarak bir HTTP uç noktası aracılığıyla Google Play'e yüklenir. Her işaret, bir gösterge anahtarı ve bir not ile ilişkili olarak kaydedilir. Bunların tanımlarını bir protokol arabelleği dosyasında belirtirsiniz.
Gösterge anahtarları
Gösterge anahtarı, kareden gelen işaretin nereden geldiğini gösterir ve her işaret işlevi çağrısına iletilmesi gereken bir tam sayıdır. Android Frame Pacing kitaplığı, swappy_common.h içinde tanımlanan önceden tanımlanmış bir gösterge anahtarı kümesi kullanır.
Frame Pacing kitaplığını kullanmıyorsanız kendi gösterge anahtarlarınızı da tanımlayabilirsiniz.
Ek açıklamalar
Notlar, bir işaret kaydedildiğinde oyununuzun ne yaptığı hakkında bağlamsal bilgiler verir. Örneğin, bir ek açıklama aşağıdakilerden herhangi birini tanımlayabilir:
- Mevcut oyun seviyesi
- Ekranda "büyük patron" var
- Oyun durumuyla ilgili diğer tüm bilgiler
Ek açıklamalar, com.google.tuningfork.Annotation protokol arabelleği mesajı tarafından tanımlanır. Mevcut ek açıklamayı ayarlamak için tanımladığınız mesajın serileştirilmiş halini TuningFork_setCurrentAnnotation yöntemine iletirsiniz. Ardından, başka bir ek açıklama ayarlanana kadar sonraki tüm işaret verileri bu ek açıklamayla ilişkilendirilir. Aşağıda, ek açıklamalar için örnek bir proto tanımı verilmiştir:
import "tuningfork.proto"
enum Level {
INVALID_LEVEL = 0;
Level_1 = 1;
Level_2 = 2;
Level_3 = 3;
}
message Annotation {
optional Level level = 1;
}
Doğruluk parametreleri
Doğruluk parametreleri, oyununuzun performansını ve grafik kalitesini (ör. mesh ayrıntı düzeyi, doku çözünürlüğü ve kenar yumuşatma yöntemi) etkiler. Ek açıklamalar gibi doğruluk parametreleri de com.google.tuningfork.FidelityParams protokol arabelleği mesajı kullanılarak tanımlanır. Aşağıda, doğruluk parametreleri için örnek bir proto tanımı verilmiştir:
import "tuningfork.proto"
message FidelityParams {
int32 texture_quality_level = 1;
int32 shadow_resolution = 2;
float terrain_details_percent = 3;
int32 post_processing_effects_level = 4;
}
Tuning Fork başlatma sırasında, oyunun kullandığı parametrelerin serileştirilmiş halini iletirsiniz. Örneğin, kullanıcı oyun oluşturma ayarlarını değiştirirse bu parametreleri değiştirebilirsiniz. Bu durumda, daha sonra yüklediğiniz veriler yeni parametrelerle ilişkilendirilir.
Google Play'in tanımladığınız ek açıklamaları ve doğruluk parametrelerini anlayabilmesi için bu tanımları içeren protokol arabelleği dosyasının, başlatma ayarlarıyla birlikte oyunun APK'sına eklenmesi gerekir. Ayrıca, verilerinizin Google Play kullanıcı arayüzünde bu parametrelere göre segmentlere ayrılması için APK'nızdaki yaygın doğruluk parametresi kombinasyonlarına varsayılan değerler sağlamanız gerekir. Daha fazla bilgi için Kalite düzeylerini tanımlama bölümüne bakın.
Bellek ve CPU ek yükü
Tuning Fork kitaplığı tarafından kullanılan tüm bellek, oyun sırasında sürprizlerle karşılaşmamak için başlatma sırasında ayrılır. Verilerin boyutu, gösterge anahtarlarının sayısına, olası ek açıklamaların sayısına ve her histogramdaki grup sayısına bağlıdır. Bu değerlerin her birinin, her grup için dört bayt ile çarpılmasıyla elde edilen değerlerin katıdır. Ayrıca, çift arabelleğe alınmış şekilde gönderime olanak tanımak için tüm histogramların iki kopyası vardır.
Gönderim ayrı bir ileti dizisinde gerçekleşir ve tick çağrılarını engellemez. Yükleme bağlantısı yoksa gönderim daha sonra yüklenmek üzere sıraya alınır.
Bir tick işlevini çağırmanın işlem yükü çok azdır: Bu işlev yalnızca histogram grupları dizisinde bir dizin hesaplar ve bir tam sayı sayısını artırır.
Tuning Fork kitaplığını entegre etme
Bu entegrasyon kılavuzu iki bölümden oluşur. İlk bölümde, bir demo uygulaması ve Google Play Console kullanarak uçtan uca testin nasıl çalıştırılacağı açıklanmaktadır. İkinci bölümde, Tuning Fork kitaplığının araç zincirinize nasıl entegre edileceği ve kitaplığın sağladığı işlevlerin nasıl kullanılacağı açıklanmaktadır. Başlamak için aşağıdaki Sonraki bağlantısını tıklayın.