サーフェス タイプ

このページでは、Media3 で動画再生に使用できるさまざまな種類のサーフェスと、ユースケースに適した種類を選択する方法について説明します。Android の Surface オブジェクトについて詳しくは、グラフィックのドキュメントをご覧ください。

PlayerView のサーフェス タイプを選択する

PlayerView の surface_type 属性を使用すると、動画再生に使用するサーフェスのタイプを設定できます。使用できる値は次のとおりです。

  • surface_view（SurfaceView）
  • texture_view（TextureView）
  • spherical_gl_surface_view（SphericalGLSurfaceView）- 球面動画の再生用
  • video_decoder_gl_surface_view（VideoDecoderGLSurfaceView）- 拡張レンダラを使用した動画レンダリング
  • none - 音声再生専用で、サーフェスの作成を回避するために使用します。サーフェスの作成はコストがかかる場合があります。

ビューが通常の動画再生用である場合は、surface_view または texture_view を使用する必要があります。動画の再生において、SurfaceView には TextureView よりも多くのメリットがあります。

  • 多くのデバイスで消費電力を大幅に削減。
  • フレーム タイミングの精度が向上し、動画再生がよりスムーズになりました。
  • 対応デバイスでの高画質 HDR 動画出力のサポート。
  • DRM で保護されたコンテンツの再生時のセキュア出力のサポート。
  • UI レイヤをアップスケールする Android TV デバイスで、ディスプレイのフル解像度で動画コンテンツをレンダリングする機能。

したがって、可能な場合は TextureView よりも SurfaceView を優先する必要があります。TextureView は、SurfaceView でニーズを満たせない場合にのみ使用してください。たとえば、Android 7.0（API レベル 24）より前のバージョンで、動画サーフェスのスムーズなアニメーションやスクロールが必要な場合などです（以下の注を参照）。この場合、SDK_INT が 24（Android 7.0）未満の場合は TextureView を使用し、それ以外の場合は SurfaceView を使用することが望ましいです。

Compose でサーフェス タイプを選択する

Compose では、相互運用ソリューションは AndroidView コンポーザブルを使用して SurfaceView と TextureView をラップします。これに対応する 2 つのコンポーザブルは AndroidExternalSurface と AndroidEmbeddedExternalSurface です。

Media3 ui-compose モジュールには、Player をライフサイクルを認識した方法で Surface にリンクする PlayerSurface コンポーザブルが用意されています。この場合のサーフェス タイプは次のとおりです。

none という型はありません。これは、Compose UI ツリーに PlayerSurface を含めないことに対応するためです。