
# シーンのコスト

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

## 使う理由

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

## 例

```yaml
# lib/resources/application.yml
spring:
  flutter:
    scene:
      max-frame-rate: 30     # すべてのシーンの上限
      pixel-ratio: 1.5       # シーン独自の値。未設定: デバイスの値
      pause-off-screen: true
```

```yaml
# lib/resources/application-android.yml: Android では静止した一つのフレーム
spring:
  flutter:
    scene:
      render: still
```

## 計測結果

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

- **コストがかかるのはシーンではありません。** シーンは、ページのスレッドの約 1% でした。残りは、シーンのフレームごとに Flutter がページ全体を描画し直すことです。一秒あたり 30 フレームで、スレッドの 20% でした。
- **分離で半分になります。** ページがクロスオリジン分離されていると、Flutter はワーカーで描画します: 9%。
- **デバッグビルドは誤解を招きます。** 数値はリリースの数倍になります。リリースを計測してください。
- **止まらないアニメーションは、常にかかるコストです。** 役に立つのは、フレームを減らすこと、静止フレーム、画面外での一時停止です。
- **シーン専用のキャンバスなら、ページの分がなくなります。** `canvas: layer` または `engine` では、シーンのフレームのために Flutter がページを描くことはありません。エンジンのキャンバスでは、フレームの受け渡しもありません。Mac でシーン二つのビートは、フレームを受け渡すと Firefox で 12 ms、Safari で 6.6 ms かかり、`engine` では 1.2 ms でした。[ブラウザーでのキャンバス](speed.md#ブラウザーでのキャンバス) を参照してください。

## 役に立つもの

| プロパティ | 働き |
|---|---|
| `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 がページを描くことはない。[ブラウザーでのキャンバス](speed.md#ブラウザーでのキャンバス) を参照 |
| `spring.flutter.scene.light-clustering: false` | メッシュごとに、そこへ届く光源で陰影付けする。光源がビューに入ったり出たりしても光源のテクスチャーを作り直さない (iPhone では約 30 ms のフレームだった) |
| `spring.flutter.scene.when` | 条件が成り立つ間 `still` または `off`。`touch` (タッチスクリーン)、`slow` (シーンがこのデバイスには重すぎる。シーンが表示される前に判定される)、またはアプリ独自の条件。[コストがかかりすぎる場所で描画を減らす](speed.md#コストがかかりすぎる場所で描画を減らす) を参照 |

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

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

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

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

```yaml
# 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 のないクロスオリジンのリソースを禁止します。アドレスにあるモデルのサーバーは、ページのオリジンを許可する必要があります ([モデル](models.md) を参照)。ページが分離されているかどうかは、[デバッグタブ](debug-tab.md) が示します。[flutter run の開発サーバー](../spring-boot-starter-flutter/web.md#flutter-run-の開発サーバー) を参照してください。

## コストが最も大きい場所

- すべての画面の下の [アプリケーションのシーン](application-scene.md) は、`canvas: page` では、そのフレームごとにページ全体を描画し直します。`canvas: engine` ではページの背後に置かれ、そのフレームのためにページが描かれることはありません。
- エンジンの起動は、シェーダーをコンパイルする間、ページを止めます。[エンジンのシェーダー](shaders.md) を参照してください。
- モデルのコストは、[デバッグタブ](debug-tab.md) でモデルを隠すことで分かります。

## 関連項目

- [スマートフォンでの速さ](speed.md)
- [デバッグタブ](debug-tab.md)
- [エンジンのシェーダー](shaders.md)
- [すべてのプロパティ](properties.md)
- [フレームメーター](../spring-boot-starter-flutter/frame-meter.md)
