このページは Cloud Translation API によって翻訳されました。

パフォーマンスクラス

パフォーマンスクラスは、Android 12 で初めて導入された規格です。パフォーマンスクラスは、Android の基本要件を超えるデバイス機能のセットを定義します。

Android のバージョンごとに、対応する独自のパフォーマンスクラスがあります。これはそのバージョンの Android 互換性定義ドキュメント（CDD）で規定されています。Android 互換性テストスイート（CTS）で、CDD の要件を検証します。

各 Android 搭載デバイスは、サポート対象のパフォーマンスクラスを宣言します。デベロッパーは実行時にデバイスのパフォーマンスクラスを検出し、デバイスの機能を最大限に活用するアップグレード環境を提供できます。

デバイスのパフォーマンスクラスレベルを検出するには、Jetpack の Core Performance ライブラリを使用します。このライブラリは、ビルドバージョン情報での宣言、または Google Play 開発者サービスのデータに基づいて、デバイスのメディアパフォーマンスクラスをレポートします。

まず、Gradle ファイルに、関連するモジュールの依存関係を追加します。

Kotlin

// Implementation of Jetpack Core library.
implementation("androidx.core:core-ktx:1.12.0")
// Enable APIs to query for device-reported performance class.
implementation("androidx.core:core-performance:1.0.0")
// Enable APIs to query Google Play Services for performance class.
implementation("androidx.core:core-performance-play-services:1.0.0")

Groovy

// Implementation of Jetpack Core library.
implementation 'androidx.core:core-ktx:1.12.0'
// Enable APIs to query for device-reported performance class.
implementation 'androidx.core:core-performance:1.0.0'
// Enable APIs to query Google Play Services for performance class.
implementation 'androidx.core:core-performance-play-services:1.0.0'

Then, create an instance of a DevicePerformance implementation, such as PlayServicesDevicePerformance, in the onCreate() lifecycle event of your Application. This should only be done once in your app.

Kotlin

import androidx.core.performance.play.services.PlayServicesDevicePerformance

class MyApplication : Application() {
  lateinit var devicePerformance: DevicePerformance

  override fun onCreate() {
    // Use a class derived from the DevicePerformance interface
    devicePerformance = PlayServicesDevicePerformance(applicationContext)
  }
}

Java

import androidx.core.performance.play.services.PlayServicesDevicePerformance;

class MyApplication extends Application {
  DevicePerformance devicePerformance;

  @Override
  public void onCreate() {
    // Use a class derived from the DevicePerformance interface
    devicePerformance = new PlayServicesDevicePerformance(applicationContext);
  }
}

次に、mediaPerformanceClass プロパティを取得し、デバイスの機能に基づいてアプリのエクスペリエンスを調整します。

Kotlin

class MyActivity : Activity() {
  private lateinit var devicePerformance: DevicePerformance
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // Note: Good app architecture is to use a dependency framework. See
    // https://developer.android.com/training/dependency-injection for more
    // information.
    devicePerformance = (application as MyApplication).devicePerformance
  }

  override fun onResume() {
    super.onResume()
    when {
      devicePerformance.mediaPerformanceClass >= Build.VERSION_CODES.TIRAMISU -> {
        // Performance class level 13 and later.
        // Provide the most premium experience for the highest performing devices.
      }
      devicePerformance.mediaPerformanceClass == Build.VERSION_CODES.S -> {
        // Performance class level 12.
        // Provide a high quality experience.
      }
      else -> {
        // Performance class level 11 or undefined.
        // Remove extras to keep experience functional.
      }
    }
  }
}

Java

class MyActivity extends Activity {
  private DevicePerformance devicePerformance;
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // Note: Good app architecture is to use a dependency framework. See
    // https://developer.android.com/training/dependency-injection for more
    // information.
    devicePerformance = ((MyApplication) getApplication()).devicePerformance;
  }

  @Override
  public void onResume() {
    super.onResume();
    if (devicePerformance.getMediaPerformanceClass() >= Build.VERSION_CODES.TIRAMISU) {
      // Performance class level 13 and later.
      // Provide the most premium experience for the highest performing devices.
    } else if (devicePerformance.getMediaPerformanceClass() == Build.VERSION_CODES.S) {
      // Performance class level 12.
      // Provide a high quality experience.
    } else {
      // Performance class level 11 or undefined.
      // Remove extras to keep experience functional.
    }
  }
}

パフォーマンスクラスには上位互換性があります。デバイスは、パフォーマンスクラスを更新せずに、新しいプラットフォームバージョンにアップグレードできます。たとえば、当初パフォーマンスクラス 12 をサポートしていたデバイスを Android 13 にアップグレードし、クラス 13 の要件を満たしていない場合は引き続きクラス 12 をサポートすることを報告できます。つまり、パフォーマンスクラスを使用すると、特定の Android バージョンに依存せずにデバイスをグループ化できます。

図 1. デバイスは Android バージョンをアップグレードし、元々サポートしていたクラスをサポートしているという報告を継続できます。