シーンのコスト

シーンのコストのほとんどは、シーンそのものではありません。このページには、計測した結果と、コストを下げるプロパティがあります。スマートフォンでページを滑らかに保つ仕組み、ブラウザーでのキャンバス、シーンの描画を減らす条件は、スマートフォンでの速さ にあります。

使う理由

常に動いているシーンは、常にかかるコストです。それを表示するすべての画面で、表示されている間ずっとかかります。下の数値は、時間がどこに使われるかを示します。正しいものを下げるためです。

例

# lib/resources/application.yml
spring:
  flutter:
    scene:
      max-frame-rate: 30     # すべてのシーンの上限
      pixel-ratio: 1.5       # シーン独自の値。未設定: デバイスの値
      pause-off-screen: true
# lib/resources/application-android.yml: Android では静止した一つのフレーム
spring:
  flutter:
    scene:
      render: still

計測結果

Dota Passport のページで計測しました (Chrome、Apple M5、リリースビルド、canvas: page)。

役に立つもの

プロパティ 働き
spring.flutter.scene.max-frame-rate どのシーンも一秒あたりに描画する最大のフレーム数。デフォルトは 30。ウィジェットの maxFrameRate は、それより少ないフレームを求める。0 は画面が表示するだけのフレーム (60 から 144) で、その一つ一つにフレームのコストがかかる
spring.flutter.scene.render: still 静止した一つのフレーム。表示するものが変わったときだけ描画し直される
spring.flutter.scene.pause-off-screen スクロールで画面の外に出たシーンは描画を止める。デフォルトは true
spring.flutter.scene.pixel-ratio シーン独自のピクセル比。デバイスの値以下。3 の画面で 1 にすると、ピクセルの 9 分の 1 を描画する
spring.flutter.scene.canvas ブラウザーでシーンのフレームを描く場所。page (デフォルト)、layer、engine。後の二つでは、そのために Flutter がページを描くことはない。ブラウザーでのキャンバス を参照
spring.flutter.scene.light-clustering: false メッシュごとに、そこへ届く光源で陰影付けする。光源がビューに入ったり出たりしても光源のテクスチャーを作り直さない (iPhone では約 30 ms のフレームだった)
spring.flutter.scene.when 条件が成り立つ間 still または off。touch (タッチスクリーン)、slow (シーンがこのデバイスには重すぎる。シーンが表示される前に判定される)、またはアプリ独自の条件。コストがかかりすぎる場所で描画を減らす を参照

システムが動きを減らすよう求めているときは、プロパティが何であっても、すべてのシーンが静止した一つのフレームを描画します。

一つのプラットフォームのための値は、他と同じく、そのプロファイルのファイルに置きます。application-android.yml の render: still や、デバッグ実行が使うプロファイル (application-debug.yml) です。デバッグ実行では、一つのフレームにリリースの数倍のコストがかかります。プラットフォームのプロファイル を参照してください。

クロスオリジン分離されたページ

ヘッダーは Cross-Origin-Opener-Policy: same-origin と Cross-Origin-Embedder-Policy: require-corp です。ホストで設定し、flutter run のためには spring.flutter.web.dev-server.headers の下で設定します。

# lib/resources/application.yml
spring:
  flutter:
    web:
      dev-server:
        headers:
          Cross-Origin-Opener-Policy: same-origin
          Cross-Origin-Embedder-Policy: require-corp

require-corp は、CORS のないクロスオリジンのリソースを禁止します。アドレスにあるモデルのサーバーは、ページのオリジンを許可する必要があります (モデル を参照)。ページが分離されているかどうかは、デバッグタブ が示します。flutter run の開発サーバー を参照してください。

コストが最も大きい場所

関連項目