ディスプレイの設定を調整する

Android には、サポートされているハードウェアでアプリがディスプレイ設定を調整できるようにする API が含まれています。Android TV OS では、アプリはこの API を利用して、理想的な視聴エクスペリエンスを実現するためにフレームレートとカラー プロファイルを一致させることで、コンテンツを可能な限り最適な形式で表示できます。

コンテンツのフレームレートを合わせる

動画のフレームレートがディスプレイのリフレッシュ レートと一致しない場合、フレームレート変換によって不快なモーション ジャダー アーティファクトが発生する可能性があります。これは、ゆっくりとしたパン ショットで特に顕著になります。このため、 Surface.setFrameRate() API を使用して、コンテンツのフレームレートをフレームワークに通知し、動画 コンテンツがシームレスでない フレームレート 切り替えの対象となるかどうかを示します。

詳細については、フレームレートのガイドをご覧ください。

優先する画像プロファイルに合わせる

Android 16 の MediaQuality API を使用すると、デベロッパーは画像プロファイルを制御できます。

サンプルの事例としては、次のようなものが挙げられます。

• より広いダイナミック レンジでマスタリングされた映画やテレビシリーズの場合、デベロッパーは、クリエイターが意図したとおりにコンテンツを正確に表示するために、Filmmaker モードをリクエストできます。色の精度が高いシネマ プロファイルでは、明るさを高めるためにシャドウの微妙なディテールが強調されます。
• 狭いダイナミック レンジでマスタリングされ、日中に視聴されることが多いライブ スポーツ イベントでは、色の精度よりも明るさを優先するプロファイルが適しています。
• ゲーム デベロッパーは、画像処理を最小限に抑えた低レイテンシ プロファイルをリクエストして、プレーヤーがディスプレイの最高のパフォーマンスを得られるようにすることができます。

システム画像プロファイルの選択

画像プロファイルを選択する前に、まずデバイスがそのプロファイルをサポートしていることを確認することが重要です。

次のスニペットは、 getAvailablePictureProfiles() を使用してサポートされているすべての 画像プロファイルをクエリし、スポーツ プロファイルを適用する方法を示しています。

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.BAKLAVA) {
    val mediaQualityManager: MediaQualityManager =
        context.getSystemService(MediaQualityManager::class.java)
    val profiles = mediaQualityManager.getAvailablePictureProfiles(null)
    for (profile in profiles) {
        // If we have a system sports profile, apply it to our media codec
        if (profile.profileType == PictureProfile.TYPE_SYSTEM &&
            profile.name == NAME_SPORTS
        ) {
            val bundle = Bundle().apply { 
                putParcelable(MediaFormat.KEY_PICTURE_PROFILE_INSTANCE, profile)
            }
            mediaCodec.setParameters(bundle)
        }
    }
}
DisplaySettings.kt

名前で特定のプロファイルを取得するには、getPictureProfile() を使用します。

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.BAKLAVA) {
    val profile = mediaQualityManager.getPictureProfile(
        PictureProfile.TYPE_SYSTEM, NAME_SPORTS, null
    )
}
DisplaySettings.kt

プロファイルが利用可能かどうかをクエリする必要がない場合は、MediaFormat.KEY_PICTURE_PROFILE_INSTANCE を使用して、プロファイルを ID で MediaCodec に直接提供できます。

サポートされているプロファイルはデバイスによって異なる場合がありますが、次の既知のシステム プロファイル ID と照合することを検討してください。

const val NAME_STANDARD: String = "standard"
const val NAME_VIVID: String = "vivid"
const val NAME_SPORTS: String = "sports"
const val NAME_GAME: String = "game"
const val NAME_MOVIE: String = "movie"
const val NAME_ENERGY_SAVING: String = "energy_saving"
const val NAME_USER: String = "user"
DisplaySettings.kt