ApsaraVideo VOD:Sistem strategi

Strategi bawaan

Sistem ini mencakup strategi-strategi berikut yang direkomendasikan out of the box:

Penggunaan

Menggunakan strategi default

Strategi bawaan berjalan secara otomatis tanpa perlu konfigurasi apa pun:

final data = AliPlayerWidgetData(
  videoSource: videoSource,
);
controller.configure(data);

Mengganti strategi bawaan

Untuk mengambil data waktu proses, ganti strategi bawaan default dengan mendaftarkan instans baru yang memiliki nama yang sama menggunakan metode register(). Hal ini memungkinkan Anda menyediakan callback:

controller.strategyManager
  ..register(FirstFrameStrategy(
    onPrepared: (cost) {
      print('Time to prepare: ${cost.inMilliseconds}ms');
    },
    onFirstFrame: (cost) {
      print('Time to first frame: ${cost.inMilliseconds}ms');
    },
  ))
  ..register(StutterDetectStrategy(
    onStutterDetected: (info) {
      print('Stutters: ${info.stutterCount}, Stutter Rate: ${(info.stutterRate * 100).toStringAsFixed(1)}%');
    },
  ));

Mendaftarkan strategi kustom

Daftarkan instans strategi kustom dengan nama unik menggunakan register() untuk memperluas perilaku player:

controller.strategyManager.register(ResumePlayStrategy(
  onPositionSaved: (position) {
    print('Position saved: ${position.inSeconds}s');
  },
));

Mengelola strategi

Gunakan strategyManager untuk menghapus strategi saat waktu proses:

// Remove a strategy by name
controller.strategyManager.unregister('MyCustomStrategy');

// Remove all strategies
controller.strategyManager.clear();

Pengembangan strategi kustom

Memperluas BasePlayerStrategy

Buat strategi kustom dengan memperluas BasePlayerStrategy. Framework secara otomatis mengelola siklus hidup pendengar:

class MyCustomStrategy extends BasePlayerStrategy {
  @override
  String get name => 'MyCustomStrategy';

  @override
  void onStart(AliPlayerWidgetController controller) {
    // Subscribe to notifiers with listen(). The framework automatically cleans them up in onStop.
    listen<int>(controller.playStateNotifier, (state) {
      // Handle playback state changes
    });

    listen<Duration>(controller.currentPositionNotifier, (position) {
      // Handle playback position changes
    });
  }

  @override
  void onReset() {
    // Reset internal state when the video source changes (the strategy remains active)
  }
}

Metode siklus hidup

Mekanisme keamanan callback

Strategi biasanya menggunakan callback untuk melaporkan data ke luar, misalnya untuk memberi tahu UI tentang pembaruan. Saat strategi dihentikan, UI terkait mungkin telah dihancurkan. Untuk mencegah potensi masalah, framework menyediakan dua lapis perlindungan:

class ResumePlayStrategy extends BasePlayerStrategy {
  final void Function(Duration)? onPositionSaved;

  @override
  void onStop() {
    super.onStop();
    _savePosition();
  }

  void _savePosition() {
    // Persistensi selalu dijalankan (untuk keamanan data)
    storage.save(position);

    // Secara aman picu callback eksternal dengan notify() (dilewati jika dihentikan)
    notify(onPositionSaved, position);
  }
}

Sumber data dan sinyal status

Strategi pada dasarnya merupakan unit organisasi dasar dari logika bisnis. Karena melibatkan logika bisnis, strategi pasti melibatkan akuisisi dan pemrosesan data. Strategi memperoleh referensi lengkap ke controller dalam onStart dan dapat memperoleh data yang diperlukan melalui berbagai metode.

Sinyal status yang dapat diamati

Strategi berlangganan objek ValueNotifier pada controller dengan menggunakan metode listen():

Sumber data lainnya

Strategi juga dapat memperoleh data dari API publik apa pun pada controller:

Jika data yang Anda butuhkan tidak memiliki Notifier yang sesuai, Anda dapat:

class MyCustomStrategy extends BasePlayerStrategy {
  late AliPlayerWidgetController _controller;

  @override
  String get name => 'MyCustomStrategy';

  @override
  void onStart(AliPlayerWidgetController controller) {
    _controller = controller;

    // Metode 1: Gunakan Notifier yang sudah ada untuk memicu kueri aktif dalam callback.
    listen<int>(controller.playStateNotifier, (state) {
      // Saat status pemutaran berubah, lakukan kueri aktif untuk posisi pemutaran saat ini.
      controller.getCurrentPosition().then((pos) {
        // ...handle business logic
      });
    });

    // Metode 2: Baca informasi konfigurasi secara langsung.
    final videoSource = controller.widgetData?.videoSource;
    // ...jalankan logika berbeda berdasarkan tipe sumber video.
  }
}

Cara kerja sistem strategi

Sistem strategi beroperasi melalui mekanisme berikut:

1. Pendaftaran otomatis: StrategyManager mendaftarkan strategi bawaan yang direkomendasikan secara default saat dibuat.

2. Binding siklus hidup: Strategi dimulai bersama metode configure() controller dan dihapus bersama metode destroy().

3. Isolasi exception: Exception pada satu strategi tidak memengaruhi operasi strategi lainnya.

4. Keamanan callback: Framework menggunakan flag isActive untuk memastikan callback eksternal tidak dipicu setelah strategi dihentikan.

Contoh praktis

Lihat example/lib/pages/strategy/strategy_demo_page.dart untuk contoh lengkap penggunaan sistem strategi, termasuk implementasi penuh strategi kustom untuk melanjutkan pemutaran.

Sistem strategi memungkinkan Anda mengenkapsulasi kebutuhan bisnis ke dalam strategi-strategi independen yang dapat dikombinasikan secara fleksibel untuk berbagai skenario.