6. デバイスと購読

センサから届くデータを Riverpod で受け取る

この章のゴール

1

センサの窓口

偽物と本物を同じ形で扱う

2

Stream を購読

StreamProvider と ref.listen

3

測定画面

リアルタイム表示と保存

データの流れ

flowchart LR
  D["6軸センサ<br/>(Fake / BLE)"] -- "Stream&lt;ImuSample&gt;<br/>100Hz" --> SP["imuSampleProvider<br/>(StreamProvider)"]
  SP -- "ref.listen" --> VM["MeasurementViewModel"]
  VM -- "state(20Hz)" --> V["測定画面"]

  • センサ(Service)は、届いたデータを Stream で流すだけ
  • ViewModel は ref.listen で受け取る。購読の解除は Riverpod が自動で行う

データの形

lib/service/imu/imu_device.dart
import 'dart:math';

// 3軸の値(x, y, z)
class Vec3 {
  const Vec3(this.x, this.y, this.z);

  final double x;
  final double y;
  final double z;

  // ベクトルの大きさ(向きに関係なく、どれだけ強いか)
  double get magnitude => sqrt(x * x + y * y + z * z);
}

// 6軸センサ2個分の1回分のデータ(100Hz で届く)
// == はoverrideしない(同じ値が続いても Riverpod に間引かれないように)
class ImuSample {
  const ImuSample({
    required this.count,
    required this.acc1,
    required this.gyro1,
    required this.acc2,
    required this.gyro2,
  });

  final int count; // パケット番号
  final Vec3 acc1; // センサ1の加速度[g]
  final Vec3 gyro1; // センサ1の角速度[dps]
  final Vec3 acc2; // センサ2の加速度[g]
  final Vec3 gyro2; // センサ2の角速度[dps]
}

// 6軸センサの窓口。偽物(Fake)とBLEの本物を同じ形で扱えるようにする
abstract interface class ImuDevice {
  Stream<ImuSample> get samples; // 計測中に届くデータ
  Future<void> start();
  Future<void> stop();
  Future<void> dispose();
}
  • 加速度は g(重力加速度の何倍か)、角速度は dps(1秒に何度回るか)
  • 偽物も本物(8章)も ImuDevice の形で作るので、画面側は差し替えを意識しない

偽物のセンサ

lib/service/imu/fake_imu_device.dart
import 'dart:async';
import 'dart:math';

import 'package:motion_app/service/imu/imu_device.dart';

// 実機がなくても動かせる偽物の6軸センサ
// start() すると 100Hz で、1.5秒ごとに「振る」動きをまねた値を流す
class FakeImuDevice implements ImuDevice {
  final _controller = StreamController<ImuSample>.broadcast();
  final _random = Random();
  Timer? _timer;
  int _count = 0;

  @override
  Stream<ImuSample> get samples => _controller.stream;

  @override
  Future<void> start() async {
    _timer?.cancel();
    _count = 0;
    _timer = Timer.periodic(const Duration(milliseconds: 10), (_) {
      final t = _count / 100; // 経過秒数
      // 1.5秒周期で 0 → 1 → 0 と鋭く変化する「振り」の強さ
      final swing = pow(sin(pi * (t % 1.5) / 1.5), 8).toDouble();
      double noise() => (_random.nextDouble() - 0.5) * 4;
      _controller.add(ImuSample(
        count: _count,
        acc1: Vec3(0, 0, 1 + 3 * swing), // 静止時は重力の 1g
        gyro1: Vec3(noise(), noise(), 800 * swing + noise()),
        acc2: Vec3(0, 0, 1 + 2 * swing),
        gyro2: Vec3(noise(), noise(), 500 * swing + noise()),
      ));
      _count++;
    });
  }

  @override
  Future<void> stop() async {
    _timer?.cancel();
    _timer = null;
  }

  @override
  Future<void> dispose() async {
    await stop();
    await _controller.close();
  }
}
  • 100Hz(10ms ごと)にデータを流す。broadcast() で複数の場所から購読できる

Provider に登録する

lib/provider/providers.dart
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:motion_app/infrastructure/database/app_database.dart';
import 'package:motion_app/repository/session/session_repository.dart';
import 'package:motion_app/repository/user/user_repository.dart';
import 'package:motion_app/service/imu/fake_imu_device.dart';
import 'package:motion_app/service/imu/imu_device.dart';

part 'providers.g.dart';

@Riverpod(keepAlive: true)
AppDatabase appDatabase(Ref ref) {
  final db = AppDatabase();
  ref.onDispose(db.close);
  return db;
}

@Riverpod(keepAlive: true)
UserRepository userRepository(Ref ref) =>
    UserRepository(ref.watch(appDatabaseProvider));

