ネットワーク上のリソース

ResourceLoader の http: / https: リソース(@Value の Resource、getResource、ResourceView、ResourceImage)は、一度ダウンロードされるとアプリのファイルに保持されます。以後は再起動後もディスクから読み、期限を過ぎるとバックグラウンドで問い合わせ直します。

なぜ

iOS、Android、デスクトップでは、Image.network は画像をメモリにしか保持しません。そのため起動のたびにアバターや画像を再びダウンロードします。ブラウザーでは HTTP キャッシュが保持しますが、それもサーバーのヘッダーが許す範囲だけです。アプリのファイルに保持したリソースなら次の起動でもネットワークなしで使えて、サーバーへの確認はときどきで済みます。

例

spring:
  flutter:
    resources:
      cache:
        max-size: 300MB          # 保持するリソース全体の上限
        max-age: 7d              # 過ぎたら使いつつ問い合わせ直す
        max-entry-size: 50MB     # これより大きいものは毎回ネットワークから
        locations:               # 最初に一致した規則が勝つ
          - pattern: https://avatars.steamstatic.com/**
            max-age: 1d
          - pattern: https://api.example.com/**
            enabled: false
      view:
        fade: 200ms
// どんなリソースも。いまは画像、独自の種類はレンダラーの Bean で。
ResourceView(
  player.avatarUrl,
  width: 40,
  height: 40,
  fit: BoxFit.cover,
  shape: const CircleBorder(),
  placeholder: const AvatarPlaceholder(),
  error: (context, error) => const AvatarPlaceholder(),
)

// ImageProvider を受け取る Flutter のウィジェット向け。
CircleAvatar(backgroundImage: ResourceImage(player.avatarUrl))

仕組み

@Component()
class PdfRenderer implements ResourceRenderer {
  @override
  bool supports(String mediaType) => mediaType == 'application/pdf';

  @override
  Widget build(BuildContext context, LoadedResource resource,
          ResourceLayout layout) =>
      PdfView(bytes: resource.bytes);
}

選んだプレーヤーで動画を再生する

フレームワークはプレーヤーを持ちません。保持したリソースは playableUri() で、プレーヤーが再生できるアドレスを返します。保持したファイル(file:)、ブラウザーではその blob:、初回は次回のために保持している間の元のアドレスです。

final clip = resources.getResource(highlightUrl) as CachedResource;
final uri = await clip.playableUri();
final controller = uri.scheme == 'file'
    ? VideoPlayerController.file(File(uri.toFilePath()))
    : VideoPlayerController.networkUrl(uri);
await controller.initialize();

保持するのは単一のファイル(mp4、webm)です。断片のプレイリスト(HLS、DASH)は保持しません。書き込み中のファイルはネットワークから再生します。

プロパティ

キー 既定値 意味
spring.flutter.resources.cache.enabled true http(s) のリソースを保持するか
spring.flutter.resources.cache.max-age 7d そのまま使う期間
spring.flutter.resources.cache.max-entry-size 50MB 保持する最大のサイズ
spring.flutter.resources.cache.max-size なし 保持するリソース全体の最大バイト数
spring.flutter.resources.cache.locations なし アドレスごとの規則: pattern、max-age、enabled
spring.flutter.resources.view.fade 200ms ResourceView のフェード