Android には、サポートされているハードウェアでアプリがディスプレイ設定を調整できるようにする API があります。Android TV OS では、アプリはこの機能を利用して、理想的な視聴エクスペリエンスを実現するために、フレームレートとカラー プロファイルを一致させ、コンテンツが可能な限り最適な形式で表示されるようにすることができます。
コンテンツのフレームレートを合わせる
動画のフレームレートがディスプレイのリフレッシュ レートと一致しない場合、ユーザーはフレームレート変換による不快なモーション ジャダー アーティファクトを体験する可能性があります。これは、特にゆっくりとしたパンショットで顕著になります。そのため、Surface.setFrameRate API を使用して、コンテンツのフレームレートをフレームワークに通知し、動画コンテンツがシームレスでないフレームレートの切り替えの対象となるかどうかをシグナリングします。
詳しくは、フレームレート ガイドをご覧ください。
優先する写真プロファイルと一致させる
Android 16 の MediaQuality API を使用すると、デベロッパーは画像プロファイルを制御できます。
たとえば、次のようなシナリオがあります。
- より広いダイナミック レンジでマスタリングされた映画やテレビ シリーズの場合、デベロッパーは、クリエイターが意図したとおりにコンテンツを正確に表示するために、映画製作者モードをリクエストすることがあります。シネマ プロファイルでは、明るさを高めるために影の微妙なディテールが強調され、色の精度が向上しています。
- スポーツのライブ中継は、ダイナミック レンジが狭く、日中に視聴されることが多いため、色の正確さよりも明るさを優先するプロファイルが適しています。
- ゲーム デベロッパーは、画像処理を最小限に抑えた低レイテンシ プロファイルをリクエストできます。これにより、プレーヤーはディスプレイから最高のパフォーマンスを得ることができます。
システム ピクチャー プロファイルの選択
ピクチャー プロファイルを選択する前に、まずデバイスがそのプロファイルをサポートしていることを確認することが重要です。
次のスニペットは、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) } } }
名前を指定して特定のプロファイルを取得するには、getPictureProfile を使用します。
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.BAKLAVA) { val profile = mediaQualityManager.getPictureProfile( PictureProfile.TYPE_SYSTEM, NAME_SPORTS, null ) }
プロファイルが利用可能かどうかをクエリする必要がない場合は、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"