@Riverpod(keepAlive: true)
SessionRepository sessionRepository(Ref ref) =>
    SessionRepository(ref.watch(appDatabaseProvider));

// 6軸センサ。今は偽物を使う(8章でBLEに差し替える)
@Riverpod(keepAlive: true)
ImuDevice imuDevice(Ref ref) {
  final device = FakeImuDevice();
  ref.onDispose(device.dispose);
  return device;
}

// センサのデータを Riverpod で購読できるようにする
@riverpod
Stream<ImuSample> imuSample(Ref ref) => ref.watch(imuDeviceProvider).samples;
  • imuSample は Stream を返すので StreamProvider になる
  • @riverpod(keepAlive なし)→ 誰も使わなくなったら自動で購読をやめる

測定の ViewModel

lib/ui/measurement/view_model/measurement_view_model.dart
import 'package:freezed_annotation/freezed_annotation.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:motion_app/provider/providers.dart';
import 'package:motion_app/service/imu/imu_device.dart';

part 'measurement_view_model.g.dart';
part 'measurement_view_model.freezed.dart';

@freezed
abstract class MeasurementState with _$MeasurementState {
  const factory MeasurementState({
    @Default(false) bool isMeasuring,
    @Default(0) double gyro1, // センサ1の現在の角速度の大きさ[dps]
    @Default(0) double gyro2, // センサ2の現在の角速度の大きさ[dps]
    @Default(0) int sampleCount,
  }) = _MeasurementState;
}

@riverpod
class MeasurementViewModel extends _$MeasurementViewModel {
  final _samples = <ImuSample>[]; // 測定中に受け取った全データ

  @override
  MeasurementState build(String userId) {
    // センサのデータを受け取る。購読の解除は Riverpod が自動で行う
    ref.listen(imuSampleProvider, (previous, next) {
      final sample = next.value;
      if (sample != null) _onSample(sample);
    });
    // 画面を閉じたら計測を止める(onDispose の中では ref を使えないので先に取得)
    final device = ref.read(imuDeviceProvider);
    ref.onDispose(device.stop);
    return const MeasurementState();
  }

  void _onSample(ImuSample sample) {
    if (!state.isMeasuring) return;
    _samples.add(sample);
    // 100Hz で画面を描き直すと重いので、5件に1回(20Hz)だけ状態を更新する
    if (_samples.length % 5 != 0) return;
    state = state.copyWith(
      gyro1: sample.gyro1.magnitude,
      gyro2: sample.gyro2.magnitude,
      sampleCount: _samples.length,
    );
  }

  Future<void> start() async {
    _samples.clear();
    state = const MeasurementState(isMeasuring: true);
    await ref.read(imuDeviceProvider).start();
  }

  // 止めて保存する。保存できたら true
  Future<bool> stopAndSave() async {
    if (_samples.isEmpty) return false;
    // await のあとで ref を使わないよう、必要なものは先に取得しておく
    final repository = ref.read(sessionRepositoryProvider);
    final device = ref.read(imuDeviceProvider);
    state = state.copyWith(isMeasuring: false);
    await device.stop();

    // 最大値を求める(7章でドメイン層に移す)
    double peakGyro1 = 0, peakGyro2 = 0, peakAcc1 = 0, peakAcc2 = 0;
    for (final s in _samples) {
      if (s.gyro1.magnitude > peakGyro1) peakGyro1 = s.gyro1.magnitude;
      if (s.gyro2.magnitude > peakGyro2) peakGyro2 = s.gyro2.magnitude;
      if (s.acc1.magnitude > peakAcc1) peakAcc1 = s.acc1.magnitude;
      if (s.acc2.magnitude > peakAcc2) peakAcc2 = s.acc2.magnitude;
    }
    await repository.add(
      userId: userId,
      durationSec: _samples.length / 100, // 100Hz
      sampleCount: _samples.length,
      peakGyro1: peakGyro1,
      peakGyro2: peakGyro2,
      peakAcc1: peakAcc1,
      peakAcc2: peakAcc2,
    );
    return true;
  }
}

ref.listen と描き直しの頻度

ref.listen(imuSampleProvider, (previous, next) {
  final sample = next.value; // まだ値がない(読み込み中)ときは null
  if (sample != null) _onSample(sample);
});
  • 毎回来る値を ref.watch で受けると build がやり直されて状態が消える → listen を使う
  • build の中で 1回だけ 呼ぶ(メソッドの中で呼ぶと購読が増え続ける)
  • データは 100Hz でも、画面の更新は 5件に1回(20Hz) で十分。全部更新すると重くなる

保存の処理について

  • stopAndSave の中(63〜70行目)で最大値を計算しているが、これは 業務のルール。7章でドメイン層に移す
  • await のあとで ref を使わないよう、必要なものは先に取得している

測定画面

