Oyun Modu API'si

Game Mode API, oyununuzu en iyi performans veya en uzun pil ömrünü uzatır.

Alternatif olarak, İyileştirilecek Oyun Modu müdahaleleri artık geliştiriciler tarafından güncellenmeyen oyunların performansı.

Game Mode API ve müdahaleler aşağıdaki platformlarda kullanılabilir:

• Belirli Android 12 cihazlar
• Android 13 veya sonraki sürümleri çalıştıran cihazlar

Her oyun, Oyun Modu API'si davranışını uygulayabilir. Oyun Modu önerin OEM'lere müdahale ayarları Oyun Modu müdahalelerini devre dışı bırakın.

Kurulum

Oyununuzda Oyun Modu API'sini kullanmak için aşağıdakileri yapın:

1. Şunu indirin ve yükleyin: Android 13 SDK'sı

2. AndroidManifest.xml dosyasında, uygulamanızı oyun olarak beyan etmek için appCategory özelliğini <application> öğesi:

android:appCategory="game"

1. Mevcut oyun modunu ana etkinliğinize ekleyerek sorgulayabilirsiniz:

// Only call this for Android 12 and higher devices
if ( Build.VERSION.SDK_INT >= Build.VERSION_CODES.S ) {
  // Get GameManager from SystemService
  GameManager gameManager = Context.getSystemService(GameManager.class);

  // Returns the selected GameMode
  int gameMode = gameManager.getGameMode();
}

// Only call this for Android 12 and higher devices
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
  // Get GameManager from SystemService
  val gameManager: GameManager? = context.getSystemService(Context.GAME_SERVICE) as GameManager?

  // Returns the selected GameMode
  val gameMode = gameManager?.gameMode
}

1. Oyun modu durumunu onResume işlevi:

   

En İyi Uygulamalar

Oyununuz zaten çoklu kaliteyi ve kare hızını destekliyorsa performans için uygun ayarları belirlemeli ve pil tasarrufu modları:

• Maksimum cihaz kare hızlarına istikrarlı bir şekilde ulaşmak için: Çok az kullanarak daha yüksek kare hızlarına ulaşabilirsiniz.

• Pil ömrünü uzatmak için: Daha düşük bir ekran yenileme hızı seçmeyi düşünün (ör. 30 Hz veya 60 Hz) ve kare ilerleme hızını kullanın daha düşük bir oran.

Birinci şahıs nişancı, çok oyunculu online ve birinci şahıs nişancı gibi yüksek görüntü kalitesine sahip oyunlar ve rol yapma oyunlarında (RPG'ler) bu tür oyunlara odaklanmanız gerekir: kullanıcı ilgisini en üst düzeye çıkarmak için yüksek tutarlı kare hızlarına ulaşma.

Hem yüksek görüntü kalitesine sahip hem de basit oyunlar için pil tasarrufu modunu desteklemeniz gerekir. en yüksek kare hızlarınızı düşürerek oynatma süresini uzatabilirsiniz.

Oyun modları için destek beyan etme

Oyun modları desteğini beyan etmek ve Oyun Modu müdahalelerini geçersiz kılmak için OEM'ler için önce oyun modu yapılandırmasını <application> öğesi AndroidManifest.xml dosyası:

<application>
    <meta-data android:name="android.game_mode_config"
               android:resource="@xml/game_mode_config" />
  ...
</application>

Ardından projenizin res/xml/ dizininde bir game_mode_config.xml dosyası oluşturun şu içeriklerle:

<?xml version="1.0" encoding="UTF-8"?>
<game-mode-config
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:supportsBatteryGameMode="true"
    android:supportsPerformanceGameMode="true"
/>

Oyun Modları Arasında Geçiş Yap

Oyun modları arasında geçiş yapmak için Pixel cihazlar) veya OEM'ler tarafından sağlanan benzer uygulamalar için geçerlidir. Alternatif olarak Oyun Modu'nun kabuk komutunu kullanın.

Oyun Paneli'ni kullanıyorsanız ve optimizasyon simgesi görüntülenmiyorsa Oyununuz kullanıma sunulduğunda uygulamanızı Google Play Console'a yüklemeniz gerekebilir Play Store'dan yükleyebilirsiniz. Uygulama testi hakkında bilgi için Play Store'a göz atın Uygulama paketlerini ve APK'ları dahili olarak paylaşma.

. Şekil 1. Pixel'de çalışan oyunun yer paylaşımlı olarak gösterilen Oyun Paneli olanak tanır.

Şekil 1'de, koşu oyununun Oyun Modu, Optimizasyon widget'ını tıklayın. Widget'ta görüldüğü gibi, oyun şu anda PERFORMANCE yatırım yapmanız önemlidir.

Geliştirme sırasında, Oyun Paneli ve üretici her uygulama için Oyun Modu'nu ayarlayabileceğiniz herhangi bir yöntem sunmamaktadır. Oyun Modu durumunu adb üzerinden değiştirin:

adb shell cmd game mode [standard|performance|battery] <PACKAGE_NAME>

Örnek Uygulama

Oyun Modu API örneği , uygulamalarınızda yaklaşık% 25 güç tasarrufu yapacak şekilde FPS'yi ve oluşturma çözünürlüğü sınırlarını nasıl optimize edebileceğinizi vurgular.

Sonraki

Oyun Modu Müdahaleleri başlıklı makaleyi okuyun. oyun güncellemeleri sağlamak mümkün olmadığında oyunların performansını artırmak için.