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.

Uyarı: OEM'ler, oyun modu müdahalelerini geliştirici olmadan uygulamayı tercih edebilir geri bildirimde bulunun.

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:

Java

// 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();
}

Kotlin

// 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
}

Desteklenen oyun modu	Açıklama
DESTEKLENMİYOR	Oyun, Oyun Modu API'sini desteklediğini beyan etmiyor ve Oyun Modu müdahalelerini desteklemiyor.
STANDART	Kullanıcı, oyun modu seçmedi veya standart modu seçti.
PERFORMANS	Pil ömrünün ve ses kalitesinin azalması karşılığında en düşük gecikmeli kare hızlarını sunar.
PİL	Çözünürlüğün veya kare hızlarının düşmesi karşılığında mümkün olan en uzun pil ömrünü sağlar.

Önemli: Pil Tasarrufu modu oyuna özgüdür ve sistemi etkilemez düzeyinde Android Pil Tasarrufu davranışı sergileyin.

1. Oyun modu durumunu onResume işlevi:

   

ziyaret edin.

Önemli: Uygulamanız bir cihazı devam ettirirken her zaman getGameMode() yöntemini sorgulamalıdır. devam edebilir. Ayrıntılar için yukarıdaki şemaya bakın.

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"
/>

Önemli: Oyununuz bir Oyun Modu'nu desteklediğini beyan ediyorsa oyun, kendi optimizasyonunu uygulayabilir. Sonuç olarak, platform daha önceki tüm uyguladı.

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.