lib/ui/measurement/view/measurement_page.dart
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:motion_app/ui/measurement/view_model/measurement_view_model.dart';

class MeasurementPage extends ConsumerWidget {
  const MeasurementPage({super.key, required this.userId});

  final String userId;

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final state = ref.watch(measurementViewModelProvider(userId));
    final notifier = ref.read(measurementViewModelProvider(userId).notifier);
    final big = Theme.of(context).textTheme.displaySmall;

    return Scaffold(
      appBar: AppBar(title: const Text('測定')),
      body: Center(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Text('センサ1  ${state.gyro1.toStringAsFixed(0)} dps', style: big),
            Text('センサ2  ${state.gyro2.toStringAsFixed(0)} dps', style: big),
            const SizedBox(height: 8),
            Text('${(state.sampleCount / 100).toStringAsFixed(1)} 秒'),
            const SizedBox(height: 32),
            state.isMeasuring
                ? FilledButton.icon(
                    icon: const Icon(Icons.stop),
                    label: const Text('停止して保存'),
                    onPressed: () async {
                      final saved = await notifier.stopAndSave();
                      if (saved && context.mounted) context.pop(true);
                    },
                  )
                : FilledButton.icon(
                    icon: const Icon(Icons.play_arrow),
                    label: const Text('測定開始'),
                    onPressed: notifier.start,
                  ),
          ],
        ),
      ),
    );
  }
}

ルーターに測定画面を追加

lib/router/router.dart
import 'package:go_router/go_router.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:motion_app/ui/home/view/home_page.dart';
import 'package:motion_app/ui/measurement/view/measurement_page.dart';
import 'package:motion_app/ui/user_detail/view/user_detail_page.dart';
import 'package:motion_app/ui/user_list/view/user_list_page.dart';

part 'router.g.dart';

// パスは定数にまとめ、文字列の打ち間違いを防ぐ
abstract final class Routes {
  static const home = '/';
  static const users = '/users';
  static String userDetail(String userId) => '/users/$userId';
  static String measurement(String userId) => '/users/$userId/measure';
}

@Riverpod(keepAlive: true)
GoRouter router(Ref ref) {
  return GoRouter(
    initialLocation: Routes.home,
    routes: [
      GoRoute(
        path: Routes.home,
        builder: (context, state) => const HomePage(),
        routes: [
          GoRoute(
            path: 'users', // 子ルートは先頭に / を付けない
            builder: (context, state) => const UserListPage(),
            routes: [
              GoRoute(
                path: ':userId',
                builder: (context, state) => UserDetailPage(
                  userId: state.pathParameters['userId']!,
                ),
                routes: [
                  GoRoute(
                    path: 'measure',
                    builder: (context, state) => MeasurementPage(
                      userId: state.pathParameters['userId']!,
                    ),
                  ),
                ],
              ),
            ],
          ),
        ],
      ),
    ],
  );
}

詳細画面から測定へ

lib/ui/user_detail/view/user_detail_page.dart
import 'package:flutter/material.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:go_router/go_router.dart';
import 'package:intl/intl.dart';
import 'package:motion_app/router/router.dart';
import 'package:motion_app/ui/user_detail/view_model/user_detail_view_model.dart';

class UserDetailPage extends ConsumerWidget {
  const UserDetailPage({super.key, required this.userId});

  final String userId;

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final state = ref.watch(userDetailViewModelProvider(userId));

    return Scaffold(
      appBar: AppBar(title: Text(state.user?.name ?? '')),
      floatingActionButton: FloatingActionButton.extended(
        icon: const Icon(Icons.sensors),
        label: const Text('測定する'),
        onPressed: () async {
          // 測定画面で保存したら true が返ってくるので、履歴を読み直す
          final saved = await context.push<bool>(Routes.measurement(userId));
          if (saved == true) {
            ref.read(userDetailViewModelProvider(userId).notifier).load();
          }
        },
      ),
      body: state.isLoading
          ? const Center(child: CircularProgressIndicator())
          : ListView(
              padding: const EdgeInsets.all(16),
              children: [
                const Text('測定履歴'),
                if (state.sessions.isEmpty) const Text('まだ測定していません'),
                for (final s in state.sessions)
                  ListTile(
                    leading: const Icon(Icons.timeline),
                    title: Text('最大角速度 ${s.peakGyro1.toStringAsFixed(0)} / '
                        '${s.peakGyro2.toStringAsFixed(0)} dps'),
                    subtitle: Text(
                        '${DateFormat('yyyy/MM/dd HH:mm').format(s.recordedAt)}'
                        '  ${s.durationSec.toStringAsFixed(1)}秒'),
                  ),
              ],
            ),
    );
  }
}
  • 測定画面で保存すると true が返ってくるので、履歴を読み直す

チェックポイント

CHECK 0 / 4