Bu konuda, diğer adıyla Android Performance Tuner'ın nasıl entegre edileceği açıklanmaktadır Yerel (C) içinden kare süresi verilerini kaydedip yüklemek için Tuning Fork kitaplığı ve C++) oyun motorları.
Unity oyun motoru için Unity rehberine göz atın.
Arka plan
Oyun deneyiminin temel bileşenlerinden biri oluşturma performansıdır. Oluşturma aşağıdaki iki girdinin sonucudur:
- Kare hızı: Bir karenin ne sıklıkta çizildiğidir.
- Grafik kalite ayarları: Bir karenin sunulduğu kalite düzeyi, ve grafikler dahil.
Oyunlarda iyi oluşturma performansı aşağıdaki şekilde tanımlanır:
- İstikrarlı ve tutarlı bir kare hızı (yani, istediğiniz sıklıkta oluşturulur).
- Çerçeveler korunarak mümkün olan en yüksek sıklıkta oluşturulur kararlılık (oyun türüne bağlı olarak genellikle 30 veya 60 FPS).
- Ekran boyutları ve ekran boyutları göz önünde bulundurulduğunda, kullanıcılar için ayrıntı seviyesini en üst düzeye çıkarma ve istenen istikrarlı kare hızına ulaşmayı sürdürüyoruz.
Android Çerçeve İlerleme Hızı kitaplığı oyunlar için sabit bir kare hızı sağlar. Kalan Kare sürelerindeki değişim, belirli karelerde görüntülenen ayrıntı düzeyinden sahneler ve cihazın grafik yetenekleri. Kullanım Android Performance Tuner, oyun sırasında kare oluşturma süresinin belirli zamanları hedefinizden daha yavaş veya hızlı olduğunu düşünmelisiniz ve bu sorunlar ile şu fırsatlara sahip olacaksınız:
- Belirli kalite ayarları
- Oyununuzdaki belirli sahneler
- Belirli cihaz modelleri veya cihaz özellikleri
Veri kaydetme ve yükleme
Tuning Fork kütüphanesi, işaretleme işlevleri her karenin Android Frame Pacing kitaplığı tarafından çağrılması gerekir. Kitaplıkta bu onay işareti bilgileri histogramlar halinde toplanır ve daha sonra HTTP uç noktası aracılığıyla Google Play'e yüklenen içeriklerdir. Her onay işareti Bir araç anahtarı ve bir ek açıklama, bir protokolde belirttiğiniz tanımlar arabellek dosyası.
Enstrüman tuşları
Gösterge anahtarı, çizginin çerçevenin neresinden geldiğini belirtir ve
her onay işlevi çağrısına iletilmesi gereken tam sayı. Android Çerçeve İlerlemesi
kitaplığı, swappy_common.h içinde tanımlanan önceden tanımlanmış bir dizi gösterge anahtarı kullanır.
Çerçeve İlerlemesi'ni kullanmıyorsanız kendi araç anahtarlarınızı da tanımlayabilirsiniz
kitaplığını açar.
Ek Açıklamalar
Ek açıklamalar, bir kullanıcı sizi tıkladığında oyununuzun onay işareti kaydedilir. Örneğin bir ek açıklama, takip etmek için:
- Oyunun mevcut seviyesi
- "Büyük patron" ekranda
- Alakalı diğer tüm oyun durumu bilgileri
Ek açıklamalar com.google.tuningfork.Annotation protokolüyle tanımlanır
arabellek mesajı. Geçerli ek açıklamayı ayarlamak için
bu mesaj
TuningFork_setCurrentAnnotation().
Sonraki tüm işaret verileri, başka bir onay işareti görünene kadar bu ek açıklamayla
ek açıklamanın ayarlanmasını sağlar. 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, reklamınızın performansını ve grafik kalitesini etkiler.
Örgü ayrıntı düzeyi, doku çözünürlüğü ve kenar yumuşatma gibi oyunlar
yöntemidir. Notlar gibi doğruluk parametreleri de
com.google.tuningfork.FidelityParams protokol arabellek mesajı. Bu özellik,
doğruluk parametreleri için örnek bir proto tanımı:
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 ilk kullanıma hazırlarken, şunun serileştirmesini geçersiniz: parametreleridir. Bu parametreleri, örneğin, Kullanıcı oyun oluşturma ayarlarını değiştirir ve daha sonra yüklediğiniz veriler yeni parametrelerle ilişkilendirilir.
Google Play'in ek açıklamaları ve doğruluk parametrelerini anlayabilmesi için bu tanımları içeren protokol arabellek dosyasının oyunun APK'sında paket halinde sunulur. Ayrıca ortak doğruluk parametresi kombinasyonları için verilerinizi Google Play kullanıcı arayüzünde segmentlere ayırmanız gerekir. Daha fazla bilgi için bkz. Kalite seviyelerini tanımlayın.
Ek bellek ve CPU yükü
Tuning Fork kitaplığının kullandığı tüm bellek şurada tahsis edildi: ilk kullanıma hazırlamayı kolaylaştırır. Verilerin boyutu araç anahtarı sayısına, olası ek açıklama sayısına ve her histogramdaki kova sayısı; bu dört çarpı tahmininin katlarıdır bayt olarak kabul edilir. Tüm histogramların iki kopyayı kullanarak veya çift arabelleğe alınmış biçimde gönderebilirsiniz.
Gönderim ayrı bir ileti dizisinde gerçekleşir ve onay çağrısını engellemez. Yanıt hayır ise: yükleme bağlantısı varsa, gönderim daha sonra yüklenmek üzere sıraya alınmıştır.
Onay işlevi çağırmak için işlem yükü çok azdır. histogram paketleri dizisinde bir dizin hesaplar ve Tam sayı.
Tuning Fork kitaplığını entegre etme
Bu entegrasyon kılavuzu iki bölüme ayrılmıştır. İlk bölümde bu riskin . İlgili içeriği oluşturmak için kullanılan ikinci bölümde Tuning Fork kitaplığının Google Analytics 4'e nasıl entegre edileceği ve kitaplığın sağladığı işlevleri nasıl kullanacağınızı öğreneceksiniz. Önce Başlamak için aşağıdaki Sonraki bağlantısını tıklayın.